Patch Conversion Information - TheRealMrWicked/CSXtoXP3 GitHub Wiki

Decrypting the CSX File

The EntisGLS engine used a .csx file for storing the conversation data, we need to extract the data from this file and turn it into an easily readable/editable version.

Firstly download the yosuga.csx/Haruka.csx file, as mentioned before the English translation can be found on the Discord server.

Then download the CSX Extractor/Importer created by ProgerXP, after the program is downloaded extract the csx.rar file using 7-Zip or WinRar into a folder.

Place the yosuga.csx/Haruka.csx file into the new folder, then open a command prompt window in this folder, this can be done by clicking the little folder in the top left corner and then typing the word "cmd".

Once Command Prompt is open, simply type the command csx.exe "filename" export-no-names replacing "filename" with either yosuga.csx or Haruka.csx respectively, after this has finished you will see that many new files have been created.

The only files that we need for the conversion are the .utf files, in this case yosuga.utf - yosuga8.utf.

New Game File Listing

The digital version of Yosuga no Sora is built on the KiriKiri engine and uses .xp3 files to store the data for the game, a picture is included below for reference of the files that came with the game.

The files and their uses are briefly listed below:
html (folder) – Contains the website data for the manual.html file.
plugin (folder) – Contains various DLL files for windows to use.
char.xp3 – Contains the character models shown in game.
data.xp3 – Contains the startup sequence and the text for the game.
event.xp3 – Contains the pictures for major events in the game (mostly NSFW content).
manual.html – An instructional file containing instructions for how to play the game.
parts.xp3 – Contains the backgrounds, pictures and background music for the game.
readme.txt – Contains the notices from the creators of the game, about copyright, etc.
voice.xp3 – Contains all the voice files for the characters.
エンジン設定.exe – An executable that allows for settings of the game to be changed.
ヨスガノソラ.exe – The actual executable of the game.

Decrypting the XP3 File

The data.xp3 file is what is used to store the text that is actually displayed in the game such as the conversation between two people and Haruka’s inner thoughts. In order to see the contents of any of the xp3 files a program such as GARbro must be used, download the program and open it. Then using the interface in the program navigate to the data.xp3 file, double click on the file and a menu asking for the “Encryption type” will appear. Select the type as Yome no Imouto to no In’ai, click ok and the file will open.

Then a menu with 4 files will appear scenario, system, begin.tjs and startup.tjs. Select the four files, right click and click extract.

After that another menu will pop-up, point it to where you want the files to extract to and click ok.

Now that the files are extracted, we will just be focusing on the scenario folder for the conversion.

The scenario folder for Yosuga no Sora contains 306 files which are organized in such a manner:
00_a001.ks - 00_a034.ks – Sora's Route (47 Files)
00_b001.ks - 00_b034.ks – Nao's Route (66 Files)
00_c001.ks - 00_c036.ks – Akira's Route (66 Files)
00_d001.ks - 00_d044.ks – Kazuha's Route (56 Files)
00_e001.ks - 00_e037.ks – Mokota's Route (50 Files)
00_g001.ks - 00_g003.ks – Motoka's Route (4 Files)
00_z001.ks - 00_z015.ks – Introduction/Common Route (16 Files)
macro.ks - Control file. (1 File)

The scenario folder for Haruka na Sora contains 114 files which are organized in such a manner:
00_a001.ks - 00_a022.ks – Kozue's Route (35 Files)
00_g001.ks - 00_g025.ks – Yahiro's Route (29 Files)
00_h001.ks - 00_h032.ks – Sora's Route (42 Files) countdown.ks - The Countdown Scenario (1 File) karaoke.ks - The Karaoke Scenario (1 File) macro.ks - Control file. (1 File) web01.ks - web06.ks - Web Dramas (6 File)

An example of a few files from the scenario folder can be found below:

Encrypting the XP3 File

To re-encrypt the files into a data.xp3 file simply reverse the process that was done in the decrypting process. Firstly navigate to the folder that has the four files (presumably with the newly replaced scenario folder), select them, right click and click "create archive".

Then a menu will appear with various settings ensure they are as follow:
Archive Name - data.xp3
Archive Format - XP3
Version - 2
Encryption Scheme - Yome no Imouto to no In’ai
Be sure to also tick the 3 check boxes.

Once there is no errors GARbro should have just created the data.xp3 file, if the name is incorrect you can always rename it to whatever you want. If there were any errors, try repeating the steps again.