Reset cutscene facing destination with original camera rotation handoff
This commit is contained in:
1 parent
7818cc8d64
commit
dae13ace73
24 files changed
+2864
-9
No files matched your search
@@ -0,0 +1,102 @@
|
||||
# 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
|
||||
```
|
||||
|
||||
@@ -0,0 +1,118 @@
|
||||
# Jimmy landing → idle orientation ownership
|
||||
|
||||
2026-11-05. User reports a slight bank/pitch can remain after landing without
|
||||
further movement. This investigation tests the original paths rather than
|
||||
assuming that support implies an upright snap. Parent owns runtime integration.
|
||||
|
||||
## Evidence and coordinate owners
|
||||
|
||||
Original Neutron.exe SHA256
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
Retained complete REA instruction Evidence
|
||||
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`,
|
||||
artifacts/jimmy-movement-audit/rea-original-disassembly.json. This report reuses
|
||||
that observation; it does not claim a new Ghidra decompile. VA-to-file mapping
|
||||
below is checked through PE sections (these EXE text offsets equal VA−400000).
|
||||
JN-Engine's original C3DJimmy/C3DPlayer decompiler notes supplied leads only.
|
||||
|
||||
Current Euler is game224/228/22C (complete2E4/2E8/2EC). Destination Euler is
|
||||
game274/278/27C (complete334/338/33C); game+A (completeCA) is facing dirty.
|
||||
Destination setter36C→472660 storesXYZ and sets dirty. Jimmy facing43A420
|
||||
reads current/destination independently and runs before controlled-player gating.
|
||||
There is no small-error snap in that recovered interpolator.
|
||||
|
||||
## Grounded and idle transitions
|
||||
|
||||
| Original VA / file offset | Recovered behavior |
|
||||
|---|---|
|
||||
|438A60..438B9E /38A60..38B9E|Input dispatch uses retained movement mode game704. Mode0 selects ordinary ground handler438BC0; mode1/2 selects439900. It does not itself reset current/destination Euler.|
|
||||
|438BC0..43915D /38BC0..3915D|Complete ground handler prefix samples input, support/root, idle animation/sounds and camera-vector angles. No330/32C/36C Euler dispatch or direct current/destination Euler store occurs in this bounded prefix.|
|
||||
|438F66 /38F66|Ground accepted-heading flag ESI starts0. Keyboard/accepted analog directions set it; neutral input need not do so.|
|
||||
|43951E..439520 /3951E..39520|If ESI remains0, jump4395CF, skipping all destination writes. This preserves old destination pitch/roll/yaw and dirty state.|
|
||||
|43957C,439599,4395C9 /3957C,39599,395C9|Accepted steering publishes pitch0/roll0 and the selected destination yaw through36C. Input, rather than the mere fact of standing, owns these upright destinations.|
|
||||
|437AEA,437B12 /37AEA,37B12|Grounded/released wrapper calls complete140 when prior movement mode1, before the animation decision and resetting mode0/turn0 at437B9E..437BAC.|
|
||||
|429910..429962 /29910..29962|Complete140 clears complete1E64/1E68, hides the A18 menu indicator except rawmode2 and stops A3C sound if valid. No current/destination Euler write occurs. The menu488 target403700 only hides two UI resources.|
|
||||
|43B28A..43B2EB /3B28A..3B2EB|Accepted STOP selection uses generic animationE0 and clears acceleration278. It does not reset current/destination Euler; same-animation request returns earlier43AFF8..43B010.|
|
||||
|40DD90..40DF79 /DD90..DF79|Generic animation start resolves the named morph, starts it and sets shape/timing. No Euler destination/current setter is dispatched in the resolved routine.|
|
||||
|game37C→472970 /72970|Jimmy's body landing callback binding is the bare no-op/log stub, not an upright reset.|
|
||||
|
||||
The derived Jimmy input hook426030 also has a separate impact latch. Its support
|
||||
query is4260AA, falling gate uses vertical thresholds at4260EF/4261B1 and sets
|
||||
**game1D98** at4261C5 (complete1E58). On support42622D..42625E, it clears that
|
||||
latch, plays soundC0 and calls complete1A0(-10,-10,5), the camera effect path.
|
||||
This is not a rotation reset. Offset names in the friend's mixed-interface notes
|
||||
must not be copied without the C0 adjustment. The pickup-halo AddEuler4264F8
|
||||
writes the effect object1D94, not Jimmy. The426F47 Euler copy likewise targets
|
||||
an attached action objectA10 from Jimmy's current Euler.
|
||||
|
||||
Ordinary air input439900 independently accepts support for speed decay, but
|
||||
turn return439989..439A58 has no supported-axis reset. Its ordinary destination
|
||||
439DB7..439E2D is `(acceptedPitch,currentYaw,-storedTurn)`. The last accepted air
|
||||
input can therefore leave a small bank destination after turn0 is subsequently
|
||||
written by the grounded wrapper. Neutral ground input alone does not replace it.
|
||||
Earlier [Bubble recovery](bubble-motion.md) already records the analogous
|
||||
no-input retention; this is not evidence for introducing a cleanup timer or snap.
|
||||
|
||||
## Rendering and scope
|
||||
|
||||
473540 converts current degrees to source14-bit angle units. The existing
|
||||
JimmyRenderTransform already performs that quantization. The OMT hierarchy
|
||||
retains full pitch/roll. The final OMT model-matrix decomposition remains its
|
||||
previous precision gate; none of these static paths establishes a general
|
||||
"grounded means upright" policy.
|
||||
|
||||
**Recovered:** the local writes, dispatch order and retention contracts above.
|
||||
**Inference:** stale last-air bank can explain the reported freeze in the port
|
||||
and is also possible through these source components. A full original frame
|
||||
trace is still required to prove whether another scene writer intervenes in the
|
||||
reported route. A component result is not that whole-game observation.
|
||||
**Implementation:** parent owns any runtime change; do not silently insert a
|
||||
landing snap and label it original behavior. The independently recovered CAM/MCA
|
||||
flattening writes both current and destination and has a different owner.
|
||||
|
||||
## Guard and finite component verification
|
||||
|
||||
`tools/binary/jimmy_landing_rotation.py` guards original SHA, seven branch/field
|
||||
anchors, five virtual bindings and eleven bounded range hashes. Optional retained
|
||||
REA input verifies Evidence identity and lists all ground-prefix calls.
|
||||
`jimmy_landing_rotation_probe.c` executes the original43915D..4395CF keyboard
|
||||
suffix and actual43A420/458F90/472480 facing leaves with real472660 destination
|
||||
setter and4723F0 getter. A synthetic actor/input phase replaces body, camera,
|
||||
animation resources and full scheduling. It seeds a supported neutral-input
|
||||
boundary after the last airborne destination publication, then records one and
|
||||
300 input/facing passes; it does not execute full landing or whole gameplay.
|
||||
|
||||
All seven finite original-component cases complete successfully inside the
|
||||
network/filesystem-isolated Wine32 generated copy. The final capture records
|
||||
wineExit0 and `JIMMY_LANDING_ROTATION_COMPLETE`. Example observations:
|
||||
|
||||
- Neutral last-air target `(0,155,-5)` retains that destination; after300 passes,
|
||||
current is approximately `(0,155,355)`. The five-degree bank survives.
|
||||
- Neutral last-air forward target `(-40,290,-25)` retains it and settles to
|
||||
`(320.000183,290,335.000183)`, rather than upright.
|
||||
- Dirty0 with current `(10,155,15)` leaves that rotation unchanged for300 passes.
|
||||
- Active Up publishes `(0,290,0)` and levels via the original interpolator;
|
||||
Left likewise publishes zero destination pitch/roll while changing yaw.
|
||||
|
||||
The neutral suffix does not query support itself: caller selection of the ground
|
||||
input path is the fixture boundary, not a newly observed whole landing callback.
|
||||
`tools/binary/jimmy_landing_rotation_reference.json` retains all7 observations,
|
||||
source range/byte/virtual guards, generated C/executable/shared harness/log hashes,
|
||||
and capture exit metadata. Raw logs, generated source and executable are retained
|
||||
under artifacts/jimmy-landing-rotation/. NoOriginal directory is mounted for the
|
||||
probe and no original entrypoint executes. This confirms retention in the
|
||||
specific original components and leaves another whole-frame writer explicitly
|
||||
unresolved; it supplies no evidence-based justification for a universal land snap.
|
||||
|
||||
Reproduce static preparation:
|
||||
|
||||
```
|
||||
python3 tools/binary/jimmy_landing_rotation.py ../Original \
|
||||
--generate-probe artifacts/jimmy-landing-rotation \
|
||||
--rea-disassembly artifacts/jimmy-movement-audit/rea-original-disassembly.json
|
||||
```
|
||||
|
||||
Compile generated C with local i686-w64-mingw32-gcc and `-Itools/binary`; execute
|
||||
only through tools/recon/reference_capture.py's `--asset-probe` boundary with
|
||||
`--probe-success JIMMY_LANDING_ROTATION_COMPLETE`. Parent owns regression-test
|
||||
placement and runtime decisions; no shared/runtime file was edited by this agent.
|
||||
@@ -0,0 +1,68 @@
|
||||
# Jimmy rotation at script and ground handoffs
|
||||
|
||||
2026-11-05. User reports jumping at an angle into cutscene triggers leaves Jimmy
|
||||
tilted, and a slight tilt can also remain after landing and standing still.
|
||||
|
||||
## Recovered cutscene correction
|
||||
|
||||
[Original camera ownership](jimmy-cutscene-rotation-source.md) records REA
|
||||
Evidence, original addresses/file offsets, callers, vectors and native execution.
|
||||
CAM416671..4166EB and initial MCA431518..431590 explicitly flatten both current
|
||||
Euler and facing destination, preserving current yaw and the dirty flag. Their
|
||||
direct game+274 writes were previously described as a render cache; the air
|
||||
bridge correctly identified them as destination state but missed this handoff.
|
||||
The port only flattened current Euler. Control-independent facing then consumed
|
||||
the stale airborne target and restored the tilt (and sometimes the prior yaw).
|
||||
|
||||
LabSimulation.FlattenOrientation now replaces currentXYZ and destinationXYZ with
|
||||
`(0,currentYaw,0)` without calling the dirty-setting destination setter. Existing
|
||||
CAM/MCA preparation ordering, prior-owner guards, AI NULL/DEFAULT differences,
|
||||
held input, queued motion and fire lifecycle remain intact. Authored transforms
|
||||
still change current Euler independently of destination; no generic control-loss
|
||||
or per-frame orientation clamp is introduced. Original orientation W is verified
|
||||
by the probe but remains outside the port's XYZ orientation model.
|
||||
|
||||
## Landing investigation
|
||||
|
||||
[Landing source investigation](jimmy-landing-rotation-source.md) records its
|
||||
separate boundary. Neutral ground input retains its prior destination; ground
|
||||
apply, STOP, the landing notification and the derived impact latch do not supply
|
||||
a proven leveling reset. This differs from the directly evidenced camera reset.
|
||||
Do not invent an unconditional grounded snap from this symptom. Seven copied-original300-tick ground-input/facing trajectories reproduce
|
||||
retention: destination `(0,155,-5)` retains roll355 after300 neutral passes;
|
||||
active Up/Left replaces X/Z targets and levels. The managed ground tests compare
|
||||
all seven source trajectories. These are component observations, not a whole
|
||||
original frame trace: another unobserved frame writer or an original quirk remains
|
||||
open. No landing policy is changed without that evidence.
|
||||
|
||||
## Verification
|
||||
|
||||
The old implementation fails the new director regression at the pending target.
|
||||
Eight integrated cases cover CAM/original lab Carl MCA, both input/player orders,
|
||||
and clean/dirty facing. They enter real banked jumps, verify immediate current/
|
||||
destination flattening and unchanged dirty/impulse, then run120 locked body ticks
|
||||
without reintroducing tilt. Additional checks compare20 saved native camera
|
||||
preparation/facing XYZ/dirty outputs, including negative/wrapped Euler and yaw
|
||||
seams. These comparisons seed dirty through live input; the native probe's whole
|
||||
object comparison separately proves independence from the old destination and W.
|
||||
The saved fixture includes original range and probe provenance hashes.
|
||||
|
||||
Native Linux SDL/Vulkan --smoke-control-phases now first creates a real8-tick
|
||||
banked jump before triggering the original Carl MCA. It asserts both current and
|
||||
destination are leveled while dirty survives the handoff, verifies they remain
|
||||
upright through15 locked body/fire/energy ticks, and checks held-input resumption.
|
||||
It saves locked-start/locked-fall GPU captures. The Carl lock and powered VR04
|
||||
replays remain regression checks. Artifacts: artifacts/jimmy-rotation-handoff/.
|
||||
28 movement groups, extended Director tests, original25 ground observations plus
|
||||
seven trajectories,14 jetpack groups and both visual groups pass. Build passes
|
||||
with zero warnings/errors using NuGetAudit=false (the first default-audit attempt
|
||||
reported unavailable network metadata). Native Linux banked handoff/Carl lock/
|
||||
powered jetpack runs pass with zero Vulkan validation errors. The jetpack replay
|
||||
requires explicit VR04; an initial default-lab invocation was rejected by its
|
||||
existing argument guard before rendering and the corrected replay passes.
|
||||
All336 Python tests pass, including new camera/landing source and native-fixture
|
||||
provenance guards. The initial managed fixture name collision was corrected
|
||||
before the final Director run. Package results follow below.
|
||||
|
||||
These are static-source, isolated original-component and port-runtime checks.
|
||||
They do not establish whole-original frame scheduling or native Windows parity.
|
||||
Reference in new issue
Block a user