这里有中文版

This an unofficial localization project for game EXAPUNKS.

First at all, you should own this game, you can buy it on steam or GOG or whatever platforms.

Prepare the environment

1. install python 3 and some dependent libraries.

• install python from https://www.python.org/downloads/

• install pandas

  pip install pandas
  

• install openpyxl

  pip install openpyxl
  

• install Pillow

  pip install pillow
  

• install python-lz4

  pip install lz4
  

2. copy game files to localization working directory

• copy Content/descriptions/en/* to ./export_txt/Content/descriptions/en/

• copy Content/vignettes/* to ./export_txt/Content/vignettes

• copy PackedContent/fonts/*.packedfont to ./font/fonts

• copy PackedContent/*.tex to ./images/PackedContent

  Note: must be fixed files:

  Content/vignettes/ember-7.csv miss a double quote at line 12

  Content/vignettes/nivas-3.csv miss a double quote at line 9

3. install fonts (optional)

• install Source Han Sans
• install Source Han Mono

otherwise set your favorite fonts in import_txt/translation.py and font/gen.py

Translate the texts

There are three json files in directory import_txt, they need be translated.

You could run json2excel.py to generate excel files from these json files, then edit them in M$ Excel or LibreOffice calc or whatever spreadsheet editor.

• EXAPUNKS_descriptions.json

  Grabbed from Content/descriptions/*.txt

  All texts in this file need been traslated.

• EXAPUNKS_vignettes.json

  Grabbed from Content/vignettes/*.csv

  All texts in this file need be translated.

• EXAPUNKS_exe.json

  Grabbed from EXAPUNKS.exe

  Not all texts in this file need be translated.

  Only translate the text you actually see in the game.

How to use json2excel.py

generate EXAPUNKS_descriptions.xlsx from EXAPUNKS_descriptions.json

json2excel.py EXAPUNKS_descriptions.json EXAPUNKS_descriptions.xlsx

do the same thing

json2excel.py EXAPUNKS_descriptions.json

traverse current directory, generate .xlsx files from all .json files.

json2excel.py

automatically decide whether to overwrite the current .xlsx files based on update date

json2excel.py --auto

Modify the textures

Run images/export_imgs.py

It will traverse directory images/PackedContent, convert all .tex files to .png into the directory out.

Pick up the images what you want to modify. (No need for half's, will be generated automatically.)

Put all of them to the new dirctory, keep the same directory struct.

Generate the localization patch

Run run.bat, the localization patch will be generated in patch directory.

If you want to know more details about this procedure, see details.md

Change game settings

Edit %USERPROFILE%\Documents\My Games\EXAPUNKS\xxxxxx\config.cfg

Language = English

Change 'English' to 'Chinese | Japanese | French'

Some screenshots

PDF Manual (still in progress)