Match Jimmy controller arithmetic and facing to original probes

This commit is contained in:
UnixNight committed 2026-11-05 09:47:28 -05:00
1 parent 42ea2b8cd5
commit 0e2f426d42
60 files changed
+6027 -48

No files matched your search

+72
View File
@@ -0,0 +1,72 @@
# 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.