Files
Neutron/docs/gameplay/jimmy-render-transform.md
T

7.4 KiB
Raw Blame History

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.