Apply recovered player phases, static camera query and level availability
This commit is contained in:
1 parent
117db77c7b
commit
09cf1172bf
33 files changed
+1500
-99
No files matched your search
@@ -14,6 +14,10 @@ primary ownership. Follow-ups cover [lab registry](lab-registry.md),
|
||||
[scene loader](scene-loader.md). All investigators have returned file ownership.
|
||||
Primary owns integration/runtime corrections. [Exit review](review.md) records
|
||||
checkpoint completion, verified changes and the next evidence gates.
|
||||
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.
|
||||
|
||||
Evidence labels used throughout:
|
||||
|
||||
|
||||
@@ -15,6 +15,17 @@ nearest-hit support query or swept camera sphere would produce a different
|
||||
algorithm. Full follow-camera integration still requires camera state continuity,
|
||||
source angle/previous-eye handling and the remaining input-mode branches.
|
||||
|
||||
**Implementation continuation:** `OriginalCameraRay` now implements these source
|
||||
grids and shares the individual segment kernel with `OriginalBodySupport` while
|
||||
preserving support's nearest-hit reducer. Program uses this query for LV1B/VR04/
|
||||
LEV1. Player follow consumes one query per input callback, source hit adjustment
|
||||
and1.5 gain; the post-interpolation sphere sweep is removed for these scenes.
|
||||
Other scene filters and synthetic fixtures keep the explicit provisional adapter.
|
||||
Eleven managed groups verify route registration counts and synthetic order/kernel/
|
||||
filter cases; a separate movement consumer check asserts origin, gain and absence
|
||||
of a second query. Shared viewport/DEFAULT handoff and full follow state remain
|
||||
open, so this is static-obstruction recovery rather than whole-camera fidelity.
|
||||
|
||||
## Actual caller arguments and unused actor getter
|
||||
|
||||
Jimmy complete vtable4A3BDC, slot16C at4A3D48 (fileA3D48), resolves43B820.
|
||||
|
||||
+16
-11
@@ -2,15 +2,17 @@
|
||||
|
||||
Checkpoint scope: lab → tutorial VR04 → lab → outside, including intro,
|
||||
explanation, pickup/practice, RETURN, Carl conversation and exit. This compares
|
||||
source contracts with playable baseline69d0187, not all gameplay in all levels.
|
||||
source contracts with the current port and preserved playable baseline69d0187,
|
||||
not all gameplay in all levels. Rows marked “now” include the implementation
|
||||
continuation; the original baseline remains a separate comparison point.
|
||||
Address details/PE offsets and source-byte extractors are in the linked reports.
|
||||
**S**=static/data recovery, **P**=isolated original component probe,
|
||||
**M**=managed port regression, **R**=port runtime. No row has full original-game
|
||||
runtime comparison. Coverage does not mean implementation completeness.
|
||||
|
||||
| ID / system | Recovered contract / anchors | Baseline implementation | Evidence / remaining gap | Next bounded action |
|
||||
| ID / system | Recovered contract / anchors | Port implementation | Evidence / remaining gap | Next bounded action |
|
||||
|---|---|---|---|---|
|
||||
| LOOP | Viewport47E4F0: physics479BC0 before registry473740, including game input44DF80; second sync473770; list50999C construction order. Separate millisecond engine logic/morph clock100F9B10. | Fixed60Hz grouped controller→physics→NPC→director→UI→morph. | S/M/R. Source pass/input bridge recovered; actual cadence and retained/spawned-object order still open. | C3: construction/reuse registry trace before changing scheduler. |
|
||||
| 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. |
|
||||
| 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. |
|
||||
@@ -18,10 +20,11 @@ runtime comparison. Coverage does not mean implementation completeness.
|
||||
| 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. |
|
||||
| SCRIPT | Source AI/CAM/MCA dispatch and chains; task45F990 objective406F50 BEFORE records BEFORE per-entity424. | Bounded synchronous director; baseline objective after records/actor batch. | S/M/R. Script callbacks recovered for route; generic class coverage and reentrancy incomplete. | C1: ordered objective notification; C2: per-actor Carl override. |
|
||||
| CONTROL | Global5099E4 null during valid CAM/MCA; PlayerControlled completion target; DEFAULT447D..447F restores camera/UI/music. | Director raw ownership plus explicit debug effective override; player physics stops when uncontrolled. | S/M/R. Null control is not proof all objects/physics stop; scheduler gap remains. | Map raw ownership transitions against phase gates and deferred LOAD. |
|
||||
| CAMERA | Shared viewport; strict>1000 DEFAULT snap;43B820 ray correction;47C210 first wall-grid hit then first general-grid hit, FIFO cells; source per-level far planes. | Shot-time interpolation, separate chase eye stale during cutscenes, fixed follow gains and nearest sphere obstruction; merged max far plane. | S/M/R. Static grid predicate/filters now recovered; x87 boundaries, source angle/previous-eye and input branches open. | C5: static source adapter then shared camera handoff/follow; no nearest-hit substitution. |
|
||||
| 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+74C/+74D deferred scene request; selective teardown/reuse;Jimmy/Goddard retention; per-object28→40C. RETURN root+9A8/flags954/9A5, restore423A90, STRT suppress4427F2. | RuntimeCheckpoint carried root/return bool, reconstructed actors/audio, app-owned presentation. | S/M/R. Core loader chain recovered; per-field resets, retained helper/current-game lifetime and fades open.50988A is editor R input, not load reset. | C7: retained-field/route lifecycle trace, then state-container integration; keep modern presentation. |
|
||||
| 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. |
|
||||
| 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. |
|
||||
|
||||
@@ -42,18 +45,20 @@ runtime comparison. Coverage does not mean implementation completeness.
|
||||
|
||||
## Assumptions and symptom-level adapters to replace
|
||||
|
||||
1. Fixed60Hz and controller-before-physics currently make tests deterministic;
|
||||
they are not recovered original scheduling. Preserve arithmetic tests but do
|
||||
not treat existing travel measurements as the source oracle.
|
||||
1. Fixed60Hz remains a deterministic port policy. Baseline controller-before-
|
||||
physics has now been replaced for the controlled player; other grouped scene
|
||||
callbacks and morph timing remain incomplete. Preserve arithmetic tests but
|
||||
do not treat existing travel measurements as the source oracle.
|
||||
2. Floor snap/visual sole correction and24-unit swept capsule solve visible
|
||||
penetration/navigation symptoms. They do not recover Jimmy's body/root geometry
|
||||
or47BD80 response. Keep rendering pivot and physics support investigations separate.
|
||||
3. Carl activation is applied after a generic actor batch in the baseline;
|
||||
source virtual callbacks execute per actor in registry order. C2 replaces this
|
||||
adapter without inventing full NPC sensing.
|
||||
4. Chase interpolation/sphere clipping and DEFAULT's simple camera reset mask
|
||||
camera ownership gaps. Per-level far limits are recovered; merged-layer maximum
|
||||
is a rendering policy pending masks/fog, not complete clipping recovery.
|
||||
4. Route static sphere clipping is now replaced by source grids/kernel. Chase
|
||||
state and DEFAULT's simple camera reset still mask ownership gaps. Per-level
|
||||
far limits are recovered; merged-layer maximum is a rendering policy pending
|
||||
masks/fog, not complete clipping recovery.
|
||||
5. File duration is a cutscene completion estimate. The source also uses software
|
||||
duration, but integer elapsed boundaries, repeat, invalid/stopped channels,
|
||||
clock pause and effects-bank ownership remain lifecycle inputs. SDL queue-empty
|
||||
|
||||
@@ -53,3 +53,26 @@ allowed where it resolves a core-system question, without waiting for every leve
|
||||
- Exit review: core architecture checkpoint documented in `review.md`; feature
|
||||
expansion remains paused. C1/C2 full integration passes; final follow-up Python
|
||||
discovery and original hashes recorded under artifacts/re-checkpoint/.
|
||||
- C3/C7 gate closed: normal Init copies stored+11 to live+139, restoring the
|
||||
level game's deletion predicate. Destructor explicitly unlinks its registry
|
||||
node. `level-game-lifetime.md` and three byte regressions retain that proof.
|
||||
- C3 first implementation: controlled player physics consumes prior motion/queued
|
||||
impulse before input/player/fire callbacks. Fresh versus retained input order
|
||||
follows proven registration; stored mode and same-frame landing reset are
|
||||
explicit. Twenty movement groups, input-only routes and GPU RETURN pass targeted
|
||||
checks. Full-scene scheduling, uncontrolled-body and collision response remain open.
|
||||
- C5 static adapter implemented/integrated for LV1B/VR04/LEV1: source cell/FIFO/
|
||||
wall-first predicate and single-triangle kernel, source eye adjustment/gain,
|
||||
one query per input callback. Eleven camera groups and existing support groups
|
||||
pass; full camera handoff/input state remains open.
|
||||
- C7 availability correction: level entry enables state4→1 for the recovered eight
|
||||
gadgets, then VR01..08 disables owned1→4. Unknown states/other groups preserved;
|
||||
tutorial bypass unchanged. Source anchors and boundary/round-trip tests cover it.
|
||||
Arbitrary retained scalar/mode/fire state is still gated by the streamer/lifecycle
|
||||
fixture; no blanket carry was introduced.
|
||||
- Full integration passes: artifacts/implementation/integration-final.log.
|
||||
Seventy Python checks, all managed groups including20 movement/11 camera/
|
||||
13 support, GPU story/route/practice/RETURN/jetpack/animation with zero validation
|
||||
errors, SDL dummy lifecycle and539 unchanged hashes. RETURN also verifies
|
||||
retained input order and tutorial availability normalization. Packages rebuilt
|
||||
after the implementation milestone; platform runtime claims remain separate.
|
||||
@@ -0,0 +1,99 @@
|
||||
# C3/C7: old level-game deletion is restored by ordinary initialization
|
||||
|
||||
Static source recovery,2026-10-25. Original Neutron.exe SHA256
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
Preferred VAs below are EXE addresses. Their physical offsets are VA−400000;
|
||||
the read-only helper independently uses PE section mapping and emits both.
|
||||
No original was modified or executed. No modern runtime code was edited here.
|
||||
|
||||
## Resolved distinction: stored defaults versus live state
|
||||
|
||||
The prior loader report correctly found the lab class-default initializer's
|
||||
virtual204(0) at44D472, but that writes **live interface+139 only**. The
|
||||
constructor-reachable class-default stage is not the final lifetime state.
|
||||
The normal initialization pass subsequently restores live state from a separate
|
||||
stored field, **interface+11**. This resolves the apparent preserved-old-game
|
||||
contradiction without inferring destruction from overwriting509948.
|
||||
|
||||
| Stage | Original instruction / function | Effect |
|
||||
|---|---|---|
|
||||
| Generic constructor |46FDB3 pushes1;46FDB7 →470F40 | Setter writes stored+11 and dispatches204 to set live+139 |
|
||||
| Class defaults |44D456 pushes0;44D472 invokes204 | Live+139 becomes0, stored+11 remains1 |
|
||||
| Normal per-object initialization |46E5C3 invokes slot28 | Lab/tutorial/outside game slot28 is44D4E0 |
|
||||
| Game base initialization |44D4E0 jumps4587F0;4587F3 calls470540 | Enters the common initialization bridge |
|
||||
| Restore effective lifecycle state |4705B3 invokes8C getter470F30, pushes result4705B9,4705BC invokes204 setter4719C0 | Reads stored+11 and writes live+139 |
|
||||
| PostLoad |46E61A invokes40C after28 for each object | Game has already restored its ordinary live teardown predicate1 |
|
||||
| Ordinary departure |46E032/46E06F/46E0AC call200 getter4719B0 | Getter reads live+139; game qualifies for all three teardown passes |
|
||||
|
||||
This common initializer also copies other stored/editor configuration fields to
|
||||
live fields. Do not generalize every corresponding field as persisted gameplay
|
||||
state: the +11→+139 bridge is specifically proven here.
|
||||
|
||||
Route game interface tables:
|
||||
|
||||
- Lab4C386C, tutorial VR04 4CE4AC, outside4C561C all resolve28→44D4E0,
|
||||
8C→470F30 and204→4719C0.
|
||||
- 470F30 reads byte[interface+11].4719C0 writes byte[interface+139] from its
|
||||
argument.4719B0 reads that live field for the teardown predicate.
|
||||
- The usual game interface is complete+8C for level-game objects, unlike Jimmy's
|
||||
complete+C0. Pointer bases must remain explicit.
|
||||
|
||||
## Actual deletion and registry removal
|
||||
|
||||
For initialized old level games with live+139=1, ordinary transition46DFF0:
|
||||
|
||||
1. Calls slot20 in the first filtered traversal at46E054.
|
||||
2. Calls slot34 in the second filtered traversal at46E091.
|
||||
3. Sets interface+6=1 in the third traversal at46E0CA.
|
||||
4. Calls473710 at46E0D9. That sweep finds marked objects, invokes interface
|
||||
slot0 with argument1 at473733..737, then restarts the global list scan.
|
||||
|
||||
Lab slot0 at4C386C points44F610: subtract5C converts game interface+8C to the
|
||||
destructor's complete+30 subobject, then jumps44F3F0. That scalar deleting
|
||||
wrapper calls44F420; its base call44F499→44D390 jumps44D3C2→4746E0.
|
||||
The game destructor calls4587E0 at47476A with its game interface, and4587E0
|
||||
jumps470060, the common interface destructor.
|
||||
|
||||
The common destructor explicitly scans registry50999C at4700E5, matches the
|
||||
dying interface against node+8 at4700F2, and erases matching nodes using
|
||||
469490 at470106 with list object509998. This is the actual old-game registry
|
||||
removal edge. It precedes allocation/registration of the destination game in
|
||||
46E170. Existing current-game pointer509948 can temporarily refer to the old
|
||||
object during teardown; destination construction overwrites it later, but that
|
||||
overwrite is not the operation responsible for deletion.
|
||||
|
||||
There is no need to model accumulating old level-game input callbacks for the
|
||||
normal route: the initialized live flag selects ordinary deletion. Abnormal
|
||||
paths that bypass normal Init or mutate the stored/live flags require separate
|
||||
evidence and are outside this successful-load case.
|
||||
|
||||
## Why Jimmy and Goddard differ
|
||||
|
||||
Jimmy4226B5..BF and Goddard41C99B..9E invoke470F40 with0. Unlike the game's
|
||||
class-default virtual204(0), this updates **both** stored+11 and live+139.
|
||||
Common Init therefore restores0 for these retained characters, and their
|
||||
positive reusable+9 fields allow GAM/object lookup reuse without re-appending
|
||||
their nodes. Those constructor values, their reuse flag and any later field
|
||||
resets are separate concepts.
|
||||
|
||||
Fresh lab order game→Jimmy→fire remains proven by lab-registry.md. On a
|
||||
successful later ordinary load the old game is deleted, retained nodes keep
|
||||
their order, and the new game is appended afterward. Thus relative input versus
|
||||
Jimmy order can differ from fresh construction. Complete retained helper-node
|
||||
and per-field reset coverage is still needed before claiming all callback
|
||||
ordering or all transition state is recovered.
|
||||
|
||||
## Verification and implementation consequence
|
||||
|
||||
`checkpoint_level_game_lifetime.py ../Original` checks the binary identity,
|
||||
decisive stored/live flag, initialization, teardown and destructor/unlink bytes,
|
||||
plus route vtable targets. Its tests guard the actual source contract rather
|
||||
than a speculative lifecycle simulation. This is static evidence, not observed
|
||||
original gameplay.
|
||||
|
||||
The normal old-level-game removal gate is now closed. C3 can preserve retained
|
||||
object insertion order while deleting/replacing the level-game callback owner,
|
||||
instead of freezing fresh game-before-Jimmy order for every transition. Keep
|
||||
the port's application-owned window/Vulkan session as the authorized modern
|
||||
presentation policy. Remaining source gates are per-field character/helper
|
||||
reset rules, exact timer/event-pump behavior and original runtime comparison.
|
||||
@@ -0,0 +1,79 @@
|
||||
# C3 implementation: player phase boundaries
|
||||
|
||||
The first implementation chunk separates the controlled player's prior-body
|
||||
physics, game input, player controller, owned fire effect and camera-input update.
|
||||
It does not replace the entire scene scheduler, collision response or animation
|
||||
clock. Evidence is in `input-frame-bridge.md`, `lab-registry.md`, the new
|
||||
`player_phase_evidence.py`, and the follow-up `level-game-lifetime.md`.
|
||||
|
||||
## Source contract and implementation
|
||||
|
||||
EXE47E554 calls479BC0 physics before473740 game-object callbacks47E582;473770
|
||||
sync follows47E587. A fresh game registers before Jimmy, and Jimmy before his
|
||||
owned fire. Retained Jimmy/fire precede the newly appended destination game.
|
||||
The level-game deletion predicate is restored by normal initialization; a
|
||||
constructor-default zero is not the final gameplay lifetime flag. The focused
|
||||
lifetime report records the complete vtable/field provenance.
|
||||
|
||||
`LabSimulation.Step` now integrates **existing** velocity, acceleration and queued
|
||||
impulse first. Fresh input then produces speed/destination yaw, the player update
|
||||
produces velocity/impulse for the next physics pass, and fire ticks afterward.
|
||||
On scene continuation, the player/fire update precedes the destination input
|
||||
callback. `InputAfterPlayerUpdate` records this specific retained registry relation;
|
||||
it does not claim all source objects are retained by the current port.
|
||||
|
||||
Input uses the stored movement mode, as438B1E..438B2A does, rather than deriving
|
||||
it from current physical support. Held jump selects air mode at437A96. Grounded
|
||||
released-jump reset437B9E..437BAC clears jump state, mode and turn in the **player**
|
||||
callback. Landing can therefore clear turn on the same frame physics finds support.
|
||||
Jump queues impulse after physics and requests its pose; it does not retroactively
|
||||
move the body or falsely clear its physical supported state that frame.
|
||||
|
||||
Source addresses above have EXE raw offsets VA−400000. The helper verifies the
|
||||
hashed supplied EXE, maps PE offsets and checks9 decisive instruction sequences.
|
||||
No original code was executed for these source assertions.
|
||||
|
||||
## Verification and remaining limits
|
||||
|
||||
Movement regressions assert old velocity before current input, one-time delayed
|
||||
impulse consumption, fresh versus retained ordering, independent movement mode,
|
||||
landing reset and unchanged fixed-step presentation independence. Input-only lab
|
||||
navigation still reaches SCENE35→50→60 and the outside LOAD. This is port evidence,
|
||||
not original timing/latency fidelity. Source nominal frame rate remains unproven;
|
||||
the port keeps its explicit60Hz policy.
|
||||
|
||||
The existing capsule/gravity adapter remains. Source479DF7..479E54 can cancel
|
||||
gravity on a support hit before a queued jump, giving a different first takeoff
|
||||
velocity. Applying that cancellation to the provisional capsule's prior support
|
||||
flag caused false support transitions in the port; it must be integrated with
|
||||
the recovered pre-integration support/response in C4, not bolted onto that flag.
|
||||
No source-fidelity claim is made for jump apex, stairs, wall response or visual
|
||||
pivot. The underground replay checks clearance of the recovered radius60 body,
|
||||
not raw209-unit standing-mesh bounds, which are a separate provisional render
|
||||
scale/pivot policy. Closed-gate collision and both directional crossings remain
|
||||
required. This clarifies the physical assertion rather than inferring a collider
|
||||
from the render mesh.
|
||||
|
||||
Other scene callbacks still run in subsystem groups. Uncontrolled player physics
|
||||
and control-release body preparation need their own source trace before changing
|
||||
cutscene behavior. Engine morph logic remains on the port animation clock. These
|
||||
are explicit next scheduler boundaries, not claimed solved by this player chunk.
|
||||
|
||||
Bounded follow-up anchors for that next boundary (static reads, not implemented
|
||||
here): Jimmy game vtable4A373C+410→42AFC0 calls43A750 at42AFC3.43A758 clears
|
||||
speed interface608;43A76C calls2C4 with three zero arguments. That target471F40
|
||||
writes interface1A4/1A8/1AC. Map this preparation to the body consumer before
|
||||
changing uncontrolled physics or resumption. Slot438→42AE00 additionally calls
|
||||
complete178→427FF0 and sets interface1D65/global4F8182. These callbacks belong
|
||||
to CAM/MCA ownership transfer, rather than interpreting null control as a whole
|
||||
world pause. Lateral input complete870 is written by walking input43915D/4391B1/
|
||||
439226; its cross-mode lifetime is another scalar coupling to verify when filling
|
||||
out the phase state model. The present chunk does not claim all controller fields.
|
||||
|
||||
Final verification: full scripts/test.sh passes, log
|
||||
`artifacts/implementation/integration-final.log`;20 movement groups and the new
|
||||
11 camera groups, existing support/interaction/route suites, all GPU replays with
|
||||
zero enabled-validation errors, SDL dummy tests and539 original hashes unchanged.
|
||||
The70 Python checks include the new mode/phase and lifecycle source anchors.
|
||||
Baseline69d0187 and current240-step completed walks have essentially identical
|
||||
travel/final position; within-frame producer/consumer timing is tested separately.
|
||||
@@ -0,0 +1,151 @@
|
||||
# Retained character resets: bounded C3/C7 contract
|
||||
|
||||
Static investigation,2026-10-25. Originals remain read-only and were not executed.
|
||||
Neutron.exe SHA256 is
|
||||
`f5281076e1a2492f2d61f87aae3f4544b6d0f535ebe33f9fbb6f78710fe1aea8`.
|
||||
All code/vtable anchors below are preferred-base EXE VAs; PE-mapped raw file
|
||||
offset is VA−400000 for these sites. The new helper prints both coordinates and
|
||||
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.
|
||||
|
||||
## Enclosing ordinary-load phases
|
||||
|
||||
The common loader evidence remains `scene-loader.md`: selective teardown, GAM
|
||||
factory/reuse/property stream, then registry per-object28 followed immediately
|
||||
by40C. Jimmy/Goddard can survive and be reused; that alone does not imply every
|
||||
field survives. Jimmy uses game-interface complete+C0; shadow uses complete+C8.
|
||||
Keep constructor/default-class initialization separate from callbacks28/40C.
|
||||
|
||||
The object property read at46E3FD uses IAT48D190, imported
|
||||
`OMediaStreamOperators::operator>>(OMediaClassStreamer*)`. Route JIM1 property
|
||||
records contain authored position/rotation/flags/StartPoint and no serialized
|
||||
jump/movement-mode/burn timer field. This is a statement about decoded records,
|
||||
not proof the read implementation cannot indirectly invoke another callback.
|
||||
Full streamer virtual call provenance is still a separate gate.
|
||||
|
||||
## Jimmy initialization: exact resets and a coordinate correction
|
||||
|
||||
Jimmy interface vtable4A373C+28→437890. It first calls4587F0 at437896;
|
||||
4587F0→470540 applies generic authored/live-property setters, then calls
|
||||
interface68(1). Jimmy-specific43789B..4378C1 then:
|
||||
|
||||
| Instruction / raw offset | Field and recovered effect |
|
||||
|---|---|
|
||||
|4378A1 /378A1|Clear interface608 = complete6C8 (movement speed in existing recovery)|
|
||||
|4378A7 /378A7|Clear interface614 = complete6D4 (air turning accumulator)|
|
||||
|4378AD /378AD|Clear interface618 = complete6D8; full semantic name unresolved here|
|
||||
|4378B8 /378B8|Invoke interface328 =4723F0, the logical Euler-vector getter|
|
||||
|4378BE..4378C1 /378BE..378C1|Copy that vector's Y into interface61C = complete6DC|
|
||||
|
||||
**Correction:** interface328 is not velocity.4723F0 copies interface224/228/
|
||||
22C/230, the logical Euler vector (position is214/218/21C/220). Therefore the
|
||||
earlier scene-loader wording “captures another velocity component” is stale.
|
||||
The clear618/capture61C pair should remain unnamed or associated with yaw
|
||||
tracking until its consumers are traced; do not carry it as vertical velocity.
|
||||
|
||||
Generic470540 additionally clears interface274/278/27C and298 at4709CA..9DC,
|
||||
then sets byte5=1 and bytesA/6=0. This report does not name that vector as impulse
|
||||
without tracing the actual body consumer. It also re-applies authored defaults
|
||||
through virtual getters/setters, so absence of a direct scalar write in437890
|
||||
alone is not proof of scalar preservation.
|
||||
|
||||
## Jimmy PostLoad40C
|
||||
|
||||
Vtable4A373C+40C→423610. Selected proven effects relevant to transition state:
|
||||
|
||||
| Site | State transition / ownership |
|
||||
|---|---|
|
||||
|42363B|Clear interface1D91; semantic name not assigned|
|
||||
|423642..423656|Load default SoundEffects.omt, set current bank696008; gate4F8434 initially clear|
|
||||
|4236A3/4236AA|Set current interaction/body radius60 through interface110|
|
||||
|4236B3/4236BA|Set support factor1.265f through interface100|
|
||||
|4236C0|Clear interface938 (tutorial flag later set for VR01..08)|
|
||||
|4236FF|Current game virtual168(0), a gameplay/modal state callback; do not equate every control state with world pause|
|
||||
|42370A and423729|Complete11C(0) for Jimmy and existing companion; both resolve40D350 and disable morph animation pause flag complete654, not jump/movement mode|
|
||||
|42375E/423778|Stop associated saved effect handles through458A00, mark handles974/988 as−1|
|
||||
|42378B /2378B|Clear WORD interface728 = complete7E8, the jump state, to0|
|
||||
|423792|Clear interface970 temporary object pointer before later allocation|
|
||||
|42399D/4239E6|Apply matching STRT root and Euler rotation|
|
||||
|423A90..423B1E|Consume pending RETURN flag, override Jimmy with saved departure root, apply identical companion root|
|
||||
|423B3D|Grant control through current game virtual118|
|
||||
|423B43..423C67|Write shared viewport: authored STRT camera occurs inside match loop, later unconditional actor-local(0,200,−300) overwrites viewport eye|
|
||||
|423CD4..423CE2|When companion already exists, call its interface174(0,0,0); constructor is not repeated|
|
||||
|
||||
The final viewport assignment explains why merely carrying the old chase-eye
|
||||
cache would not reproduce source scene entry. Full orientation/follow cache
|
||||
setup remains in the camera investigation. The unconditional final eye uses
|
||||
local(0,200,−300), distinct from DEFAULT's local(0,500,−500) conditional snap.
|
||||
|
||||
### Movement mode, fire and transition staging limits
|
||||
|
||||
Player constructor43748A initializes complete7C4 movement mode0, but the inspected
|
||||
JimmyInit28 and JimmyPostLoad40C do not establish an unconditional reset of this
|
||||
field. PostLoad does explicitly reset jump state7E8 as above. Stage43B5A0 is
|
||||
called with the complete player pointer; its complete148 call43B7FB resolves
|
||||
429A00, which stops sound handle completeA44 and assigns−1. That callback does
|
||||
not reset movement mode or fire time. Stage also clears complete7FC at43B5EE.
|
||||
|
||||
Do not promote absence of writes in these bounded local functions to a complete
|
||||
preservation proof: game/streamer/control callbacks and class-specific gadget
|
||||
cleanup can change player state elsewhere. In particular RETURN457FF7 performs
|
||||
gadget cleanup before flags/staging, distinct from ordinary stage. Carrying raw
|
||||
movement mode, held input, physics vectors or arbitrary jump timers across scenes
|
||||
is not yet justified by this report. The current port's blanket constructor
|
||||
zeroing is likewise an implementation policy, not a recovered reset contract.
|
||||
|
||||
## Retained fire/shadow/companion callbacks
|
||||
|
||||
| Object | Constructor-only state | Ordinary per-object28 /40C |
|
||||
|---|---|---|
|
||||
|Jetpack fire complete+C0 interface4A3160|421E51 calls470F40(0), selecting retention;421E62 zeros complete6BC owner and421E68 zeros complete6C0 timer; player437525 later assigns owner interface to6BC|28=4587F0 generic Init;40C=40E7B0 generic visibility/animation policy. Neither local path assigns owner6BC or timer6C0. No repeated constructor assumed.|
|
||||
|Shadow complete+C8 interface4B37B8|43F767 calls470F40(0); authored size/owner are separate from runtime position|28=4587F0;40C=43F810→4354C0, then copies authored size words to completeAC/B0, resets completeB4=2/B8=0 and optional visibility flag. More base4354C0 effects remain open.|
|
||||
|Goddard complete+C0 interface49F480|Ctor sets retention/reuse and owns shadow; aliases/defaults are constructor state|28=41E6A0→407EB0→4587F0; then byteA=1, AIstate608=authored87C, current waypoint800=null.40C=41E590→409480, then level-specific visibility/collision/radius policy.|
|
||||
|
||||
Fire421FB0 later queries its owner and, when grounded, clears timer interface600
|
||||
(complete6C0) at421FE9, then subtracts dt. That is an **effect tick**, not an
|
||||
initialization reset. It can observe the controller's same-pass changes according
|
||||
to the recovered registry ordering. Timer preservation through local28/40C does
|
||||
not prove it survives the entire transition unchanged without an intervening
|
||||
owner/gadget/frame callback; exact first destination tick remains a lifecycle test.
|
||||
|
||||
Goddard's ordinary PostLoad sets radius130 and enables normal body behavior for
|
||||
LV1B/VR04/LEV1; source-level hide branches cover other levels. Its existing-instance
|
||||
callback174 is4716D0, not a constructor. Full rotation/AI resource resets in
|
||||
409480 are not recovered here; retain the earlier patrol approximations explicitly.
|
||||
|
||||
## Directly evidenced implementation candidate: gadget availability
|
||||
|
||||
JimmyPostLoad **always first enables** group0 gadgets in source order
|
||||
`7,3,0,5,1,6,2,4` via403870(false), calls423DEF..423E3F. For numeric
|
||||
VR01..VR08 it then calls403870(true) for those same indices at423E71..423EC1.
|
||||
At40389E, disabling changes only owned state1→4; at4038AA enabling changes only
|
||||
4→1. All other values are preserved, including unowned0 and unknown wire values.
|
||||
This is availability state, not ownership acquisition or inventory reset.
|
||||
|
||||
For the route: lab entry converts disabled-owned4→1; practice VR04 converts
|
||||
owned1→4; return lab converts4→1. The VR04 powered-jump path bypasses the normal
|
||||
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`
|
||||
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
|
||||
inventory regions and TSK round-trip back to lab. GPU practice/RETURN smoke also
|
||||
asserts state4 in VR04 and state1 on lab return. This correction does not invent
|
||||
persistence for arbitrary physics/mode/fire fields.
|
||||
|
||||
## Verification and remaining gates
|
||||
|
||||
Run `python3 -m unittest discover -s tests -p test_checkpoint_character_reset.py -v`
|
||||
and `python3 tools/binary/checkpoint_character_reset.py ../Original`. Tests verify
|
||||
31 immutable instruction anchors,11 callback/vtable targets,16 exact gadget-call
|
||||
arguments, source route player property names, and conditional1/4 conversion
|
||||
boundaries. The state oracle tests interpretation, not execution of source code.
|
||||
|
||||
Remaining gates: complete property-streamer callback chain; RETURN gadget cleanup
|
||||
versus ordinary departure; movement-mode/fire/hold/extra-acceleration writer
|
||||
provenance through all destination callbacks; physical body re-registration/reset;
|
||||
full shadow base reset and Goddard409480 policy; source camera orientation/cache
|
||||
reset. Do not carry these fields merely because object identity persists.
|
||||
@@ -1,5 +1,11 @@
|
||||
# Checkpoint exit and implementation continuation
|
||||
|
||||
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`,
|
||||
`level-game-lifetime.md` and the current ledger. The exit review below preserves
|
||||
the evidence/verification boundary at the original checkpoint milestone.
|
||||
|
||||
The initial architecture checkpoint is complete: all requested core systems have
|
||||
source anchors, state owners/lifetimes, route interactions, baseline comparison,
|
||||
explicit unknowns and bounded implementation actions. Feature expansion remains
|
||||
|
||||
@@ -79,7 +79,7 @@ retention and the current-level global509948 are distinct: GAM loading assigns
|
||||
Further class-specific lifecycle flags or later predicate changes require their
|
||||
own evidence; do not generalize the constructor default into a full object map.
|
||||
|
||||
**Critical integration consistency gate: old level-game ownership.** The lab game
|
||||
**Resolved follow-up: old level-game ownership.** The lab game
|
||||
is initialized for preservation (interface4C386C slots200/204 resolve
|
||||
4719B0/C0; defaults bridge above reaches44D456's push0/44D472's dispatch204).
|
||||
Later changes to that predicate remain part of the lifetime audit. GAM loading then
|
||||
@@ -95,12 +95,16 @@ The lab constructor chain44F300→44F358/44D2B0→44D306/4745A0 was also inspect
|
||||
destructor/removal was established in this inspected chain. **Overwriting the
|
||||
current-game pointer does not remove an old game from registry50999C.**
|
||||
|
||||
Consequently the remaining contract must include the old level-game registry
|
||||
membership and callback eligibility: locate its explicit removal/deactivation
|
||||
or account for its retained28/40C/update callbacks. Do not infer a clean sequence
|
||||
containing only Jimmy/Goddard plus the new game from selective deletion alone.
|
||||
Possible later class/OMT ownership effects remain open; this negative bounded
|
||||
audit does not prove that old games accumulate or remain active at runtime.
|
||||
The subsequent audit in `level-game-lifetime.md` closes this gap: normal Init28
|
||||
calls470540, whose4705B3 getter8C reads stored interface+11 through470F30;
|
||||
4705BC setter204 copies it to live+139. Generic game construction stored+11=1;
|
||||
the direct defaults204(0) never changed that stored value. Thus initialized level
|
||||
games qualify for selective teardown. Their destructor reaches470060 and
|
||||
explicitly removes their registry node at470106→469490. Jimmy/Goddard instead
|
||||
use470F40(0), setting both stored/live fields, so initialization preserves their
|
||||
retention. The earlier bounded prefix/constructor search was incomplete; pointer
|
||||
overwrite is still not deletion, but Init and destructor now establish actual
|
||||
old-game removal and retained-character/new-game ordering.
|
||||
|
||||
## GAM construction/reuse and initialization
|
||||
|
||||
@@ -127,7 +131,7 @@ registry in order. It invokes object28, handles attached render-object state,
|
||||
then object40C, handles attached render state again, then advances registry.
|
||||
These are per-object boundaries, not “initialize all, then PostLoad all.” Jimmy's
|
||||
28 is437890; it calls4587F0→470540 and resets movement fieldsinterface+608/+614/
|
||||
+618 and captures another velocity component+61C. Jimmy40C423610 applies:
|
||||
+618 and captures logical Euler.Y (yaw) into+61C, not body velocity. Jimmy40C423610 applies:
|
||||
|
||||
1. Matching source STRT root42399D and rotation4239E6.
|
||||
2. Existing companion source root423A36.
|
||||
@@ -176,8 +180,8 @@ force original editor R semantics into the game's current R reset control.
|
||||
|
||||
## Bounded continuation gate
|
||||
|
||||
1. Resolve old level-game removal/deactivation and callback eligibility across
|
||||
destination construction. Then trace a retained Jimmy through one departure,
|
||||
1. Old level-game removal is now resolved by the Init stored/live flag bridge and
|
||||
destructor unlink. Trace a retained Jimmy through one departure,
|
||||
identifying every mutation
|
||||
from property load, initialization and PostLoad. Constructor evidence closes
|
||||
byte+9 ownership; it does not substitute for this per-field reset trace.
|
||||
|
||||
Reference in new issue
Block a user