Files
Neutron/docs/reverse-engineering.md
T

76 lines
5.4 KiB
Markdown

# Reverse-engineering index
Authoritative reference is supplied originals. Findings must be supported by file
offsets, virtual addresses, API symbols or observed behavior. Decompiled output is
evidence, not original source. Original gameplay has not yet been observed successfully; isolated original DLL
probes and modern runtime checks are recorded separately.
- `checkpoint/control-phase-implementation.md`, `uncontrolled-player.md`,
`uncontrolled-physics.md`, `cutscene-preparation.md`: frame/body versus identity
gates, ordered CAM/MCA/AI preparation and bounded implementation. `rea.md` records
local tooling, Evidence and procedure-recognition limits.
- `checkpoint/retained-player-body.md`, `retained-streamer.md`,
`retained-return-cleanup.md`, `retained-companion.md`: complete named property
read chain, bounded ordinary-load scalar/body resets, full tutorial availability
tails and companion/shadow lifecycle. Source-byte checks and an isolated original
body-routine probe are separate from whole-game/runtime comparison.
- `checkpoint/collision-response.md`, `ceiling-wrapper.md`,
`body-root-registration.md`, `camera-handoff.md`: REA continuation into bounded
sphere kernel/original component probe, root-ray cancellation, retained physical
re-registration/repeated Init and shared scripted/follow eye. Source-byte guards,
port implementation and unresolved integration gates remain separate.
- `save-format.md`: full supplied TSK layout, task query/assignment and activation gates.
- `analysis/lab-progression.md`: CAM/MCA/AI dispatch, original lab chain and skip/camera formulas.
- `analysis/scene-entities.md`: exact entity-resource preparation and contact/sprite evidence.
- `analysis/level-resource-mapping.md`: supplied Level3B/E GAMs, separate registered
OMT loader paths, null-database handling and unverified gameplay reachability.
- `analysis/original-collision.md`: radius/mask follow-up; unresolved original pivot/solver.
- `analysis/scene-models.md`: explicit OMT/ASE model bindings, source bounds and props.
- `analysis/patrol.md`: shared state/waypoint phases, Goddard/Carl profiles and limits.
- `analysis/dynamic-collision.md`: source3DUD broadphase/triangle order and modern response boundary.
- `analysis/buttons-doors.md`: button contact/cooldown and moving-bar state machine.
- `analysis/ui.md`: original objective/practice canvases, coordinates, input and return strings.
- `analysis/carl-cutscene-control.md`: MCA activation locks control; serialized target restores it at completion.
- `analysis/objective-timing.md`: source popup timer/slide/O latch and modal clock behavior.
- `analysis/camera-clipping.md`: per-level original near/far geometry clipping and merged-layer limits.
- `analysis/air-steering.md`: corrected mode1 fall-through, airborne keyboard handler and source regression evidence.
- `analysis/jetpack.md`: corrected lab pickup identity, powered-jump/effect/energy phases.
- `analysis/sound-effects.md`: default bank identity, preserved wave payloads and loop lifecycle.
- `original-manifest.json`: complete original SHA-256 baseline.
- `reconnaissance.md`: input/tool inventory, game identity and initial environment.
- `analysis/binary.md`: PE/compiler, entry points, imports and function mappings.
- `analysis/graphics.md`: renderer/API, geometry, camera and Vulkan equivalents.
- `analysis/assets.md`, `file-formats.md`: recovered OMT/ASE/texture/audio evidence.
- `gam-format.md`: fully accounted GAM wire format and exact round-trip validation.
- `analysis/gameplay.md`: original controls, startpoint/camera, entities and limits.
- `analysis/movement-checkpoint.md`: corrected walking/yaw/airborne/jump-held and
chase-camera evidence; original frame order, pivot and collider remain unresolved.
- `analysis/collision-checkpoint.md`: explicit provisional source-triangle solver,
geometry/mask choices, tests and limitations; not an original algorithm recovery.
## Function map under investigation
Provisional mappings from binary agent (disassembly must accompany final report):
C3DJimmy update 0x424600, input 0x426030; player input 0x438A60, walking branch
0x438BC0. Player defaults ctor region 0x4372A0 sets acceleration 30, deceleration
35, maximum speed 600; increments occur per simulation invocation, while movement
uses elapsed time. A future simulation must recover update cadence before calling
these coefficients timestep-independent. Gravity and jump have since been
resolved: game setup 0x44D414 sets gravity Y=-800; jump branch 0x4383B3 queues
Y=550 impulse, consumed/cleared at 0x479EBB..0x479EF2. Semi-implicit free-motion
fragment implemented in Game/RecoveredMotion.cs and regression tested; collision
and activation gating remain unresolved. The no-gadget controller checkpoint now
integrates the corrected formulas; see analysis/movement-checkpoint.md rather than
the older preliminary movement interpretations.
## Unresolved
Follow-up evidence: `analysis/runtime-checkpoint.md` identifies TSK StoredVector,
RETURN placement and one-time STRT suppression; `analysis/water-collision.md`
recovers the NC shape registration gate; `analysis/underground-route.md` records
input-only passage coverage with an explicit riverlab/SCENE65 fixture.
Original execution under isolated Wine/Windows; complete gameplay algorithms;
remaining actor animations and render states; full runtime save state; exact historical timing and
Windows runtime compatibility. Follow `tasks.md` for concrete next actions.