Files
Neutron/docs/checkpoint/cutscene-preparation.md

48 lines
3.6 KiB
Markdown
Raw Permalink 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.
# Cutscene preparation and control handoff
2026-10-26, static EXE evidence. SHA256
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
VAs below use400000 preferred base; raw offset=VA−400000 at these sites.
cutscene_preparation.py records exact bytes/virtual targets; its projection is
interpretation, not source execution. Primary completed the investigator's helper,
corrected its sign-extended byte−1 comparison anchor and added tests/report.
| Boundary | Proven order and source sites |
|---|---|
|CAM with PlayerControlled=NULL|Guard prior raw owner416635;43841665D→41041666B→flatten current/destination Euler(0,currentYaw,0)41667E..4166E5→game118(NULL)4166F4. Target lookup occurs later416754. Preparation can precede a missing target/sound failure.|
|Initial MCA activation|First target name `none` guard431300 exits before preparation. A non-none name reaches initial target/animation prelude; missing lookup can continue. Prior owner guard431502;410431512→flatten current/destination Euler431525..43158D→438431598→game118(NULL)4315A7. Per-shot helper invoked431600.|
|Later MCA shot|CompleteE0→431750; target/sound/animation work, no410/438 or raw control clear. The sound−1 check431771 sign-extends one immediate byte, not a four-byte immediate.|
|AI PlayerControlled=NULL|Prior raw owner guard40C4AD→41040C4B9→game118(NULL)40C527; no438 or flatten. Named AI ownership remains an older port interpretation requiring broader proof.|
|DEFAULT|447D5C checks whether Jimmy already owns raw control;447E27 restores via118 without410/438. No new key-release boundary is implemented. Music uses authored ownership independently of debug force.|
Jimmy410→42AFC0 calls43A750 first: clear speed608 and velocity XYZ2C4; stop
saved sound148; then request complete150(`STOP`) at42AFDE/E5. Body changes precede
the STOP animation notification. Mode, jump, hold, pending impulse, acceleration
and fire timer are separate. Existing isolated43A750 probe validates its limited
write set with invalid sound handle; it does not execute full camera activation.
Jimmy438→42AE00 invokes selected-gadget cleanup178→427FF0 and sets interface1D65
and global4F8182. Supported no-selection/jetpack cleanup clears selection; other
gadget cases are not blanket resets (retained-return-cleanup.md). The port exposes
these ordered boundaries, implements supported player motion/selection and logical
orientation changes, and leaves other class/UI/resource side effects explicit.
Authored AI movement has separate setters: marker root310 at40C732→target314
at40C757; yaw40C88F..40C961 uses174→4716D0, writes authored/live Euler and cached
Euler, and does not write movement destination yaw61C. PlayerSceneBinding applies
root/yaw to the simulation without erasing pending motion or destination yaw.
Only actual transform writes emit that event; animation-only changes do not.
The port's skip fast-forward, malformed/reentrant activations, MCA's initial
animation prelude, all other class virtual effects and full shared camera state
are not certified by this chunk. Existing named control behavior is preserved,
not newly recovered here. Three byte/projection tests and coupled managed
director/body tests guard the implemented ordering and boundaries.
2026-11-05 correction: game+274 is the facing destination, not an independent
render cache. CAM/MCA copy `(0,currentYaw,0,currentW)` into both current and
destination vectors without touching dirty. See
[exact rotation handoff](../gameplay/jimmy-cutscene-rotation-source.md) for20
isolated original-code cases and the recovered fix. STOP alone, AI NULL and
DEFAULT retain their existing separate policies.