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

+30 -2
View File
@@ -70,5 +70,33 @@ meaning depends on each property.
Save data has a fixed-looking region followed by Pascal task names and big endian
values (NewGame.tsk tail includes SCENE = 30). Save writing is not yet recovered.
Physics, jumping, collision, AI, RNG, combat, progression and cutscene execution
remain under investigation. No original gameplay session has been captured yet.
## Recovered arithmetic fragments
Binary analysis has now resolved actual game gravity, jump impulse and basic
integration order. `src/GamePort/Game/RecoveredMotion.cs` implements those narrow
fragments independently of the still-unrecovered full controller/collision system.
- CJimmyGame setup `0x44D414` overrides generic engine gravity to (0,-800,0).
- Jump branch `0x4383B3` queues a one-frame (0,550,0) impulse.
- Player airborne logic additionally changes acceleration: state<3 at `0x438148`
uses `gravity*1.33-gravity`, producing roughly -1064 effective vertical
acceleration. Other states/jetpack gates remain unresolved. Therefore the
tested -800 free-motion fragment is **not** a complete normal-jump controller.
- Physics `0x479EBB..0x479FC0` consumes/clears impulse, adds acceleration*dt and
gravity*dt, then computes displacement from the updated velocity (semi-implicit
Euler). Subsequent collision resolution and activation flags remain unresolved.
- Player speed increment 30, idle decay 35 and maximum 600 are per invocation,
without dt. Constructor fields and branch addresses are in binary.md. Rendering
frame rate must not silently become the simulation invocation rate.
- The original uint32 RNG at `0x438D52` wraps `state*1664525+32767` and returns
`state>>16`. A System.Random replacement would produce different sequences.
- The -350 value originally suspected during investigation is a camera offset,
**not** gravity. Follow offset (0,200,-350), look target offset (0,80,0).
C# regressions exercise impulse consumption/order, limits, initial original data,
and RNG overflow. These establish the reconstructed arithmetic, without claiming
bit-identical x87 behavior or a complete faithful controller.
Physics gating, collisions, AI, combat, progression, cutscene execution and
simulation cadence remain under investigation. No original gameplay session has
been captured yet.
+12
View File
@@ -23,6 +23,18 @@ verification possible without a desktop; this is distinct from SDL presentation.
Simulation implementation must follow recovered algorithms and timing. A generic
fly camera or rendered model alone does not satisfy the playable-scene requirement.
The completed foundation includes a single synchronous Vulkan renderer supporting
offscreen and SDL surface presentation, an independent SDL WAV stream, bounded
GAM/PNG/scene readers, and a retained-topology morph sampler. Prepared scene JSON
avoids a Python runtime dependency in native packages. Mesh draw ranges omit null
materials following the original renderer, while retaining their geometry. Default
normal atlas and morph transforms are supported by binary/duplicate-asset evidence.
Physics arithmetic fragments are independent of a full controller; no invented
collision/task system has been silently inserted. The main program remains a
scene investigation runtime; future simulation must be a separate stateful module
with recovered timing, input, collision, triggers and progression.
Subsystem implementation and validated ownership are documented in
`infrastructure.md`, `analysis/graphics.md` and `rendering.md` as they become
available. Persistent docs distinguish planned architecture from verified behavior.
+34 -17
View File
@@ -1,21 +1,38 @@
# Compatibility and validation
Status is evidence-based; compilation alone is not runtime verification.
Compilation, native runtime, original behavior and full feature completion are
separate evidence categories. **The game is not fully reconstructed/playable yet.**
| Feature | Implemented | Tested | Evidence / limits |
|---|---|---|---|
| Original preservation | Hash baseline | Initial corpus | 539 files in original-manifest.json |
| GAM reader/encoder Python | Yes | Linux, all 35 levels | Byte-for-byte round trip, six tests |
| GAM C# loader | Yes | Pending compilation | Original scene/player/camera exposed |
| OMT geometry recovery | In progress | Original level1 meshes | Asset agent integration pending |
| .NET 10 Linux build | In progress | Pending | Project-local SDK installed |
| Windows x64 build/package | Pending | Unverified | Cross-build will not prove execution |
| Vulkan frame | In progress | Pending | Headless Mesa available; no initial display |
| SDL3 window/input/audio | In progress | Pending | Native dependencies being built locally |
| Playable scene / original fidelity | No | No | Rendering foundation does not establish gameplay |
| Original execution/reference capture | No | No | Wine absent initially; originals not executed |
| Animation/AI/combat/progression/save | No | No | Reverse engineering ongoing |
| Feature | Implemented / tested | Evidence and limits |
|---|---|---|
| Original preservation | Verified after extraction/runtime tests | All539 original SHA-256 hashes unchanged |
| GAM Python / C# | All35 files,3299 entities | Exact Python round-trip; C# corpus/start/corruption checks |
| OMT recovery | All100 archives audited | 2155meshes,2183materials,1614textures,875RIFF, zero failures |
| C# original loaders | Linux runtime | All128 PNG /254 ASE base meshes; morph/base UV tests |
| .NET10 Linux build | Pass, zero warnings/errors | Local SDK10.0.402/runtime10.0.13 |
| Windows x64 publish | Pass | Correct PE32+ app and SDL3.dll; native execution untested |
| Linux self-contained package | Native run verified | Two headless frames without SDK/source/originals mounted |
| Vulkan1.3 lab | llvmpipe + GTX1070 | Real indexed/textured/depth frame/readback; validation enabled, zero errors |
| Original camera/projection | Data/math integrated | GAM camera, recovered FOV/clips; startup/follow behavior not compared |
| Jimmy normal texture / morph | Native preview verified | Correct atlas slot0, base topology/UV retained; state speed/loop unverified |
| Null-material visibility | Binary rule implemented/tested | Original DX renderer skips null pointers; proxy geometry retained |
| SDL3 presentation/input | Linux Xvfb + GTX1070 | Six frames; injected keyboard event received |
| Swapchain resize | Linux tested | 960x720 ->800x600, zero validation errors |
| Focus / fullscreen | Code present, partial/unverified | Focus clears keys; fullscreen toggle not dynamically tested |
| Mouse/relative input/controller | Incomplete | SDL entry point declaration alone is not behavior |
| Audio stream | Linux dummy device | Original11025Hz mono WAV consumed10752bytes/500ms; speakers untested |
| Physics fragments/RNG | Standalone C# tests | Recovered arithmetic; controller/jump/collision state incomplete |
| Intro/task/entity/gameplay loop | Incomplete | GAM data recovery is not task execution or gameplay |
| Menus/AI/combat/progression/saves | Incomplete | Required future work |
| Original execution | Attempted under isolated Wine11 | Window created, GL/Vulkan rendering unusable; no reference comparison |
| Native Windows functionality | Unverified | Requires local Windows installation or VM |
Current known limitations: no reconstructed complete gameplay loop yet; no native
Windows testing or reference captures. Exact camera, physics, fixed-function
lighting/blending/fog and task behavior need binary/observational validation.
Generated evidence: artifacts/final-tests.log, test-level1b.ppm, test-player.ppm,
resize-input.ppm, package-linux.ppm, extracted/audit.json and reference*/ logs.
The lab/player images have been visually inspected; they do not establish original
visual equivalence. Windows cross-publishing must not be represented as Windows
runtime validation. Package scope and prerequisites are in infrastructure.md.
Known visual/behavior limits include incomplete lighting/fog/blend/culling/material
mapping, inferred initial look-at, preview animation loop/speed, no reconstructed
intro/controller/collision/trigger execution and no original comparison captures.
+19
View File
@@ -0,0 +1,19 @@
# Local dependencies
| Component | Version used | Source / license metadata |
|---|---|---|
| .NET SDK | 10.0.402 | Official builds.dotnet.microsoft.com archive; pinned SHA-256 in bootstrap.sh |
| .NET runtime | 10.0.13 | Self-contained publish runtime pack; bundled LICENSE and THIRD-PARTY-NOTICES |
| Silk.NET.Vulkan / KHR / EXT | 2.23.0 | NuGet packages, locked transitive versions in packages.lock.json; MIT license expression |
| SDL3 Linux / Windows | 3.4.2 | Official libsdl.org archives; zlib license, copied to packages/licenses/SDL3.txt |
| glslang/SPIR-V tools | Ubuntu local packages | Development shader compilation/validation only |
| Vulkan loader/ICD | Host platform | Runtime Vulkan 1.3 driver/loader prerequisite |
| Khronos validation layer | 1.3.275 | Local Ubuntu package; development verification only |
| Python | 3.12 | Existing host interpreter; analysis/preparation only, stdlib extractors |
| Wine | 11.0 | Official WineHQ stable Ubuntu amd64/i386 packages; original-reference testing only |
The .NET runtime pack version must be checked against the generated publish
runtimeconfig; the SDK and runtime have distinct version numbers. Library license
metadata is recorded for continuity; original game assets retain their original
ownership. Packages are local artifacts, not public distribution authorization.
No project files or assets were uploaded to dependency sources.
+61
View File
@@ -0,0 +1,61 @@
# Native infrastructure and package scope
Verified environment: Ubuntu 24.04 x86-64; project-local .NET SDK 10.0.402,
Silk.NET 2.23.0, SDL 3.4.2 built from official source (Linux) and official x64
SDL3.dll (Windows). GLSL compiled to Vulkan 1.3 SPIR-V and checked by spirv-val.
Khronos validation layers are installed locally. No root installation is required.
`scripts/env.sh` selects local SDK, NuGet cache, native tools and validation layer;
it also disables .NET CLI telemetry. `bootstrap.sh` reproduces dependency setup
on the tested Ubuntu host using official pinned SDK/SDL archives and apt packages.
Downloaded archive SHA-256 values are checked before extraction. Tool/dependency
downloads are permitted by the specification; no project material is uploaded.
## Implemented
- C# .NET 10 shared executable and local-only solution/build scripts.
- Vulkan 1.3 instance/device/graphics queue, descriptors, buffers, texture uploads,
sampler, indexed graphics pipeline, depth attachment, offscreen target/readback.
- SDL3 Vulkan surface, swapchain/presentation, resize/recreation, synchronization,
cleanup, keyboard, focus handling and fullscreen toggle.
- SDL3 WAV streams with conversion, optional looping and lifecycle cleanup.
- Original OMT-derived world geometry/materials/textures; original ASE model and
retained-base vertex morph animation samples; original GAM entities/camera.
- Self-contained Linux/Windows publishing with matching native SDL3 libraries.
The renderer completes submissions synchronously. This deliberately simple early
implementation is maintainable but does not target final performance. It currently
has a texture-times-color pipeline, nearest mip level/linear sampling, alpha
discard and depth. Original per-material culling/blending, lighting, fog and
animation state/render sorting are incomplete. See rendering.md for evidence.
## Verified checks
- `scripts/test.sh`: Python extraction/GAM tests, C# data/morph/arithmetic tests,
all 128 PNG and 254 ASE base meshes, actual original lab and player rendering.
- Offscreen Mesa llvmpipe: lab 2,869 source triangles / 33 recovered textures;
combined Jimmy preview 3,683 triangles / 34 textures; zero Vulkan validation
errors. Readback is saved locally, visually reviewed and compared before/after
material/texture fixes. This is not original-game visual equivalence proof.
- SDL3 window on NVIDIA GeForce GTX 1070 under Xvfb: six frames, injected keyboard
received, resize 960x720 -> 800x600, zero validation errors. Tested with scoped
escalation because the restricted tool sandbox blocks display-socket access.
- Recovered 11,025 Hz mono WAV: dummy-device SDL3 stream consumed 10,752 bytes
in 500 ms. Physical speaker output, positional mixing and original timing are
unverified.
- Linux/Windows self-contained cross-publishing succeeds. Native Windows execution
remains unverified; Wine reference testing is a separate investigation path.
## Scope limits
This is an investigation/runtime foundation, not complete reconstructed gameplay.
Original collisions, task/trigger execution, introductory cutscene, inventory,
combat, enemies, progression, save/load, original mouse/control behavior and
remaining scenes are incomplete. Player rendering at the original startpoint is
an animated preview; its interpolation loop/speed are not a recovered state machine.
Packages include local copies of asset directories (ASE/png/gam/omt), original
font PNGs/NewGame/readme, lab/Jimmy scene resources, recovered music, .NET runtime,
SDL3, SPIR-V and these limitations. Legacy EXEs/DLLs, old user save slots, tool
caches and analysis databases are not runtime dependencies. Vulkan drivers remain
platform prerequisites. No claim of native Windows runtime validation is made.
+67 -21
View File
@@ -1,25 +1,71 @@
# Progress
# Progress — current checkpoint
## Verified so far
- Read complete primary specification, inspected originals, established ownership.
- Created local-only Git repository under GamePort and persistent project guidance.
- Recorded all 539 original-file SHA-256 hashes (224,601,234 bytes).
- Identified PE32 x86 MSVC C++ game and Open Media Toolkit 2.0 DR4 engine.
- Fully decoded 35 GAM levels, 3,299 entities, 93 class codes, 84,044 properties.
- Python GAM reader/encoder round-trips every original byte; six targeted tests pass.
- C# GAM reader added with explicit endian handling and original startpoint/camera.
- OMT resource index and meshes recovered by asset investigation; integration ongoing.
- Scoped dependency download approved; local .NET 10 SDK/Silk/SDL setup ongoing.
**Full reconstruction is incomplete.** The current milestone is an evidence-backed
asset recovery toolchain and a native original-scene/animation investigation
runtime with local Linux/Windows packages. No completed playable-scene claim.
## Current work
Binary/rendering investigation, exact material/texture/audio recovery, C# runtime,
Vulkan offscreen verification, SDL3 presentation, cross-platform packaging.
No claim of full playable reconstruction, original behavior comparison, or Windows
runtime validation. See `tasks.md` and `compatibility.md` for remaining work.
## Verified
- Full `../prompt.MD` specification read; originals preserved and local Git initialized.
- All 539 original files (224,601,234 bytes) still match recorded SHA-256 hashes.
- Native PE32 x86 MSVC C++ game, Open Media Toolkit 2.0 DR4, Direct3D7/DirectDraw7,
DirectInput8 and DirectSound identified with addresses in analysis reports.
- 35 GAM files: 3,299 entities, 93 class codes, 84,044 properties, byte-for-byte
round-trip in Python and full corpus decoding in native C#.
- 100 OMT files / 7,027 indexed resources audited: 2,155 meshes, 2,183 materials,
1,614 textures, 875 bounded RIFF resources; zero decode failures.
- ASE/OMT coordinate and UV conversion proven with duplicate assets. Jimmy morph
sample vectors retain original base UV/topology; normal texture corrected to
jimycarl.png via actual InitObject code, with shock atlas kept separate.
- .NET SDK10.0.402/runtime10.0.13, Silk.NET2.23.0, SDL3.4.2 provisioned locally.
- C# builds without warnings/errors; 20 Python tests plus native C# corpus,
malformed-data, arithmetic, visibility, case lookup, morph and merge tests pass.
- Native Vulkan lab rendering: 2,869 triangles / 33 textures; combined Jimmy
preview: 3,683 triangles / 34 textures. Real GPU readback, zero validation errors
under llvmpipe; scene/player screenshots visually reviewed.
- Fixed original null-material skipping removes false white collision-proxy
surfaces. Original startpoint/camera and recovered projection are available.
- SDL3 hardware window/presentation on GTX1070 under Xvfb: six frames, injected
keyboard received, resize to800x600, zero validation errors.
- SDL3 recovered WAV stream consumes bytes on dummy device. Speaker output untested.
- Self-contained linux-x64/win-x64 packages built under dist/. Linux package also
renders inside a separate filesystem namespace with no SDK/project/original
directory mounted. Windows native execution remains unverified.
- Official Wine11 original-copy runs attempted in isolated filesystem/network
namespaces. Both GL and Vulkan backends produce unusable frames; details below.
## Build and run
From GamePort: `source scripts/env.sh`, `dotnet build`, then `dotnet run -- --with-player`.
Asset preparation: `python3 tools/extractors/prepare.py --audio sounds musicsecretlab`.
Tests: `scripts/test.sh`; packages: `scripts/package.sh`. See README for exact options.
Generated outputs and dependencies are ignored, and everything remains local.
## Remaining and current constraints
No original gameplay reference has been captured. Wine GL cannot obtain a suitable
pixel format/3D surface; Wine Vulkan logs unsupported fixed-function state and a
swapchain image count mismatch. Native Windows/VM access has been requested for
reference/fidelity and native port validation. These failures do not establish
original behavior. Static reverse engineering can continue independently.
Original controller, collision resolution, introductory LABEXP cutscene, entity
activation/task/trigger execution, interactions, combat, AI, progression, menus,
mouse behavior and saves remain incomplete. Gravity/impulse integration fragments
are tested, but the player jump state machine adds extra acceleration and is not
implemented as a complete controller. Animation looping/speed are explicit preview
policies. Rendering material/lighting/fog/blend state mapping also remains incomplete.
Three subagents contributed independent investigation/infrastructure work and then
hit a usage limit. Primary reviewed/integrated their work, corrected texture and
visibility assumptions, finished scripts/tests/packages, and owns the current files.
Do not assume their final reports imply completed gameplay.
## Continuation
Read AGENTS, this file, tasks, architecture and analysis reports. Check local Git
status and active agents before editing. Avoid repeating completed inventory/GAM
analysis. Original initial-scene evidence points to LV1B / STARTEXP, with VR01 as
a smaller resource-validation scene. Exact movement defaults now recovered in
binary investigation; do not substitute unverified gameplay guesses.
Read AGENTS, tasks, architecture, compatibility, reverse-engineering index, and
analysis reports. Check Git status before editing. Avoid repeating solved inventory,
GAM decoding or OMT extraction. LV1B/STARTEXP is initial scene evidence; its LABEXP
trigger still needs reconstruction. VR01 provides a smaller, 16-entity test scene.
Next actionable addresses/tasks are in tasks.md; original execution procedure and
errors are in reference-testing.md. Commit history preserves local milestones.
+38
View File
@@ -0,0 +1,38 @@
# Original reference testing
Originals are never executed in place. `tools/recon/reference_capture.py` copies
Original to ignored `artifacts/reference/game`, then launches official Wine 11.0
in bubblewrap with all namespaces unshared, no network, a minimal read-only host
filesystem, and writable generated work/prefix only. Original paths and home are
not mounted. Xvfb runs inside the namespace; ImageMagick captures its root window.
Return key injection is optional. The new port has no Wine dependency.
Local WineHQ Ubuntu noble stable amd64/i386 packages were downloaded separately,
verified against official index SHA-256 and extracted under `.tools/wine`. The
wrapper also needs `.tools/native/usr/bin/Xvfb`, bubblewrap, xkbcomp, ImageMagick,
32-bit Wine runtime libraries and an appropriate Wine graphics backend. Mesa
software-driver dependencies are kept project-local. Network namespace creation
needs scoped tool escalation in this environment; no host installation is used.
Reproduce (Linux host with those tools):
```sh
python3 tools/recon/reference_capture.py --seconds 24 --enter --debug
```
The supplied NeutronNoCD.exe was launched in the isolated copy and created its
1024x768 'Jimmy Neutron' window. Initial captures were uniform white. Debug logs
show Wine DirectDraw/Direct3D initialization failing to find a suitable GL pixel
format, then failing to allocate a 3D-capable surface (0x8876086a). These captures
are **not usable gameplay references**. Original timing, startup, cutscene,
lighting, camera, collision and audio have therefore not yet been compared.
The wrapper records screenshots, Wine/Xvfb logs, window tree and isolated process
list, all locally under artifacts/reference. An alternate Wine Vulkan backend is
also tested with `--wine-renderer vulkan --output artifacts/reference-vulkan`.
It created a Vulkan device/window but logged unsupported fixed-function states
and a requested swapchain image count1 outside the driver's supported3..16 range.
Those frames are also unusable. Failures must not be treated as original behavior.
No native Windows installation/VM or Windows 98 image was available in the initial
environment/tool inventory. A local reference machine remains necessary if Wine
cannot render correctly. Native Windows port execution remains separately untested.
+46
View File
@@ -0,0 +1,46 @@
# Current Vulkan rendering and evidence
Original API and state maps: `analysis/graphics.md`. Mesh/material/texture formats:
`file-formats.md`. Vulkan code: `src/GamePort/Rendering/Vulkan/VulkanRenderer.cs`.
Default prepared LV1B view uses the GAM STARTEXP camera; positive-Z projection
uses recovered FOV `0xAAA/16384*360` degrees, near 20, far 10000. Generic engine
far default is 3200; other scene-specific overrides remain to be mapped. Camera
target offset (0,80,0) is recovered, but startup look-at and follow interpolation
have not been dynamically compared. Vulkan viewport Y is handled in projection.
World OMT coordinates and per-corner UVs are unchanged. ASE conversion (x,z,y)
and (u,-v) is verified using duplicate gate/yokianpart assets; no invented light
is applied to Jimmy. The original normal texture is jimycarl.png (InitObject
0x422C96), while jimyshock.png is texture slot 1, a separate effect (0x422CA7).
The normal atlas and scene/player captures have been visually inspected locally.
## Null-material visibility correction
LV1B references material 18 from 45 draw ranges but that material does not exist
in its original resource index. Names include phoneblock, blockfan and Box/Plane
objects. Rendering them with white fallback surfaces incorrectly obscured the
actual lab. Disassembly of OMT2.dll DX draw_shape at `0x1003756C` loads the
polygon material pointer, tests it at `0x1003756F`, and jumps directly to polygon
advance at `0x10037A7F` when null. Therefore the modern scene loader retains this
geometry but excludes unresolved-material draw ranges, matching the original
render path. It does not assign collision semantics solely from names.
The original also tests in-memory polygon flag 4 (0x10037577). For v2 resources,
the first serialized bool sets flag 2 at 0x10003F83 (DX disables culling for that
bit at 0x10037731); the second bool sets flag 1 at 0x10003F9B. Other legacy
fields and per-material pipeline states still need full mapping.
## Animation preview
MorphAnimation reads prepared base topology/UV and sample vertex positions, with
linear interpolation following DLL 0x10002F9A. It can append a player draw with
independent texture to original scene geometry and updates the mapped coherent
vertex buffer after synchronous frame completion. Source frame sample timing is
used for preview. Loop closure, state selection, state-specific playback speed,
normal interpolation, clothing variants and gameplay pose transforms remain
unverified. This is not a complete animation/gameplay reconstruction.
GPU readback evidence: `artifacts/test-level1b.ppm`, `artifacts/test-player.ppm`,
`artifacts/jimmy-normal.ppm`, `artifacts/resize-input.ppm` (generated/ignored).
No original reference image equivalence or pixel-perfect claim is made.
+5 -1
View File
@@ -19,7 +19,11 @@ C3DJimmy update 0x424600, input 0x426030; player input 0x438A60, walking branch
0x438BC0. Player defaults ctor region 0x4372A0 sets acceleration 30, deceleration
35, maximum speed 600; increments occur per simulation invocation, while movement
uses elapsed time. A future simulation must recover update cadence before calling
these coefficients timestep-independent. Jump/gravity values remain provisional.
these coefficients timestep-independent. Gravity and jump have since been
resolved: game setup 0x44D414 sets gravity Y=-800; jump branch 0x4383B3 queues
Y=550 impulse, consumed/cleared at 0x479EBB..0x479EF2. Semi-implicit free-motion
fragment implemented in Game/RecoveredMotion.cs and regression tested; collision
and activation gating remain unresolved. See analysis/gameplay.md.
## Unresolved
+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.