Trace Carl lifecycle and add read-only original state observer
This commit is contained in:
1 parent
c642b69849
commit
4cd62d3627
28 files changed
+2387
-5
No files matched your search
@@ -0,0 +1,148 @@
|
||||
# Jimmy base, animation completion and STOP during cutscene return
|
||||
|
||||
2026-11-06. Bounded original-code investigation of the dependencies omitted by
|
||||
[the skip composition](jimmy-skip-composition.md). 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.
|
||||
Reference in new issue
Block a user