Files
Neutron/docs/reverse-engineering.md
T

39 lines
2.3 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. Runtime behavior has not yet been observed.
- `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
Original execution under isolated Wine/Windows; complete gameplay algorithms;
archive animations and render states; save schema; exact historical timing and
Windows runtime compatibility. Follow `tasks.md` for concrete next actions.