Files
Neutron/docs/checkpoint/uncontrolled-player.md

8.1 KiB
Raw Permalink Blame History

Uncontrolled Jimmy and owned jetpack-fire callbacks

Static C3 continuation,2026-10-26. Original Neutron.exe SHA256 f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8. All addresses below are preferred-base EXE VAs; inspected raw offsets are VA−400000, independently checked through PE sections by the helper. No original code was executed for this report. Original files remain read-only. No runtime files were changed by this independent investigation.

Result

Null control is not a gate on the entire Jimmy object or on his owned fire object. Jimmy's movement math has an explicit identity gate inside437940. Fire421FB0 does not read the raw controlled pointer at all: after the common gameplay gate and base work, it tests its owner/support/timer and follows the owner. Physics is an earlier separate pass; its exact activation gates belong to the companion physics investigation. Do not infer physics freeze from the movement return.

Jimmy caller chain and work before the movement gate

Registry473740 invokes interface slot10→470280, which stores dt and dispatches normal3C4→424600 (table4A373C). Source editor/supervisor mode uses3C8 instead; this report covers normal gameplay. Jimmy game-interface pointer is complete+C0.

424600 increments global4F8408 by dt before inspecting control. At42460A it loads5099E4;424622 bypasses only a cleanup prefix when that pointer is nonnull. Raw NULL therefore performs UI/resource cleanup, resets interface1D74 and stops saved sounds interface974/97C through47D7A0, assigning−1. It does not return from the object update. Other actors being controlled skip this NULL-only prefix but still fail Jimmy's later identity gate.

42469F then queries support218→458960 regardless of control. On support, gadget0 uses radius160; ordinary selected gadget uses radius60 at4246DC. The callback also has its own menu/modal branch42471F..424751, character timers and class callbacks. Those are separate from ownership. At424C34 it calls437940; after that returns, it continues through complete1C8→424E80 and position/history/class callbacks. Complete1C8 has a raw-NULL menu-hide early return of its own.

Consequently “skip all Jimmy update when uncontrolled” and “call the whole controller with no keys” are both broader policies than the source gate.

Movement437940: exact gate placement

Order / site Recovered operation
437946..43794D Call475CA0; false jumps straight437C33. This is a common gameplay predicate, not the controlled pointer.475CA0 returns false only when5099AB!=0 and4F641C==0; meanings of these two flags are not assigned here.
437953..437964 Increment interface774 timer before raw ownership comparison.
43796A Base40E050 update runs before raw ownership comparison. Its own resource/transform/animation-end policies remain separate.
43796F..437A0F Conditional interface7A8 timer/restore work precedes ownership. This is not the jump-hold7B4 field.
437A1B..437A2B Compare raw5099E4 with Jimmy's game interface; mismatch jumps437C33, the return epilogue. Normal allocated complete pointer is nonzero, so the source complete-to-interface idiom gives this+C0 interface exactly.
437A31..437A43 Two additional flag guards4F83E0 and4F8181 can skip the same controller tail even when Jimmy is controlled. Their full semantics are outside this bounded audit.
437A49 onward Read movement mode704, jump-held callback and support; choose ground/air application. Grounded released path437B9E clears jump728, mode704 and turn614. These writes are after the ownership gate.
437BC5 /437C1C Invoke complete134→437F90 air/jetpack math or complete130→437C40 ground math. These are complete-object slots, not same-numbered game-interface getters.
437C2D Write final speed via game-interface26C only after the controlled tail.

Uncontrolled movement therefore does not itself consume held jump, clear grounded jump/mode/turn, compute new steering/velocity/extra acceleration, or perform the final speed publication. Existing body state can still be consumed by the earlier physics pass. Control-preparation410's explicit speed/velocity clear is a different event and must not be expanded into a per-frame reset of every field.

Fire421FB0: independent owner and timer

Owned fire uses complete+C0 interface4A3160; its normal3C4 target is421FB0. Owner is interface5FC=complete6BC; timer is interface600=complete6C0.

Site Recovered operation
421FB6..421FBD Same475CA0 gate. False returns4220BC.
421FCA Base40E050 callback before owner test.
421FCF..421FD7 Read owner5FC; no owner skips timer/energy/follow.
421FDF..421FE9 Query owner's support218; true sets remaining time0. Jimmy's support218 resolves458960, which accepts force-support interface4A0 or reads cached support13F via471A10.
421FF3..422003 Subtract dt and store timer, including when already zero/negative.
422009..422049 Strict positive result takes active visibility/energy path; nonpositive hides through complete58(1). Positive path may request complete58(0), then calls42A920 with−dt×.5. The complete70 visibility-related check is not a control gate.
42204C..4220B6 Copy owner logical position310 and Euler328 into fire314/32C even when timer is inactive/hidden.

Energy helper42A920 skips numeric VR01..VR08, otherwise adjusts global4F83D4 and clamps0..100; no controlled-pointer condition. A running timer can continue with zero energy, and landing zeroes it before subtracting dt. A controller that is skipped while raw NULL does not make the effect skip as well. The full421FB0 body checksum and absence of the5099E4 address are guarded by the helper; base resource/animation work is not replaced with a claim that all indirect operations are independent of every global state.

Collision-side cancellation still runs outside movement ownership

Before calling437940,424600 reads vertical velocity and, if positive, invokes complete1A4→425170. This source ceiling-ray/response path is outside raw ownership gates. On a hit it can change body velocity and invoke complete1E0→425120. In mode1,425120 clears jump complete7E8, requests FALL, zeros owned fire6C0 if present, then invokes complete140. Thus fire can be cancelled by collision during a cutscene even though ownership alone does not cancel it. Complete1A8→4252E0 also refreshes a source distance cache before437940. These are not yet a recovered full collision implementation, and must not be silently replaced by calling controlled air math during a cutscene.

After movement, complete1B0→425490 can maintain/replay a position history under its own flag; complete1B4→4255C0 has another flagged class-specific effect. Their full behavior remains outside this movement/effect split. A limited implementation must state that it does not reproduce every branch of424600.

Port consequence and verification boundary

The audited port gates its entire LabSimulation.Step on effective control, so it freezes both body and fire when uncontrolled. A justified partial correction is an explicit body/effect tick while suppressing Jimmy input/controller math, with control preparation applied at the actual CAM/MCA events. Do not send default input through StepPlayer: the grounded-release and steering changes above would run despite the source early return. Do not treat raw NULL as F1/practice pause. Modern force-control/noclip policy stays distinguishable from original ownership.

Four Python tests verify47 instruction sites,12 vtable targets and two whole-body hashes, plus source-gate/state projections with nondefault timers, absent owner, raw NULL/other actor, strict expiry and VR energy immunity. Run python3 -m unittest discover -s tests -p test_uncontrolled_player.py -v or python3 tools/binary/uncontrolled_player.py ../Original for reproducible JSON. These tests interpret immutable code; they do not execute the original callback, validate original cadence, prove full body response or compare complete cutscenes.

Remaining: full class-specific424600 branches, pre-control base/timer semantics, source collision-side ceiling/distance behavior, complete animation-end timing, global475CA0 flag owners and original end-to-end runtime comparison.