Files
Neutron/docs/gameplay/jimmy-base-return.md

9.7 KiB
Raw Permalink Blame History

Jimmy base, animation completion and STOP during cutscene return

2026-11-06. Bounded original-code investigation of the dependencies omitted by the skip composition. No runtime change or new rotation reset is justified by these results.

Identity and evidence

Original Neutron.exe SHA256 f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8. Retained complete REA instruction Evidence ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904 is reused and its subject hash verified. The helper verifies original identity, virtual bindings and PE-maps the source ranges. Addresses below are preferred EXE VAs; the listed text file offsets equal VA minus400000.

JN-Engine's C3DAnimated/C3DPlayer/C3DJimmy reports supplied indexing leads. The conclusions here come from authoritative bytes, retained REA instructions and the bounded native execution, rather than its reconstructed movement.

Recovered base/update contract

Boundary / VA / file offset Original ownership and effects
Jimmy424600..424D10 /24600..24D10 The ordinary derived frame callback eventually invokes437940 at424C34. Its null-control prelude handles helpers/menu/sound; the inspected function contains no direct mode704/turn614 reset. It also calls other Jimmy helpers; this is not a full execution proof of that frame.
43796A→40E050 /3796A→E050 Player wrapper invokes animated base before its raw-owner identity gate437A1B. Base behavior therefore remains relevant while raw control is null.
40E050..40E1C8 /E050..E1C8 Global readiness gate; one-time pickup-link work; common object update462520; optional authored-transform pin when game58C CanMove==0; animation clock/completion check. No direct movement-mode/turn reset. Actual lab JIM1 CanMove is1, as the earlier supplied-GAM investigation records.
462520..462649 /62520..62649 Optional body-context/current-root bridge, then458930→473240. A missing body context skips the former bridge but still reaches the common update.
473240..473298 /73240..73298 Calls game3D4→4732B0 to maintain sound handles, expiration callback if its timer expires, then game3D8→43A420 facing.
40E162..40E1C0 /E162..E1C0 Requires both game574/575 readiness bytes. Increments game4C4/complete584 clock. If completeAD play-loop is0 and game56C/complete62C record exists, current frame at least record48−1 calls complete104. There is no completion latch here.
complete4A3BDC+104→43A900 /A3CE0→3A900 Actual Jimmy animation-ended callback. Tests current action through complete100→40DF80. STOP, ordinary talk and FALL do nothing in this callback.
43A92E..43A9A9 /3A92E..3A9A9 FENCE/LADDER completion selects STOP, clears shared4F83E0 and special timer, invokes Stop, clears special movement fields, restores saved position through game314, and enables body state. No mode704/turn614 or Euler reset.
43A9CA..43AA38 /3A9CA..3AA38 SPLAT/HIT completion selects STOP; HIT additionally clears shared4F83E0/special timer. This is not an ordinary scene-return rotation reset.

The optional body-context bridge in462520 has not been exercised with a real world/body here. Its current-root writes and any level callback side effects remain a separate boundary; a null synthetic context must not establish their absence in the whole original.

STOP is two different entry paths

Script preparation's game410→42AFC0 is not the same entry as assigning a target deactivation animation through completeE0:

game410 ->42AFC0
  ->43A750: speed608=0, velocity XYZ via2C4->471F40, sound148->429A00
  ->sound148->429A00 again
  ->complete150->43AFF0("STOP"): action acceptance
      ->completeE0->40DD90("STOP",1) if accepted

TargetDeactAnim STOP ->completeE0->40DD90("STOP",1) directly

43AFF0 first rejects an unchanged current action and protected HIT/SPLAT/FENCE/ LADDER/other special states; it then recognizes STOP at43B28A. Its accepted STOP branch stops sound, selects the animation and clears acceleration through game278. There is no mode/turn/Euler reset. A Stop call can therefore clear speed/velocity while its STOP animation request is rejected. Direct animation selection has a distinct acceptance boundary.

Selection dependency / VA / file offset Recovered effects and limits
40DD90..40DF7C /DD90..DF7C Requires complete634/635. Resets local animation clock; may bind the selected shape, call completeC8 shape refresh and preserve scale; builds the resource key with HI/LOW prefix; finds the animation record; updates name/record; dispatches completeE4 with start frame/repeat and completeC0 with animation definition. No movement-mode/turn/Euler reset in this procedure.
completeC8→462270 /62270..62331 Reads bound shape radius and bounds. Calls game110→471240, game2E8→472120 and game2E0→4720C0. The latter setters write game1D4/1C4 bounding vectors, not Euler or destination Euler.
completeE4→40DA30 /DA30..DAAD Calls morph subobject frame/repeat and pause methods, mirrors loop byte completeAD, selects frame metadata if present. No mode/turn/Euler reset.
completeC0→47ED54 /7ED54 OMT animation-definition transport is represented by an explicit resource adapter in the probe. Full DLL animation playback is not executed.

Native observations

tools/binary/jimmy_base_return.py and _probe.c generate a private mapped-source probe; it runs in the existing network-isolated Wine32 copy environment. Original files are neither modified nor mounted in that execution namespace. The final run emits the required success marker and exits0. Post-capture Python assertions validate 140 finite cases:

  • 84 base cases: seven action names STOP/TALK/FALL/HIT/SPLAT/FENCE/LADDER, three readiness states, loop0/1 and before/at-final-frame. Each runs180 actual base/common/facing updates. Both Euler vectors stay(0,155,0), movement mode1 and stored turn11.666668 survive. Eligible non-loop completion is called180 times. The action-selection adapter in this matrix records/copies the new action name without changing playback flags; repeated completion here is deliberately not a claim about the full selected animation's playback.
  • 56 STOP cases: same seven initial actions, readiness off/on, record absent/ present and game410 Stop versus direct completeE0 selection. These execute actual42AFC0,43A750,429A00,43AFF0,40DD90,40DA30 and462270 as applicable. STOP selection/frame/pause paths are checked, including protected-action rejection versus direct selection. Mode/turn and initially distinct Euler vectors remain unchanged. Non-direct Stop clears speed and velocity. After an explicit synthetic upright seed, another180 actual base updates retain upright vectors and the old mode/turn. Successful real STOP selection sets loop1, so this interval has no animation-ended callback.

Base cases execute the actual462520 chain with a synthetic null body-context pointer. The pickup link is marked checked, CanMove is1, sound handles invalid, timer0 and facing dirty0. Resource lookup, shape/animation binding, shape bounds, morph current-frame/frame-set/pause transport and special Stop/restore/enable callbacks are explicit adapters. Actual action-name getter and string comparison semantics are used. These are original components on synthetic state, not actual Carl startup, body integration, registry scheduling, a full Jimmy frame, OMT playback/rendering or native Windows gameplay.

Consequence and remaining question

The omitted base completion and accepted STOP request paths do not supply a hidden ordinary-mode or stored-turn reset in these bounded source cases. The successfully selected STOP loop also prevents a later completion callback from quietly repairing those fields. This strengthens the existing composition's retained-state interpretation; it still does not establish the actual original first resumed input order or entry state.

Preserve the evidence gate. The next comparison must identify a real divergence in entry/contact state, registry/frame placement, input eligibility or the remaining live body/derived-frame context before changing the port. A blanket rotation reset or switching all fresh sessions to retained ordering is not supported by this result.

Artifacts and reproduction

  • artifacts/jimmy-base-return/build/source.json: source ranges, PE offsets, hashes, virtual bindings and retained REA excerpts.
  • artifacts/jimmy-base-return/native-observations.json: all140 case records and source/probe/log/capture hashes.
  • probe/wine.log and probe/capture.json: final success marker and exit0.
python3 tools/binary/jimmy_base_return.py ../Original \
  --output artifacts/jimmy-base-return/build \
  --rea artifacts/jimmy-movement-audit/rea-original-disassembly.json
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wl,--image-base,0x10000000 \
  -I tools/binary artifacts/jimmy-base-return/build/jimmy_base_return_probe.c \
  -o artifacts/jimmy-base-return/build/probe.exe
python3 tools/recon/reference_capture.py --asset-probe \
  --probe-executable artifacts/jimmy-base-return/build/probe.exe \
  --probe-success JIMMY_BASE_RETURN_COMPLETE --seconds 12 \
  --output artifacts/jimmy-base-return/probe
python3 tools/binary/jimmy_base_return.py ../Original \
  --output artifacts/jimmy-base-return/build \
  --rea artifacts/jimmy-movement-audit/rea-original-disassembly.json \
  --capture artifacts/jimmy-base-return/probe

First-run prefix setup exceeded its initial capture interval; the initialized rerun established the84 base cases. The expanded resource adapter initially expected STOP instead of the source's HISTOP lookup; that harness assertion was corrected before the successful140-case capture. Source virtual bindings are checked before compilation. No failed harness/setup attempt is original gameplay evidence. No runtime/shared documentation edit or commit is made by this agent.