Files
Neutron/docs/gameplay/jimmy-orientation.md
T

73 lines
5.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.