東方永夜抄 ～ Imperishable Night

🌙「永夜已明」Authored reconstruction complete — Linux playable ✓ · Windows/macOS in progress · Web edition is the next spell card 💫

Platform guides

The Web edition is planned as a future playable target after the native desktop ports. It is not available yet.

This project reconstructs the source code of the original Japanese 東方永夜抄 ～ Imperishable Night version 1.00d executable. All 1,107 authored functions are now present in source, and 1,105 are accepted as byte-exact by reproducible comparison. The authored-source recovery milestone is complete; current work focuses on whole-image reconstruction, compiler/runtime libraries, and playable Windows, Linux, and macOS products.

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 reconstruction and platform-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.

Playable modern ports

An independent CMake target compiles the production-authored sources for modern hosts. It does not replace or make an exactness claim about the VC7 build.

For build dependencies, runtime asset expectations, --data-dir, and the remaining platform sequence, see Playable reconstruction ports.

For a source checkout on Debian or Ubuntu, the Linux quick start installs missing i386 dependencies, builds, and runs using only the original data directory:

scripts/setup-modern-linux.sh "/path/to/the/original/TH08 directory"

The Portable Linux build workflow also publishes th08-modern-linux-i386.tar.gz as a downloadable Actions artifact. Extract it and pass only the original game-data directory:

./run-th08.sh "/path/to/the/original/TH08 directory"

Neither path embeds the original executable or DAT archives.

The native i386 build has been exercised under both WSLg and a Kali Linux x86-64 virtual machine. The Kali recording below was made in a low-memory VM without 3D acceleration; its slow first 45 seconds are shown at 8x speed, while the remainder plays at the recorded speed.

Only th08.dat and thbgm.dat are runtime data requirements. The Linux port does not open or execute the original th08.exe. A clean two-DAT directory previously exposed a Linux compatibility bug during the first score-backup rotation: Win32 rejects an invalid search handle harmlessly, while the Linux backend tried to delete it and crashed. The corrected backend now creates the backup and continues into the title assets with an initially empty backup/ directory. On a software-rendered VM, a fresh configuration's fullscreen FPS/vsync calibration can still be slow; reusing an existing th08.cfg is an optional startup convenience, not a data requirement.

The portable Linux window uses the project-owned resources/modern-icon.png, derived from the Touhou Lab artwork supplied for this reconstruction. It is not an icon extracted from the original executable.

Known Linux issue

• During the Stage 4-to-5 transition, a dynamic text texture can still tile across the outer frame and HUD (most visibly as repeated Yakumo Yukari text). This is a known renderer/texture-state bug in the Linux port, not a damaged DAT archive; gameplay testing can continue past it.

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

• Linux download, installation, and play guide
• Native Windows user guide and status
• Native macOS user guide and status
• Architecture and binary inventory
• Reverse-engineering workflow
• IDA and analysis safety
• Build and exact matching
• Playable reconstruction ports
• Native Linux playable reconstruction
• 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.