11 KiB
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.
-
Body root publication and body modes:19 actual dispatcher/kernel contact-root observations plus87 body/support/friction flag/payload observations. Parent integration compares100 complete outputs and six state-only mutation cases; independent flags, XYZW and landing ownership are implemented without enabling special Jimmy terrain or dynamic pairs.
-
Jimmy air target state and render transform: apply-owned pitch seeds, full STRT/current Euler, destination/dirty Init, degree-to-short caching and original hierarchical basis.26 additional native comparisons plus14 final render matrices (documented precision mismatch). Integration keeps the local sole correction modern and broader body admission separate.
-
Jimmy movement stabilization: current priority, preserving our playable controller over JN's tuned replacement. Ground/air/facing/jump reports record108 native component observations matched by managed implementations,27 special-contact eligibility observations and12 recovered air destination writes. The last two are investigation evidence; special-body and ordinary air-pitch/render integration remain open. REA's complete original instruction Evidence and offsets are linked in those reports.
-
gameplay/grappler-live.md: boundedVR08 integration/coverage and runtime evidence.grappler-body.mdrecords shared sphere context and41 native cases;grappler-camera.md,grappler-resources.md,grappler-lifecycle.mdrecord consumer state, exact art/shape-scale source and cleanup/persistence. Original component execution and modern/native Windows evidence remain distinct. -
gameplay/grappler-query.md: enclosing426030 early-return correction, VR08 static filter/selected-material metadata,42 copied-original aim/constraint/ post-base contact cases and corresponding managed components. The attachment leaf's broad acceptance does not bypass earlier aim rejection. Full attached body/base-contact, camera and helper presentation/lifetime remain separate. -
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.mdandrocketship-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.mdrecords original meter/tutorial resources, UV stretch and alignment uncertainty;player-energy.mdreuses42A920 REA for warning-latch/callback order.bubble.mdrecords 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.mdretain original group0 state, menu rectangles and54 canvases.shrink-ray.mdtraces input/ownership/energy/target scan and callback;shrink-heading.mdrecords15 copied-DLL references plus 65,540 comparison cases.shrink-targets.mdtraces actual3SOL bodies, authored morphs and authored/reset versus prior dynamic AI modes.gadget-blending.mddistinguishes recovered opacity/blend branches from Vulkan depth policy;gadgets-review.mdrecords 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.mdrecords 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.