東方永夜抄 ～ 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:

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

The currently available IDA MCP session is attached to TH07. It must not be used as TH08 evidence. Until an exact TH08 1.00d IDB is open and the metadata preflight passes, use target-side objdump/llvm-objdump, a correctly imported Ghidra project, and the inherited upstream mappings. See IDA and analysis safety.

Project map

• Architecture and binary inventory
• Reverse-engineering workflow
• IDA and analysis safety
• Build and exact matching
• 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, claims, 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.