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 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.
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.pyOriginal executables, game data, Ghidra databases, decompiler output, compiler payloads, and generated build artifacts are private and never committed.
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.pyCanonical 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.
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.
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.
AGENTS.md— session recovery and evidence rules.config/target.toml— TH11 identity, PE, and Rich facts.config/build.toml— explicitly open production graph.config/match-units.toml— canonical exact contexts.docs/RE_WORKFLOW.md— reconstruction loop and gates.docs/ORACLES.md— bounded acceptance rules.docs/RE_HANDOFF.md— resume state and next work.docs/ARTIFACTS.md— retained private artifacts and cleanup policy.docs/KNOWLEDGE_BASE.md— durable TH11-local facts.docs/RENDER_CAMERA.md— camera and batch submission evidence.
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.