Recover retained route state and complete PostLoad availability tails

This commit is contained in:
UnixNight committed 2026-10-26 03:58:52 -04:00
1 parent 1dddfefc68
commit 9ad5a8ef6b
36 files changed
+1559 -32

No files matched your search

+5
View File
@@ -18,6 +18,11 @@ Implementation continuation: [level-game lifetime](level-game-lifetime.md),
[retained character resets](retained-character-reset.md), and
[player phase implementation](player-phase-implementation.md). These supersede
the old-game-removal question and record the first C3/C5/C7 implementation chunks.
The retained-field continuation adds [property reader](retained-streamer.md),
[RETURN cleanup and full availability tails](retained-return-cleanup.md),
[player body/scalar boundary](retained-player-body.md) and
[companion/shadow resets](retained-companion.md). It corrects the earlier
availability-prefix interpretation and implements bounded route scalar carry.
Evidence labels used throughout:
+4 -3
View File
@@ -14,7 +14,7 @@ runtime comparison. Coverage does not mean implementation completeness.
|---|---|---|---|---|
| LOOP | Viewport47E4F0 physics before registry473740, including input44DF80; second sync473770; construction order and selective retained-character/new-game ordering. Separate engine morph clock. | Player now integrates prior body state, then fresh input/player/fire or retained player/fire/input. Other systems remain grouped; fixed60Hz policy. | S/M/R. Controlled player partial order implemented; full registry/cadence and uncontrolled-body preparation open. | C3 continue other callbacks and morph/control phases; C4 support/response remains separate. |
| INPUT | Game interface+8C slot3C4→44DF80→475A70 reads controlled5099E4 and calls3CC; Jimmy interface+C0→426030. | SDL arrows/jump aliases; control gate, modern debug override; mouse/controller incomplete. | S/M/R, user Windows route. Input occurs in object traversal after physics; device sampling/focus and latency open. | Trace event pump, key/mouse and focus gates alongside retained registry order. |
| MOVE |437940/439900 ground/air arithmetic; physics479D20 consumes queued impulse once before acceleration/gravity. | Recovered arithmetic placed in same-tick controller→physics; fixed dt, custom yaw/model conventions. | S/P/M/R. Local arithmetic evidence does not validate enclosing phase. | Split pending velocity/impulse only after C3 oracle. |
| MOVE |437940/439900 ground/air arithmetic; physics479D20 consumes queued impulse once before acceleration/gravity. | Controlled player consumes prior body state before callbacks; fresh/retained input order explicit. Fixed dt and custom yaw/model conventions remain. | S/P/M/R. Controlled partial phase split verified; uncontrolled/full registry and body response open. | Continue C3 uncontrolled phases, then C4 support/response. |
| JET |437F90 controller;421FB0 effect; fresh constructor order places fire after Jimmy, both after global physics. States0..5, hold>.4,8s, energy. | Explicit state table with post-collision effect ticking and VR immunity. | S/M/R. Fresh same-pass countdown recovered; retained child lifecycle, sound and expiry→animation open. | Trace retained Jimmy/fire resets and phase end events before scheduler integration. |
| COLL |479D20/47BD80 body response; support and quick magnitude; dynamic boxes; NC-shape registration exclusion. | Source support and box pieces around modern swept24-unit capsule, feet/root grounding and slide. | S/P/M/R. Response/masks/stairs/contact order not fully recovered; source radius60 is not port capsule24. | C4: isolate response and root convention; replace adapter behind route tests. |
| ANIM | Engine morph10002DB0; linear interpolation10002F9A; game logical→OMT sync4624B0. | ASE sample timing, unconditional loop closure, pose/action aliases,1/60 advance. | S/P/M/R. Playback flags, rate, completion callbacks, transition order open. | Recover one-shot/loop/end notifications before more aliases. |
@@ -23,8 +23,8 @@ runtime comparison. Coverage does not mean implementation completeness.
| CAMERA | Shared viewport; strict>1000 DEFAULT snap; source eye correction/gain; first wall-grid hit then general-grid FIFO; per-level far planes. | Static source query now integrated for the three route scenes; other scenes use provisional sweep. Separate chase/script eyes and merged clip maximum remain. | S/M/R. Query/kernel/counts tested; x87 boundaries, shared handoff/previous-eye and input branches open. | C5 next shared viewport/DEFAULT and complete follow state. |
| AUDIO | CAM416776..E1 stops music; DEFAULT447F12..45 restarts; bank696008 / gate4F8434; handle47D890 polls inherited software duration and repeat+30. | Separate SDL streams, floating-file-duration cutscene completion, independent per-file SFX. | S/M/R (dummy streams). Source duration/allocation/play-failure/bank/attenuation lifecycle incomplete; speakers/native Windows timing not verified. | C6: explicit bank owner and software channel-clock tests; SDL queue-empty is not the source oracle. |
| UI |406F50 selector/timer;4043D9 controlled clock;407070/O edge;404D97 practice resume.44 objective flags distinct from selector. | Timed objective subset, modal practice, modern UiViewport/debug. | S/M/R. Other flags/gadgets/highlights/cursor/energy/layout transitions open; source widescreen not recovered. | Keep modern scale policy separate; recover UI dispatcher/mode gates before expanding. |
| LOAD | CEditor deferred scene request; selective teardown/reuse; Init stored+11→live+139 resolves old-game deletion; Jimmy/Goddard retained. RETURN root/flags and per-object28→40C. | Snapshot/reconstructed scene state with retained input-order identity; app-owned presentation. | S/M/R. Old-game removal closed. Per-field/helper resets and fades remain;50988A is editor R input. | C7: retained-field/route lifecycle fixtures, then state-container integration. |
| INVENTORY | PostLoad423DEF..423EC1 enables eight owned gadgets4→1, then VR01..08 disables1→4; other values/items preserved. | Availability pass now applied at level entry and verified across TSK tutorial/return; snapshots preserve raw values. | S/M/R. Full selected-gadget/UI and retained scalar state remain incomplete. | Keep availability separate from ownership, task changes and arbitrary state carry. |
| LOAD | CEditor deferred scene request; selective teardown/reuse; Init stored+11→live+139 resolves old-game deletion; Jimmy/Goddard retained. RETURN root/flags and per-object28→40C. | Reconstructed scene with retained input-order identity and bounded mode/hold/fire container; app-owned presentation. | S/P/M/R. Property stream and bounded scalar/companion resets closed; full body/helper timing and fades remain.50988A is editor R input. | Continue body registration/helper traversal and uncontrolled scheduling; other gadget/level branches remain gated. |
| INVENTORY | PostLoad common prefix enables eight owned gadgets4→1, then VR01..08 disables1→4; full tail re-enables the practice gadget. LV1B disables1/7; other wire values preserved. | Availability pass now applied at level entry and verified across TSK tutorial/return; snapshots preserve raw values. | S/M/R. Full selected-gadget/UI and other level tails remain incomplete; bounded route mode/hold/fire carry is implemented. | Keep availability separate from ownership, task changes and arbitrary state carry. |
| SAVE | TSK45FEE0 writer /4603F0 reader; records, arrays, return strings, stored departure root; queued460E70→460EA0. | Original-format round-trip and CLI save, scene snapshots; no full source save UI/load lifecycle. | S/M. Source reader duplicates matching task callback then all-entity420 post-task hook; this is distinct from Jimmy placement PostLoad423A90. Current fresh-director path differs. | C7 after C1/C2; test repeated callbacks before adopting loader behavior. |
| CHECKPOINT | Pickup42AF00 stores+1E38 root/+1E48 level separately from+9A8 RETURN root. | Capture exposed, not used for return; source capture consumers unknown. | S/M. Do not interpret as death/respawn until read consumer found. | Track unresolved consumer; no speculative gameplay. |
@@ -41,6 +41,7 @@ runtime comparison. Coverage does not mean implementation completeness.
| Pickup checkpoint complete+1E38/+1E48 | Pickup callback42AF00 writes; read consumer not proven | Do not equate with departure root or invent reset/respawn semantics. |
| Music/effects/cutscene voice | CAM takes bank/voice and stops music; DEFAULT restores source defaults | Runtime bank/handle lifetime, not task ownership; current port independently opens WAVs. |
| Viewport/camera target | CAM/MCA target/eye; DEFAULT snap and follow; clip/layer resource settings | Original camera handoff is shared viewport state; baseline chase and scripted cameras diverge. |
| Jimmy mode/hold/owned-fire timer | Constructor, controller/fire ticks; property/Init/PostLoad/cleanup boundaries traced for supported route states | Ordinary route container retains these scalars; jump/body reset independently. TSK/debug checkpoint load carries none. First grounded tick can clear retained mode/timer. |
| Modern application presentation and debug | RenderSession keeps window/GPU; debug visibility across loads | User-authorized session policy, outside original TSK or gameplay claims. Scene audio/gameplay disposed/recreated. |
## Assumptions and symptom-level adapters to replace
+19
View File
@@ -81,3 +81,22 @@ allowed where it resolves a core-system question, without waiting for every leve
unavailable; source full integration validated above. Package evidence recorded
separately without changing runtime. Continue the remaining source-state and
shared-camera/control/collision gates rather than resuming feature expansion.
- Retained-field continuation2026-10-26: property extraction has no hidden reset
callback; generic Init re-applies authored body vectors, final preparation clears
velocity/speed, Jimmy jump state resets separately from mode/hold/fire. Bounded
route/no-gadget/jetpack PlayerLevelState now carries only those three scalars
through ordinary transitions, never TSK loads. Companion/shadow reset fields and
same-state AI guard are documented; body registration/new-helper timing remain.
- Corrected C7 prefix-only availability: full VR01..08 tails re-enable the practice
gadget0..7, so owned VR04 jetpack finishes1. LV1B disables gadgets1/7. Managed
state boundaries/unknown values and GPU practice/RETURN guard the correction.
Other level-specific selection/availability tails remain an explicit gate.
- Retained continuation validation:84 Python,22 movement plus remaining managed
groups,26 enabled-validation GPU renders, final nondefault tutorial/RETURN
boundary replay, four final SDL dummy checks and539 original hashes pass.
Original43A750/vector leaf component probe passes in isolated Wine32; this is
separate from whole-loader/original-game/native-Windows validation. Next gates:
uncontrolled body/controller/fire scheduling, body registration/helper traversal,
C4 response/root and shared camera handoff. See progress.md for test-race details.
+12 -1
View File
@@ -9,6 +9,17 @@ checks individual bytes, virtual targets and source route GAM properties.
This report distinguishes proven local resets from fields whose enclosing
retention/property/callback semantics remain unresolved. No runtime code changed.
## Superseding continuation (2026-10-26)
The bounded investigation below was an initial local-prefix audit. Its old claim
that VR04 finishes with jetpack state4 is incomplete: the full level-specific
PostLoad tail re-enables the practice gadget, so owned jetpack finishes state1.
LV1B additionally disables gadgets1/7. See retained-return-cleanup.md for all
VR01..08 tail calls. Runtime/tests now apply those complete tutorial/route rules.
Property callbacks and bounded scalar carry are closed by retained-streamer.md,
retained-player-body.md and retained-companion.md. Later sections preserve the
initial evidence and explicitly limited scope, not the current final-state claim.
## Enclosing ordinary-load phases
The common loader evidence remains `scene-loader.md`: selective teardown, GAM
@@ -128,7 +139,7 @@ owned1→4; return lab converts4→1. The VR04 powered-jump path bypasses the no
inventory state guard, so source state4 here does not imply the tutorial jetpack
should fail. Lab→outside similarly normalizes these group0 entries; tasks, score
and acquired-table state remain independent. The audited baseline lacked this
availability pass. Continuation now calls `SceneInventory.ApplyLevelAvailability`
availability pass. The first continuation called `SceneInventory.ApplyLevelAvailability`
once on level entry, before starting the authored sequence, and preserves raw
values in constructors/snapshots and arbitrary task assignments. Managed tests
cover every VR01..08 code, all relevant/unknown state boundaries, both untouched
+127
View File
@@ -0,0 +1,127 @@
# Retained Goddard and shadow: ordinary-load reset trace
Static investigation,2026-10-26. Original EXE SHA256
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
All VAs below are in this EXE at preferred base400000; inspected raw offsets are
**VA−400000**, independently PE-mapped by `tools/binary/retained_companion.py`.
No original code was executed. No runtime implementation was changed.
## Identity, caller and property boundary
Goddard complete vtable49F920 is installed at41C866; its game-interface table
49F480 is installed at41C883 with complete+C0 receiver. Shadow complete table
4B3C1C/game-interface4B37B8 are installed at43F6A0/43F6AD, interface complete+C8.
Constructor retention/reuse writes remain as recovered in scene-loader.md:
Goddard41C99B..41C99E passes0 to470F40, and41C9C0 sets complete+C9=1.
These are constructor facts, not repeated initialization.
The route GAMs level1b.gam/LV1B, VR04.gam/VR04 and level1.gam/LEV1 contain **no
3DOG or3SHA serialized records**. Their bounded GAM parses/hashes are emitted by
the helper. Consequently ordinary reuse on this route does not stream a new
Goddard/shadow property record. The app's per-object Init28→PostLoad40C registry
pass still runs on their retained interfaces (scene-loader.md). A fresh companion
is dynamically constructed by Jimmy PostLoad when his interface95C pointer is
null:423C6A tests it;423C98 calls Goddard constructor41C810;423CAE stores it.
Existing pointer takes423CD4..423CE2 instead, discussed below. Exact same-pass
handling of a newly appended companion remains a registry-order question.
## Goddard Init and PostLoad
49F480+28→41E6A0 tail-jumps407EB0. At407EB3 it calls generic4587F0;407EB8 sets
interface byteA=1;407EBC..407EC2 copies authored87C→current AIstate608;
407EC8 clears current waypoint800. Complete offsets add C0. This replaces current
AI state and waypoint, not all AI fields. In constructor41C90E/41C914, current
complete6C8 and authored complete93C both start4.
49F480+40C→41E590 calls shared actor409480 at41E593. Its local work, in order:
| Source VA / raw coordinate | Reset or refresh |
|---|---|
|409486 /9486|Call generic40E7B0 visibility/animation policy; not a constructor.|
|40948B..40949A /948B..949A|Resolve tag string interface6AC through474070; always assign resulting pointer to600.|
|4094A0..4094FD /94A0..94FD|Only if pointer nonnull: refresh610 from target+404 (identity) and828/82C/830 from target logical root310. Null pointer leaves those cached fields untouched locally.|
|409503..40951E /9503..951E|Snapshot current608→authored87C; invoke complete124(current608), target4089B0.|
|40952D..409552 /952D..9552|Read authored Euler via interface170→4716A0 (FC/100/104/108), write logical Euler via32C→472450 (224/228/22C/230).|
|409561..409580 /9561..9580|Read authored Euler again and copy all four words into interface274/278/27C/280. This is an Euler-cache write, not sufficient evidence to name274 a queued physical impulse.|
The state setter4089B0 is not an unconditional state-entry callback. After its
special complete970 guard for requested states0/6,4089F8 copies current6C8 to
previous6CC and assigns requested6C8;408A18 skips transition cases when equal.
Init has already assigned current from authored, and PostLoad passes that exact
current value back. Therefore this chain does not justify replaying arbitrary AI
state-entry side effects at scene load. Intervening source callbacks could change
state; those require their own ordered fixture.
Goddard's derived41E590 then applies level policy:
| Source | Normal LV1B/VR04/LEV1 branch |
|---|---|
|41E598|interface918=1500 (range; exact consumer semantics remain separate). VR06 substitutes3500 at41E5EE.|
|41E608..41E613|If render attachment exists, set complete70=1 and dispatch complete58(0), the existing show/unhide path.|
|41E618/41E624|interfaceD0(1) and214(1); setters4710C0→471A40 and471A00 write authored/live movement/collision flags.|
|41E632|interface2C initialization/sync dispatch42AB50, which gates4623D0 on interface49E. Body re-registration internals remain in the physics investigation.|
|41E637..41E63B|complete17C(0)→41CC30: select submode0, copy globals4F8200/204/208 into complete6D4/6D8/6DC, set WORD complete9A0=0. These are table-sourced resets; do not invent numerical values from uninitialized file storage.|
|41E641/41E64A..651|interface914=1; interface110(130)→471240 writes authored34 and264→471B40 writes live15C.|
|41E657|interface928=0.|
Hidden branch41E661 applies to LEV6,LEV7,LV1C,LV1D,LV4A,LV6A. It calls complete58(1),
interfaceD0(0),214(0), and sets928=1. It does **not** locally assign130 radius or
submode0; carrying an old radius is not equivalent to resetting it to0. The helper
includes exact comparison immediates and a bounded branch oracle, with neighbors
tested. These later-level predicates are recovered locally, not proof of those
levels' full behavior.
## Existing companion174: rotation, not velocity
Jimmy423CD4 addsC0 to the existing companion pointer and passes three zeroes to
its interface174 at423CE2. 49F480+174→4716D0 writes authored EulerFC/100/104,
dispatches330→472420 to logical Euler224/228/22C, then3E0→4624F0→473540 to convert
logical Euler and dispatch render angle sync3E4. It is a rotation reset. Calling
it a velocity reset would conflate distinct coordinate fields.
Thus the source can zero Goddard's authored orientation before his own retained
PostLoad later copies authored→logical/cache. This report establishes both local
mutations; precise registry placement must determine their temporal order. Jimmy's
separate STRT/RETURN root placement still owns companion position, as already
documented. No broad body-velocity reset is inferred from174.
## Shadow PostLoad and resource lifetime
4B37B8+28→4587F0 generic Init;40C→43F810 first calls4354C0 at43F814. That base:
-4354C3..4354CA resolves authored database name interface4BC using46ACC0.
-If found,4354D6..4354F5 calls completeC8→464430 with resolved database,
authored interface4B8 resource selector and float-converted4B4. If a resulting
attached object exists at complete8C (interface−3C),435503..435513 sets its60/64
to1 and calls its embedded interface24 slot10.
-If the first database lookup fails,435518 tries literal4F02C0
`permanenticons.omt`; if found43553F..435542 attaches selector3 with the same
float-converted4B4. If both fail, no attachment dispatch occurs locally.
43F819..43F844 then converts signed authored WORDs interface520/522 into complete
AC/B0 runtime size;43F84A/43F854 resets completeB4=2 andB8=0. If global509A13 is
set,43F867..43F86B calls complete58(1) to hide. This refreshes visual-resource
references and size/flags, so retained identity does not mean retaining the old
scene's texture/database handle. No local owner-pointer reset is proven; full
database teardown/reattachment internals are separate.
## Implementation and remaining gates
Current port reconstructs companion/animation/patrol objects on scene continuation
and explicitly restores RETURN roots. It does not model this complete retained
Goddard/shadow lifecycle. Existing patrol remains a subset: state4 follow, source
angle/render sync, shadow resource identity and per-object ordering are incomplete.
Direct fixture contracts now supported: no route property reload for companion;
Init restores AIstate/clears waypoint; target caches refresh conditionally;
authored rotation controls PostLoad and174; normal route reapplies130/flags/
submode0; shadow resources/sizes refresh. Unknown fields must remain unknown,
not be silently copied or zeroed. Full body registration4623D0 and exact newly
appended/retained registry callback timing gate live retained-container integration.
Validation: `python3 -m unittest discover -s tests -p test_retained_companion.py -v`
checks EXE identity, exact instruction/vtable targets, route record absence,
rotation-setter provenance and level-branch boundaries. Helper JSON:
`python3 tools/binary/retained_companion.py ../Original`. This is immutable static
evidence plus an interpretation oracle, not original runtime execution or port
gameplay validation.
+90
View File
@@ -0,0 +1,90 @@
# Retained player: body reset and ordinary-load scalar boundary
2026-10-26. Original EXE SHA256
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
Preferred-base EXE VAs below map to raw offset VA−400000; the helper independently
maps PE sections. Originals remain untouched. Static recovery, isolated component
execution and port tests are separate evidence categories.
## Closed callback chain
Read `retained-streamer.md`, `retained-return-cleanup.md` and
`retained-companion.md` alongside this report. Together they close the bounded
no-selected-gadget/jetpack route path through deferred load, property read,
generic Init, Jimmy PostLoad and final control preparation. The property reader
does named descriptor writes without an implicit constructor/reset callback.
Route game Init28 resolves44D4E0→4587F0→470540. Game control118 resolves475A40,
which writes global5099E4; it does not itself reset Jimmy's movement mode.
Generic Init470540 re-applies authored vectors through virtual getters/setters:
| Quantity | Authored interface field / getter | Live field / setter | Init caller / physics consumer |
|---|---|---|---|
| Acceleration |3C..48 /11C→471290|164..170 /274→471BD0|4706EA→47070F;479F01 reads270→471B70,479F4A adds acceleration×dt to velocity|
| Queued impulse |4C..58 /124→4712E0|174..180 /288→471CC0|47071E→470743;479EBB reads284→471C60,479EE5 adds it,479EF2 clears via28C→471C90|
| Velocity |7C..88 /13C→4713D0|1A4..1B0 /2C0→471F70|4707BA→4707DF;479F8D reads2BC→471F10|
All copied vectors have four float components. These are authored→live copies,
not unconditional zero writes and not arbitrary preservation of the prior live
body. Route GAM JIM1 records do not contain these authored vector properties;
their source constructor/class defaults remain distinct from property extraction.
The port currently initializes its provisional body vectors to zero.
Jimmy PostLoad's common tail424472 grants control;42447D invokes410→42AFC0.
42AFC3 calls43A750, which clears speed608 at43A758 and invokes2C4(0,0,0) at
43A764..43A76C. Target471F40 writes velocity1A4/1A8/1AC; it does not overwrite
the fourth component1B0. Complete148 stops the saved sound, then the derived
preparation requests `STOP` animation. Neither null control nor this preparation
means all scene physics stops. Uncontrolled-body scheduling remains a next chunk.
Generic Init also clears274/278/27C and298; these are separate cached fields,
**not** the acceleration/impulse vectors above. Do not confuse a virtual slot
number with a same-numbered member offset.
## Bounded retained-state contract
| State | Boundary behavior and evidence |
|---|---|
|Movement mode complete7C4/interface704|Constructor zero is not repeated; absent from route GAM, generic Init and resolved no-gadget/jetpack cleanup/PostLoad writes. Retain.|
|Jump hold complete874/interface7B4|Same bounded absence after closing property/control paths. Retain; later state0 takeoff resets it independently.|
|Owned fire timer complete6C0/interface600|Fire retained object; generic28/40C do not reset it; jetpack cleanup does not own it. Retain. First grounded fire tick421FE9 zeros it before subtracting dt.|
|Jump state complete7E8/interface728|PostLoad42378B resets WORD to0. Do not carry with mode/hold.|
|Speed608, turn614, scalar618, destination yaw61C|Jimmy Init437890 clears first three and captures authored logical Euler.Y; final preparation clears speed again.|
|Body vectors, support, radius, collision contacts|Re-apply their own initialization/PostLoad policy; not copied in the scalar container. Source radius60/factor1.265 reasserted. Full registration/response remains open.|
|Selected gadget|Cleanup and destination selection have their own state machine; not persisted by this scalar container.|
|Goddard/shadow|Identity survives; Init/PostLoad restore specific authored AI, waypoint, target, rotation/resource/visibility state. No blanket AI or shadow-state carry.|
This is a **boundary** contract. A first destination controller/effect callback can
change the same scalar immediately. Observing the timer after grounding is not a
test of whether the loader reset it. Other gadget cleanup branches explicitly
change movement mode; other level tails remain unported and need separate proof.
The full ordinary loader and original route have not been executed end to end.
## Port implementation and verification
`PlayerLevelState` carries only mode/hold/fire in memory for LV1B/VR04/LEV1 and
selected gadget−1/3. Apply follows new scene construction and precedes scene
playback. Destination jump state starts0; body, presentation and debug settings
initialize independently. Noclip does not capture a carry state. Unsupported
levels/gadget cases use the existing reconstruction policy, explicitly unproven.
TSK/CLI/debug checkpoint load gets no scalar container; no wire format changed.
R reset remains the authorized modern reset, clearing these transient fields.
Movement tests use nondefault mode/hold/fire sentinels, then independently verify
body/jump reset, airborne first tick, grounded release/effect reset, unsupported
scope and explicit reset. The GPU practice/RETURN fixture seeds nondefault values
and asserts the actual cross-scene bridge before the destination's first tick.
These are port regressions, not original cadence or whole-route fidelity evidence.
Static helper: `python3 tools/binary/retained_player_body.py ../Original`.
Two evidence tests guard26 instruction sites and16 virtual targets. The C probe
maps an isolated copied EXE without entry point/import initialization, calls the
original vector leaf accessors and43A750 with sound handle−1, and compares all
other sentinel bytes. Synthetic fixture vtables use byte-guarded source targets
in a rebased copy; selected paths use no absolute globals or unresolved imports.
The isolated Wine32 probe passes; it is intentionally narrower than full Init/PostLoad.
Runtime probe outcome and full integration/package evidence are in progress.md.
Remaining: body registration4623D0, original support/response and cadence,
uncontrolled controller/fire phases, exact registry traversal of newly appended
helpers, other selected gadgets/level tails and original end-to-end comparison.
+122
View File
@@ -0,0 +1,122 @@
# RETURN cleanup and complete PostLoad route tail
Static C3/C7 continuation,2026-10-26. Read-only source is Neutron.exe SHA256
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
All preferred-base EXE VAs below map to raw file offset VA−400000 for these sites.
The helper maps PE sections independently and emits actual offsets/bytes and
virtual targets. No original code was executed; no runtime implementation changed
in this investigation. This report supersedes the earlier **prefix-only** gadget
availability interpretation in retained-character-reset.md.
## Result: cleanup is selected-gadget policy, not a universal motion reset
RETURN457FED adjusts Jimmy's game interface−C0 to complete, then457FF7/9 invokes
complete178. Table4A3BDC+178 resolves427FF0. After cleanup,458014 setscomplete954,
458028 sets9A5, and45815C dispatches complete168→43B5A0. Cleanup therefore runs
before RETURN flags and ordinary transition staging.
427FF0 first updates the C2DInGameMenu at completeA18, if present. Provenance:
Jimmy42238D calls401430,4223A6 stores its result inA18,401464 installs48D414;
literal4EF05C identifies `C2DInGameMenu`. Cleanup calls its4B0(3) at42800C, then
4C4 at42801A; those resolve405FB0 (menu selection/resource visibility) and406590
(close/free menu resources). The receiver is not the owned C3DJetpackFire.
428020 loads signed WORD selected gadget4F0588. Unsigned bound428027..2A rejects
values outside0..7, including−1, to the common epilogue. Table428844 has:
| Selected gadget | Case target | Relevant distinction |
|---|---|---|
|0|428037|If completeA14 exists, explicitly writes movement mode7C4=0 at42804F and restores radius/support.|
|1|4284FB|Writes mode7C4=1 at4286EA after companion/gadget cleanup.|
|2|42810C|Other gadget/companion policy.|
|3 (jetpack)|42882F|Directly the common epilogue: selected gadget4F0588=−1.|
|4|4281B3|Other gadget/companion policy.|
|5|4280CC|Conditional companion/gadget policy.|
|6|42871D|Other gadget/companion policy.|
|7|4287AC|Other gadget/companion policy.|
The jetpack/no-selection branch does not zero movement mode7C4, jump7E8, hold874
or owned fire6C0. This is a local caller projection, not proof that every later
load callback preserves those fields. Generic cleanup must not be modeled as
“clear all movement”; gadgets0/1 demonstrate different behavior.
Ordinary43B5A0 does not use this selected-gadget dispatch. It stages strings,
clears7FC, conditionally copies departure root9A8 unless9A5, queues the scene
request at43B7F1, then calls complete148 at43B7FB. That target429A00 only stops
saved sound handleA44 via458A00 and writes−1. Practice Yes40470D uses this ordinary
stage. Ordinary LOAD uses it at458276. RETURN adds its preceding cleanup/flags.
## Critical correction: read the entire Jimmy PostLoad
The generic prefix423DEF..423E3F enables the eight group0 gadgets, then
VR01..08 prefix423E71..423EC1 disables them. **That is not the final state.**
Jimmy PostLoad continues through424557 and has level-specific overrides:
| Destination | Tail behavior and source call VAs |
|---|---|
|LV1B|423FBB..423FCB recognizes LV1A..LV1C.424108 disables group0 item1;424113 disables item7.|
|VR01|4242BB cleanup;4242C7 enables item0.|
|VR02|424319 cleanup;424325 enables item1.|
|VR03|4242F0 cleanup;4242FC enables item2;424408 selects item2.|
|VR04|424340 cleanup;42434C enables item3;42435A selects item3.|
|VR05|424380 enables item4;424394 cleanup.|
|VR06|4243A8 cleanup;4243B4 enables item5.|
|VR07|4243CA cleanup;4243D6 enables item6.|
|VR08|4243EE cleanup;4243FA enables item7;424408 selects item7.|
|LEV1|Falls through to common42440E without those per-level overrides.|
VR05..08 branch424365 subtracts56523035, bounds0..3, then dispatches table424558
to42437A/42439C/4243BE/4243E0. Every enable call pushes `(disabled=false,item,group0)`
in reverse argument order and targets403870; conversion remains only4→1. Thus
every tutorial enables its corresponding practice gadget0..7 after disabling the
others. Unknown/unowned wire values remain unchanged. LV1B owned items1/7 finish4.
Source VR04 owned jetpack3 finishes1, not4; lab return leaves it1. The earlier
port tests asserting VR04 jetpack4 validated an incomplete source prefix.
Other ordinary-level branches also exist in423EE1..42440E; their availability,
selection and automatic save policies are outside this bounded route correction.
Do not present a route-specific implementation as a full PostLoad reconstruction.
## Remaining callback closure for retained fields
Common PostLoad42373E cleans selected gadget5 specifically, not every gadget.
Jump state is separately cleared at42378B (interface728=complete7E8). The route
tails above run after that reset. VR04's complete174(3) resolves428D50; its table
4298E8 is indexed item+1 and maps both−1 and3 to428DE0. That branch tests global
inventory item9==2, conditionally schedules another practice level, and otherwise
returns. It does not initialize movement/hold/fire time. Its UI prelude uses the
same menu-selection405FB0 and does not own the effect timer.
The common tail424472 grants control through game118, then42447D invokes Jimmy410
→42AFC0. That calls43A750 (speed0/body velocity2C4(0,0,0), separately recovered by
primary), stops sound148, then complete150(`STOP`) at42AFDE..E5. Complete150 is
43AFF0: a conditional animation/action request; it dispatches completeE0→40DD90,
which updates morph selection/alias strings and animation flags through base
targets. It contains no movement-mode/hold/owned-fire write. `STOP` is literal
4ED040, distinct from `RUN`4ECA64. This final control preparation does not mean
movement mode is walking0.
Owned fire has its own subsequent tick421FB0. It queries owner support218 at421FDF,
zeros interface600=complete6C0 only if grounded421FE9, then subtracts dt421FF3.
This is an effect tick, not a loader reset. Takeoff separately zeros the timer at
438391. Initialization can preserve a timer that the first destination tick then
changes; comparisons must observe the same phase.
**Confidence:** high for exact cleanup/table arguments and final route availability;
high for absence of direct scalar reset in these resolved local paths. Mode/hold/
fire preservation through a complete transition additionally requires the sibling
property-stream/Init proof and enclosing control/loader order. Retaining only
these bounded scalars after that closure is justified for no-selection/jetpack
route states; retaining arbitrary gadget modes, physics vectors or effect handles
is not justified by object identity. Body reset, selected gadget and jump state
must remain independent state dimensions. Original runtime comparison remains open.
## Verification
`python3 -m unittest discover -s tests -p test_retained_return_cleanup.py -v`
passes5 tests covering immutable source identity, exact instructions/vtables,
cleanup table, all eight tutorial tail argument/dispatch sites, and a deliberately
nondefault sentinel projection for selected jetpack/no-selection cleanup. The
projection checks interpretation only; it does not execute the original routine.
`python3 tools/binary/retained_return_cleanup.py ../Original` emits the evidence;
local generated copy: artifacts/retained-return-cleanup.json. No originals modified.
+99
View File
@@ -0,0 +1,99 @@
# Retained Jimmy: GAM property-stream boundary
Static C3/C7 follow-up,2026-10-26. Read-only analysis of supplied Neutron.exe
SHA256`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`
and OMT2.dll SHA256`3ec41ead011adf56387a6dbd4580e5b5a9721b5f8020c8a56420f42824354943`.
EXE preferred base400000; DLL preferred base10000000. All listed raw offsets
map to VA−module base, checked through the PE sections by retained_streamer.py.
No original code was executed. This report closes the property-streamer's hidden
callback question; it does not by itself prove preservation through all loading.
## Recovered call chain
| Source VA / raw | Edge / state |
|---|---|
|46E38B/6E38B,46E3AC/6E3AC|Ordinary loader tests/looks up reusable class; otherwise46E3B9 calls factory459CB0. Both paths converge at46E3C1.|
|46E3CB/6E3CB|Load EBX from IAT48D190, whose imported decorated symbol is OMediaStreamOperators pointer extraction of OMediaClassStreamer.|
|46E3FC/6E3FC|Push current game interface and call EBX, stream receiver in ECX.|
|OMT2 10073E00/73E00|Exported extraction saves stream receiver, loads supplied object into ECX, passes stream and dispatches **receiver slot4** at10073E0A. Returns stream; no constructor, default or Init call.|
|EXE4A373C+4,4A3160+4,49F480+4|Jimmy, fire and Goddard receiver read slots all resolve473B30.|
|473B30/73B30|Generic registered-property reader. Reads count, then property name at473B94; dispatches receiver slot400 at473BA3 to lookup descriptor.|
|4A373C+400 →473EB0/73EB0|Lookup scans interface+26C list; descriptor name is at+8, returns matching descriptor pointer at473F8F, or null. No field setter/initialization callback.|
|473BBC..473BC0|Reads serialized wire type and stores it into descriptor+4, selects typed case at473BD0.|
|473BEE..473BF4|String destination is descriptor+48; imported primitive extraction writes there directly.|
|473C43..473C4A|Integer case reads temporary and copies it to descriptor+48.|
|473C5F..473C65|Float case passes descriptor+48 directly to primitive extraction.|
|473CA7..473CAD|32-bit long case passes descriptor+48 to primitive extraction.|
|473E4D..473E75|Read checksum, compare/log, return. There is no end-of-read Init28, PostLoad40C, class-default or control callback.|
The complete840-byte473B30..473E77 reader and239-byte473EB0..473F9E lookup are
hashed by the helper, in addition to individual decisive instruction checks.
The caller of their stream primitives is the stream, not the character; the
reader's only character virtual dispatch is slot400. Missing-property branches
consume data into local temporaries and log; they do not add properties or invoke
character callbacks. Serialized type mutates descriptor metadata, so this is a
trusted-original-data reader contract, not a claim of hardened arbitrary input.
## Registered destinations for the route's20 JIM1 fields
Offsets below are relative to Jimmy's game interface complete+C0. These are the
pointers passed to registration3FC, not live setters inferred from key names.
| GAM name | Interface field | Registration pointer VA / raw |
|---|---|---|
|ObjectTag|3A0 string|470403/70403|
|RotateToDest|A,4 raw bytes via type2|470427/70427|
|ObjectID|404|47043E/7043E|
|PositionX/Y/Z|EC/F0/F4 floats|470458/70458,470472/70472,47048C/7048C|
|RotationX/Y/Z|FC/100/104 floats|4704A6/704A6,4704C0/704C0,4704DA/704DA|
|TaskName|430 string|45883F/5883F|
|Debug|4A4|458859/58859|
|RequiredLevel/ExactLevel/RemoveLevel|578/57C/580|40D3CC/D3CC,40D3E6/D3E6,40D400/D400|
|HasCollision/InitiallyVisible/CanMove|584/588/58C|40D41A/D41A,40D434/D434,40D44E/D44E|
|SecondPass|590|40D468/D468|
|PickupLink|595 string|40D482/D482|
|StartPoint|664 string|43784F/3784F|
Each row's exact LEA, pushed wire type/name literal and original name bytes are
checked. These destinations explain why property loading changes authored
position/rotation/configuration before Init re-applies them to live state. No
route descriptor points at mode interface704/complete7C4, jump728/7E8, live body
velocity1A4, acceleration274 or impulse288. No authored velocity, acceleration,
impulse, hold or fire-time property occurs in the route JIM1 records.
The lab LV1B, VR04 and outside LEV1 JIM1 records all have this exact20-name set.
Their record offsets and original GAM hashes are emitted by the helper. Their
placement values differ and are intentionally applied on each load. Jimmy's
constructor422245 calls422AC0, whose parent registration chain is
422AD7→437830,437846→40D3C0,40D3C3→462340,462356→458820,
458836→4703B0. Reusable-object property extraction does not repeat that constructor
chain.473FA0 registration stores the passed destination pointer in descriptor+48
at473FFE; descriptor layout and reader ownership therefore agree independently.
## What this resolves and what it does not
**Recovered:** Route GAM property extraction is a named, direct-write pass into
authored/configuration fields. It has no hidden character reset/init/default/end
callback. It does not zero or serialize mode, jump or body vectors on these GAMs.
The fire read slot shares the same primitive reader; the inspected JIM1 record
never reaches the fire object's timer through that reader.
**Inference limited by enclosing callbacks:** Runtime scalars not in these records
reach Init unchanged by this extraction pass. They may still be reset by generic
Init, Jimmy PostLoad, RETURN gadget cleanup, control handoff or an intervening tick.
Absence from GAM is not proof that they survive the complete transition. Generic
Init's authored→live vector copies are covered by the primary body investigation;
constructors can initialize authored fields even when GAM has no corresponding key.
Do not carry live velocity merely because the GAM lacks a velocity property.
**Current implementation:** The port parses GAM values and reconstructs scene
objects from snapshots. This report changes no runtime behavior. It supports a
field-specific state container, not blanket copying or rerunning constructors.
**Verification:** Three deterministic Python groups verify both module hashes,
20 decisive instruction anchors,6 vtable targets,20 descriptors, the two full
function bodies and the three exact route property sets. Run
`python3 -m unittest discover -s tests -p test_retained_streamer.py -v` and
`python3 tools/binary/retained_streamer.py ../Original`. Static source-byte/data
checks are separate from original-component execution, port runtime and full
original route comparison; none of the latter are added here.
+5 -1
View File
@@ -2,7 +2,11 @@
Implementation has since continued: the old-game Init/deletion gate is resolved,
controlled player phases are split, the route static camera query is integrated,
and PostLoad gadget availability is applied. See `player-phase-implementation.md`,
and PostLoad gadget availability is applied. The later retained-field chunk adds
bounded route mode/hold/fire carry, closes property-reader and companion reset
paths, and corrects full VR practice re-enable tails/LV1B restrictions. See
`retained-player-body.md` and the three linked follow-ups; older prefix-only
availability conclusions are superseded. See `player-phase-implementation.md`,
`level-game-lifetime.md` and the current ledger. The exit review below preserves
the evidence/verification boundary at the original checkpoint milestone.