Files
Neutron/docs/reverse-engineering.md
T

132 lines
9.1 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.
- `gameplay/grappler-component.md`:30 copied-original attachment/reel/damping
observations, isolated managed component and retained ray/body/resource REA
evidence. Cursor rejection differs from attach acceptance, and input swing
short-circuit does not suppress ordinary Jimmy frame publication. Live gates
remain explicit.
- `gameplay/rocketship-live.md`, `rocketship-body.md`, `rocketship-motion-camera.md`
and `rocketship-lifecycle.md`: owned/reused3ROC, body flags/callbacks, registry
input order, source Euler/maneuvers/shared-eye camera, rider/Goddard/fire/audio
lifecycle,96 copied-original component observations and boundedVR02 integration.
REA IDs/source offsets and unresolved special materials/pairs/retained lifetime
remain explicit; port replay is distinct from original gameplay verification.
- `gameplay/bubble-motion.md`, `bubble-body.md`, `bubble-rendering.md`,
`bubble-implementation.md`, `bubble-implementation-review.md`: mode2 controller,
copied-original radius/factor/support references, actualVR01 floor111/texture
linkage, original owned sprite and bounded implementation/review. Source and
runtime evidence remain distinct; retained helper/camera/Euler gates persist.
- `gameplay/invisible.md`, `invisible-implementation.md`, `invisible-review.md`:
timed mode2/targetability/material state, named-Jimmy versus raw-owner cleanup,
bounded implementation and independent review. `gadget-followup-assets.md`
records original meter/tutorial resources, UV stretch and alignment uncertainty;
`player-energy.md` reuses42A920 REA for warning-latch/callback order.
`bubble.md` records the next gadget's physics/visual/drain contracts and gates.
- `gameplay/gadgets-implementation.md`: first playable gadget scope and evidence
map. `gadget-controls.md`/`gadget-assets.md` retain original group0 state, menu
rectangles and54 canvases. `shrink-ray.md` traces input/ownership/energy/target
scan and callback; `shrink-heading.md` records15 copied-DLL references plus
65,540 comparison cases. `shrink-targets.md` traces actual3SOL bodies, authored
morphs and authored/reset versus prior dynamic AI modes. `gadget-blending.md`
distinguishes recovered opacity/blend branches from Vulkan depth policy;
`gadgets-review.md` records independent review and resolved scoring omission.
- `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.
- `checkpoint/collision-grid-traversal.md`, `collision-contact-callbacks.md`,
`collision-body-probe.md`, `collision-integration-review.md`: REA/static grid,
contact material linkage/landing/friction and seven dispatcher/ten ordinary-body
component observations. Managed dispatcher is isolated; live capsule remains.
- `checkpoint/collision-body-composition-source.md`, `collision-body-implementation.md`,
`collision-body-implementation-review.md`: exact source phase/radius guards,
ordinary body composition matching ten original references, VR04 static subset
and retained dynamic/special/transform boundaries. Radius100 changes support too.
- `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.
## Gadget component continuation — 2026-11-03
Supplied jn-engine class names/saved decompiler bodies guided independent local
REA and guarded-byte recovery. Rocketship owner/control, radius50/factor.6,
flight input/apply and VR02 game filter are documented in gameplay/rocketship.md.
Two synthetic Wine32 harnesses executed copied input/vertical instruction ranges,
yielding28 numeric references for13 managed RocketFlight groups. This does not
observe whole-game flight or recover the remaining body/camera/attachment phase.
Provenance and next gates: gameplay/rocketship-component.md. Grappler's source
ray/material, attach/reel/swing/detach and retained helper state are recorded in
gameplay/grappler.md with12 source/projection checks; live integration is gated.
Original/friend files remain untouched; no tuned friend C gameplay was imported.
## 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.