Agent workflow: follow the highest-priority requirements in AGENTS.md. Use affected exact checks and searchable Markdown knowledge; ordinary notes do not require full CI or replay.
This repository reconstructs the original Japanese PC-98 Touhou 2: the
Story of Eastern Wonderland (OP.EXE, MAIN.EXE, MAINE.EXE, ZUN.COM).
Progress · Handoff · Findings · ReC98 import · Workflow · Architecture · DOS build
All four files (OP.EXE, MAIN.EXE, MAINE.EXE, ZUN.COM) rebuild
byte-identical to the originals from a cold build of the pinned
ReC98 revision plus this repository's
source in src/ (see Architecture). ReC98 had
already decompiled most of TH02 outside MAIN's gameplay; this project
decompiled the rest of MAIN, including the stage and boss code, and moved
ZUN's remaining data into C++.
All of ZUN's compiled code and data is C/C++. Three routines stay as ZUN's
own assembly because TCC cannot produce them: pointnum_put(),
shots_hittest() and TH02's modified master.lib pfopen(), each a
word-aligned TASM module (see Findings).
ZUN.COM's ZUNINIT is ZUN's assembly too. master.lib and the Borland runtime
are linked as libraries.
Private inputs (original programs, Borland tools, Ghidra projects) are not in Git. With them in place:
python3 scripts/import_targets.py --retain-runtime-image /path/to/jp.hdi # extracts and verifies HUMAROKU/
python3 scripts/attest_toolchain.py
python3 scripts/build_th02.py --run-id NAME --write-ledger
python3 scripts/progress.pyTo play the rebuilt game on the original platform (PC-98 under DOSBox-X), see DOS_BUILD.md. See also TOOLCHAIN.md and GHIDRA.md.
ZUN (上海アリス幻樂団 / Team Shanghai Alice) created Touhou Project and the original TH02 game, characters, artwork and music.
- ReC98, by nmlgc and contributors: the TH02 decompilation this project starts from, plus PC-98 research, hardware definitions and the DOS build pipeline. ReC98 is used from a pinned checkout and is not redistributed here.
- master.lib: the PC-98 system library linked into TH02.
- KAJA / PMD: the PC-98 music driver shipped with the game.
- Workflow and tooling follow our TH03 and TH04 reconstructions.
- Ghidra, Wine, mtools and ReC98's MS-DOS Player build: analysis, DOS toolchain execution and disk-image extraction.
Project-authored code and documentation use the MIT License.
Files under src/ and compat/rec98/ that started as ReC98 files keep
ReC98's credit and are offered for upstream use; ReC98 itself is not
redistributed here.