Files
Neutron/docs/analysis/carl-cutscene-control.md

2.0 KiB

Carl's lab conversation control handoff

User testing found Jimmy remained controllable during the lab's ending Carl conversation. Static original evidence: LV1B neutron1a is a five-shot3MCA with PlayerControlled=JIM1 and NextTrigger=carlwalk. The earlier interpreter applied PlayerControlled at activation, prematurely granting the saved completion target.

Original MCA activation431280 chooses the first valid CameraTarget. When an actor currently owns control,431502..43159E performs actor preparation, then 43159E..4315A7 calls game virtual118(NULL). The original game setter475A40 simply assigns global controlled entity5099E4. The multi-camera completion4311F0..431228 reads PlayerControlled and applies its none/NULL/named-target semantics at the end. JIM1 in neutron1a therefore restores Jimmy after the conversation, not before it.

SceneDirector.StartMulti no longer applies the completion field. Each valid MCA shot clears ControlledTag, and FinishMulti retains the recovered restoration. Program's existing simulation gate therefore suppresses walking/turning/jumping throughout the conversation. Camera, actor/patrol and dialogue clocks continue; Escape/Space skips while preserving authored follow-up actions.

DirectorTests now execute the real neutron1a with natural and skipped completion, assert control is absent through every active shot, restored afterward, and guard the exact original43159E instruction sequence. Interaction tests retain the pre-dialogue score150/SCENE60 side effects. A60-frame headless runtime check (--smoke-carl-cutscene) holds move/turn/jump requests and records zero simulation steps with active neutron1a and zero Vulkan validation errors. This source/contact smoke does not replace live navigation or original-game comparison.

The user separately confirms lab -> tutorial -> lab -> outside is reachable in their tested build. Platform and exact checkpoint-return-position fidelity were not specified by that report; do not infer complete native-platform/original fidelity from transition reachability alone.