Pixel Game Maker Translator

This script deals with translating and optimizing the data, contained in the project.json file, of a game developed with Pixel Game Maker MV.

To function correctly, the file must be readable, that means decrypted. For this, please refer to the following link on F95Zone (courtesy of @xj47).

The script is completely automatic but it is still possible to extract the localization strings for manual modification.

Quick-start

This script uses Python 3.x and modules in the requirements.txt file. These modules can be installed with the command pip install -r path/on/disk/to/requirements.txt.

Place the script in the same directory of the (decrypted) project.json and run it.

Warning: This script overwrites the file, so make sure to create a backup copy!

Command-line Arguments

It is possible to have information on the various argoments using the command python PGMTranslator.py -h

Argument	Type	Description
-p	string	Path to the project.json file. If not specified, the file is sought in the current folder
-fl	string/locale	Code of strings from which to translate (eg zh_CN). Default is auto, it automatically select the first available language
-tl	string/locale	Code of strings to translate (eg en_US)
-s	boolean	Avoid the translation of a string that has already been translated for the language specified in -tl
-e	string	Export the part of JSON files containing the strings to be localized in the specified path. Useful for manually changing the strings
-i	string	Import the part of JSON containing the localized strings (previously exported with the parameter -e)
-o	boolean	Optimize the JSON file by removing indections and spaces, reducing its size and speeding up subsequent operations. It can take many minutes and at least 1 GB of free RAM