Trace VR04 physical registration and generated helper lifetimes

This commit is contained in:
UnixNight committed 2026-11-06 22:56:38 -05:00
1 parent 3794439d4e
commit 346d350176
17 files changed
+718 -3

No files matched your search

+8 -1
View File
@@ -10,7 +10,7 @@ object identity can survive in registry50999C.46E131 explicitly clears surviving
interfaces'49E registration flag. Jimmy PostLoad4238B4 invokes interface2C→42AB50:
false49E jumps to4623D0 InitPhysics. Identity retention is not physical-list retention.
4623D0 invokes base458910 (470A00 allocation/49E=true), copies current render XYZ
4623D0 invokes base458910 (one-time470A00 logging/49E=true), copies current render XYZ
complete44/48/4C through16C→471630, copies angular-unit Euler through174→4716D0,
then calls479A40.479A65 invokes interface150(0,0,0);479A6F invokes Init28 AGAIN,
resolving to Jimmy437890. Only then does it append a12-byte body-list node with
@@ -19,6 +19,13 @@ final control preparation have their own order; registration's Init is not a
blanket post-placement reset. Existing retained scalar conclusions remain bounded
by the closed437890/generic Init chain, not by an assumption that Init runs once.
Follow-up: [physical registration](physical-registration.md) executes12 bounded
original registration/loader cases.470A00 is a logging hook, not an allocator;
the12-byte body node is allocated inside479A40. The common polygon/sprite bridges
can append repeated actor pointers; Jimmy's outer49E guard supplies the distinct
skip boundary. The per-object Init/PostLoad order and same-pass registry appends
are now covered by original-component execution, not solely static reading.
| REA routine | Evidence ID |
|---|---|
|4623D0|ev_d60cfc7d2ff8266e19176052e1466ba98f09e7b10b92db828566fbc28d36d281|
+7 -1
View File
@@ -67,6 +67,12 @@ callback-mutated roots/membership and enter/stay/leave. The component has explic
mode2 injection and is not admitted to live scenes. VR04's6 inspected actor records
and20 bindings do not yet constitute the full physical/helper registration list.
[Physical registration](physical-registration.md) now inventories all72 VR04
records/13 actual interfaces and executes12 original registration/loader cases.
Common append versus Jimmy49E guard, nested Init and live per-object registry
traversal are verified.21 helper edges/12 RTTI identities are catalogued; actual
retained helper membership, deletion/activation and shared reclip remain open.
| ID / system | Recovered contract / anchors | Port implementation | Evidence / remaining gap | Next bounded action |
|---|---|---|---|---|
| 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. Uncontrolled body/fire now continue while movement/input are gated. Other systems remain grouped; fixed60Hz policy. | S/M/R. Controlled player partial order implemented; bounded raw-owner preparation implemented; full wrapper/registry/cadence open. | C3 continue other callbacks and morph/control phases; C4 support/response remains separate. |
@@ -80,7 +86,7 @@ and20 bindings do not yet constitute the full physical/helper registration list.
| CAMERA | Shared viewport eye is recaptured by ground/air follow after scripts; strict>1000 DEFAULT snap; aim uses pre-update eye; source ray/gain and per-level far planes. | Static source query integrated for the three route scenes; other scenes use provisional sweep. Separate chase/script eyes and merged clip maximum remain. | S/M/R. Handoff source bytes/projections recovered, not implemented; full follow/input/quantization and visual comparison open. | C5 shared viewport eye/aim and DEFAULT transition; preserve source phase boundary. |
| 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 | Deferred scene request; selective reuse; Init stored+11→live+139; Jimmy/Goddard retained. Physical49E clears and re-registration repeats Init before STRT placement. RETURN root/flags and28→40C. | Reconstructed scene with retained input order and bounded mode/hold/fire; app-owned presentation. | S/P/M/R. Physical registration chain source-guarded; full helper/body allocation/order and fades remain.50988A is editor R input. | Integrate physical list/helper traversal alongside C4; other gadget/level branches remain gated. |
| LOAD | Deferred request/selective reuse; Init stored+11→live+139; retained Jimmy/Goddard.49E clears; registration repeats Init before STRT. Per-object28→40C and same-pass appends; RETURN root/flags. | Reconstructed scene with retained input order and bounded state; app-owned presentation. | S/P/M/R.12 original registration/loader cases now pass; all72 serialized VR04 records mapped. Helper lifetime/activation and full ordering still open;50988A is editor R input. | Close helper reuse/removal and physical sequence alongside C4; 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. |
+7
View File
@@ -28,6 +28,13 @@ original/C# comparisons,6 new REA pseudocode results and20 guarded VR04 class
bindings. The pair component is verified separately; scene admission remains
gated on full physical registration/activation, real callbacks and shared reclip.
Registration continuation now covers all72 serialized VR04 records/13 interfaces
and12 original registration/loader cases, plus21 guarded helper edges. This closes
the bounded common registration and per-object loader contracts, not complete
fresh/retained helper membership. See [registration](physical-registration.md).
Next resolve helper re-entry/deletion/activation and dynamic shared reclip state;
keep live scene admission unchanged until those dependencies close.
## Objective
Establish the original ownership and timing of player state across gameplay,
+138
View File
@@ -0,0 +1,138 @@
# VR04 physical registration and initialization boundaries
2026-11-06. Extends the existing [registration trace](body-root-registration.md)
and [pair contract](pair-lifecycle.md) with complete serialized-class coverage and
12 executed original-component cases. No runtime gameplay code or scene admission
changes in this checkpoint. The playable/package baseline remains924ad2f.
## Identity and evidence
Canonical Neutron.exe SHA256:
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
`physical_registration.py` verifies that identity,6 bounded source hashes,
13 RTTI interface identities,11 own-registration sites and78 method bindings.
It inventories every one of VR04's72 records with source GAM offsets/activation
fields. Original instruction Evidence is
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`;
bounded extracts, offsets, hashes and10 private-memory relocation operands are
retained in artifacts/physical-registration/native/source.json.
New local REA/Ghidra results:
- 464210 sprite bridge:
`ev_4d39cc1aaad564de60bb801c08dfeb740d52e507227e630de9b0570e3e1bc43d`.
- 436B80 derived AI/pickup gate:
`ev_95baf27f6c5f2949dcc5f03f77f3c45bcd14852595b0cc207b9ee27c1dbb02f9`.
Requests for46E570,40E1F0 and45F2B0 had no recognized procedure in this analysis;
complete errors are retained. Their instructions remain available in the earlier
full REA disassembly. No retry is counted as successful decompilation. Successful
results/export and closed snapshot are in artifacts/physical-registration/rea/.
The prior4623D0/458910/479A40 Evidence remains linked in body-root-registration.md.
## What registration actually owns
| VA / PE file offset | Recovered behavior |
|---|---|
|4623D0 /623D0|3D-object interface at complete+C0. Calls458910; copies current complete44/48/4C through16C; converts signed14-bit Euler fields through174; calls479A40.|
|464210 /64210|Sprite interface at complete+C8. Same registration shape with the corresponding−84/−80/−7C render-root offsets; converts Euler units by360/16384; calls479A40.|
|458910 /58910|Tests interface49E. When false invokes470A00 and sets49E=true. This gates the base hook, **not the later append in either bridge**.|
|470A00 /70A00|Logging hook ending at472970; it does not allocate a physical body node. This corrects an earlier allocation label.|
|479A40 /79A40|Calls own150(0,0,0), then own28 Init, then allocates/appends a12-byte physical node and increments695D40. The payload is the game-interface pointer. No identity deduplication or pair/integration gate occurs here.|
|42AB50 /2AB50|Jimmy/Rocketship outer49E guard: true returns; false jumps to4623D0. This is a distinct guard around the whole registration path.|
|46E570..46E69F /6E570..6E69F|Live registry traversal: own28 Init, attached-render handling, own40C PostLoad, attached-render handling, next node. Then app10C cleanup and47E470 timer reset.|
The physical list695D3C and ordinary registry50999C have separate ownership.
Common registration reads the current render transform, which is not a promise
that authored GAM properties have already been streamed. Constructor registration
can precede that streaming; later Init/PostLoad work owns later state publication.
The12-case copied-code probe establishes:
- Repeated direct4623D0 or464210 calls append the same interface again, repeating
transform/zero/Init callbacks even with49E already true. This is a function
contract, not evidence that every real actor naturally acquires duplicate nodes.
- Jimmy's guarded entry skips all that work when49E is set. Clearing49E admits
another append. Clearing a flag is not equivalent to clearing the list.
- A child registered from the supplied Init callback is appended before its
parent's append, because479A40 calls Init before allocating the parent's node.
The child callback is synthetic; no claim is made that all real Init methods do so.
- Pair flag140 and integration13E false do not prevent registration. Membership,
active integration and pair eligibility must stay independent.
- The previously recovered per-object Init/PostLoad order is confirmed by actual
46E570 execution. Nodes appended from either callback are visited later in that
same traversal. A snapshot/two-global-pass model would differ in these fixtures.
## All serialized VR04 classes
The following is a source inventory of **own registration sites**, not a complete
runtime body count. Constructor rows assume that constructor is actually invoked
and succeeds; reuse, nested helpers, later calls and scene state remain separate.
| GAM kind / records | Actual interface | Own registration site / phase |
|---|---|---|
|3JIM /1|C3DJimmy4A373C, complete+C0|4238B4 virtual2C during matching-start PostLoad; guarded42AB50|
|3ROC /1|C3DRocketShip4B25AC, complete+C0|43DB22 virtual2C in PostLoad; guarded42AB50|
|STRT /1|C3DStartPoint4B7654, complete+C8|Constructor44249D→464210|
|3PHO /2|C3DPhoneBooth4ADF6C, complete+C0|Constructor4356A0→4623D0|
|3PAT /34|C3DPatrolPoint4ACEE4, complete+C8|Constructor434D44→464210|
|3PIC /11|C3DPickupItem4AE548, complete+C8|Constructor435A37→464210|
|3SOL /3|C3DYokianSoldier4C19C4, complete+C0|Constructor44BFA4→4623D0|
|3TRO /1|C3DVRTrophy4BE404, complete+C0|Constructor448D33→4623D0|
|3AIT /2|C3DAITrigger48F8C0, complete+C8|Constructor40BE5B→464210|
|3CHK /1|C3DCheckPoint4959A8, complete+C8|Constructor414323→464210|
|LOAD /2|CLoadLevel4D025C, complete+C8|Constructor457CCA→464210|
|3CAM /12|C3DCutSceneCamera497BFC, complete+C8|No own registration call in the inspected constructor/base/PostLoad chain|
|3SM1 /1|C3DSmoke4B4F08, complete+C8|No own call in that chain; it creates a separately registered SmokePuff helper|
Thus57 serialized records map to own constructor sites,2 to PostLoad sites and13
to no own call in the inspected chain. These numbers partition records; they
are **not a claim of59 actual bodies**. All these interfaces expose InitPhysics,
including the two negative own-call classes. Having that method is insufficient
evidence that it is invoked.3CAM's class is the cutscene-camera subclass, not the
base C3DCamera. Source RTTI verifies the distinction.
Authored HasCollision/task/range values are retained per record. Generic activation
40E1F0, task callback40E340, pickup45F2B0 and derived436B80 have different ownership.
The recovered436B80 first calls40E340, then may hide an acquired optional pickup;
it does not establish an independent universal body-list removal policy. Current
live flags, deletion, exclusions and child activation still require tracing.
## Execution, reproduction and limits
`physical_registration_probe.c` executes copied4623D0/464210/458910/470A00/479A40,
42AB50 and46E570. Explicit adapters supply actor vtables/transforms, Init/PostLoad
callbacks, logging, allocation, app cleanup and timer. Render-presence byte8 is
false in loader fixtures, so attached-render branches are not exercised. No real
actor constructor, original game entry point, script/task world or renderer runs.
All12 cases verify full emitted callback/order/count/flag/Init/XYZ/Euler outputs
under isolated Wine32, with Original unmounted and network disabled. The helper
checks copied EXE hash, observed probe identity, exit0 and completion marker;
provenance and validated observations are retained locally. This is original
component execution, not native Windows or full original gameplay verification.
```sh
python3 tools/binary/physical_registration.py ../Original \
--output artifacts/physical-registration/native \
--rea artifacts/jimmy-movement-audit/rea-original-disassembly.json
i686-w64-mingw32-gcc -O0 -Wall -Wextra -Wno-unused-function \
-o artifacts/physical-registration/native/probe.exe \
artifacts/physical-registration/native/physical_registration_probe.c
python3 tools/recon/reference_capture.py --asset-probe \
--probe-executable artifacts/physical-registration/native/probe.exe \
--probe-success PHYSICAL_REGISTRATION_COMPLETE --seconds 12 \
--output artifacts/physical-registration/probe
python3 tools/binary/physical_registration.py ../Original \
--output artifacts/physical-registration/native --capture artifacts/physical-registration/probe
```
The short capture uses a copied initialized generated Wine32 prefix; this scalar
probe needs no OMT DLL load. No runtime implementation or package identity changes
follow from these observations alone. [Generated helpers](vr04-generated-bodies.md)
records21 verified creation/registration calls and the remaining lifetime gaps.
Next: close helper reuse/removal and activation enough to reconstruct the actual
physical sequence for fresh and retained VR04; then integrate dynamic response
with original nearest/last-polygon reclip ownership. Keep the playable collision
baseline and separate OriginalPairCollision component until that boundary closes.
+77
View File
@@ -0,0 +1,77 @@
# VR04 generated helpers: bounded registration catalogue
2026-11-06. Complements [serialized registration](physical-registration.md).
This is source recovery, not a complete observed helper/body count. No gameplay
change, native actor constructor execution or package refresh is claimed.
`tools/binary/vr04_generated_bodies.py` verifies the canonical EXE hash,21 direct
calls,9 instruction sites and12 helper RTTI identities/36 method targets. Optional
`--rea` retains13 bounded instruction excerpts, PE offsets and hashes under
artifacts/physical-registration/helpers.json. Source Evidence is
`ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904`.
EXE text offsets cited here are VA−400000; the guard uses actual PE mapping.
JN-Engine documentation supplied navigation leads; canonical instructions and RTTI
establish the following identities. No JN replacement movement is used.
## Positive creation/registration chains
| Owner / original VA | Helper and physical-registration evidence |
|---|---|
|Jimmy422610/422633|Loop counter20, ctor40FC50; complete+AB4..B00 stores20 C3DBaseball pointers. Table49141C+40C→410000 invokes2C at41000C→464210. The loop disables each ball's integration214; sleeping does not remove registration.|
|Player4374DF; Jimmy4238EF|C3DJetpackFire ctor421D80, table4A3160, created from the Player constructor. Its own40C→40E7B0 supplies no registration call, but Jimmy's matching-start PostLoad configures the owned fire and explicitly invokes its2C at4238EF. Owner-driven registration is essential.|
|Jimmy42243F|Owned C3DRocketShip ctor43D840, distinct from a separately created serialized3ROC instance unless the loader's reuse policy selects an existing one. Its43DB22 PostLoad invokes guarded42AB50. Do not collapse nodes by kind name.|
|Rocketship43D9BC|C3DFireStrato ctor4192E0, table49BDD4. Common40E7B0 PostLoad alone is not a registration edge; other owner/lifecycle calls remain separate.|
|Jimmy42232C|C3DBubble ctor410840; direct registration410992→464210. Its410A80 PostLoad sets up retained artwork and does not itself establish repeated registration.|
|Jimmy4225BE|C3DPointCursor ctor43BC70;43BD67→4623D0. Generic40E7B0 PostLoad supplies no own registration.|
|Jimmy422800|C3DGraplingHook (original RTTI spelling), ctor41EEB0;41EFB4→4623D0. Its generic40E7B0 likewise is not a retained re-registration proof.|
|Smoke4406B1|C3DSmokePuff ctor440980;440ACC→464210. The serialized Smoke object's own negative registration result does not exclude its helper's node.|
|Goddard41CA9C/41CB09|Two C3DCursor constructors415760, each415857→4623D0. RTTI/table497620 identifies Cursor; these are not C3DFlag helpers.|
Common registration can append an interface more than once, while the Jimmy/
Rocketship outer49E guard prevents a repeated call when set. The new native
registration cases verify that distinction; this catalogue does not assert a
natural duplicate node for every positive chain above.
## Helpers whose interface does not prove body membership
- Jimmy42250C creates C3DShadow43F640, table4B37B8. Yokian44A88F creates the same
type conditionally on the source shadow flag. Their retained-canvas PostLoad
43F810→4354C0 is not itself a2C call. Terrain projection is a separate consumer.
- Jimmy42255B creates **C3DTargetCursor**4453B0, table4B9F48. It is distinct from
C3DMovingTarget/table4A8A10 and the target consumers used in VR07. Shared FourCC
3TAR or misleading class-registration strings are insufficient type evidence.
Its445580 retained-canvas setup does not establish body registration.
- Yokian44A826 creates C3DYokianShield44B510, table4C0E24. Its44B6C0 PostLoad calls
464810 canvas setup; exposing2C→464210 alone proves no physical-list membership.
The catalogue is bounded: additional Jimmy allocations (including ray/pod paths),
conditional helpers and owner callbacks still need their own lifetime inventory.
The12 listed RTTI identities are not an assertion that only12 helper types exist.
## Retained loads and late companion construction
Ordinary scene teardown clears the physical list; it also clears surviving
interfaces'49E flag. A retained registry identity is not a retained physical node.
Baseballs' explicit PostLoad and Jimmy-owned fire invocation give positive re-entry
edges. Constructor-only helper registration cannot silently be treated as a
PostLoad edge; gadget activation, later owner calls, reuse/removal and shutdown
must be followed before assigning retained membership.
Jimmy PostLoad423C98 constructs Goddard only on its observed pointer-null path.
The Jeep path is different: EDI is zeroed at4236FA and stored into game+970 at
423792, before the later null test423CEE and constructor4211A0 at423D1A. Therefore
the later null test alone is not evidence that this pointer is retained. Source
421552 invokes Jeep2C→421570, whose49E guard enters465070→4623D0. Jimmy423D75
then calls the wheel-construction hook; existing Scooter documentation covers its
four wheel objects. Old Jeep teardown/deletion and complete retained ordering
remain open; no leak or new carry/reset policy is inferred.
## Implementation consequence
The live port reconstructs selected actors and bounded body records per scene.
It does not yet reproduce this complete helper/physical-list lifecycle. The pair
component must receive source physical order with real actor callbacks, not a
filtered list of visible GAM actors or a dictionary containing one actor per kind.
No helper is added to live collision merely because a vtable exposes InitPhysics.
Resolve remaining constructor-only re-entry, deletion and activation edges before
changing that boundary. All source/probe work remains local and originals unchanged.