README
東方永夜抄 ～ Imperishable Night
This project aims to reconstruct the source code of the original Japanese
東方永夜抄 ～ Imperishable Night version 1.00d executable, with reproducible
binary comparison as the acceptance criterion.
The repository continues the work of GensokyoClub/th08. Its complete Git history was imported rather than squashed, preserving the authorship and contribution record of the original project. New infrastructure and reconstruction work build on that baseline.
The project remains active reverse-engineering work. Existing source, symbol mappings, or generated progress artwork must not be interpreted as a new exact matching percentage without a reproducible report against the target binary. Current source-presence inventory is generated in docs/PROGRESS.md and is deliberately labeled separately from strict exact-match coverage.
Target executable
Supply your own original executable as resources/th08.exe:
| Property | Required value |
|---|---|
| Version | Original Japanese 1.00d |
| Size | 840,704 bytes |
| SHA-256 | 330fbdbf58a710829d65277b4f312cfbb38d5448b3df523e79350b879213d924 |
| PE image base | 0x00400000 |
| Entry point | 0x004A619E |
Localized or patched executables are different binaries and are intentionally out of scope. The executable and game data are copyrighted assets and are not included.
python3 scripts/verify-target.py
Build
Initialize the third-party submodules, then create the upstream Visual Studio .NET 2002/DirectX 8 environment. On Linux or macOS:
git submodule update --init --recursive
./scripts/create_th08_prefix
python3 ./scripts/build.py
The prefix helper uses Wine by default; set WINE before invoking it when a
different compatible runner is required. On Windows, use the upstream setup
script directly:
python scripts/create_devenv.py scripts/dls scripts/prefix
python scripts/build.py
See Build and exact matching for dependency, build-mode, reccmp, and objdiff details.
Analysis status
IDA MCP follows whichever database is active in the GUI; it has no reliable
program selector. Use it for TH08 only after the active database passes the
attestation in IDA and analysis safety. Otherwise use
target-side objdump/llvm-objdump, the verified disposable Ghidra import, and
the target-pinned repository tools.
To see the live authored and library inventory instead of relying on prose:
python3 scripts/analysis/report-reconstruction-status.py --summary
Project map
- Architecture and binary inventory
- Reverse-engineering workflow
- IDA and analysis safety
- Build and exact matching
- Tool selection and command recipes
- Reusable knowledge map and contribution policy
- Current handoff and next milestones
- Generated reconstruction progress
- Agent operating rules
Credits and provenance
This continuation exists because of the reconstruction and tooling work by
the contributors to GensokyoClub/th08.
Their commits retain their original author/committer metadata in this
repository. The upstream project also credits @EstexNT for porting its
var_order pragma to MSVC7.
The N0zoM1z0/th07 reconstruction supplies this repository's workflow, structure, target gates, matching, and documentation model. GensokyoClub/th06 is adjacent-engine corroboration only; neither reference overrides TH08 target evidence.
License
Repository code and documentation are provided under the included MIT License. This does not grant rights to the original game, executable, or game data.