Translation Project for CHUNITHM

The goal of this translation project is to translate the game of CHUNITHM in its entirety, including all of its versions, old and new.
There are no game files included in this repo (except texture files because I consider the content transformative enough lol), all of the files in this repo can be used with the associated scripts to apply to your own game files.

Scripts and Tools:

Parse.py (by Yonokid) - extracts strings, explainText, skillSeeds, and other content from xml files into .csv files
Apply.py (by Yonokid) - imports content from .txt and .csv files into xml files
DBEditor.py (by Yonokid) - unpacks and repacks .bin files into .txt files
build.py (by Yonokid) - takes the game files and translation source files and packages them into a usable translation
EXEpatch.py (by Yonokid) - takes an exe, appends a new data section for english strings, and reroutes pointers to that section
AvatarSplice.py (by Raymonf (proompt engineer)) - automatically translates avatarAccessory dds files

How to Build:

1. Install uv.
2. Install imagemagick per the instructions here: https://docs.wand-py.org/en/latest/guide/install.html#install-imagemagick-on-windows
3. Download this repo and obtain a copy of the game you wish to build for.
   
4. Provide an exe into the path <game version>\src\exe
   
5. Run build.py <root of the directory> <root of the proper translation> <output location> <version>
   For example, if I wanted to build for 2.00.01, I would run build.py "E:\CHUNITHM NEW!! (SDHD 2.00.01)" "chutranslation\SDHD_20001" "E:\Chunithm NEW Translation" "SDHD_20001"
   

What Needs To Be Done:

1. Cleaning Code; There's always room for improvement.
   
2. TEST CASES!! I'm not how to go about this for this project, but this would be really important. Programming mistakes tend to slip by very easily in this project since there aren't that many ways to verify correct data processing besides going into the game and checking.
   
3. Documentation; Each version has its own README.md file, most of which have not been updated since the first commit.
   

Credits:

Yonokid - Leading the project or something, some programming, hex edit porting to BemaniPatcher
Raymonf - Programming for surfboard extraction and import, string exe editing, ErrorCodeTable ksy analysis
GRIM - Creating the original translation tools and spreadsheets, expertise
aetherpi - Playing the game so much that every detailed bug could be found
yellowberryhn - db file struct analysis
Bottersnike - releasing the amlibpy library insane surfboard documentation

exe (Hex Edit/string patching) Contributions:

Raymonf - Discovering encoding types Felix - Walking me through modifying the PE file Yonokid - string patching/translation

csv (A000, Option Data, xml) Contributions:

Content from NEW (SDHD 2.00.01) and up

Yonokid - All
memoriast - Granblue Fantasy content
Colin - Some trophies

Content from PARADISE LOST (SDBT 1.50.00) and below

4199 - chara, chargeItem, course, courseRule, duel, duelMission, map, mapIcon, namePlate, present, quest, ranking, reward, skill, shop, systemVoice, ticket

PolarManne - chara
AMAZON Translation Team - skill
JWOWW - skill
hybir - skill

srd (surfboard) Contributions:

Yonokid - All

db (.bin) Contributions:

Yonokid - All

texture Contributions:

Nabix - All SDHD Versions

Content from PARADISE LOST (SDBT 1.50.00) and below

GRIM - SDBT 1.50.00, SDBT 1.45.00, SDBT 1.40.00 (not available in this repo)
4199 - SDBT 1.50.00 (not available in this repo)