Trace VR04 physical registration and generated helper lifetimes
This commit is contained in:
1 parent
3794439d4e
commit
346d350176
17 files changed
+718
-3
No files matched your search
@@ -57,6 +57,11 @@ collision. Gated pairs retain contacts; sphere exclusions use the earlier actor.
|
||||
Both packages identify clean924ad2f; standalone Linux Carl return passes with4
|
||||
readbacks identical to ea04210. Current Windows is cross-published/resource-
|
||||
verified; earlier Wine64 runtime evidence belongs to ea04210, native Windows open.
|
||||
Registration continuation: docs/checkpoint/physical-registration.md and
|
||||
vr04-generated-bodies.md cover72 records/13 classes,12 original component cases
|
||||
and21 helper edges. Runtime/packages remain924ad2f. Common append is not deduped;
|
||||
Jimmy49E guards the whole bridge. Per-node Init/PostLoad visits new registry tails.
|
||||
Full retained helper membership/cleanup/activation and shared reclip remain open.
|
||||
|
||||
2026-11-06 continuation: the earlier292 original component cases plus50 derived-
|
||||
caller cases and body/visual-sync audit supply no extra reset. Startup diagnostics
|
||||
|
||||
@@ -99,6 +99,12 @@ mode2 solver, and preserves contacts when eligibility skips a pair.28 complete
|
||||
original-component comparisons support it. It is not connected to the grouped
|
||||
SceneInteractions loop: full registration/activation, real actor responses and
|
||||
shared dynamic reclip state remain prerequisites. See checkpoint/pair-lifecycle.md.
|
||||
Registration has separate ordinary registry50999C, physical list695D3C and own
|
||||
49E flag. Common4623D0/464210 can append duplicates even when49E is already set;
|
||||
Jimmy42AB50 guards the whole call.479A40 invokes Init before node append, while
|
||||
46E570 runs Init then PostLoad per node and visits same-pass registry appends.
|
||||
12 original-component cases support these boundaries; the full VR04 helper/
|
||||
activation sequence remains open. See checkpoint/physical-registration.md.
|
||||
Source root and modern feet/sole rendering are distinct adapters; F3 exit still
|
||||
uses modern capsule occupancy. See checkpoint/collision-body-implementation.md.
|
||||
The source-root upward ray is supplied separately from the camera debug query:
|
||||
|
||||
@@ -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|
|
||||
|
||||
@@ -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. |
|
||||
|
||||
@@ -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,
|
||||
|
||||
@@ -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.
|
||||
@@ -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.
|
||||
@@ -1,5 +1,16 @@
|
||||
# Compatibility and validation
|
||||
|
||||
2026-11-06 physical-registration continuation:12 copied-code registration/loader
|
||||
cases pass with complete emitted callback/order/count/flag/transform checks.
|
||||
All72 VR04 records/13 class interfaces are inventoried, with a bounded catalogue
|
||||
of21 helper creation/registration edges and12 verified helper RTTI identities.
|
||||
These are source/component results, not a complete observed physical list or
|
||||
whole-original/native Windows gameplay.342 Python checks and the existing28-case
|
||||
managed pair regression pass;539 originals remain unchanged. Runtime code and
|
||||
924ad2f packages are unchanged. See [registration](checkpoint/physical-registration.md)
|
||||
and [helpers](checkpoint/vr04-generated-bodies.md). Helper retained lifetime,
|
||||
activation and dynamic shared reclip state remain open before live admission.
|
||||
|
||||
2026-11-06 pair lifecycle checkpoint:28 copied-original pair/sphere/exclusion/
|
||||
base-contact cases match the C# dispatch component's complete callbacks, contact
|
||||
masks, integration/enabled flags and roots. Fixed reference tests also pass without
|
||||
|
||||
@@ -394,3 +394,12 @@ assets and generated packages stay excluded.
|
||||
real actor callbacks and shared reclip dependencies close. Render visibility
|
||||
and raw-control flags are not substitutes for physical eligibility. See
|
||||
checkpoint/pair-lifecycle.md.
|
||||
56. **Keep physical membership,49E and active collision as separate state.**
|
||||
Common4623D0/464210 only use49E to gate the base hook; they can append the
|
||||
same pointer again. Jimmy42AB50 guards the whole bridge. Registration runs
|
||||
Init before physical append, while loading runs Init then PostLoad per live
|
||||
registry node and visits new tails. Twelve original component cases confirm
|
||||
these boundaries. Inventory actual constructor/owner-driven helper edges;
|
||||
neither visibility nor an exposed InitPhysics method establishes membership.
|
||||
Do not synthesize a full live body count or retained re-entry from the72-record
|
||||
serialized partition. See checkpoint/physical-registration.md.
|
||||
@@ -22,7 +22,7 @@ the helper PE-maps file offsets independently (these text offsets equal VA−400
|
||||
|46BF2F..46C00A|Stage1 advances to2, clears elapsed and dispatches app114(`level1d.gam`) at46C004. This is the previously omitted positive background-load edge.|
|
||||
|app114→46DFB0;46BEDF;app104→46DFF0|Queues filename+74D with signed callback countdown+7FA=2; underflow sets pending+74C; the application then invokes ordinary selective teardown/load.|
|
||||
|Level1D GAM|LV1D,54 records, first3JIM/JIM1 at raw8. SHA256276133d750eaa82724b35c12a91fce41a9e074224e3ef12c3624564ae8ed4d9e. Loading the supplied background creates Jimmy before a user story load.|
|
||||
|46E570..46E67D|After GAM records, the whole surviving registry receives Init28 then PostLoad40C, including retained MAIN; Init is not limited to newly parsed records.|
|
||||
|46E570..46E67D|After GAM records, each surviving registry node receives Init28 then PostLoad40C before advancing to the next node, including retained MAIN; Init is not limited to newly parsed records.|
|
||||
|MAIN/Level1D game28→44D4E0→4587F0→470540|Common Init restores stored+11 into live+139 through4705B3/4705BC. Both games' stored value is1. MAIN's constructor-default live0 therefore does not imply indefinite retention after background initialization. Their40C is44DF30, a noop call plus own game520=0 store, with no later lifetime reset.|
|
||||
|404B4F→460E70→460EA0/460EF0→4603F0|The NewGame action queues NewGame.tsk; the reader consumes that request. The request itself does not initialize Jimmy.|
|
||||
|460A50..460A6A;460BD1|The reader requests a destination GAM only through an existing non-null controlled receiver accepting **C3DJIMMY** at4ECB20. It dispatches Jimmy complete168→43B5A0 with the staged filename/start/root data. The no-Jimmy path does not supply that request.|
|
||||
|
||||
@@ -7,6 +7,31 @@ Next-work plan: [recover interactions, then implement verified changes](checkpoi
|
||||
It defines the Carl source/differential gate, the bounded implementation step,
|
||||
movement/contact/animation recovery and the end-to-end platform checkpoint.
|
||||
|
||||
## VR04 registration and generated-helper continuation
|
||||
|
||||
[Physical registration](checkpoint/physical-registration.md) now covers all72
|
||||
serialized VR04 records/13 actual class interfaces and adds12 executed original
|
||||
registration/loader cases. Common bridges append repeated pointers; Jimmy's outer
|
||||
49E guard is a separate boundary. The native cases confirm per-object Init→PostLoad,
|
||||
same-pass registry appends and nested registration before parent append. They use
|
||||
synthetic actors/callbacks, not full original scene construction.
|
||||
|
||||
[Helper catalogue](checkpoint/vr04-generated-bodies.md) guards21 creation/
|
||||
registration calls,9 instruction sites and12 RTTI helper identities/36 bindings.
|
||||
Baseball PostLoad and Jimmy-owned fire give positive re-entry edges; constructor-
|
||||
only helpers, conditional children and old Jeep cleanup remain explicit unknowns.
|
||||
The57 constructor/2 PostLoad/13 negative own-call record partition is not a live
|
||||
body count. Earlier470A00 allocation wording is corrected: it logs;479A40 allocates
|
||||
the physical node. Two new REA pseudocode results and retained original instructions
|
||||
support the source trace; three unrecognized procedures remain recorded errors.
|
||||
|
||||
All342 Python checks pass, as does the existing28-case managed pair regression.
|
||||
The native capture verifies complete12-case callbacks/order/flags/transforms and
|
||||
source/probe identities. All539 originals remain unchanged. No gameplay/runtime
|
||||
source is changed; both924ad2f packages and their prior verification remain the
|
||||
playable baseline. Actual helper reuse/removal/activation and shared dynamic
|
||||
nearest/last-polygon reclip ownership remain next. Evidence: artifacts/physical-registration/.
|
||||
|
||||
## Ordered physical pair contract
|
||||
|
||||
[Pair lifecycle](checkpoint/pair-lifecycle.md) now records the original physical-
|
||||
|
||||
@@ -5,6 +5,11 @@ offsets, virtual addresses, API symbols or observed behavior. Decompiled output
|
||||
evidence, not original source. Original gameplay has not yet been observed successfully; isolated original DLL
|
||||
probes and modern runtime checks are recorded separately.
|
||||
|
||||
- [Physical registration](checkpoint/physical-registration.md) and
|
||||
[generated helpers](checkpoint/vr04-generated-bodies.md): all72 VR04 serialized
|
||||
records/13 RTTI interfaces;12 original registration/loader cases;21 helper
|
||||
creation/registration calls. Per-object Init/PostLoad and live appends are
|
||||
executed component evidence. Full retained helper membership/cleanup is open.
|
||||
- [Ordered physical pairs](checkpoint/pair-lifecycle.md):6 REA pseudocode results,
|
||||
8 guarded source ranges,20 VR04 class bindings and28 complete copied-code/C#
|
||||
comparisons. One-sided exclusions, gate-retained contacts, callback-mutated
|
||||
|
||||
@@ -74,6 +74,13 @@ Execution order and acceptance criteria: [next work plan](checkpoint/next-work-p
|
||||
- [ ] Complete VR04 physical registration/activation and generated-helper inventory,
|
||||
then dynamic nearest/last-polygon reclip ownership. Preserve existing scene
|
||||
collision admission until real actor/special callbacks are verified.
|
||||
- [x] Inventory all72 serialized VR04 records/13 actual interfaces and execute12
|
||||
original registration/loader cases (duplicate append,49E guard, nested order,
|
||||
per-object Init/PostLoad and same-pass registry additions).
|
||||
- [x] Guard21 helper creation/registration edges and12 RTTI identities; separate
|
||||
owner-driven fire/Baseball re-entry from constructor-only or conditional helpers.
|
||||
Full live body counts and retained helper cleanup remain open. See
|
||||
checkpoint/physical-registration.md and vr04-generated-bodies.md.
|
||||
|
||||
- [x] Expand original lifecycle coverage:96 Carl contact,8 composed input/
|
||||
controller/skip-prefix,48 task/objective and140 base/STOP cases; recover complete
|
||||
|
||||
@@ -0,0 +1,49 @@
|
||||
from pathlib import Path
|
||||
import sys
|
||||
import unittest
|
||||
|
||||
ROOT=Path(__file__).resolve().parents[1]
|
||||
sys.path.insert(0,str(ROOT/'tools/binary'))
|
||||
from physical_registration import collect
|
||||
from vr04_generated_bodies import collect as helpers
|
||||
|
||||
|
||||
class PhysicalRegistrationTests(unittest.TestCase):
|
||||
@classmethod
|
||||
def setUpClass(cls):
|
||||
cls.source=collect(ROOT.parent/'Original')
|
||||
cls.helpers=helpers(ROOT.parent/'Original')
|
||||
|
||||
def test_all_serialized_records_have_actual_class_interfaces(self):
|
||||
self.assertEqual(len(self.source['records']),72)
|
||||
self.assertEqual(len(self.source['classes']),13)
|
||||
self.assertEqual(len({r['file_offset'] for r in self.source['records']}),72)
|
||||
camera=self.source['classes']['3CAM']
|
||||
self.assertEqual(camera['name'],'C3DCutSceneCamera')
|
||||
self.assertEqual(camera['game_table'],'0x497bfc')
|
||||
self.assertEqual(camera['methods']['0x2c'],'0x464210')
|
||||
|
||||
def test_own_registration_phases_do_not_claim_a_runtime_total(self):
|
||||
self.assertEqual(self.source['serialized_phase_counts'],
|
||||
dict(postload=2,constructor=57,no_own_call_in_inspected_chain=13))
|
||||
self.assertEqual(self.source['classes']['3JIM']['registration_site'],'0x4238b4')
|
||||
self.assertEqual(self.source['classes']['3ROC']['registration_site'],'0x43db22')
|
||||
self.assertTrue(all('unobserved' in r['runtime_membership'] for r in self.source['records']))
|
||||
|
||||
def test_registration_loop_and_append_source_ranges(self):
|
||||
self.assertEqual(len(self.source['ranges']),6)
|
||||
self.assertEqual(len(self.source['relocations']),10)
|
||||
self.assertEqual(self.source['ranges'][-1]['file_offset'],'0x6e570')
|
||||
|
||||
def test_generated_helpers_use_verified_types_and_separate_owner_calls(self):
|
||||
self.assertEqual(len(self.helpers['calls']),21)
|
||||
self.assertEqual(len(self.helpers['sites']),9)
|
||||
types={c['name']:c for c in self.helpers['classes']}
|
||||
self.assertEqual(len(types),12)
|
||||
self.assertEqual(types['C3DTargetCursor']['table'],'0x4b9f48')
|
||||
self.assertEqual(types['C3DBaseball']['methods']['0x40c'],'0x410000')
|
||||
self.assertEqual(types['C3DJetpackFire']['methods']['0x40c'],'0x40e7b0')
|
||||
self.assertEqual(types['C3DCursor']['table'],'0x497620')
|
||||
|
||||
|
||||
if __name__=='__main__':unittest.main()
|
||||
@@ -0,0 +1,169 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Read-only VR04 serialized registration inventory and copied-code loop probe."""
|
||||
import argparse
|
||||
from collections import Counter
|
||||
import hashlib
|
||||
import json
|
||||
from pathlib import Path
|
||||
import re
|
||||
import struct
|
||||
import sys
|
||||
|
||||
from checkpoint_script_state import EXE_SHA256, find_case, read_va, rel_call_target
|
||||
from pe_inspect import PE
|
||||
from rtti_map import rtti_map
|
||||
sys.path.insert(0, str(Path(__file__).resolve().parents[1]/'levels'))
|
||||
from gam import parse
|
||||
|
||||
REA_ID = 'ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904'
|
||||
# Own registration sites, not counts of nested helpers or live runtime nodes.
|
||||
# PostLoad sites dispatch virtual2C; constructor sites directly call the bridge.
|
||||
CLASSES = (
|
||||
('3JIM','C3DJimmy',0x422160,0x4a373c,0xc0,'postload',0x4238b4,None),
|
||||
('3ROC','C3DRocketShip',0x43d840,0x4b25ac,0xc0,'postload',0x43db22,None),
|
||||
('STRT','C3DStartPoint',0x4422d0,0x4b7654,0xc8,'constructor',0x44249d,0x464210),
|
||||
('3PHO','C3DPhoneBooth',0x4355a0,0x4adf6c,0xc0,'constructor',0x4356a0,0x4623d0),
|
||||
('3PAT','C3DPatrolPoint',0x434b30,0x4acee4,0xc8,'constructor',0x434d44,0x464210),
|
||||
('3PIC','C3DPickupItem',0x4358b0,0x4ae548,0xc8,'constructor',0x435a37,0x464210),
|
||||
('3SOL','C3DYokianSoldier',0x44bee0,0x4c19c4,0xc0,'constructor',0x44bfa4,0x4623d0),
|
||||
('3TRO','C3DVRTrophy',0x448c60,0x4be404,0xc0,'constructor',0x448d33,0x4623d0),
|
||||
('3SM1','C3DSmoke',0x440530,0x4b4f08,0xc8,'no_own_call_in_inspected_chain',None,None),
|
||||
('3CAM','C3DCutSceneCamera',0x415a00,0x497bfc,0xc8,'no_own_call_in_inspected_chain',None,None),
|
||||
('3AIT','C3DAITrigger',0x40ba70,0x48f8c0,0xc8,'constructor',0x40be5b,0x464210),
|
||||
('3CHK','C3DCheckPoint',0x414190,0x4959a8,0xc8,'constructor',0x414323,0x464210),
|
||||
('LOAD','CLoadLevel',0x457b10,0x4d025c,0xc8,'constructor',0x457cca,0x464210),
|
||||
)
|
||||
RANGES = (
|
||||
(0x4623d0,0x46246e,'51906b2746390b64d79865a4ea0cddd03733aa5625d562bbf57264b7fa9b3d63'),
|
||||
(0x464210,0x46429f,'a99be3694789b6b6284b7e171eec0f2f26b59eef6a366265646bf6c8cbd92000'),
|
||||
(0x458910,0x45892b,'9631a8979eaae01bbf611aa19759788fb03daa8888f753dc64a58b7b7982070e'),
|
||||
(0x479a40,0x479aba,'cd3225de887694ae93f8ae226eeecf71322038438c7b587a81c14a504b10ae98'),
|
||||
(0x42ab50,0x42ab5f,'faf97e04eb625de47a2541a07db3a483ca05cd9b9fee870c7ca33d272e6e7e7a'),
|
||||
(0x46e570,0x46e69f,'ef42fea8b45653bbd21064e5d2da15011ddadc1790a7356997c2a7ba363d3c9c'),
|
||||
)
|
||||
TARGETS = (0x48e5b4,0x695d3c,0x695d40,0x50999c)
|
||||
|
||||
|
||||
def collect(original):
|
||||
original = Path(original)
|
||||
pe = PE(find_case(original,'Neutron.exe'))
|
||||
if hashlib.sha256(pe.data).hexdigest() != EXE_SHA256:
|
||||
raise ValueError('Unsupported executable')
|
||||
classes = {}
|
||||
for kind,name,ctor,table,displacement,phase,site,target in CLASSES:
|
||||
tables = rtti_map(pe,name)['vtables']
|
||||
if not any(int(t['va'],16)==table and int(t['object_displacement'],16)==displacement for t in tables):
|
||||
raise ValueError('RTTI/table identity mismatch')
|
||||
if site:
|
||||
if target and rel_call_target(pe,site)!=target:
|
||||
raise ValueError('Registration bridge call changed')
|
||||
if target is None and read_va(pe,site,3)!=b'\xff\x50\x2c':
|
||||
raise ValueError('PostLoad InitPhysics dispatch changed')
|
||||
methods = {hex(slot):hex(struct.unpack('<I',read_va(pe,table+slot,4))[0])
|
||||
for slot in (0x28,0x2c,0x178,0x210,0x220,0x40c)}
|
||||
classes[kind] = dict(name=name,constructor=hex(ctor),game_table=hex(table),
|
||||
displacement=hex(displacement),own_registration_phase=phase,
|
||||
registration_site=hex(site) if site else None,
|
||||
registration_file_offset=hex(pe.offset(site-pe.base)) if site else None,methods=methods)
|
||||
ranges, relocations = [], []
|
||||
for start,end,digest in RANGES:
|
||||
data = read_va(pe,start,end-start)
|
||||
if hashlib.sha256(data).hexdigest()!=digest:
|
||||
raise ValueError('Source range changed')
|
||||
ranges.append(dict(va=hex(start),file_offset=hex(pe.offset(start-pe.base)),length=end-start,sha256=digest))
|
||||
for target in TARGETS:
|
||||
for match in re.finditer(re.escape(struct.pack('<I',target)),data):
|
||||
relocations.append(dict(va=hex(start+match.start()),target=hex(target)))
|
||||
path = find_case(original,'gam/VR04.gam')
|
||||
records = []
|
||||
for ordinal,entity in enumerate(parse(path.read_bytes()).entities):
|
||||
c = classes[entity.kind];values=entity.values()
|
||||
records.append(dict(ordinal=ordinal,kind=entity.kind,tag=values.get('ObjectTag'),
|
||||
file_offset=hex(entity.offset),own_registration_phase=c['own_registration_phase'],
|
||||
game_table=c['game_table'],task=values.get('TaskName'),
|
||||
authored={k:values[k] for k in ('HasCollision','RequiredLevel','ExactLevel','RemoveLevel','CanMove') if k in values},
|
||||
runtime_membership='unobserved; reuse, helpers, constructor success and owner calls remain separate'))
|
||||
return dict(source_sha256=EXE_SHA256,classes=classes,ranges=ranges,relocations=relocations,
|
||||
gam_sha256=hashlib.sha256(path.read_bytes()).hexdigest(),records=records,
|
||||
serialized_phase_counts=dict(Counter(r['own_registration_phase'] for r in records)),
|
||||
scope='All72 serialized records/13 class interfaces; conditional source own-registration sites, not a complete runtime physical-list count.')
|
||||
|
||||
|
||||
def generate(original,output,rea):
|
||||
original,output=Path(original).resolve(),Path(output).resolve()
|
||||
if output.is_relative_to(original) or original.is_relative_to(output):
|
||||
raise ValueError('Separate generated directory required')
|
||||
if output.exists() and any(p.is_symlink() for p in output.rglob('*')):
|
||||
raise ValueError('Generated output contains symlinks')
|
||||
report=collect(original)
|
||||
evidence=next(r for r in json.loads(Path(rea).read_text())['records'] if r['evidence_id']==REA_ID)
|
||||
if evidence['subject']['digest']['sha256']!=EXE_SHA256:
|
||||
raise ValueError('REA source identity mismatch')
|
||||
rows=[]
|
||||
for line in evidence['raw_result']['stdout'].splitlines():
|
||||
match=re.match(r'\s*([0-9a-f]+):',line)
|
||||
if match:rows.append((int(match[1],16),line))
|
||||
for item,(a,b,_) in zip(report['ranges'],RANGES):
|
||||
item['rea_extract']='\n'.join(line for va,line in rows if a<=va<b)
|
||||
if not item['rea_extract']:raise ValueError('Missing REA instructions')
|
||||
report['rea_evidence_id']=REA_ID
|
||||
output.mkdir(parents=True,exist_ok=True)
|
||||
text=Path(__file__).with_name('physical_registration_probe.c').read_text()
|
||||
text=text.replace('/* RELOCATIONS */',','.join('{%s,%s}'%(r['va'],r['target']) for r in report['relocations']))
|
||||
(output/'physical_registration_probe.c').write_text(text)
|
||||
(output/'grappler_scalar_probe.c').write_text(Path(__file__).with_name('grappler_scalar_probe.c').read_text())
|
||||
(output/'source.json').write_text(json.dumps(report,indent=2)+'\n')
|
||||
return dict(records=len(report['records']),classes=len(report['classes']),ranges=len(report['ranges']),
|
||||
relocated_operands=len(report['relocations']),serialized_phase_counts=report['serialized_phase_counts'])
|
||||
|
||||
|
||||
def capture(output,directory):
|
||||
output,directory=Path(output),Path(directory)
|
||||
metadata=json.loads((directory/'capture.json').read_text());log=(directory/'wine.log').read_text()
|
||||
if metadata['captures'][-1]['wineExit']!=0 or 'PHYSICAL_REGISTRATION_COMPLETE' not in log:
|
||||
raise ValueError('Incomplete original component capture')
|
||||
source=json.loads((output/'source.json').read_text())
|
||||
digest=lambda p:hashlib.sha256(p.read_bytes()).hexdigest()
|
||||
if digest(find_case(directory/'game','Neutron.exe'))!=source['source_sha256']:
|
||||
raise ValueError('Copied source identity mismatch')
|
||||
if json.loads((directory/'probe-identity.json').read_text())['sha256']!=digest(output/'probe.exe'):
|
||||
raise ValueError('Observed probe identity mismatch')
|
||||
cases=[json.loads(line[4:]) for line in log.splitlines() if line.startswith('REG ')]
|
||||
expected=[('polygon_first','P0;R0;Z0;I0;',[0],[1,0,0],[1,0,0]),
|
||||
('polygon_repeat','P0;R0;Z0;I0;',[0,0],[1,0,0],[2,0,0]),
|
||||
('guard_already_registered','',[0,0],[1,0,0],[2,0,0]),
|
||||
('clear_then_guard','P0;R0;Z0;I0;',[0,0,0],[1,0,0],[3,0,0]),
|
||||
('sprite_first','P1;R1;Z1;I1;',[1],[0,1,0],[0,1,0]),
|
||||
('sprite_repeat','P1;R1;Z1;I1;',[1,1],[0,1,0],[0,2,0]),
|
||||
('nested_init_registration','P0;R0;Z0;I0;P1;R1;Z1;I1;',[1,0],[1,1,0],[1,1,0]),
|
||||
('register_disabled_body','P0;R0;Z0;I0;',[0],[1,0,0],[1,0,0]),
|
||||
('loader_three','I0;L0;I1;L1;I2;L2;C;T;',[],[0,0,0],[1,1,1]),
|
||||
('loader_append_on_init','I0;L0;I1;L1;I2;L2;C;T;',[],[0,0,0],[1,1,1]),
|
||||
('loader_append_on_post','I0;L0;I1;L1;I2;L2;C;T;',[],[0,0,0],[1,1,1]),
|
||||
('loader_empty','C;T;',[],[0,0,0],[0,0,0])]
|
||||
if len(cases)!=len(expected):raise ValueError('Missing original observations')
|
||||
for row,(name,events,order,flags,inits) in zip(cases,expected):
|
||||
if (row['name'],row['events'],row['order'],row['count'],row['flags'],row['inits'])!=(name,events,order,len(order),flags,inits):
|
||||
raise ValueError(f'Original registration mismatch: {name}')
|
||||
for i in range(3):
|
||||
registered=i in order
|
||||
if row['positions'][i] != ([1.25+i,-2.5-i,3.75+i] if registered else [0,0,0]):
|
||||
raise ValueError('Transform publication mismatch')
|
||||
if row['rotations'][i] != ([22.5,-45,90] if registered else [0,0,0]):
|
||||
raise ValueError('Angle bridge mismatch')
|
||||
files=[directory/'wine.log',directory/'capture.json',directory/'probe-identity.json',
|
||||
output/'source.json',output/'physical_registration_probe.c',output/'probe.exe']
|
||||
report=dict(cases=cases,provenance={str(p):digest(p) for p in files},
|
||||
scope='12 isolated copied-code registration/loader cases with synthetic Init/PostLoad/transform/log/timer dependencies; no real scene construction or native Windows test.')
|
||||
(output/'observations.json').write_text(json.dumps(report,indent=2)+'\n')
|
||||
return dict(cases=len(cases),scope=report['scope'])
|
||||
|
||||
|
||||
if __name__=='__main__':
|
||||
cli=argparse.ArgumentParser(description=__doc__);cli.add_argument('original',type=Path)
|
||||
cli.add_argument('--output',type=Path);cli.add_argument('--rea',type=Path);cli.add_argument('--capture',type=Path)
|
||||
args=cli.parse_args()
|
||||
if args.capture and not args.output or args.output and not(args.rea or args.capture):
|
||||
cli.error('Generation needs --output/--rea; capture needs --output/--capture')
|
||||
result=capture(args.output,args.capture) if args.capture else generate(args.original,args.output,args.rea) if args.output else collect(args.original)
|
||||
print(json.dumps(result,indent=2))
|
||||
@@ -0,0 +1,90 @@
|
||||
/* Copied registration and per-object Init/PostLoad loop. No original entrypoint.
|
||||
Synthetic transforms/Init/PostLoad, logging, allocation and timer dependencies. */
|
||||
#define main unused_scalar_main
|
||||
#include "grappler_scalar_probe.c"
|
||||
#undef main
|
||||
typedef struct Node {struct Node*next,*previous;void*value;} Node;
|
||||
typedef struct Actor {
|
||||
unsigned char raw[0x900];uintptr_t table[0x440/4];
|
||||
int id,family,inits,nested;float position[3],rotation[3];
|
||||
} Actor;
|
||||
static Actor actors[3];static Node bodies,registry,registry_nodes[3];
|
||||
static uintptr_t app_table[0x130/4];static unsigned char app[0x900];
|
||||
static char events[1024];static unsigned used;static int append_stage;
|
||||
static void*game(Actor*a){return a->raw+0x100;}
|
||||
static Actor*owner(void*g){for(int i=0;i<3;i++)if(game(&actors[i])==g)return &actors[i];require(0,"actor owner");return NULL;}
|
||||
static void event(char code,Actor*a){used+=(unsigned)snprintf(events+used,sizeof(events)-used,"%c%d;",code,a->id);require(used<sizeof(events)-10,"events");}
|
||||
static void TC position(void*g,float x,float y,float z){Actor*a=owner(g);a->position[0]=x;a->position[1]=y;a->position[2]=z;event('P',a);}
|
||||
static void TC rotation(void*g,float x,float y,float z){Actor*a=owner(g);a->rotation[0]=x;a->rotation[1]=y;a->rotation[2]=z;event('R',a);}
|
||||
static void TC zero(void*g,float x,float y,float z){require(x==0&&y==0&&z==0,"registration150 zero");event('Z',owner(g));}
|
||||
static void list_init(Node*n){n->next=n->previous=n;n->value=NULL;}
|
||||
static void add_registry(int id){
|
||||
Node*n=®istry_nodes[id];n->value=game(&actors[id]);n->next=®istry;n->previous=registry.previous;
|
||||
registry.previous->next=n;registry.previous=n;
|
||||
}
|
||||
static void register_body(Actor*a,int guarded){
|
||||
unsigned entry=guarded?0x42ab50:a->family?0x464210:0x4623d0;
|
||||
((void(TC*)(void*))AT(entry))(game(a));
|
||||
}
|
||||
static void TC init(void*g){
|
||||
Actor*a=owner(g);event('I',a);a->inits++;
|
||||
if(a->nested){a->nested=0;register_body(&actors[1],0);}
|
||||
if(a->id==0&&append_stage==1){append_stage=0;add_registry(2);}
|
||||
}
|
||||
static void TC post(void*g){Actor*a=owner(g);event('L',a);if(a->id==0&&append_stage==2){append_stage=0;add_registry(2);}}
|
||||
static void logging(void*g,const char*label){(void)g;(void)label;}
|
||||
static void TC cleanup(void*self){require(self==app,"app owner");events[used++]='C';events[used++]=';';events[used]=0;}
|
||||
static void timer(void){events[used++]='T';events[used++]=';';events[used]=0;}
|
||||
static void*allocate(size_t size){require(size==12,"body node bytes");return malloc(size);}
|
||||
static void reset(void){
|
||||
if(bodies.next)while(bodies.next!=&bodies){Node*n=bodies.next;bodies.next=n->next;free(n);}
|
||||
list_init(&bodies);list_init(®istry);memset(actors,0,sizeof(actors));
|
||||
memset(app,0,sizeof(app));*(void**)app=app_table;app_table[0x10c/4]=(uintptr_t)cleanup;
|
||||
used=0;events[0]=0;append_stage=0;*(void**)AT(0x695d3c)=&bodies;*(unsigned*)AT(0x695d40)=0;
|
||||
*(void**)AT(0x50999c)=®istry;
|
||||
for(int i=0;i<3;i++){
|
||||
Actor*a=&actors[i];a->id=i;a->family=i==1;*(void**)game(a)=a->table;
|
||||
#define SLOT(s,f) a->table[(s)/4]=(uintptr_t)(f)
|
||||
SLOT(0x16c,position);SLOT(0x174,rotation);SLOT(0x150,zero);SLOT(0x28,init);SLOT(0x40c,post);SLOT(0x3f8,logging);
|
||||
#undef SLOT
|
||||
unsigned char*complete=(unsigned char*)game(a)-(a->family?0xc8:0xc0);
|
||||
float xyz[]={1.25f+i,-2.5f-i,3.75f+i};short angles[]={1024,-2048,4096};
|
||||
memcpy(complete+0x44,xyz,sizeof(xyz));memcpy(complete+0x50,angles,sizeof(angles));
|
||||
}
|
||||
}
|
||||
static void snapshot(const char*name){
|
||||
printf("REG {\"name\":\"%s\",\"events\":\"%s\",\"order\":[",name,events);int first=1;
|
||||
for(Node*n=bodies.next;n!=&bodies;n=n->next){printf("%s%d",first?"":",",owner(n->value)->id);first=0;}
|
||||
printf("],\"count\":%u,\"flags\":[",*(unsigned*)AT(0x695d40));
|
||||
for(int i=0;i<3;i++)printf("%s%u",i?",":"",*((unsigned char*)game(&actors[i])+0x49e));
|
||||
printf("],\"inits\":[%d,%d,%d],\"positions\":[",actors[0].inits,actors[1].inits,actors[2].inits);
|
||||
for(int i=0;i<3;i++)printf("%s[%.9g,%.9g,%.9g]",i?",":"",actors[i].position[0],actors[i].position[1],actors[i].position[2]);
|
||||
printf("],\"rotations\":[");
|
||||
for(int i=0;i<3;i++)printf("%s[%.9g,%.9g,%.9g]",i?",":"",actors[i].rotation[0],actors[i].rotation[1],actors[i].rotation[2]);
|
||||
puts("]}");
|
||||
}
|
||||
static void next(void){used=0;events[0]=0;}
|
||||
int main(void){
|
||||
setbuf(stdout,NULL);map_source();
|
||||
static const struct{unsigned va,target;} relocations[]={/* RELOCATIONS */};
|
||||
for(unsigned i=0;i<sizeof(relocations)/sizeof(*relocations);i++){
|
||||
uint32_t value=(uintptr_t)AT(relocations[i].target);
|
||||
require(*(uint32_t*)AT(relocations[i].va)==relocations[i].target,"original relocation operand");
|
||||
memcpy(AT(relocations[i].va),&value,4);
|
||||
}
|
||||
jump(AT(0x478990),allocate);jump(AT(0x47e470),timer);
|
||||
reset();register_body(&actors[0],0);snapshot("polygon_first");
|
||||
next();register_body(&actors[0],0);snapshot("polygon_repeat");
|
||||
next();register_body(&actors[0],1);snapshot("guard_already_registered");
|
||||
next();*((unsigned char*)game(&actors[0])+0x49e)=0;register_body(&actors[0],1);snapshot("clear_then_guard");
|
||||
reset();register_body(&actors[1],0);snapshot("sprite_first");
|
||||
next();register_body(&actors[1],0);snapshot("sprite_repeat");
|
||||
reset();actors[0].nested=1;register_body(&actors[0],0);snapshot("nested_init_registration");
|
||||
reset();*((unsigned char*)game(&actors[0])+0x13e)=0;*((unsigned char*)game(&actors[0])+0x140)=0;
|
||||
register_body(&actors[0],0);snapshot("register_disabled_body");
|
||||
reset();add_registry(0);add_registry(1);add_registry(2);((void(TC*)(void*))AT(0x46e570))(app);snapshot("loader_three");
|
||||
reset();add_registry(0);add_registry(1);append_stage=1;((void(TC*)(void*))AT(0x46e570))(app);snapshot("loader_append_on_init");
|
||||
reset();add_registry(0);add_registry(1);append_stage=2;((void(TC*)(void*))AT(0x46e570))(app);snapshot("loader_append_on_post");
|
||||
reset();((void(TC*)(void*))AT(0x46e570))(app);snapshot("loader_empty");
|
||||
puts("PHYSICAL_REGISTRATION_COMPLETE");return 0;
|
||||
}
|
||||
@@ -0,0 +1,104 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Guard bounded VR04 generated-helper constructor and registration leads."""
|
||||
import argparse
|
||||
import hashlib
|
||||
import json
|
||||
from pathlib import Path
|
||||
import re
|
||||
import struct
|
||||
|
||||
from checkpoint_script_state import EXE_SHA256,find_case,read_va,rel_call_target
|
||||
from pe_inspect import PE
|
||||
from rtti_map import rtti_map
|
||||
|
||||
CALLS = (
|
||||
('Jimmy baseball loop',0x422633,0x40fc50),
|
||||
('Player jetpack fire',0x4374df,0x421d80),
|
||||
('Jimmy owned Rocketship',0x42243f,0x43d840),
|
||||
('Rocketship FireStrato',0x43d9bc,0x4192e0),
|
||||
('Jimmy Bubble',0x42232c,0x410840),
|
||||
('Jimmy Shadow',0x42250c,0x43f640),
|
||||
('Jimmy TargetCursor',0x42255b,0x4453b0),
|
||||
('Jimmy PointCursor',0x4225be,0x43bc70),
|
||||
('Jimmy GraplingHook',0x422800,0x41eeb0),
|
||||
('Jimmy PostLoad Goddard',0x423c98,0x41c810),
|
||||
('Jimmy PostLoad Jeep',0x423d1a,0x4211a0),
|
||||
('Smoke SmokePuff',0x4406b1,0x440980),
|
||||
('Yokian Shield',0x44a826,0x44b510),
|
||||
('Yokian conditional Shadow',0x44a88f,0x43f640),
|
||||
('Goddard Cursor first',0x41ca9c,0x415760),
|
||||
('Goddard Cursor second',0x41cb09,0x415760),
|
||||
('Bubble registration',0x410992,0x464210),
|
||||
('PointCursor registration',0x43bd67,0x4623d0),
|
||||
('GraplingHook registration',0x41efb4,0x4623d0),
|
||||
('SmokePuff registration',0x440acc,0x464210),
|
||||
('Cursor registration',0x415857,0x4623d0),
|
||||
)
|
||||
CLASSES = (
|
||||
('C3DBaseball',0x49141c,0xc8),('C3DJetpackFire',0x4a3160,0xc0),
|
||||
('C3DFireStrato',0x49bdd4,0xc0),('C3DBubble',0x49250c,0xc8),
|
||||
('C3DShadow',0x4b37b8,0xc8),('C3DTargetCursor',0x4b9f48,0xc8),
|
||||
('C3DPointCursor',0x4b0390,0xc0),('C3DGraplingHook',0x49fafc,0xc0),
|
||||
('C3DJeep',0x4a2aec,0xc0),('C3DSmokePuff',0x4b545c,0xc8),
|
||||
('C3DYokianShield',0x4c0e24,0xc8),('C3DCursor',0x497620,0xc0),
|
||||
)
|
||||
SITES = (
|
||||
('Baseball explicit PostLoad registration',0x41000c,'ff502c'),
|
||||
('Jimmy own selected-start registration',0x4238b4,'ff502c'),
|
||||
('Jimmy owner-driven fire registration',0x4238ef,'ff522c'),
|
||||
('Jeep InitObject registration',0x421552,'ff522c'),
|
||||
('Jeep pointer overwritten before allocation test',0x423792,'89bd70090000'),
|
||||
('Jeep allocation null branch',0x423cee,'85c00f8585000000'),
|
||||
('Jeep overwrite source register is zero',0x4236fa,'33ff'),
|
||||
('Baseball loop count20',0x422610,'be14000000'),
|
||||
('Baseball loop decrement/backedge',0x422695,'4e0f8579ffffff'),
|
||||
)
|
||||
|
||||
|
||||
def collect(original,rea=None):
|
||||
pe=PE(find_case(Path(original),'Neutron.exe'))
|
||||
if hashlib.sha256(pe.data).hexdigest()!=EXE_SHA256:raise ValueError('Original identity mismatch')
|
||||
calls=[]
|
||||
for name,va,target in CALLS:
|
||||
if rel_call_target(pe,va)!=target:raise ValueError(name)
|
||||
calls.append(dict(name=name,va=hex(va),file_offset=hex(pe.offset(va-pe.base)),target=hex(target)))
|
||||
sites=[]
|
||||
for name,va,expected in SITES:
|
||||
if read_va(pe,va,len(bytes.fromhex(expected))).hex()!=expected:raise ValueError(name)
|
||||
sites.append(dict(name=name,va=hex(va),file_offset=hex(pe.offset(va-pe.base)),bytes=expected))
|
||||
classes=[]
|
||||
for name,table,displacement in CLASSES:
|
||||
candidates=rtti_map(pe,name)['vtables']
|
||||
if not any(int(t['va'],16)==table and int(t['object_displacement'],16)==displacement for t in candidates):
|
||||
raise ValueError('Helper RTTI/table mismatch')
|
||||
classes.append(dict(name=name,table=hex(table),displacement=hex(displacement),
|
||||
methods={hex(slot):hex(struct.unpack('<I',read_va(pe,table+slot,4))[0]) for slot in (0x28,0x2c,0x40c)}))
|
||||
result=dict(source_sha256=EXE_SHA256,calls=calls,sites=sites,classes=classes,
|
||||
scope='Bounded generated helper identities/creation/registration sites; not a complete body count, retained cleanup proof or original runtime observation.')
|
||||
if rea:
|
||||
evidence_id='ev_0d64cc58fa8f5573fc8e61e0f2c20e36288099212bd2257d3a3121361fd6c904'
|
||||
record=next(r for r in json.loads(Path(rea).read_text())['records'] if r['evidence_id']==evidence_id)
|
||||
if record['subject']['digest']['sha256']!=EXE_SHA256:raise ValueError('REA identity mismatch')
|
||||
rows=[]
|
||||
for line in record['raw_result']['stdout'].splitlines():
|
||||
match=re.match(r'\s*([0-9a-f]+):',line)
|
||||
if match:rows.append((int(match[1],16),line))
|
||||
ranges=((0x422609,0x42269c),(0x4236fa,0x423798),(0x4238b0,0x4238f5),
|
||||
(0x423ce8,0x423d7b),(0x410000,0x410020),(0x40e7b0,0x40e812),
|
||||
(0x421540,0x421580),(0x440530,0x440780),(0x44a730,0x44a980),
|
||||
(0x4354c0,0x43554a),(0x445580,0x4455b0),(0x44b6c0,0x44b6eb),
|
||||
(0x464810,0x46489a))
|
||||
result['rea_evidence_id']=evidence_id
|
||||
result['ranges']=[]
|
||||
for a,b in ranges:
|
||||
excerpt='\n'.join(line for va,line in rows if a<=va<b)
|
||||
if not excerpt:raise ValueError('Missing REA range')
|
||||
result['ranges'].append(dict(va=hex(a),file_offset=hex(pe.offset(a-pe.base)),
|
||||
length=b-a,sha256=hashlib.sha256(read_va(pe,a,b-a)).hexdigest(),rea_extract=excerpt))
|
||||
return result
|
||||
|
||||
|
||||
if __name__=='__main__':
|
||||
cli=argparse.ArgumentParser(description=__doc__);cli.add_argument('original',type=Path)
|
||||
cli.add_argument('--rea',type=Path);args=cli.parse_args()
|
||||
print(json.dumps(collect(args.original,args.rea),indent=2))
|
||||
Reference in new issue
Block a user