Modifying game text or Verifying correct setup - compupro/steins-gate-hrdarling-patch GitHub Wiki

This guide walks you through either modifying the game text or verifying that your setup works properly. The guide starts with a common route for both tasks, splits into routes specific for each task, and returns to a second common route that ends with testing the game. It assumes you have completed Setting up your working directory.

1. Run topographer.run. If a folder called atlas-scripts wasn't there, it will create it. It will put a bunch of Atlas scripts inside containing the scripts with the original Japanese. If the text files 1, 2, 4, 5, 8, 9, 10, 11, and 12 are missing, that is normal. They do not contain editable text
   • If you're on Windows, you may need to run it through msys
2. If every line of text in the Atlas scripts are separated by a new line, run util_carriage_return_buster.py and it will replace instances of \r\r\n (CRCRLF) with \r\n (CRLF).
3. Go to "Verifying correct setup route" or "Modifying game text route" depending on what you're doing

4. Run atlas-compile.bat
5. Run patch-final-check-hash.sh. Most if not all of the lines should report Hash <some hash> for <file> is valid
   • As of the time of this writing, file 30.BIN always seems to fail and it will say Hashes a4cf8d5dcc16af8781b0cec97d131237 and 73418067fd27f047a8238e256b5e5bb0 for 30 aren't valid because Topographer doesn't process the original 30.BIN properly and I don't have a solution for it yet. The rest of them should be valid though According to HaselLoyance, the creator of Topographer, the latest version should be able to produce an ATLAS script that compiles perfectly. However, I haven't tested this so you'll have to replace the Topographer build in this repo with the latest one in the one linked.
6. Go to common route 2

4. All the game text should be in the Atlas scripts. If you edit them and everything goes well, those changes should be reflected when you test the game. If you just want to test that you are able to modify the game text, the line 〔倫太郎〕「時間は流転し、死へ臨む存在とともに生まれ消えてゆく。有限」 in 16.txt is the first dialogue in the game

• Try only editing the text inside the Japanese quotation marks 「」 first. I haven't tried editing the speaker tag yet, but in Steins;Gate PSP, editing the speaker tag also requires you to edit a different Atlas script as well

5. Run atlas-compile.bat
6. Go to common route 2

7. Copy the contents of patch-data into patch-data-merged
8. Merge the BIN files that aren't in patch-data from original-data into patch-data-merged. (You will be copying the BIN files 1, 2, 4, 5, 8, 9, 10, 11, and 12 from original-data into patch-data-merged)
9. Add the files in patch-data-merged into a new CPK in CpkFileBuilder and set them all to Tries file compression: True. This is all done for you if you use my sg-hrdarling-SCENE00-data-merged.cpkproj
10. Build the CPK with the following options. Make sure you actually set the CPK File Path as well, or else it will either say that you don't have disk space or will end up somewhere weird
11. Replace the SCENE00.CPK in the DATA0 folder with the new SCENE00.CPK
12. Add the files in DATA0 into a new CPK in CpkFileBuilder and set them all to Tries file compression: False. This is all done for you if you use my sg-hrdarling-DATA0.cpkproj
13. Build the CPK with the following options
14. Open the game iso with UMDgen, navigate to PSP_GAME/USRDIR, and delete DATA0.CPK
15. Add your new DATA0.CPK in its place
16. (optional) Go to the UMD Properties tab and click "Optimize" to reduce unused space in the ISO
17. Save a new iso. You can test your iso in an emulator or in a real PSP with modified firmware. If you were successful, you should be able to play the game with your changes reflected (if you made any).