Render original lab and Jimmy with native Vulkan and SDL3 on .NET 10

This commit is contained in:
UnixNight committed 2026-10-23 17:36:04 -04:00
1 parent 3df20ac19a
commit 008c0e16da
41 files changed
+2125 -68

No files matched your search

+59 -26
View File
@@ -1,30 +1,63 @@
# Tasks
## Completed
- [x] Full specification read; original inventory, hashes and local Git established.
- [x] Capabilities/tool reconnaissance; independent investigators with file ownership.
- [x] Executable format and engine identification.
- [x] Decode/round-trip all 35 GAM files; reader corruption and original-data tests.
- [x] Implement C# GAM asset reader (compilation/runtime checks pending).
## Completed milestones
## Active
- [ ] Complete binary/graphics report with addresses, rendering state and camera.
- [ ] Recover player timing, movement, gravity, collision and input algorithms.
- [ ] Extract OMT meshes, textures, materials, animations, sound and music robustly.
- [ ] Verify asset schema and integration into native Vulkan renderer.
- [ ] Compile .NET 10 runtime and verify real offscreen rendering/readback.
- [ ] Integrate SDL3 window/input/audio; exercise local display where possible.
- [ ] Local Linux and Windows self-contained builds and dependency packaging.
- [ ] Test original preservation after tools; checkpoint stable work locally.
- [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] Isolated copied-original Wine attempts; actual failures documented.
## Required after foundation
- [ ] Run original in isolated copied-data Wine prefix or local Windows VM.
- [ ] Capture original startup, controls, camera, animation, audio and gameplay.
- [ ] Reconstruct LV1B opening sequence and one complete playable scene.
- [ ] Implement/verify collision, interactions, trigger/task system and progression.
- [ ] Implement original animation playback and correct rendering states.
- [ ] Implement menus, inventory, gadgets, combat/AI and all remaining scenes.
- [ ] Recover save/load behavior, configuration, audio mixing and transitions.
- [ ] Compare reconstruction to original references; resolve fidelity differences.
- [ ] Run native Windows tests; distinguish cross-publishing from runtime evidence.
- [ ] Produce verified local release packages and accurate known limitations.
## Next implementation priorities
1. Recover full player physics/collision and controller before calling any preview
playable. 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.
2. Finish airborne state table at `0x437F90` (jump at `0x4383B3`, extra acceleration
`0x438148`, held predicate `0x42A730`, mode dispatch `0x437A8C`). Gravity is -800,
queued impulse550, but normal jump states add gravity*1.33-gravity; avoid the
incomplete '-800 only' jump model. Map landing, retrigger and jetpack gates.
3. Finish walking friction/input/cadence: `0x438BC0`, `0x437C40`, destination yaw
`0x472660`, yaw interpolation `0x43A430`. Resolve mixed per-call acceleration
with timed integration; rendering refresh rate must not accelerate movement.
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.
## Required validation and expansion
- [ ] Usable original reference captures under local Windows/VM or working Wine.
- [ ] Original walking/jump/collision/camera/input comparisons and first complete scene.
- [ ] 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.
- [ ] Native Windows execution/input/audio/resize/driver testing (cross-build already passes).
- [ ] Fidelity regression references, remaining discrepancies and actual release candidate.
## Repeatable commands
- `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)
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.