103 lines
6.5 KiB
Markdown
103 lines
6.5 KiB
Markdown
# Jimmy cutscene rotation: source ownership
|
||
|
||
2026-11-05. User reports that jumping at an angle into cutscene triggers retains
|
||
Jimmy's airborne tilt. This investigation identifies a direct source mismatch,
|
||
not a new global "cutscenes upright" policy.
|
||
|
||
## Source and provenance
|
||
|
||
Original Neutron.exe SHA256
|
||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||
REA retained complete instruction Evidence
|
||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`,
|
||
artifacts/jimmy-movement-audit/rea-original-disassembly.json, supplies the exact
|
||
instruction windows. `tools/binary/jimmy_cutscene_rotation.py` independently
|
||
checks original identity and seven complete instruction-range hashes; optional
|
||
`--rea-disassembly` retains matching extracts in its generated source.json.
|
||
Preferred VA400000; raw offsets below are VA minus400000, independently checked
|
||
against PE section mapping. This uses existing REA evidence rather than repeating
|
||
the previously unsupported native selectors.
|
||
|
||
## Recovered facts
|
||
|
||
Jimmy game interface is complete+C0. Current Euler is game224/228/22C/230,
|
||
complete2E4/2E8/2EC/2F0. Destination Euler is game274/278/27C/280,
|
||
complete334/338/33C/340. Byte game+A is facing dirty; byte+5 is facing enabled.
|
||
|
||
| Original boundary | Current and destination ownership |
|
||
|---|---|
|
||
|CAM NULL control:416671..4166EB, file16671..166EB|Read current full Euler through328 at41667E→4723F0. Build `(0,current.Y,0,current.W)`. Direct-write destination at4166A0..4166C9, then full current setter32C at4166E5→472450. Neither operation writes dirty or calls destination setter36C.|
|
||
|Initial MCA:431518..431590, file31518..31590|Read328 at431525; build the same flat Vec4; write current32C at431565, then direct-write destination431578..43158D. Preserve dirty.|
|
||
|Current full setter32C→472450, file72450|Copies all four values to game224..230; does not touch destination/dirty. Distinct from current XYZ setter330→472420.|
|
||
|Destination XYZ setter36C→472660, file72660|Writes destinationXYZ and sets dirty+A=1. Camera suffixes bypass this setter; using it would introduce a dirty-state change absent from source.|
|
||
|Facing43A420, file3A420|Global-ready475CA0, enabled+5, dirty+A gate. On acceptance, clears dirty first, compares before-step current/target axes, marks dirty for any unequal axis, adds per-axis angular deltas through334. Runs before Jimmy's raw-control gate437A1B.|
|
||
|
||
The old [preparation report](../checkpoint/cutscene-preparation.md) called
|
||
game274 a "cached Euler". The later [target-state recovery](jimmy-air-target-state.md)
|
||
identifies this same storage as the live facing destination. These camera writes
|
||
therefore replace the **whole destination**, including Y with current Y; they do
|
||
not merely cache an independent render rotation. Full W is copied too, though the
|
||
port currently models orientationXYZ only.
|
||
|
||
CAM's broader order remains438 cleanup→410 stop→orientation writes→clear raw
|
||
control. MCA starts410 stop→orientation writes→438 cleanup→clear raw control.
|
||
Their prior-owner guards still apply. Initial MCA's first-name `none` guard exits
|
||
before this path; subsequent shots do not repeat it. Generic AI NULL ownership
|
||
40C4AD..40C527 only stops motion and clears control: **no flattening**. DEFAULT
|
||
restores control without flattening/preparation. Animation STOP is also separate
|
||
from these orientation writes. Do not flatten on every input lock, shot, action
|
||
change, or missing controller tick.
|
||
|
||
## Port mismatch and implementation contract
|
||
|
||
At investigation start, LabSimulation.FlattenOrientation only set Pitch=Roll=0;
|
||
it left destinationEuler at the airborne target. The newly restored full-Euler
|
||
facing bridge legitimately runs while uncontrolled. Its next step therefore
|
||
interpolates Jimmy back toward the stale airborne pitch/bank and possibly old
|
||
heading. The source camera path overwrites that stale target at the handoff.
|
||
|
||
Replace currentXYZ and destinationXYZ with `(0,currentYaw,0)` on this existing
|
||
FlattenOrientation boundary, preserving facingDirty/facingEnabled and all motion,
|
||
impulse, jump/hold/fire and pitch seeds. Preserve named-authored/current writes as
|
||
separate ownership; do not make arbitrary current setter writes reset destination.
|
||
The existing CAM/MCA order and prior-owner guards remain authoritative. Parent
|
||
owns integration and managed/native port checks.
|
||
|
||
## Verification boundary
|
||
|
||
The source guard passes against authoritative bytes. The bounded native probe
|
||
executes the copied original orientation suffixes with the actual328/32C leaves,
|
||
then the actual43A420 facing leaf and334 Euler-add chain, using synthetic owner
|
||
storage/vtables and a forced-ready global facing gate. It does not execute game
|
||
entrypoints, camera activation, actor registry, body, inputs, gadget cleanup or
|
||
renderer. All execution is in the generated copy with Original unmounted and
|
||
network disabled. All20 native cases pass (CAM/MCA × five initial Euler pairs × dirty0/1).
|
||
Each suffix changes exactly the full current/destination vectors in the synthetic
|
||
object; all other sentinel bytes, including enabled/dirty, are preserved. Before
|
||
facing, current and target both equal `(0,oldCurrent.Y,0,oldCurrent.W)`; after
|
||
one real facing pass dirty is0, and after30 passes the same upright vectors
|
||
remain. Cases cover positive tilt, actual powered-flight-style wrapped tilt,
|
||
negative tilt, heading359 with target1, and heading360 with target0. Initial
|
||
current/targetW differ, proving the source copies currentW into both.
|
||
|
||
Artifacts: artifacts/jimmy-cutscene-rotation/build/source.json,
|
||
probe/wine.log, probe/capture.json, native-observations.json. The JSON retains all
|
||
before/prepared/after-facing/after30 vectors and dirty bytes for managed
|
||
comparison. First3s capture only created the Wine prefix; repeating with12s allowed
|
||
initialization and completed with exit0 and the required marker. This is a native
|
||
original-component execution under Wine32, not whole-game/runtime Windows parity.
|
||
|
||
```sh
|
||
python3 tools/binary/jimmy_cutscene_rotation.py ../Original \
|
||
--rea-disassembly artifacts/jimmy-movement-audit/rea-original-disassembly.json \
|
||
--generate-probe artifacts/jimmy-cutscene-rotation/build
|
||
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wl,--image-base,0x10000000 \
|
||
-I tools/binary artifacts/jimmy-cutscene-rotation/build/jimmy_cutscene_rotation_probe.c \
|
||
-o artifacts/jimmy-cutscene-rotation/build/probe.exe
|
||
python3 tools/recon/reference_capture.py --asset-probe \
|
||
--probe-executable artifacts/jimmy-cutscene-rotation/build/probe.exe \
|
||
--probe-success JIMMY_CUTSCENE_ROTATION_COMPLETE --seconds 12 \
|
||
--output artifacts/jimmy-cutscene-rotation/probe
|
||
```
|
||
|