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

123 lines
8.1 KiB
Markdown
Raw 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.
# 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.