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

52 lines
3.4 KiB
Markdown
Raw Permalink 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.
# 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](main-menu-player-lifetime.md).
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.
```sh
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
```