Sins of a Solar Empire: Rebellion

Sins of a Solar Empire: Rebellion

Not enough ratings
Convert Data
By myfist0
Convert BIN format files to TXT format files.
Starting to mod SoaSE first requires converting files from BIN format to TXT format. Once converted, the files can be edited with any text editor like notepad, I recommend Notepad++ (free). Using TXT files is fine, BIN file are used to help the game load faster and save a lot of space, basically a form of compression the game can read.

Note: The ConvertData files are version specific. The old ConvertData files included with Forge Tools 3 will not work with current files or the current ConvertData files will not convert older mod files.

Converting files will keep the same extension (e.g. *.entity). To open the converted files you will need to first specify a program to do so (e.g. notepad). The very first line upon opening the file will either read TXT or BIN.

Required Files
To keep all my modding files together, I created a Developer folder in my C drive (C:\Developer). Inside the Developer folder, I created a folder called ConvertData.

Navigate to where SoaSE is installed
(e.g. C:\Program Files (x86)\Steam\steamapps\common\Sins of a Solar Empire Rebellion)
and Copy [Ctrl + C]


Paste [Ctrl + V] the files in the ConvertData folder (e.g. C:\Developer\ConvertData). Note the short address location. This address will need to be typed at the DOS prompt so keep it short to avoid spelling errors. You can also use paste at the DOS prompt.

Navigate to the folder containing the BIN files, where SoaSE is installed or the mod folder e.g.

C:\Program Files (x86)\Stardock Games\Sins of a Solar Empire - Trinity\GameInfo

and COPY [Ctrl + C] the files which you choose to mod and paste them to the ConvertData folder.

The 3 ConvertData exes are DOS programs and will need the Command Prompt window to use them.

Navigate to Start --> Programs --> Accessories --> Command Prompt
or type cmd [Enter]in the Start --> Run box.

Vista and Win 7
Navigate to Start --> All Programs --> Accessories --> Command Prompt
or type cmd [Enter] in the Start --> Start Search box.

Navigate to the ConvertData folder in DOS using the cd "Change Directory" command and address, this is not case sensitive. e.g.

CD C:\Developer\ConvertData

There are 4 different types of files to convert.
  • brushes
  • entity
  • mesh
  • particle

To do each file separately from the selected expansion, use...

ConvertData_Rebellion type FileName.type FileName.type txt [Enter]

Trinity Versions
ConvertData_OriginalSins type FileName.type FileName.type txt [Enter]
ConvertData_Entrenchment type FileName.type FileName.type txt [Enter]
ConvertData_Diplomacy type FileName.type FileName.type txt [Enter]

Here is an example using AbilityEMPBlast.entity from the GameInfo directory.

ConvertData_Rebellion entity AbilityEMPBlast.entity AbilityEMPBlast.entity txt

If there was no error the file will be converted to TXT and the DOS prompt will return to the convert directory.

Once the mod is tested and everything is good you may want to help the game load quicker by converting the TXT files back to BIN format. This is the same as the process above accept for the TXT switch at the end of the command line.

By default, the ConvertData exes will convert to BIN so the bin switch at the end is not required. The next 2 examples are identical.

ConvertData_Rebellion type FileName.type FileName.type bin [Enter]

ConvertData_Rebellion type FileName.type FileName.type [Enter]

< >
myfist0  [author] Mar 30, 2017 @ 6:41am 
Here is a complete guide on making your own from the version you have installed. Includes batch convert (.bat).
Kylandor Jul 30, 2016 @ 4:53am 
Nevermind, after re-reading and exploring the SoaSE I realized my error and I've now been able to edit the files.
Kylandor Jul 29, 2016 @ 11:33pm 
I've created the exe folder for modding the file I want to mod but I am unsure what step is next, typing in the ConvertData_Rebellion type name.type name.type results in "Command Line Option Syntax error Type Command/? for help."

I am currently stuck here thus and am unable to convert the files from BIN to TXT.
My name is Bond James Bond [ITA] Mar 5, 2016 @ 4:53am 
Thanks for the answer, actually i used a batch file to repeat the call, i found the tips on the SINS forum, where there is another version of this guide with the multiple convert section.
GoaFan77 Mar 4, 2016 @ 3:37pm 
Bond: You can use a batch (.bat) file to automate calling ConvertData. That's what most modders do I think. I'm not sure why that's not mentioned in this guide. I'll try to see if I can't add something on that here via the guide author.
My name is Bond James Bond [ITA] Mar 2, 2016 @ 8:08am 
Hi, I've to convert all the reference file of a mod so i can't download the already converted file, is there any way to convert all file or i have to convert each file singularly ?
Thanks for a reply,