This repo contains scripts that can be used to convert the pack structure of the game TROUBLESHOOTER: Abandoned Children into the original and readable data structure used by the devs.
Python 3.5+ is required to run the scripts.
The pillow module is required for the extract_imagesets script.
You can install it via
pip install pillow
or
python -m pip install pillow
You have to clone/copy this repo into the Troubleshooter main folder
e.g. Steam\steamapps\common\Troubleshooter\TROUBLESHOOTER-mine
or adjust the GAME folder in lib\paths.py.
- extract_files.py - decrypts, unpacks and copies the "pack"ed files into the "Data" directory using the original file paths and names
- extract_imagesets.py - splits the extracted image sets into its single images
- apply_mod.py - check Modding
Modding is possible by moving edited files into the MOD folder set in lib\paths.py.
The edited files have to have the same path as their original within the MOD folder, so e.g. if you want to mod xml\Option.xml, then you have to move the modded version to MOD\xml\Option.xml.
The script apply_mod.py packs all the files from the mod folder into their packed form and replaces the original files with them. It also creates a backup of the original files in the BACKUP folder set in lib\paths.py.
So if you want to undo your mod, simply copy all files from BACKUP into the Package folder of the game and use replace all.
It's a small cli tool that makes it possible to decrypt the encrypted files of the game. It can also encrypt files again, which can be used to create mods. Since the devs encrypted their assets for whatever reason and might use the encryption for their network protocols as well, I won't publicize the code of this tool nor how the encryption works.
Same as for the exe, just that it can be integrated into other tools as library. It exports two functions,
int decrypt(char* data, long size);
int encrypt(char* data, long size);which do what their name says.
Note that the data should have a length multiple of 16, as otherwise the encryption will fail. The EXE/CLI versions automatically padds 0es at the end, the dll doesn't do so.