From c6eb1861cda9abc970699ce3079bd360071bb892 Mon Sep 17 00:00:00 2001 From: Cristian Cerroni Date: Tue, 3 Nov 2026 10:42:14 -0500 Subject: [PATCH] Assess supplied jn-engine research and capture evidence --- docs/compatibility.md | 8 ++ docs/decisions.md | 8 ++ docs/progress.md | 26 ++++- docs/reviews/jn-engine-capture-request.md | 73 +++++++++++++ docs/reviews/jn-engine-capture.md | 19 ++++ docs/reviews/jn-engine-gameplay.md | 86 ++++++++++++++++ docs/reviews/jn-engine-survey.md | 118 ++++++++++++++++++++++ docs/tasks.md | 10 ++ 8 files changed, 347 insertions(+), 1 deletion(-) create mode 100644 docs/reviews/jn-engine-capture-request.md create mode 100644 docs/reviews/jn-engine-capture.md create mode 100644 docs/reviews/jn-engine-gameplay.md create mode 100644 docs/reviews/jn-engine-survey.md diff --git a/docs/compatibility.md b/docs/compatibility.md index 0f9d733..7bfa5a2 100644 --- a/docs/compatibility.md +++ b/docs/compatibility.md @@ -3,6 +3,14 @@ Compilation, native runtime, original behavior and full feature completion are separate evidence categories. **The game is not fully reconstructed/playable yet.** +Supplied jn-engine assessment (2026-11-03): documentation/source/artifact review +only; no new build or runtime validation. Same declared EXE, different declared +OMT2.dll;254 ASE/126 PNG/35 GAM files match byte for byte. All539 original hashes +verify. Class specs, decompiler bodies and derived D3D7 fixtures are useful +evidence candidates; proposed original gameplay traces/raw OMTC/Ghidra project +are not included. No prototype C mechanics were imported or port fidelity +promoted. See reviews/jn-engine-survey.md; existing package claims below stand. + Baseball (2026-11-02): source hold/release/20-slot pool, exact ball/aim/TIME art, bounded ball body, VR07 moving-target callbacks and F1 grant are implemented. 12 managed/6 visual/16 Baseball Python groups and independent review pass. diff --git a/docs/decisions.md b/docs/decisions.md index c578c49..8c19a6e 100644 --- a/docs/decisions.md +++ b/docs/decisions.md @@ -231,3 +231,11 @@ mount/control handoff and wheel-dependent drive/support cannot be represented by a Jimmy mode or an invented constant wheel count. Preserve the source report/exporter and close wheel bodies before live Scooter integration. +41. **Use supplied jn-engine as research, not a replacement runtime.** Same EXE + declaration and415 byte-identical shared assets support cross-indexing its + class specs/decompiler bodies and adapting bounded tests. Different declared + OMT2.dll, mixed pointer bases, forced prototypes and explicit native gameplay + tunings require independent checks. Retain C#/.NET10/SDL3/Vulkan and REA byte + evidence. Capture tooling/derived scenes are present; raw OMTC, analysed + Ghidra database and proposed gameplay state traces are not. Record offered + permission before source import. Assessment: reviews/jn-engine-survey.md. diff --git a/docs/progress.md b/docs/progress.md index 317329c..d7f0ec4 100644 --- a/docs/progress.md +++ b/docs/progress.md @@ -1,4 +1,28 @@ -# Progress — 2026-11-02 +# Progress — 2026-11-03 + +## Supplied jn-engine research assessment + +User requested review of the friend's SURVEY-for-Rockman.md and jn-engine-master. +Survey read in full; independent source/gameplay and capture/tooling reviews are +integrated in [reviews/jn-engine-survey.md](reviews/jn-engine-survey.md). Useful +class/address index, saved Jimmy helper bodies (including429D00), animation and +campaign leads, capture tooling and derived Level1 fixtures. All208 ledger rows +are specs, not implemented/fidelity-verified classes. C gameplay uses explicit +approximations and conflicting gadget modes; retain our existing C# port. + +EXE SHA matches the friend's declaration; OMT2.dll differs. All254 ASE/126 PNG/ +35 GAM shared files are byte-identical by case-insensitive name and SHA-256. +Complete539-file original manifest verifies unchanged. Mixed Jimmy pointer bases, +stale timer naming and capture-specific renderer claims require validation. +No raw OMTC, analysed Ghidra database or proposed gameplay state tap is included. +Prepared a local evidence-request document; no external message was sent. + +Documentation-only assessment: no gameplay changes, friend-tree edits/execution, +network, build or new runtime claim. Both investigators returned ownership. +Use the saved bodies to guide the next bounded REA gadget recovery; original +state captures would strengthen future cadence/control/transition comparisons. +Direct source import awaits recording the author's offered permission/licence. +Existing d6ca417 playable/packages and collision gates are preserved. ## Baseball continuation diff --git a/docs/reviews/jn-engine-capture-request.md b/docs/reviews/jn-engine-capture-request.md new file mode 100644 index 0000000..0cf6786 --- /dev/null +++ b/docs/reviews/jn-engine-capture-request.md @@ -0,0 +1,73 @@ +# Proposed evidence request for jn-engine author + +2026-11-03. Prepared locally from the supplied survey; **not sent**. This is an +investigation contract, not an implemented recorder/replay feature or schedule. +Our [assessment](jn-engine-survey.md) explains the evidence and version limits. + +## Existing material first + +- Analysed Neutron.exe Ghidra project/export, Ghidra version, analysis options + and applied script list. Saved target6 bodies are already useful; preserve + prototype warnings and explicit function boundaries in the handoff. +- Raw Level1 OMTC for anchor8881 and constituent world-fixture keyframes, with + matching original screenshots and fixture-generation commands/settings. + Derived scenes/draws/textures exist locally; raw capture/reference image do not. +- Hashes of the actual captured EXE, OMT2.dll and proxy, executable variant, + display/renderer settings, starting level/save/task state and capture build. + EXE manifest matches ours; OMT2.dll manifest currently differs. +- The offered written code/script permission or permissive licence, if direct + source import is intended. Keep original game assets/binaries distinct. + +## Minimal original-state recording + +First record a short VR04 standing/walk/release/turn/jump/held-jetpack sequence. +Then lab→VR04→lab→outside, including intro, Carl control handoff and RETURN. +Gadget activation, death/restart and save/load can follow a validated basic trace. + +Please record a versioned little-endian schema and an address/base map. Every +state field should name its width/type, pointer base, sampling phase and source +instruction/helper; mark unresolved fields rather than guessing. Include: + +- Update sequence, render sequence, phase, game dt and wall timestamp separately. + Renderer EndScene timestamps alone cannot establish simulation cadence/order. + Identify skipped/invalid-dt and paused updates; report dropped frames/records. +- Initial save/TSK/checkpoint/level/start identity, RNG and relevant settings; + input down/edge state, focus, mouse/controller axes and polling phase. +- Raw controlled pointer and class identity, independently tracked Jimmy identity, + pose/velocity, movement mode, jump phase, support/shadow distance, pending + impulse, control/cutscene owner, gadget display/raw mode and energy/timers. +- Camera mode/owner/transform/clips, task/SCENE changes, objective/UI transitions, + audio start/stop identifiers and level-load/RETURN/reset boundaries as feasible. + +Start with samples immediately around the game-update body, then add subphases +where a discrepancy demands it. Our current static map has dt write47E502 to +696030, physics47E554, registry47E582→473740, transform sync47E587→473770, +base draw47E6DF and render counter increment47E6EF. These are **EXE virtual +addresses**, with their current evidence in `../checkpoint/loop-motion.md`; +validate safe hook boundaries/ABI before instrumenting a copied installation. +Registry order and changes within the update can matter, so a lone end-of-frame +snapshot cannot establish which owner wrote a field first. + +## Pointer-base correction needed before capture + +Jimmy's game interface is complete object+C0. These established pairs are: + +| Value | Complete Jimmy | Jimmy game interface | +|---|---|---| +| Movement mode | +7C4 | +704 | +| Jump state | +7E8 | +728 | +| Shadow ground distance | +86C | +7AC | + +The survey's proposed list mixes the two columns. The raw controlled global +5099E4 can be null or owned by another class during cutscenes/vehicles; do not +apply Jimmy offsets without class validation. Root/velocity access slots are +virtual getters, not established raw memory field offsets. Resolve actual +storage or use a reviewed getter strategy without changing simulation state. +Similarly verify widths/layouts for proposed SCENE/objective/gadget/RNG taps; +the survey alone does not define a serialization contract. + +Acceptance: one short recording with reproducible startup, explicit schema, +complete input/dt/state phase alignment and no unexplained record drops. Compare +that recording manually before expanding recorder coverage or implementing a +GamePort replay consumer. Keep capture/replay work local with separate generated +outputs and untouched originals. diff --git a/docs/reviews/jn-engine-capture.md b/docs/reviews/jn-engine-capture.md new file mode 100644 index 0000000..1ec5bf9 --- /dev/null +++ b/docs/reviews/jn-engine-capture.md @@ -0,0 +1,19 @@ +# jn-engine capture, tooling and oracle review + +2026-11-03. Read-only source/artifact inspection; no friend code, scripts, legacy binaries, network services or Ghidra jobs executed. Paths below beginning `J/` mean `../../../jn-engine-master/` relative to this document. Confidence is high for source/artifact inventory; reported historical measurements remain provenance claims until independently replayed. + +**Useful now:** capture-derived Level 1 fixtures, bounded algorithm reference tests, and address/naming tools. Preserve GamePort's C#/.NET 10, SDL3 and Vulkan architecture; translate selected evidence rather than importing the C/SDL2/OpenGL runtime. + +**Binary scope.** Local SHA-256 recomputation confirms `Original/Neutron.exe` matches `J/docs/binaries.sha256:12` (`f5281076…1aea8`). However our `Original/OMT2.dll` is `3ec41ead…54943`; friend declares `a94f13e1…b0fea` (`:14`). Executable addresses can be cross-indexed; DLL addresses, helper semantics and captured renderer behavior need version reconciliation. No friend original DLL is included for byte comparison. This difference is not evidence that its captures are wrong. + +**Instrumentation exists, state tracing does not.** `J/instrument/proxy/ddraw_proxy.c:4` implements a replacement `ddraw.dll` forwarding through `ddraw_orig.dll`; COM wrappers hook scene boundaries, draws and state changes (`com_wrappers.c:202–234,389`). `protocol.h:12–83` specifies packed little-endian OMTC v4, accepting v1–4: transforms, viewport, textures, render/texture-stage states, light/material, draws; v3 adds pixels, v4 masks/color keys. Commands include capture controls, frame marks and camera changes (`:62–71`). Capture uses a 32 MiB producer/consumer buffer; overflow drops whole frames (`capture.c:43,596–616`). Frame time is `GetTickCount`, **not the simulation dt** (`:581–584`). No proposed state-tap addresses or gameplay-state record exist in this instrumentation. + +**Included evidence has limits.** `assets/capture/` contains 390 files, 13,512,573 bytes. `level1_hudfix/frame_meta.json:4–31` attributes anchor frame 8881 to a 2026-05-25 capture, 640×480, 3,523 draws and 342 textures. Local `draws.json` actually contains 3,523 entries; textures, HUD reconstruction, `scene.bin`, `scene_reproject.bin` and `scene_world.bin` are present. The world fixture combines seven accepted keyframes; three rejected registrations are recorded (`scene_world_summary.json:5–32`). These are useful rendering fixtures, not continuous movement/physics evidence. No `.omtc`, original screenshot named by the manifest, original executable tree, `.gpr` or `.gzf` project is supplied. `validate_replay_fixture.py:34–39` requires absent raw artifacts, so its accepted-frame replay cannot currently be reproduced directly. + +**Renderer claims deserve targeted calibration.** `PROJECT_HISTORY.md:1242–1259` records unusual projection `[3][3]=1`, zero vertex-alpha caveats, no fog in that capture, billboard tags, HUD FVF `0x152`/orthographic projection and `canvas_id=Canv+1`. Treat these as scoped capture/source findings. Do not infer universal no-fog or force every Vulkan material opaque. Verify matrix storage/transposition explicitly: wire schema says row-major (`protocol.h:92`) while architectural math uses column vectors. Historical histogram improvements are not image parity (`history/native_vs_capture_8881_phase5_report.md:94–117`). Particularly, `tools/check_oracle_diff.py:41–74` checks fixture counts/magic, player presence and FOV/clip values; it does **not** compare images or trajectories. + +**Oracles: 16 substantive Python scripts plus one template**, rather than the survey's 15. All substantive scripts build/run repository-specific C dumpers. Reuse expected-value functions, corpus enumeration and protocol formats with a C# adapter; no existing generic external-runtime CLI makes them drop-in tests. Strong cases include 3CAM clamp-order/branch precedence with real authored counterexamples (`C3DCutSceneCamera.py:8–35`) and animation mutation tests (`C3DAnimated_dispatch.py:460–498`). Scope remains narrow: 3MCA excludes six out-of-range entries (`C3DMultiCutSceneCamera.py:20–26`); walk-camera uses synthetic inputs/tolerances and documents omitted paths (`C3DPlayer_walkcam.py:29–43`); AI-trigger bypasses activation gates (`C3DAITrigger.py:21–25`). These prove translations against recovered models, not independent original runtime fidelity. + +**Adoption route.** First compare shared corpus/hashes, then adapt one camera/parser oracle and selected Level 1 render-state fixtures. Ghidra markup/dump scripts exist, but markup creates/replaces structures (`ApplyRttiClassMarkup.java:154–170`); apply only to a copied project with explicit paths. The analysed project remains an offer. State tapping is feasible future instrumentation: require pre/post-update phase, dt, input snapshot, stable actor identity, initial save/state/RNG, collision/camera state and dropped-frame reporting before replay comparisons. Begin with VR04 walking/jumping/jetpack traces. + +Keep execution local: receiver defaults to all interfaces (`receive.py:392`) with control enabled (`:501`); deployment uploads remotely (`deploy_xp.py:144–145`). Do not run those defaults or remote workflows. Use reviewed offline readers/local fixtures and separate generated directories. No new implementation or runtime validation is claimed here. diff --git a/docs/reviews/jn-engine-gameplay.md b/docs/reviews/jn-engine-gameplay.md new file mode 100644 index 0000000..4ed4d46 --- /dev/null +++ b/docs/reviews/jn-engine-gameplay.md @@ -0,0 +1,86 @@ +# jn-engine gameplay review + +2026-11-03. Read-only source/document comparison. `J:` denotes +`../../../jn-engine-master/`; `N:` denotes this GamePort repository. No original +execution, network, builds or friend-repository changes. Confidence is high for +what these source files implement; original-behavior claims below remain +candidates until checked against our guarded binary evidence. + +## Verdict + +Useful chiefly as an address/naming index, decompilation supplement and campaign +research map. Do not replace our movement or recovered gadgets with its C runtime. +The ledger really contains 208 rows, all `spec`, with 181 Medium and 27 Low +confidence, and every named report exists (`J:docs/decomp_ledger.csv`). That is +specification coverage, not 208 faithfully implemented classes. Three resolver +rows are deliberately inert, including the unported rock-placement controller +(`J:src/game/behaviors/behavior_resolver_inert.c:1-19`). + +## Concrete comparisons + +- **Locomotion is intentionally different.** Its live player defers parsed + acceleration/deceleration and uses instant tank movement, jump650 and + turn2.8 radians/s (`J:src/game/behaviors/behavior_player.c:14-27,113-155`). + World gravity is1600, versus our recovered800 magnitude + (`J:src/engine/physics.h:6-8`). These are explicit native tunings, not evidence + against our controller. Collision is axis-separated AABB resolution plus a + mesh adapter (`J:src/engine/physics.c:24-50,87-134`). + +- **Gadget names/modes cannot be transplanted.** Its eight-gadget list includes + Jetpack and excludes Baseball (`J:src/game/behaviors/behavior_gadgets.c:71-80`); + our recovered eight tiles include Baseball, with Jetpack outside that tile set + (`N:docs/gameplay/gadget-controls.md:67-79`). Native Shrink Ray writes mode6 + (`J:src/game/behaviors/behavior_gadgets.c:180-182`), whereas our item6/raw6 is + Baseball (`N:docs/gameplay/baseball-implementation.md:11-15`). Its own AMI table + sends mode6 toVR07, and its header admits gadget-to-AMI mapping was unrecovered + (`J:src/game/gadget_menu.c:52-61`; `gadget_menu.h:25-30`). + +- **Our recent slices are substantially deeper.** Friend Invisible hides Jimmy + immediately on equip and calls the mechanic native design + (`J:src/game/behaviors/behavior_gadgets.c:31-37,175-178`); our recovered activation + has recharge7, duration7, cost2, alpha.7 and a separate AI eligibility flag + (`N:docs/gameplay/invisible.md:64-91`). Friend Bubble recovers visual phases but + explicitly invents follow placement; it has no corresponding mode2 body/input + implementation (`J:src/game/behaviors/behavior_gadgets.c:286-325,467-479`; + compare `N:docs/gameplay/bubble-implementation.md:11-18,37-43`). Its Baseball is + a forward projectile at800 with2.5s lifetime + (`J:src/game/behaviors/behavior_player.c:139-155`); ours implements source + aim/release, twenty retained slots and speed1800 without inventedTTL + (`N:docs/gameplay/baseball-implementation.md:11-21`). + +- **Rocket/Grappler/Scooter are prototypes, not shortcuts through recovery.** + Rocket selection force-boards the nearest3ROC within6000 + (`J:src/game/behaviors/behavior_gadgets.c:154-160`). Grappler chooses the nearest + hook and directly translates Jimmy with tuned reach2200/pull1500/arrival120 + (`same:348-350,387-399,481-490`). Scooter has tuned movement, no wheel children, + and mounts directly on selection (`J:src/game/behaviors/behavior_scooter.c:25-30, + 48-55,75-77,155-161`). Our recovered Scooter instead separates equip from later + interaction mount and requires four constructed wheel actors + (`N:docs/gameplay/scooter.md:50-75`). Reuse their asset/class leads and investigate + Jimmy429D00/426A70; do not adopt these replacement mechanics. + +## Highest-value next reuse + +**Animation:** `J:docs/decomp/C3DAnimated.md:221-232` identifies repeated last-frame +completion, including paused one-shots, no completion latch, and selection timing +reset rules. Runtime implements these at `J:src/game/animated_dispatch.c:210-258`; +player HIT/SPLAT/FENCE/LADDER hooks switch toSTOP +(`player_anim.c:137-142`). This is useful beyond our currently limited pose enum +(`N:src/GamePort/Game/LabSimulation.cs:8`). Preserve its own `linked-blocked` +boundary: nativeASE metadata does not prove originalA3dm import/timing or faithful +FENCE entry (`J:docs/decomp/C3DAnimated.md:183-193,334-358`). Mutation-sensitive +native oracles establish implementation wiring, not execution of the original. + +**Campaign/state:** use `J:src/game/behaviors/behavior_ai_trigger.c:140-193` as a +compact SCENE/KITTY transition checklist. Its explicit deferrals include AIState, +AISpeed, animation selection and state-gated object dispatch (`same:37-40`), plus +reward/menu/Goddard/energy effects (`same:140-145,192-193`). Its arm-on-exit +trigger policy (`same:13-17`) requires independent validation. + +**Trust corrections:** survey says `+86C` timer naming was corrected, but +`J:docs/decomp/C3DPlayer.md:70` still says `jump_gate_timer`. Jimmy's field-map +pointer bases are mixed (`C3DJimmy.md:18,24-26,35`); normalize complete versus +game-interface+C0 before reusing offsets. Target6 also forces generic thiscall +signatures and warns about `unaff_retaddr`/dt artifacts +(`J:docs/decomp/evidence/c3djimmy_target6.md:19-32`). Treat its function definitions +as useful recovery leads, not ABI proof. diff --git a/docs/reviews/jn-engine-survey.md b/docs/reviews/jn-engine-survey.md new file mode 100644 index 0000000..82ce496 --- /dev/null +++ b/docs/reviews/jn-engine-survey.md @@ -0,0 +1,118 @@ +# Supplied jn-engine assessment + +2026-11-03. User requested review of `../../../SURVEY-for-Rockman.md` and +`../../../jn-engine-master/`. The survey was read in full; its generated claims +were checked against supplied source/artifacts and our existing evidence. +Read-only review of that tree; no friend code, legacy executables, deployment, +network services or Ghidra scripts executed. GamePort source baseline: d6ca417; +documentation HEAD on entry: c0acf58. No gameplay changes or new runtime claim. + +## Conclusion + +**Useful research and validation material, especially the saved decompiler bodies +and original capture tooling. It is not a more complete faithful gameplay +implementation to substitute for this port.** Keep C#/.NET10, SDL3 and Vulkan. +Use their class/address index to accelerate REA investigations; independently +check each imported interpretation. Their C/SDL2/OpenGL gameplay intentionally +contains approximations which our recent recovered gadget slices already exceed. + +Detailed independent reviews: +[gameplay](jn-engine-gameplay.md), [capture/tooling](jn-engine-capture.md). +A ready-to-share [evidence request](jn-engine-capture-request.md) records the +most valuable additional material; nothing has been sent externally. + +## Identity and corpus checks + +Local SHA-256 recomputation versus `J:docs/binaries.sha256`: + +| Binary | Our original | Friend's declared original | Consequence | +|---|---|---|---| +| Neutron.exe | 1,019,904 bytes; `f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8` | Identical declared size/hash | EXE addresses can be cross-indexed | +| OMT2.dll | 1,343,488 bytes; `3ec41ead011adf56387a6dbd4580e5b5a9721b5f8020c8a56420f42824354943` | 1,339,392 bytes; `a94f13e148bff790aab556d0381055df57f2ff4f9abc5947c25847c7370b0fea` | Reconcile DLL build before reusing DLL addresses or treating captures as our exact engine version | + +Friend originals are not included, so the second column is a direct measurement +and the third a supplied manifest declaration. A DLL difference does not make +their measurements invalid; it limits their automatic applicability. + +Case-insensitive filename pairing and SHA-256 comparison establish **all 254 +Original/ASE, 126 Original/png and 35 Original/gam files are byte-identical to +their supplied counterparts**. Friend directories contain two additional ASEs +(`bigbotstop.ase`, `sporkystop.ase`) and thirty additional PNGs. Do not merge these +extras into our authoritative asset set. The survey's asset-count explanation is +stale; our earlier 128 PNG count includes two root font PNGs outside Original/png. +Our full original manifest verifies all539 files unchanged after this review. + +## Evidence value and reuse order + +Here `J:` means `../../../jn-engine-master/`, relative to this report. + +| Material | Verified scope | Recommended use | +|---|---|---| +| Class ledger and reports | 208 ledger rows, all `spec`: 181 Medium/27 Low; reports present | Naming/address/dependency index, not a completion percentage | +| Jimmy target6 decompiler output | Saved helper bodies including 428D50, 427FF0, 429D00, 426A70; generic signatures have artifacts | First gameplay reuse: compare Grappler/Rocketship recovery with REA and guarded EXE bytes | +| C3DAnimated report/dispatch | Completion and selection timing rules, including repeated end callbacks | Candidate for replacing limited animation ownership after independent verification | +| GAM schema, class IDs, SCENE/KITTY transition table | Source/data research over shared level corpus; several effects deferred | Expand campaign coverage checklist and identify missing owners/callers | +| Linkage oracles | 16 substantive Python scripts plus template, building their C dumpers | Adapt selected expected-value functions/corpus cases to a GamePort adapter; not drop-in original-runtime tests | +| DDraw proxy and OMTC protocol | Real draw/state/texture capture implementation; derived Level1 fixtures supplied | Calibrate selected Vulkan states after matching binary/version and matrix conventions | +| Ghidra scripts and offered database | Scripts included; analysed project absent | Apply reviewed naming/function-boundary ideas to a copied project through our REA workflow | +| Gameplay state tap / deterministic original replay | Proposed in survey; not implemented/included | Request a minimal phase-aware trace before building a replay consumer | + +**Immediate recovery lead:** `J:docs/decomp/evidence/c3djimmy_target6.md:2556` +contains Jimmy429D00, previously unidentified by our default analysis. Its +header and `J:tools/ghidra/CreateFunctions.java` explain how explicit boundaries +were created. This can unblock investigation, but forced `__thiscall`, +`unaff_retaddr` and uninitialized aliases prevent treating the output as a +finished algorithm or ABI. Maintain REA Evidence and byte checks when continuing. + +## Corrections before adoption + +- Movement is explicitly tuned: instant tank movement, jump650 and gravity1600. + This is not evidence to replace our recovered550/800 behavior. +- Their native gadget list includes Jetpack and omits Baseball; Shrink Ray uses + raw6, conflicting with our recovered item6/raw6 Baseball. Invisible activation, + Bubble placement, Grappler pull, Scooter mounting and Baseball lifetime also + contain native design/tunings. Use class evidence, not these replacement rules. +- Jimmy field maps mix complete-object and game-interface bases. Our established + interface is complete+C0. Movement mode is complete+7C4/interface+704; jump state + complete+7E8/interface+728; shadow distance complete+86C/interface+7AC. + The survey mixes these bases in its proposed tap list. Its corrected shadow + interpretation is also not propagated to `J:docs/decomp/C3DPlayer.md`. +- Capture fixtures are derived evidence, not an included raw stream: 390 files, + 13,512,573 bytes; anchor8881 has3523 draws/342 textures at640x480. No `.omtc` + or named original reference screenshot is present. The “oracle diff” checks + fixture structure/counts/configuration, not pixels or gameplay trajectories. +- No-fog/vertex-alpha/projection observations are capture-specific. Verify state + and matrix storage before changing global rendering policies. +- The survey compared older builds; its “other seven gadgets” and “no vehicles” + coverage statements do not describe current GamePort recovery/integration. +- No licence file was found in the supplied tree. Record the offered written + permission or permissive licence before directly importing friend code/scripts. + +Field/loop cross-checks: [movement checkpoint](../analysis/movement-checkpoint.md), +[Bubble pointer/slot contracts](../gameplay/bubble-motion.md), +[loop ownership](../checkpoint/loop-motion.md). Detailed citations for the C +runtime differences and capture limits are in the two independent reviews. + +## Concrete next steps and remaining questions + +1. For the next gadget slice, use the saved429D00/426A70 bodies and Rocketship + class report to guide a bounded REA recovery. Resolve pointer bases, callers, + ownership and body dependencies before implementation; do not port prototype + gadget movement. +2. Request the analysed Ghidra database, raw OMTC with matching screenshots and + exact capture DLL hashes. Their existing Level1 fixtures are useful now, but + raw data is needed to reproduce the claimed renderer observations independently. +3. Start the proposed original-state instrumentation with VR04 movement/jetpack, + then lab→tutorial→lab→outside including Carl/RETURN. Require game-update + phases, initial state and stable actor identity before planning replay tooling. +4. Later adapt one camera oracle and animation-completion cases, explicitly + separating recovered-model consistency from original-runtime comparison. + +Open: capture DLL version/availability; raw evidence and analysed project; +corrected/typed field maps and function signatures; original simulation cadence; +renderer parity; actual state-tap feasibility; final-level/credits behavior; +code reuse permission. None is silently resolved by this source intake. + +Validation this turn: source/artifact review, exact binary/corpus hashes, ledger +counts and original-manifest verification. No new build, port regression run, +original execution or native Windows validation was needed or claimed. diff --git a/docs/tasks.md b/docs/tasks.md index 54d741e..759c6ad 100644 --- a/docs/tasks.md +++ b/docs/tasks.md @@ -46,6 +46,16 @@ compile, runtime and original-fidelity verification are separate. ## Immediate continuation +**Latest user request: assess supplied friend's decomp. Completed2026-11-03.** +See [assessment](reviews/jn-engine-survey.md), independent gameplay/capture +reviews and the prepared local evidence request. No source import or gameplay +change. Same EXE/shared corpus, different declared OMT2.dll;208 class specs and +saved helper bodies are useful leads, prototype C gameplay is not authoritative. +For subsequent gadget work, cross-check target6's429D00/426A70 and Rocketship +report with local REA. Raw original traces, analysed Ghidra project, capture DLL +identity and offered code permission remain open; do not treat proposals as +delivered runtime evidence. Preserved port/release validation is unchanged. + **Current direction: user-requested gameplay gadgets; collision work parked.** Preserve35a2a66 body implementation,0272f7b release notes and baseline69d0187. Recover/implement original gadget selection/use with local REA and original art;