Files
Neutron/docs/progress.md
T

76 lines
4.7 KiB
Markdown

# Progress — current checkpoint
**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.
## 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.
- Windows x64 package also renders two headless frames under isolated Wine64,
exit0, without source/SDK/originals mounted. Its fixed-time PPM is byte-identical
to the Linux package on the same lavapipe driver. Native Windows remains untested;
Wine test did not enable validation or exercise SDL window/audio/input.
- 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, 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.