Reconstruct lab story, interactions, patrol and jet pack practice flow

This commit is contained in:
UnixNight committed 2026-10-24 20:33:03 -04:00
1 parent 58424120bb
commit c929f942e1
84 files changed
+7957 -305

No files matched your search

+59 -68
View File
@@ -1,78 +1,69 @@
# Tasks
## Completed milestones
Full-game completion remains the objective. Original files are authoritative;
compile, runtime and original-fidelity verification are separate.
- [x] Entire specification; original inventory/hashes; local-only Git and guidance.
- [x] Binary/compiler/API identification and address-based reports.
- [x] All GAM entities decoded and byte-round-tripped; C# corpus reader tested.
- [x] All indexed OMT meshes/materials/textures/RIFF resources decoded and audited.
- [x] ASE transform/morph-base UV/topology recovery and regression tests.
- [x] .NET10 + SDL3 + Vulkan1.3 shared source; real scene/model/texture rendering.
- [x] Original LV1B lab plus original Jimmy morph preview at GAM startpoint.
- [x] Correct normal atlas and null-material visibility from binary evidence.
- [x] Recovered impulse/gravity/speed/RNG arithmetic fragments with tests.
- [x] Native Linux Vulkan offscreen and SDL3 window/input/resize verification.
- [x] SDL3 recovered WAV stream consumption test (dummy device).
- [x] Self-contained Linux and Windows local packages, matching SDL3 libraries.
- [x] Packaged Linux runtime isolated from SDK/source/originals; renders successfully.
- [x] Preliminary Wine64 Windows-package render; exact fixed-time readback matches Linux.
- [x] Isolated copied-original Wine attempts; actual failures documented.
- [x] Correct preview floor overlap, identify still idle, add explicit animation inspection controls/tests.
- [x] User confirmed corrected Windows build loads and renders.
- [x] Controllable lab: recovered walking/backpedal/turn/no-gadget jump formulas,
original animation clips, fixed60Hz simulation, collision and chase camera.
- [x] 11 collision and13 movement test groups; source lab and synthetic edge cases,
render-rate independence, held/re-pressed jumping and ten-minute stability.
- [x] Linux240-step SDL key/jump/resize replay and GPU readback, zero validation errors.
- [x] Rebuilt both packages; packaged Linux window and preliminary Windows Wine64
window240-step walking/key/jump/resize pass, matching movement statistics.
- [ ] Test this movement checkpoint natively on Windows (previous rendering confirmed).
## Integrated milestones
## Next implementation priorities
- [x] Inventory/hashes, binary/API identification, full GAM round-trip and OMT audit.
- [x] .NET10/SDL3/Vulkan1.3 shared native code and self-contained platform packages.
- [x] Original lab geometry, corrected Jimmy atlas, original morphs and inspection.
- [x] Walking/jumping/chase camera and source-triangle provisional collision.
- [x] Linux headless/window/input/resize/audio-stream checks; initial native Windows
rendering user-confirmed; preliminary Wine64 movement package checks.
- [x] Original TSK/task gates/checkpoint CLI and independent music/speech streams.
- [x]16-cue lab camera/speech/actions/control restoration and skip execution.
- [x] Source actor/sprite/model preparation,9 lab props and all33 available scenes.
- [x] B/E GAM correction: both supplied; missing registered OMT geometry is not an
established progression blocker. No substitution or extra-file request.
- [x] Lab jet pack/Carl/exit task route and objective/inventory/score effects.
- [x] Original objective/practice art, strict input regions, modal pause and VR04 entry.
- [x] Shared Goddard/Carl patrol subset and recovered body support with DLL checks.
- [x] Button/vertical-door behavior and source dynamic broadphase/box triangle rules.
- [x] Powered-jump state/effect/energy arithmetic, original FLY/fire morphs and GPU replay.
1. Replace provisional capsule collision/pivot with recovered original behavior.
Trace `0x479D20` past displacement integration, shared collision call
via interface slot0x130 in `0x462520`, and object collision caches. Retain
invisible/null-material geometry; its exact collision masks remain unresolved.
Recover original actor/model pivot, scale and spawn settling: the preview now
uses a floor-derived model offset, which must be replaced with proven behavior.
Recover stair/step handling, dynamic collider activation, and camera obstruction.
2. Compare reconstructed no-gadget airborne behavior with the original. Walking,
jump state table and zero-fuel held/re-press repeat path are now recovered in
`analysis/movement-checkpoint.md`; transient state3 and takeoff phase remain
approximations. Recover powered gadget states and original animation routing.
3. Recover original frame cadence and phase order; current fixed60Hz preserves
per-call speed increments independent of rendering. Find reverse timer+0x830
writer before implementing its >1.5 turnaround branch. Recover mouse steering.
4. Execute LV1B STARTEXP/LABEXP intro. GAM parsing supplies records; implement task
prerequisites, object activation/visibility, camera triggers and progression
from code/observations. Then build a complete small scene (VR01 if useful).
5. Recover original morph state selection, playback speed, smooth normals and
transitions. Current interpolation is original; loop/speed are preview policy.
6. Continue material/fog/light/blend/culling and render sorting mapping, then
compare visuals to original; current unlit modulation is only a foundation.
## Immediate continuation
## Required validation and expansion
1. Integration suite and both packages pass; commit this stable milestone locally.
Keep native Windows story/input/audio pending and preserve current evidence.
Re-run checks only when new changes or unresolved concerns justify them.
2. Exercise the lab route through actual walking/navigation, buttons and doors.
Current lab-route smoke directly invokes source contacts; it is not navigation
or original-fidelity evidence. Recover runtime42AF00 checkpoint restoration on
VR return separately from saved STRT/RETURN strings and unknown TSK StoredVector.
3. Recover47BD80 collision response/479D20 movement phase and source object exclusions.
Support trace/magnitude/radii/factors and dynamic broadphase are recovered;
wall response, Jimmy capsule/visual pivot, stairs and camera obstruction remain
modern approximations. Preserve source normals and invisible proxy geometry.
4. Complete contextual SFX bank switching, source volume/pan/attenuation/channel
policies, jetpack sound callbacks and MPEG-in-RIFF bird1/id162 decoding. Default
SoundEffects.omt identity and pickup/button/door stream lifecycle are integrated;
physical/native Windows output and original timing remain unverified.
5. Complete objective slide/timing, practice highlights/cursor/controller handling,
energy/gadget UI. Stationary geometry and keyboard/pointer choices are recovered.
6. Recover Carl sensing409CC0, Goddard follow-state4, actor class defaults and full
morph state/playback-end synchronization. Generic patrol states alone are not AI.
7. Recover original global cadence/object phase order, mouse steering/relative input,
exact clipping/fullscreen/focus/scaling behavior and material/fog/light/blend states.
- [ ] Usable original reference captures under local Windows/VM or working Wine.
- [ ] Original walking/jump/collision/camera/input comparisons and first complete scene
including intro/triggers/interactions (movement checkpoint implemented).
- [ ] Physical audio output and original SFX/music timing, mixing/panning/positional audio.
- [ ] Fullscreen, minimized-window, mouse/relative capture, display scaling and controller behavior.
- [ ] Pickups, score/health, gadgets/inventory, combat/AI, all levels and transitions.
- [ ] Original menus, cutscenes, dialogue/voice and state-dependent rendering.
- [ ] Save/load schema and configuration persistence; NewGame reference is not save support.
- [ ] Full native Windows input/audio/resize/driver testing (initial rendering is user-reported).
- [ ] Fidelity regression references, remaining discrepancies and actual release candidate.
## Full reconstruction and verification
## Repeatable commands
- [ ] Working original gameplay captures and physics/input/render/audio comparisons.
- [ ] One complete, source-faithful playable scene including navigation and transitions.
- [ ] All inventory/gadgets, health/damage, enemies/combat, scoring and win/loss behavior.
- [ ] All levels, class-specific triggers/AI and full original progression.
- [ ] Menus, cutscenes, configuration and complete runtime save/load.
- [ ] Original render-state, animation, lighting/fog/alpha and camera fidelity.
- [ ] Speaker output, positional mixing, original timing and native Windows audio.
- [ ] Native Windows input/resize/story/driver validation of the current build.
- [ ] Verified Linux/Windows release packages and documented remaining discrepancies.
- `source scripts/env.sh; dotnet build`
- `scripts/test.sh` (20 Python tests, C# checks, native offscreen/audio, original hashes)
- `python3 tools/extractors/audit.py ../Original --report artifacts/extracted/audit.json`
- `NEUTRON_WINDOW_TEST=1 scripts/test.sh` with DISPLAY for input/resize smoke
- `scripts/package.sh` for local investigation packages (not a finished game release)
## Commands
Keep runtime, tests and docs coherent. No remotes/uploads/cloud CI. Do not modify
originals or claim unobserved fidelity. All prior agent ownership has returned to
primary; use explicit file ownership if further parallel work is started.
From GamePort: `source scripts/env.sh`, `dotnet build`, `scripts/test.sh`.
`scripts/package.sh` rebuilds local packages. `NEUTRON_WINDOW_TEST=1 scripts/test.sh`
adds window checks with a working DISPLAY. `tools/recon/reference_capture.py`
executes copied originals/generated probes in an isolated local harness.
Verify preservation using `python3 tools/recon/inventory.py ../Original --verify
docs/original-manifest.json`. No remotes/uploads/cloud work. Check Git status and
exclusive file ownership before edits; all prior agent ownership returned to primary.