Files
Neutron/docs/checkpoint/control-phase-implementation.md

5.2 KiB

C3 continuation: uncontrolled body and fire

Implementation2026-10-26. Source contracts: uncontrolled-player.md, uncontrolled-physics.md and cutscene-preparation.md. This replaces the port's whole-player freeze on control loss with a bounded phase split.

LabSimulation.Step consumes prior body state first. Input/controller math runs only when Jimmy has effective control; fire ticks independently afterward. The existing fresh/retained input ordering remains. Ordinary grounded radius60 is reasserted before the movement gate, matching the supported wrapper path. Grounded fire can expire while mode/jump/hold remain untouched by the skipped controller. Queued impulses survive camera preparation and are consumed once by the following body pass. Neither control loss nor restoration invents a key flush.

PlayerSceneBinding connects raw-owner preparation events to speed/velocity and supported gadget cleanup, and publishes the simulated root while uncontrolled. Authored AI transforms update the body too, preventing a later physics publish from overwriting the script's teleport. Authored current writes preserve the facing destination. The later full-Euler bridge publishes all axes; CAM/MCA preparation now replaces destinationXYZ with the upright current heading too. See rotation feedback. Initial MCA preparation occurs once, with its first-name guard; later shots do not repeat it. AI and CAM use their own callback order. STOP notification follows physical preparation. DEFAULT grants control without preparation.

Force Control is a modern effective-input override; raw ownership still selects source preparations/music. Noclip keeps its separate flight path. F1/modal/inspect boundaries stop the whole frame, so body/fire do not accrue paused time. Contact-triggered interactions retain the existing control gate pending C4.

Counters now distinguish total Steps, PhysicsSteps, ControllerSteps and EffectSteps. Total Steps also counts modern flight, which bypasses the physical/effect phases. The console report exposes these counts; a cutscene's nonzero total count does not mean Jimmy accepted input. --smoke-carl-cutscene asserts zero controlled updates/jumps/turn/speed while physical/effect callbacks continue. The new --smoke-control-phases seeds an airborne retained-fire fixture, holds movement and jump through15 locked frames, checks falling/fire/energy without input, then skips/restores control and verifies held-input movement resumes. This is a port fixture, not an original end-to-end recording. Headless story pre-roll uses the same binding/phase policy.

Verification and limits

New managed tests cover queued impulse across preparation, uncontrolled fire and tutorial immunity, independent grounded resets, CAM/MCA/AI order, body-before-STOP observation, raw/effective ownership, later-shot behavior, held jump restoration and authored teleport synchronization. Python adds9 source/projection tests. The input-only lab replay now uses the same binding and waits through live cutscenes with body/fire ticking. Its old coasting turn missed the narrow exit: port snapshot root(318.11124,75.02122,770.8816), yaw47.52308, controlJIM1, no shot/block and2290 wall hits. Braking with the actual Down input before large heading changes restores the route (score150, owned jetpack, one practice No, zero jumps,6 wall hits). No physics or task gate was changed to make that replay pass. The provisional corner response remains a useful C4 investigation case. Native Linux GTX1070 at1280x720 passes Carl/control-phase and F1/F3 tools/menu checks with zero enabled Vulkan validation errors. Full integration/package results are recorded in progress.md; native Windows remains separate.

REA6.8.0/Ghidra12.1.4 source Evidence is retained under artifacts/uncontrolled-phases/rea/. IDs:

Procedure Evidence ID
475CA0 gameplay gate ev_aa0b7db46894c10d2f28f76d0da1e568ef06253f3d6c8cf6b06fbef299602bab
479BC0 body traversal ev_56b7e074ec8509d1c5b3576d02361ff051963b777d7ccb8259ed9c65dc2db52f
437940 movement gate ev_de7097867d129a4232318e667e9496c6868cdb1da4b37a1f3304c94b0b101677
40E050 animated base ev_03a109302788b85597e253293bbcb535c4080732e41cc828bb33d01d2b2da09a
462520 base body/rotation bridge ev_f0a2e1fd465472295b272f2fdbfb6be4651aeb8c35d90dc2ca02a495ed359edd

These are static decompiler observations with unknown C++ types, not original source or runtime.421FB0 maps correctly from file21FB0 but lacks an analyzed procedure in this Ghidra profile; its pseudocode is unavailable, not evidence that the source callback is absent. Existing guarded bytes/vtable/body hash remain the authority for that callback. Partial batches preserve successful Evidence.

Remaining: full424600 wrapper timers/UI/sound cleanup, base40E050/462520 resource/transform/morph policies, collision-triggered ceiling cancellation, Bubble/mode0 radius160 and other gadget/class cases, original body registration and response, complete registry and engine cadence, shared viewport handoff and original whole-game comparison. Calling the entire controller with empty input would not implement these missing phases. Existing capsule/yaw/camera adapters remain explicit; this chunk does not certify a complete scene scheduler.