7.4 KiB
Jimmy logical/render Euler and compatible pivot bridge
2026-11-05. This investigates the original transform before enabling ordinary up/down airborne tilt. The existing playable movement and upright placement are the baseline. JN-Engine original class/decompiler notes supplied navigation leads; its tuned movement and renderer are not copied as behavior references.
Original facts and state ownership
Authoritative identities are EXE
f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8
and OMT2.dll
3ec41ead011adf56387a6dbd4580e5b5a9721b5f8020c8a56420f42824354943.
tools/binary/jimmy_model_bridge.py guards their ranges, five Jimmy bindings and
both double angle constants. File offsets below are independently PE-mapped.
| VA / file offset | Recovered contract |
|---|---|
| EXE4624B0 /624B0 | Jimmy game-interface3DC asks310→472300 for the current logical/body Vec4; copies XYZ to complete44/48/4C without scale or floor/sole subtraction. |
| EXE4624F0 /624F0 | Angle publication hook3E0 jumps to473540. |
| EXE473540 /73540 | Reads current degree Euler through328→4723F0; each axis is remainder360, multiplied by double45.51111111111111 at4D6408 and truncated through47F940, then masked16383. Double360 is4D6410. |
| EXE462500 /62500 | Game3E4 stores the three resulting shorts at interface−70/−6E/−6C = complete50/52/54. Position and cached render angles are distinct records. |
| DLL1003FA60 /3FA60 | OMediaElement::compute_hxform copies the parent hierarchy; obtains current animation dynamic offset from virtual7C and adds complete44/48/4C. With identity parent, resulting translation is exactly root+dynamic offset. Rotation does not rotate that root. |
| DLL1003FB26..1003FBE3 /3FB26..3FBE3 | Reads cached angle shorts52/50/54 with negative signs and rotates the hierarchical basis. Row-vector form is Rz(−roll)·Rx(−pitch)·Ry(−yaw), with unit scale in the probed path. |
| DLL1003FC00 /3FC00 | compute_model_matrix consumes the hierarchy and decomposes/re-quantizes its rotation through original angle lookup before publishing the final4×4. This additional precision behavior is distinct from the hierarchical basis. |
473540 does not duplicate Y into X: the0C stack load at473586 reads Y, then pushZ at473595 shifts the stack. The0C load at4735A6 consequently reads original X. Native asymmetric(-40,45,-15)→(14564,2048,15702) confirms independent axes. The double render conversion is kept separate from physics472B10's float 45.5111122 factor. Render caching is not permission to mutate current degree Euler or its destination state. Their phase/state owners remain in LabSimulation.
The position bridge has no hardcoded radius75.9, standing-minimum offset or scale. Prior mode2 DLL import probes establish original jimstop geometry and zero dynamic frame offsets for the tested clips; see original collision. That does not certify every clip, shape mutation, hierarchy or transform flag. There is no newly recovered original correction for the port's sole alignment.
REA and native evidence
The retained EXE instruction Evidence is
ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904
in artifacts/jimmy-movement-audit/rea-original-disassembly.json. The DLL REA
inspect-with-objdump Evidence is
ev_af082632c98b34ccfcedef01466cafa03365e7fbf482496d01a4cda6d2f8f787,
retained in artifacts/jimmy-model-bridge/rea-dll-disassembly.json. Its16MiB output
cap was reached, so it is a bounded prefix, completion unknown, not complete
DLL analysis. All transform ranges used here are present and separately guarded
against original bytes. An initial REA target-path error was corrected by making
a separate generated DLL copy; no missing-target result is cited as analysis.
The OMT probe calls exported compute_hxform and compute_model_matrix against a synthetic element, identity parent and zero dynamic-offset callback. Fourteen cases include upright, individual90° axes, full combined axes, ordinary forward/ backward air tilts, negative units,16383/16384 seams, halfturn, tiny angles and two roots with the same rotation. No game/renderer entrypoint, GPU, body, animation or audio runs. The original DLL is loaded only from an isolated copy.
The angle probe executes copied473540, original4723F0 getter and462500 setter with synthetic actor fields. It bypasses CRT exception dispatch at4802CA into its original finite x87 remainder primitive4802D4;47F940 truncation is original. Twelve finite cases cover independent axes, negative/fractional degrees, multiple revolutions, exact angle units, canonical360 and tiny seams. This does not verify CRT exceptions, nonfinite inputs or the whole object scheduler.
Both isolated Wine32 runs exit0 with their success markers. First-time Wine prefix
creation exceeded the initial capture window; reuse of an already completed local
analysis prefix resolved setup. Successful model and angle logs/capture metadata
are retained separately under artifacts/jimmy-model-bridge. Fixture
tests/GamePort.JimmyRenderTests/original-render-reference.json commits all40
observations (14 hierarchy +14 final render matrices +12 angle writes), source
ranges/constants/bindings and generator/probe-EXE/output hashes.
Implemented helper and explicit modern policy
JimmyRenderTransform.AngleUnits follows the recovered finite degree conversion.
Source(root,euler) uses those units and the original hierarchical axis order;
its translation is the unrotated root. Aligned(root,euler,localYCorrection)
pre-translates local vertices before that source rotation/root transform.
The helpers are pure and reject nonfinite inputs; no broader renderer or asset
rewriting is introduced.
For baseline upright placement, the caller may retain the fixed modern correction
c = -modelMinimumY - rootHeight, then use
Translate(0,c,0) * Source(ActorRoot,Euler). For the standing mesh, minimumY is
approximately−64.6165 and the existing logical clearance is75.9, givingc≈−11.2835.
This preserves the upright sole location while combined pitch/roll rotate around
the logical root. The local point(0,−c,0) stays at ActorRoot under every rotation.
It is a modern compatibility adapter, not a recovered original pivot offset,
scale or new body clearance. It must not change collision/body support geometry.
The old world-space sole correction is not evidence for the source transform.
Tests and remaining gates
The managed suite compares all12 original degree writes and14 hierarchical transforms (basis tolerance1e−6), unit-scale determinant, unrotated translation, modern upright/combined-tilt pivot invariants and nonfinite rejection. Two Python groups verify source ranges/constants/bindings and complete native fixture/ provenance. Commands from GamePort:
dotnet run --project tests/GamePort.JimmyRenderTests
python3 -m unittest discover -s tests -p test_jimmy_model_bridge.py
Both pass. Final OMT model-matrix parity is deliberately not claimed. Its approximate angle decomposition produces up to0.007286333 matrix-coefficient deviation in the14 saved cases, largest at the16383-unit near-zero seam; ordinary combined air tilt differs by roughly0.0002..0.0003. The test records that mismatch instead of treating the final matrices as conforming. Exact decomposition/lookup, all render flags/parents/dynamic offsets, complete source pivot/clip ownership and whole-original/native Windows visual comparison remain separate gates. Runtime integration/route/native checks are owned by the parent movement continuation.