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)

noword / EXAPUNKS-Localize