Files
Neutron/docs/gameplay/jimmy-cutscene-return-source.md
T

6.5 KiB

Cutscene completion and first resumed input: original boundaries

2026-11-05. User comparison: ordinary landing tilt occurs in the original; skipping Carl's laboratory conversation must leave Jimmy upright. Gameplay changes are paused for source recovery. The previous camera-entry correction is preserved; it did not verify neutral input after the scene ended.

Original EXE SHA256: f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8. Retained REA full-instruction Evidence: ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904. VA400000 is the preferred base; the guard uses PE sections for file offsets (the cited text offsets equal VA minus400000). Originals are read-only.

Recovered state owners

Boundary / VA (file offset) Original facts
Control118→475A40 (75A40) Load argument, store raw controlled pointer5099E4, return. No actor, movement-mode, turn or orientation reset.
DEFAULT447D34..447FC5 (47D34..47FC5) Restores raw owner through118; handles shared camera eye/UI/music and clears shared skip. Inspected code has no direct Euler/mode/turn reset or Jimmy Init.
MCA completion4311F0..43127F (311F0..3127F) Resolves named PlayerControlled/NULL/none, grants through118, cleans resources and dispatches the next trigger. A grant is not initialization.
Jimmy cleanup42AE00..42AE29 (2AE00..2AE29) Calls complete178, sets game1D65 and global4F8182. No direct movement-mode/turn reset.
Selected-gadget cleanup427FF0 (27FF0) Raw-1 is rejected by the unsigned range guard428027; raw3's table entry also reaches common tail42882F. That tail only restores selected-gadget sentinel-1 and returns. Bubble/vehicle branches have separate policies.
Menu prelude405FB0/406590 (5FB0/6590) The inspected selection/close callbacks manipulate menu resources. They do not dispatch a recovered Jimmy movement reset.
Player input438A60 (38A60) Dispatches by retained game704, after raw-owner and camera-bump gates. Complete124 is ground438BC0;128 is air439900; no derived Jimmy air override supplies a hidden reset.
Air target439DB7..439E33 (39DB7..39E33) Accepted pitch/current yaw/negative stored turn become destination Euler. This is a writer, not a render-only cache.
Grounded released controller437BA5/437BAC (37BA5/37BAC) Clears mode704 and turn614 after the raw-ownership gate. Null ownership therefore leaves these fields retained.

Jimmy complete object is game interface+C0. Game704/614 correspond to complete 7C4/6D4. Current and destination Euler retain their previously recovered separate owners. Complete table4A3BDC slots124/128/12C/130/134/140 resolve438BC0/439900/ 43A120/437C40/437F90/429910 respectively.

Input callback426030 has independent gates:407060 reads global4F8198,475CA0, raw owner,4F8430 and game1D2D precede438A60. The bounded camera/default paths do not establish a special first-resume write to4F8430 or1D2D. Known1D2D writes belong to hit lock (complete1DED, set42A820/clear42567F). Camera bump7C8 can suppress dispatch, but no inspected camera/default write proves it is seeded here. These are ruled-out local explanations, not whole-program absence proofs.

Skip is a distinct source path

The actual MCA update430DA0 tests a playing sound before entering its skip branch 430EED..431027. Escape509853, Space509858, controller509AC4 or shared skip4F83E4 can request it; nonzero4F8182 suppresses it. The accepted path resolves JIM1, sets complete1E00=1 at430F37, sets shared4F83E4=1 at430F3E, stops the sound, performs target-class/animation cleanup, deactivates the MCA, dispatches completionE4 at431012, and resets its shot index. CAM has the analogous latch/ flag writes at41613B/416142 and its own completion order.

The Jimmy byte is the shared input-action/menu debounce latch recovered in gadget controls, not a recovered orientation-reset flag. No claim is made that copying this latch alone fixes the tilt. DEFAULT clears shared skip at447D91 or447F89. The port's immediate SceneDirector.Skip/Drain fast-forward does not represent these per-actor/registry/input-latch boundaries. Its earlier comment labeling it an original chain skip overstates that coverage.

New REA pseudocode and limits

A generated EXE copy was opened by local REA/Ghidra12.1.4. Complete replies, Evidence export and closed snapshot are in artifacts/jimmy-cutscene-return/rea-completion/. New successful pseudocode:

Procedure Evidence
475A40 raw owner setter ev_3e6ebc517bdc52a7c2cd8af4475b837f2e7126f5a54a45e147356784b4e93eb7
438A60 retained-mode input dispatch ev_77ee22e6d49adc0c983af92ba74273faf5f4daf697ab520ea45d22b08bc11bcb
42AE00 cleanup wrapper ev_2ee50b10018363378445be32df38ab4f6b2125247b69485304867674d5d484da

DEFAULT entry447CF0 did not resolve to a Ghidra procedure; the provider then reported the numeric selector as an unmapped file offset. Its complete error is retained as00.json; no pseudocode is attributed to it. The guarded retained REA instructions support the DEFAULT statements above. No unchanged retry or claim that the whole original was executed follows from that provider result.

Port cause versus original explanation

The port diagnostic reproduces48 cases. On fresh input-before-player order, a grounded player returns with retained mode1/turn; first neutral air input republishes the old bank before the controller clears mode/turn. On retained order, the controller clears those fields first, avoiding that writer. This identifies a port cause. It does not prove that changing all scheduling or resetting turn on every control grant matches the original.

The complete original skip-to-idle frame has not been executed or fully closed. Remaining explanations include exact skip/input suppression, actor callback placement, contact/support state when the conversation starts and unmodeled wrappers. User observation takes precedence over assuming the local component composition describes the whole game. Further source recovery must explain why the original avoids the stale writer before another runtime patch is made.

Verification

tools/binary/jimmy_cutscene_return.py checks original identity,12 source sites, 12 virtual bindings and13 bounded spans. jimmy_cutscene_chain.py independently checks skip/contact/frame boundaries and actual lab records. Complete generated reports are under artifacts/jimmy-cutscene-return/source-contracts/. These are static byte/data checks. The48-case harness is managed port execution; no new original full-frame or native Windows observation is claimed.