Preserve retained Jimmy update order on initial story entry
This commit is contained in:
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
|
||||
```
|
||||
Reference in new issue
Block a user