179 lines
13 KiB
Markdown
179 lines
13 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.
|
|
|
|
- [Dynamic box/shared context](checkpoint/dynamic-context.md): full47A5E0 plus
|
|
static reclip/kernel execution,17 complete C# composition comparisons and12
|
|
captured kernel triangle/normal arguments. Nearest reset, retained hit/last
|
|
polygon, callback effects and publication are bounded source/component facts.
|
|
Jeep default deletion eligibility has13 guarded sites/5 bindings; complete
|
|
cleanup and live actor/shared-world integration remain open.
|
|
- [Physical registration](checkpoint/physical-registration.md) and
|
|
[generated helpers](checkpoint/vr04-generated-bodies.md): all72 VR04 serialized
|
|
records/13 RTTI interfaces;12 original registration/loader cases;21 helper
|
|
creation/registration calls. Per-object Init/PostLoad and live appends are
|
|
executed component evidence. Full retained helper membership/cleanup is open.
|
|
- [Ordered physical pairs](checkpoint/pair-lifecycle.md):6 REA pseudocode results,
|
|
8 guarded source ranges,20 VR04 class bindings and28 complete copied-code/C#
|
|
comparisons. One-sided exclusions, gate-retained contacts, callback-mutated
|
|
roots/membership and notification order are recovered. The reusable component
|
|
remains outside live scenes; physical registration and real callbacks are open.
|
|
- [Body root publication](checkpoint/body-root-publication.md) and
|
|
[body modes](checkpoint/body-modes.md):19 actual dispatcher/kernel contact-root
|
|
observations plus87 body/support/friction flag/payload observations. Parent
|
|
[integration](checkpoint/body-contact-implementation.md) 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](gameplay/jimmy-air-target-state.md) and
|
|
[render transform](gameplay/jimmy-render-transform.md): 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](gameplay/jimmy-air-bridge.md)
|
|
keeps the local sole correction modern and broader body admission separate.
|
|
- [Jimmy movement stabilization](gameplay/jimmy-movement-stabilization.md):
|
|
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.md` records shared sphere context and41 native cases;
|
|
`grappler-camera.md`, `grappler-resources.md`, `grappler-lifecycle.md` record
|
|
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.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.
|