75 lines
5.2 KiB
Markdown
75 lines
5.2 KiB
Markdown
# Jimmy facing interpolation and full Euler seams
|
||
|
||
2026-11-04. This source-backed helper closes an integration dependency of the
|
||
ordinary movement audit. The current playable port remains the baseline. No
|
||
JN-Engine native movement/controller constants were adopted.
|
||
|
||
## Recovered original contract
|
||
|
||
Authoritative EXE SHA256
|
||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||
Code VAs below have independently mapped file offset VA−400000. New extractor
|
||
jimmy_orientation.py records three bounded ranges, hashes and two double factors.
|
||
|
||
| VA / file offset | Contract |
|
||
|---|---|
|
||
|43A420..43A5CF /3A420..3A5CF|Jimmy game-interface3D8 facing.475CA0 gameplay gate, +5 enabled, +A dirty control execution. Clear dirty, read current224/228/22C and retained target274/278/27C. Unequal axes reassert dirty; current/target remain distinct state.|
|
||
|43A4A4..43A58C /3A4A4..3A58C|For each target−current difference, wrap strictly>180 by−360 and strictly<−180 by+360 once. ±180 retain sign. Pitch/yaw deltas have explicit float stack stores; roll's difference remains on x87 until final argument publication.|
|
||
|43A58C..43A5C2 /3A58C..3A5C2|Multiply differences by supplied float dt, then double4.5 for pitch/roll (4AFD38), double3.7 for yaw (4AFCF0), store each resulting delta as float parameter and invoke334. There is no small-step snap or gain clamp.|
|
||
|458F90..458FB6 /58F90..58FB6|Jimmy334 wrapper repeats gameplay gate, then forwards XYZ float parameters to472480.|
|
||
|472480..472570 /72480..72570|Add angles and preserve original asymmetric negative truncation and strict>360 single wrap. Existing RocketOrientation.Add models this leaf; zero steps can normalize negative angles.|
|
||
|473240→47328D /73240→7328D|Shared base updater invokes game3D8→43A420.43796A calls40E050 before437A1B raw-owner identity check. Facing is thus a base phase independent of movement input acceptance. Body/registry/callback ordering still belongs to caller.|
|
||
|
||
Jimmy vtable4A373C+334 binds458F90 and+3D8 binds43A420. The probe uses these
|
||
original wrapper/leaf bodies with a synthetic game-interface object and active
|
||
475CA0. No global game entrypoint or actor/controller/body path executes.
|
||
|
||
## Why this matters for live integration
|
||
|
||
LabSimulation previously interpolated raw targetPitch−Pitch and targetRoll−Roll
|
||
with float4.5, while yaw used IEEERemainder and float3.7. Source AddEuler used by
|
||
movement canonicalizes all axes, so a recovered pitch/roll338 must approach0
|
||
through360. A raw difference would instead rotate338 toward0 the long way.
|
||
This can create an artificial spin after a slope/vehicle/Bubble tilt. Source
|
||
native338→0 at60Hz produces339.65 on both pitch/roll, preserving the short arc.
|
||
|
||
New JimmyOrientation.Step(current,target,dt,enabled=true,dirty=true) returns the
|
||
new full Euler and leaves destination state untouched. It supports ordinary
|
||
movement and existing Bubble facing; no targets are invented/reset by the helper.
|
||
X/Y delta rounding, factor widths and AddEuler parameter publication are preserved
|
||
with double intermediates and explicit float argument casts. Disabled/clean gates
|
||
return current unchanged. Caller owns actual enabled/dirty fields and scheduling;
|
||
this pure API does not infer either from input ownership.
|
||
|
||
Parent owns LabSimulation integration: apply this once in the recovered base
|
||
phase, after fresh input and before ordinary controlled apply, while retained
|
||
input remains after player/fire. Remove duplicate naive interpolation. Exact
|
||
base-wrapper/dirty flag state and unsupported class modes remain separate gates.
|
||
|
||
## Evidence and verification
|
||
|
||
Parent's retained REA inspect_with_objdump Evidence
|
||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`
|
||
contains the complete original disassembly. Bundle:
|
||
artifacts/jimmy-movement-audit/rea-original-disassembly.json. The focused source
|
||
instructions/caller are retained under artifacts/jimmy-orientation-audit. The
|
||
same routine may not be recognized as a Ghidra procedure under the default profile;
|
||
no unchanged failed pseudocode selector was repeated. This evidence establishes
|
||
bytes/instructions, not original gameplay runtime.
|
||
|
||
The isolated copied-original probe executes43A420/458F90/472480 and records16
|
||
cases: ordinary axes,338→0 leveling, both359/1 seams, negative angles, exact±180,
|
||
>180, canonical360, fractional input/double arithmetic, small-angle/no-snap,
|
||
120-tick settling, upright and enabled/dirty/zero-dt gates. Wine32 exits0 with
|
||
JIMMY_ORIENTATION_COMPLETE. Source/generator/shared-map-helper/generated EXE/log
|
||
hashes are committed in original-orientation-reference.json. Native outputs and
|
||
capture metadata are under artifacts/jimmy-orientation-audit/probe.
|
||
|
||
Two managed groups compare all16 observations and verify retained target state.
|
||
Two Python groups guard identity, ranges/offsets, double factors, complete fixture
|
||
and provenance/gates. This is component execution plus managed conformance, not
|
||
whole-original/native Windows gameplay, full animation/visual-root parity or a
|
||
complete scene registry/cadence implementation. Parent records live verification.
|
||
|
||
Live integration/route/native/package status (2026-11-05): [movement stabilization](jimmy-movement-stabilization.md). The audit API notes above describe the isolated component boundary; parent integration is now recorded in that continuation.
|