Files
Neutron/docs/gameplay/jimmy-derived-frame.md

3.4 KiB
Raw Permalink Blame History

Derived Jimmy frame around the controller

2026-11-06. This closes a caller-level omission in the earlier component composition; the lifecycle correction is separately established by menu/player lifetime.

Canonical EXE SHA256f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8; retained REA instruction Evidence ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904. The guard verifies14 source sites,21 virtual bindings,15 ranges and the actual controller call. Text file offsets below equal preferred VA−400000; the helper PE-maps them independently.

Source boundary Recovered ownership
424600..424D10 /24600..24D10 Actual Jimmy game3C4 caller. Null raw control closes/hides helper UI and stops sound handles. It does not itself clear movement mode or stored turn.
424721..424751 If the menu exists and shared4F8181 is set, poll menu4A8→403A10. State2 calls menu460; both state2 and other states return before the controller. This lock is distinct from raw ownership.
424767 complete208→424D10 Objective/UI helper before the controller. The separate objective presentation does not set modal input gate4F8198; that explicit-modal opener is406F90. See objective-timing.md.
424BFC complete1A4→425170 Upward world query/velocity handling. Its falling callback425120 maintains mode1; it is not a grounded resume reset.
424C08 complete1A8→4252E0 Downward/shadow-distance query and own helper state.
424C2B complete194→42AAC0 Airborne sound cleanup.
424C34→437940 Actual ordinary player wrapper. The source ownership/support/input-order conclusions remain here.
424C3F complete1C8→424E80 Invisible upkeep, with its own mode gate and ordinary non-Invisible return.
424C88 complete1B4→4255C0 Impact/material helper; world-hit dependencies remain separate.
424C94 complete1B0→425490 History/position correction. Calls game314→472360 Vec4 root setter; this is not an Euler setter.

jimmy_derived_frame_probe.c executes the complete derived caller and ordinary helpers on private copied source.437940 is a recording adapter, upward/downward world queries return no hit, and menu/resource/visibility transports are explicit adapters. Thus these cases test what the caller changes outside its controller, not another execution of the controller/body/whole game.

All50 cases pass:48 combinations of raw ownerNULL/Jimmy/other, menu lock0/1, menu state1/2, supported0/1 and rising0/1, plus two180-tick unlocked intervals. The caller dispatches the controller only while the menu lock is clear; raw ownership is passed onward rather than becoming another caller-side gate. Mode1, turn11.666668 and distinct current/destination Euler stay unchanged outside the recorded controller. Queries and menu-close callbacks have checked counts.

Artifacts: artifacts/jimmy-derived-frame/native-observations.json binds generated source, executable, source contracts, original identity, capture metadata and log hashes; capture wineExit0 and JIMMY_DERIVED_FRAME_COMPLETE are required. Primary integration reran the parser/guards and verified all50 cases. No full body/world hits, OMT playback, native Windows or actual original Carl frame is claimed.

python3 tools/binary/jimmy_derived_frame.py ../Original \
  --output artifacts/jimmy-derived-frame/build \
  --rea artifacts/jimmy-movement-audit/rea-original-disassembly.json \
  --capture artifacts/jimmy-derived-frame/probe