Skip to content
N0zoM1z0Public

About

Source reconstruction of 東方地霊殿 ~ Subterranean Animism 1.00a

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

633 Commits

Folders and files

Repository files navigation

東方地霊殿 ~ Subterranean Animism

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.

TH11 reconstruction progress

This project reconstructs the original Japanese TH11 version 1.00a executable. It follows the TH10 reconstruction workflow: target identity, reviewed boundaries and origins, maintained source, exact historical code generation, native product closure, and runtime validation are tracked separately.

Exact target

Supply your own copy at the ignored path resources/th11.exe.

Property Required value
Version original Japanese 1.00a
Size 688,128 bytes
SHA-256 2978b17f6184d100d249d4311348dd30c5c32ec75c014b667a525b797d3d8813
MD5 6af1e3b37f28293f4fc127ee01d2632c
Image base 0x00400000
Entry point 0x00461B1D

The pinned thcrap version database identifies this exact SHA-256 as th11, v1.00a, (original). The localized th11c.exe is a different target.

scripts/repo-python scripts/verify-target.py
scripts/repo-python scripts/validate-tracking.py --require-target
scripts/repo-python scripts/progress.py

Original executables, game data, Ghidra databases, decompiler output, compiler payloads, and generated build artifacts are private and never committed.

Current status

Current reviewed boundaries, source mappings and exact-byte counts are generated in docs/PROGRESS.md. Start continuation at docs/RE_HANDOFF.md; the working knowledge links the detailed topic records.

Maintained source covers large actor, damage, projectile, controller and emitter routines alongside complete byte-exact helpers. Source coverage and exact codegen remain separate; the current counts come from the generated ledgers above. The Windows i386 production build, full runtime and portability are open.

Current area Details
Pause, continue/game-over and replay/record-name editing pause3212, continuation3192
Renderer quad construction/submission quads, submission, projection/fog, immediate modes
Secondary script interpreter, stack and threads script evidence
Secondary program installation and context selection program evidence
Secondary extension parser and trace context extension evidence
Secondary lifetime, counters and large actor owners lifetime evidence
Secondary actor state, damage and projectiles state, damage, projectiles
Player controller and emitter reset controller, reset, pattern callbacks
Streaming factories and lifetime ownership factory evidence
Device setup and buffer recreation device evidence
Streaming buffers, decoder state and fades streaming evidence
Audio command queue and streaming worker audio queue evidence
Animation interpolation, layer dispatch and allocation interpolation/dispatch evidence
Renderer lifecycle, VM reclamation and pixel helpers lifecycle evidence
Buffered drawing and randomized fan fan evidence
ASCII lifecycle, glyph drawing and formatting lifecycle, drawing
Mesh effects and VM factory mesh, effects, factory
Stage interpreter and interpolation script, tweens, easing
Stage lifecycle/update/drawing/culling lifecycle, update, drawing, 12-point culling and layer dispatch, auxiliary stage owner
HUD owning lifetime, initialization and exact VM cleanup secondary debug HUD, spell stage
Animation resources chunks, textures, pixels
Other subsystems topic index

TH11's PE linker version is 9.0 and its dominant Rich compiler build is 21022. The compiler candidate is VC9 / Visual C++ 2008 RTM, selected from TH11-local evidence. TH10's VC7.1 compiler is not used. Tool hashes and independent normal C/C++, /GL, resource, linker, and PDB smoke checks are tracked in config/tools.lock.toml.

scripts/repo-python scripts/verify-toolchain.py --check
scripts/repo-python scripts/replay-exact-units.py --unit publish-stage-mesh
scripts/repo-python scripts/progress.py

Canonical normal-COFF units cold-compile maintained C/C++ with the locked VC9 compiler. The Oracle requires a complete compiler-owned function extent and exhaustive declared relocations, replays their target bindings, and compares every byte. Artifact receipts bind source inputs, profile, target, tools, and object hashes. Masked probes do not grant exact credit. Public primary-TU linked contributions use a separate VC9 linked Oracle, with complete PE/MAP/PDB identity, ownership, artifact receipts and exhaustive field replay. Owner-qualified compiler EH-static address fields are supported; standalone static owners, split ownership and the separate EH handler code remain open.

Tools and resource limits

Use scripts/repo-python for the pinned Capstone interpreter. Direct Ghidra headless scripts verify the selected tool hashes, executable identity, mapped samples, and the complete mapped .text hash before queries. REA is not used. The private database is ghidra-project/TH11.

Ghidra runs at nice 10 with one CPU affinity, one analysis worker, and a 768 MiB Java heap limit. JVM and native overhead are additional. Ghidra jobs and Wine/compiler jobs are serialized. Tool installation and reproduction details are in docs/TOOLS.md.

Current workflow

Focus on complete functions and byte-exact historical code generation: review the target, write natural C++, compile, compare full owners/fields, cold-replay only affected exact units, and commit meaningful progress. Broad behavioral, fault-injection, randomized/multiframe and caller regression suites are not routine prerequisites. Native product/runtime and portability work are deferred.

Public CI is python3 scripts/ci.py: it checks the complete checkout's syntax, ledgers, build declarations and private-artifact exclusions with no game or private toolchain. Run comparator tests when their implementation changes; --full explicitly selects both public Oracle suites.

Project map

License

Repository-authored code and documentation are provided under the MIT License. This does not grant rights to the original game or its assets. Infrastructure adapted from TH10 retains its MIT license and attribution.

About

Source reconstruction of 東方地霊殿 ~ Subterranean Animism 1.00a

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages