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

83 lines
5.2 KiB
Markdown

# 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](../gameplay/jimmy-rotation-handoff.md).
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.