Initial commit: RE tooling and docs for The I of the Dragon localization/HD

2026-09-20 09:57:07 +08:00
commit caf7376019
26 changed files with 1624 additions and 0 deletions
@@ -0,0 +1,35 @@
+# The I of the Dragon — fan tools (localization + HD)
+
+Reverse-engineering and localization tooling for *The I of the Dragon* (Topware / Primal Software).
+
+This repository tracks **only our own tools and documentation**. It does **not** contain the game,
+its assets, or any cracked distribution — those are regenerated/produced locally from a legit copy.
+
+## Layout
+
+```
+tools/            Python tooling (unpack, repack, preprocess, font patch, decoders)
+docs/             DEVLOG, format specs, patch notes
+```
+
+Working data (not tracked): `original/`, `png/`, `report/`, `patch/`, `crack/`.
+
+## Tooling
+
+| script | purpose |
+|---|---|
+| `tools/res_unpack.py`      | extract a `.res` archive (index + raw blobs, 16-byte aligned) |
+| `tools/res_repack.py`      | rebuild a `.res` byte-identically from a directory |
+| `tools/preprocess.py`      | convert textures to PNG + build classification report |
+| `tools/make_plan.py`       | build an HD upscale plan from the report |
+| `tools/decode_dat.py`      | decode/encode the XOR-obfuscated `Fonts.dat` / `*Description.dat` |
+| `tools/fontparse.py`       | parse `Fonts.dat` into font blocks and glyph rects |
+| `tools/add_section.py`     | add an executable section to the game PE |
+| `tools/apply_cjk.py`       | apply the double-byte font-rendering patch |
+| `tools/xrefs.py`           | find call/jmp xrefs in the game executable |
+
+See `docs/` for the reverse-engineered formats and addresses.
+
+## Legal
+
+No game data is distributed here. Patches are produced by the user against their own copy.