Files
Neutron/docs/gameplay/jimmy-body-transform-return.md

8.1 KiB

Jimmy body-context alignment and transform publication on return

2026-11-06. Static follow-up to the null-body-context limitation in the base/STOP probe. Original identity and cached REA instructions are reused; no new native cases or gameplay changes are claimed.

Source identity and guard

Canonical Neutron.exe SHA256: f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8. Complete EXE instruction Evidence: ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904. The read-only tools/binary/jimmy_body_transform_return.py verifies that subject, 12 source sites,16 virtual bindings and13 bounded source ranges. Its generated report contains PE file offsets, hashes and the matching retained REA extracts: artifacts/jimmy-body-transform-return/source.json.

The prior OMT transform Evidence is ev_af082632c98b34ccfcedef01466cafa03365e7fbf482496d01a4cda6d2f8f787. It is a truncated DLL disassembly prefix, not complete DLL coverage. Existing transform ranges are present and rechecked against the supplied DLL through jimmy_model_bridge.collect; see render transform for the earlier12 angle and14 hierarchy/final-matrix observations and limitations. JN-Engine's original class notes supplied field/navigation leads only.

The live context bridge can write current Euler, behind a separate gate

Original VA / EXE file offset Recovered receiver and state effect
462520..462649 /62520..62649 Runs before common458930→473240/facing. Requires475CA0, own game210→4719F0(byte13E), and nonnull own game338→472570(pointer234) for the context path.
46255D..46258F /6255D..6258F Reads support polygon's+4 link and linked+80 payload; invokes current game complete130(actor game pointer,linked record,payload,dt). Lab4C3CD0,VR044CE910 and outside4C5A80 all bind130→44E030. The callback occurs before the alignment gate.
462595..4625A2 /62595..625A2 Own game1E8→471950 reads live byte138. False bypasses normal→Euler publication but still reaches common update/facing. This gate is independent of cached support218 and raw input owner.
4625A8..462632 /625A8..62632 For true138, obtains current Euler328→4723F0, copies support normal Vec4 from polygon+8..14, calls476FF0 and writes resulting XYZ through330→472420. This changes current Euler only: target274, dirtyA, mode704 and turn614 are not written by this suffix.
471080/471090 /71080/71090 Property getterC4 reads byte10. Property setterC8 writes byte10 and invokes live setter1EC.
471950/471960 /71950/71960 Live getter1E8/setter1EC read/write byte138. Property10 and live138 are separate fields.
47059C..4705A9 /7059C..705A9 Generic Init470540 restores live138 through1EC from propertyC4. It does not infer alignment from landing or input ownership.

Crucially, the ordinary Player constructor explicitly disables this path: 43729E clears EBX;437332 installs the active Player game table4AF6C4;437426 pushes EBX=0 and437429 calls471090. The active constructor table's1EC resolves 471960, as does the eventual Jimmy table4A373C. Thus both property10 and live138 are set false. The inspected constructor interval contains no intervening EBX assignment; its callees follow the recovered x86 nonvolatile-register convention. Subsequent generic Init restores the false property into live138. This is a positive constructor/Init chain, not an assumption from the old null-context probe.

This does not prove no uninspected runtime path ever changes the property. The previously recovered Carl camera preparation/STOP/DEFAULT boundaries do not supply such a write. Enabling this surface-alignment path for Jimmy, or using it as a new cutscene-exit leveling rule, would therefore introduce unsupported state. The generic normal-angle helper's existing Scooter observations remain separate from whether Jimmy is eligible to invoke it.

The supplied static lab terrain takes the ordinary callback path

The authoritative omt/level1b.omt SHA256 is 5a33d11311fc222631eb8f7384d1863192cb1f55f7e67035caa0ae12fd9892ab. Using the existing bounded OMT parser and source shape/checkpoint exclusions, the helper inventories2869 polygons,2851 eligible for static registration. Among eligible polygons,2526 have texture references with IDs0..30 and325 have no texture. The report retains counts, shape IDs/names, original payload offsets and payload hashes. No texture ID is guessed from the port's material index.

44E030 requires both linked record and payload. It reads polygon material+0C, then the material's texture-definition ID+8; missing material/payload bypasses the callback's state paths. All identified static-lab IDs0..30 fall below its first special selector range50..55, so they select ordinary surface sound5 at 44E407. This excludes the callback's higher-numbered lava/ground-hazard branches for that supplied static geometry.

When desired surface sound changes,44E426 invokes Jimmy complete1E4→42AEC0. That method stops/restarts an existing floor-loop handle at completeA44 only if the prior handle is valid. It writes the new handle, without touching either Euler vector, mode704 or turn614. This is distinct from game-interface1E4, which is another field accessor. The ordinary path supplies no movement reset and does not grant/remove raw control.

This is not a complete runtime collision-world inventory. It does not prove the provenance of a retained338 context, rule out additional runtime geometry or dynamic interactions, or execute the full original body/derived Jimmy frame. The old Bubble floor component investigation already covers this same callback with explicit synthetic dependencies; another duplicated finite negative probe would not establish the missing original Carl entry/resume state.

Transform publication does not conditionally hide the bank

The later473770 pass calls each game interface3DC and3E0, not3C8. Jimmy3C8→4235B0 is the separate supervisor/editor update selected by470280 when app+8C is set. It must not be described as normal render synchronization.

For Jimmy,3DC→4624B0 copies current logical/body XYZ into complete44/48/4C. 3E0→4624F0→473540 reads current Euler, converts each degree axis to masked 14-bit angle units, then3E4→462500 writes complete50/52/54. These routines do not test raw control, movement mode, animation name or cutscene state, and do not replace current or destination Euler. Previously verified OMT hierarchy construction consumes those cached pitch/yaw/roll angles. The known publication path therefore provides no scene-return branch that conceals a residual bank. Whole-world parent transforms, full morph playback and final render flags remain separate from the already-probed identity-parent/unit-scale contract.

Result, implementation and remaining observation

The optional body-context bridge contains a real current-Euler writer, but the ordinary Jimmy constructor/Init disables its alignment gate. The identified static lab terrain path affects surface audio, not banking state. The normal logical→visual synchronization publishes current pitch/roll rather than dropping them. These facts close specific omissions in the composed return explanation; they do not explain the user's upright whole-original return or justify a new reset. Keep the existing playable port unchanged until actual original entry, registry placement and resumed input state are measured.

Integration follow-up: the menu/player lifetime chain subsequently establishes retained player-before-input order for successful original TSK story entry. The resulting correction changes that entry classification; it does not enable this optional surface-alignment gate or alter visual publication.

Verification is static: source hash/site/binding/range checks, revalidated prior transform contracts and complete supplied-static-lab polygon inventory. No new original execution, native Windows comparison, runtime edit or commit is made.

python3 tools/binary/jimmy_body_transform_return.py ../Original \
  --rea artifacts/jimmy-movement-audit/rea-original-disassembly.json \
  --output artifacts/jimmy-body-transform-return