Files
Neutron/docs/gameplay/jimmy-task-return.md
T

10 KiB
Raw Blame History

SCENE60 task broadcast and Jimmy's retained bank

2026-11-06. This investigation covers the task broadcast that Carl's talk progress runs before neutron1a activation. It provides no source-supported Jimmy movement reset and does not close the whole original skip-to-idle frame. No runtime, test, build-script or package change is made here.

Identity and evidence

Authoritative Neutron.exe SHA256: f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8. Retained REA complete instruction Evidence: ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904. The helper validates that Evidence's subject hash, the authoritative binary, PE-mapped source sites, direct calls, tables and actual GAM records. Addresses below are preferred VAs; the listed text file offsets equal VA minus400000, independently checked through PE sections.

JN-Engine's docs/decomp_ledger.csv and docs/gam_schema.md supplied class/table leads only. All17 matching FourCC registrations, constructor game-table stores and game424 targets are verified against the supplied original. JN-Engine's movement implementation is not used.

Assignment phases and direct Jimmy admission

Original VA / file offset Recovered owner/transition
413E5A,413E9D /13E5A,13E9D Carl progress queries SCENE;50 becomes60 through45F990. The friend talk caller subsequently dispatches the selected conversation. This is an entry phase, not an automatic skip-completion broadcast.
45F9EC,45F9F2 /5F9EC,5F9F2 SCENE milestone switch. Byte45FC48[60−35] is2;45FBF0[2] points45FA0B, which supplies objective arguments3,1.
406F50..406F88 /6F50..6F88 For positive objective id, clear44 dwords at4F7D00, store id4F8194, zero timer4F8188, store low argument byte at indexed objective flag. This complete leaf does not write modal4F8198 or input suppression4F8430.
45FB63..45FB8B /5FB63..5FB8B Traverse task records4FC5FC, case-insensitively match name, then store supplied state at record+64. Repeated assignments are not suppressed.
45FB8D..45FBE8 /5FB8D..5FBE8 Traverse registry50999C in list order. Compare supplied task against each game interface+430 TaskName. Only exact case-insensitive matches receive game424, synchronously.
458880..45888A /58880..5888A Plain task callback stores supplied state at own game494 and returns.
4A373C+420,+424 /A3B5C,A3B60 Jimmy binds post-task hook472970 (no-op) and task callback40E340. Actual lab JIM1 has TaskNamenone, so the SCENE60 broadcast never reaches its424 callback. The45F990 loop does not invoke420.

Actual gam/level1b.gam SHA256: 316fff40db565c2add5b07cbccdef640ddb67c64d6625fea1429ce2a0542a234. JIM1 is index0/raw8, TaskNamenone, RequiredLevel0, ExactLevel/RemoveLevel−1. Carl is index8/raw1455, TaskNameSCENE, RequiredLevel0, ExactLevel/RemoveLevel−1. Direct Jimmy exclusion alone would not prove that another listener cannot affect him; the following inventory addresses that gap.

All authored matching listeners

There are89 serialized SCENE listeners, spanning17 kinds and six callback targets. The generated source.json retains every record index/raw offset, tag, authored gate, callback and a50/60 gate comparison. This is an inventory of authored records, not a runtime census of constructor-created helpers or retained actors.

Callback VA / offset Kinds and matching count Recovered behavior
458880 /58880 3CAM,3MCA,3LIO,3NEU,3PAT,3SOU,STRT,LOAD:43 Store own TaskState. In particular, CAM/MCA task callbacks do not dispatch activation, prepare Jimmy, take control or play shots.
40CA80..40CA9D /CA80..CA9D 3AIT:14 Store own TaskState, query its own task name through45FEA0, discard query result and return. This callback does not call AIT trigger40C300 or grant control.
40E340..40E3D0 /E340..E3D0 3DUD,3BUT,3OMT,3TEL:9 Store own TaskState and apply own exact/required/remove activation gates through own complete110. Every matching authored instance in these kinds has all three gates−1, so50 and60 preserve existing activation.
45F2B0..45F3A5 /5F2B0..5F3A5 3PIC,3ANI:21 Store own TaskState; if its picture is uncollected, test own exact/required gate. Set own visibility, pickup-active byte and collision byte. No NextTrigger/ActivateObject/ToggledObject dispatch occurs in this task callback.
43EBB0..43EC07 /3EBB0..3EC07 3ROC:1 Run generic animated callback. If own linked pointer game680 is nonzero, set own rendering/effect and collision flags. The inspected callback tests that pointer without dereferencing it as another actor. Authored exact/required/remove gates are all−1.
413F30..41411E /13F30..1411E 3CAR:1 Query new SCENE, run generic activation, then LV1B override on Carl. At60, resolve CARLESC3, set Carl AIstate6 and copy marker root to Carl, then leave base activation unchanged.

For the pickup/sprite paths, shrinkray (required0), the unnamed animated sprite index72 (required0) and the late pickup index120 (required140) preserve the same gate outcome at50 and60. apple (exact30) is disabled at both. All remaining matching pickup/sprite records have required/exact−1 and preserve state. Actual collection table4F8438 and live visibility are not reconstructed by this authored gate calculation. All21 callbacks can still store their own TaskState on repeated assignments.

The source helper records exact game tables and constructor/registration sites for all17 kinds. Representative bindings include AIT48F8C0+424→40CA80, CAM497BFC+424→458880, MCA4A8F64+424→458880, PIC4AE548+424→45F2B0, Rocket4B25AC+424→43EBB0, Carl495364+424→413F30 and LOAD4D025C+424→458880.

Activation dependencies and state ownership

The inspected callback tails do not contain a Jimmy mode704/turn614/Euler reset or a raw control-pointer grant. Their relevant indirect calls keep the listener as this:

  • Animated complete110→40E3E0 controls that actor's display and collision. Its complete10C hook is472970 for the matching Button/DUD/OMT/TEL/Rocket classes. Carl's hook413D60 is an own-animation resource/preparation path, guarded by its own complete635 loaded byte; it requests Carl's STOP and sets Carl's motion parameters. It does not invoke a cutscene or Jimmy cleanup.
  • Own game3A4/3AC→473030/4730E0 forwards false/true to own game224. The common224→471A40 only writes own game140 collision-enabled byte. Own game214→471A00 writes own game13E, and pickup game1F4→471980 writes own game134. These are flags, not immediate collision-pair callbacks.
  • Carl complete124→4089B0, state6, enters the408AC2 branch when eligible. Its own game410→40A6B0 preparation clears Carl velocity/speed. Carl game314→472360 copies Vec4 only to own game214 root. Neither receiver is Jimmy. Equal/locked-state branches remain local as well.
  • Display slot58 forwards to OMT resource visibility. This report does not execute the complete OMT renderer/animation graph or claim arbitrary engine observers have been exhausted. The recovered task callbacks themselves do not publish another actor's Euler/mode/turn or trigger a camera chain.

This closes the proposed direct SCENE60 task reset explanation and the authored CAM/MCA/AIT activation explanation. It does not establish the original first resumed frame or justify a blanket rotation reset, actor rescheduling or new input suppression. Later UI consumers of objective flags, runtime-created listeners and the full original registry remain separate observation boundaries.

Bounded native verification

jimmy_task_return_probe.c executes original45F990 assignment/dispatch, 406F50 objective selection and458880 state store from a private mapped copy. Only original absolute operands/jump-table targets needed by this finite path are relocated. Task and registry lists, game objects/vtables and _stricmp transport are explicit synthetic adapters. Matching actor callbacks in this probe are adapters, not actual Carl/pickup/Rocket/engine callbacks; those paths above are statically recovered.

All48 cases pass, varying prior task50/60, authored-like Jimmy tasknone versus synthetic matchingSCENE, movement mode0/1, turn−12/0/+12 and both modal/input-flag seeds0/1. Each callback observes assigned task60 and already selected objective3. Authored-like Jimmy receives zero callbacks and remains byte-for-byte unchanged across all1F00 bytes. Synthetic matching Jimmy's only change is own game494 TaskState. Modal4F8198 and input suppression4F8430 retain both tested seed values; objective timer4F8188 becomes zero.

Final capture reports wineExit0 and JIMMY_TASK_RETURN_COMPLETE; parsed output and provenance are in artifacts/jimmy-task-return/native-observations.json. The probe binary, generated source, complete copied EXE identity, static guards, Wine log and capture metadata are hashed there. No original startup, full Carl talk, skip, body, input/controller or renderer executes in this probe.

Initial capture timed out during Wine prefix creation. A missing-module repair then failed kernel32 loading. The successful run uses a copy of the previously successful generated Carl-contact Wine32 prefix. Logs for failed setup attempts and prefix repair/reuse metadata are retained; none is gameplay evidence. Original files were not modified or executed in place; isolated runs have no network or original-directory mount.

Reproduction

From GamePort, with the existing local REA Evidence and Wine32 tooling:

python3 tools/binary/jimmy_task_return.py ../Original \
  --rea artifacts/jimmy-movement-audit/rea-original-disassembly.json \
  --output artifacts/jimmy-task-return/build
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wl,--image-base,0x10000000 \
  -I tools/binary artifacts/jimmy-task-return/build/jimmy_task_return_probe.c \
  -o artifacts/jimmy-task-return/build/probe.exe
python3 tools/recon/reference_capture.py --asset-probe \
  --probe-executable artifacts/jimmy-task-return/build/probe.exe \
  --probe-success JIMMY_TASK_RETURN_COMPLETE --seconds 12 \
  --output artifacts/jimmy-task-return/probe

A fresh Wine prefix may need more time for initialization; successful completion requires both marker and process exit0, not merely screenshots or a returned wrapper.