Preserve retained Jimmy update order on initial story entry

This commit is contained in:
UnixNight committed 2026-11-06 17:08:59 -05:00
1 parent 4cd62d3627
commit ea04210f52
24 files changed
+1209 -22

No files matched your search

@@ -0,0 +1,125 @@
# 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](jimmy-base-return.md). 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](jimmy-render-transform.md)
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 **complete**1E4→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](main-menu-player-lifetime.md)
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.
```sh
python3 tools/binary/jimmy_body_transform_return.py ../Original \
--rea artifacts/jimmy-movement-audit/rea-original-disassembly.json \
--output artifacts/jimmy-body-transform-return
```