Files
Neutron/docs/tasks.md
T

4.1 KiB

Tasks

Completed milestones

  • Entire specification; original inventory/hashes; local-only Git and guidance.
  • Binary/compiler/API identification and address-based reports.
  • All GAM entities decoded and byte-round-tripped; C# corpus reader tested.
  • All indexed OMT meshes/materials/textures/RIFF resources decoded and audited.
  • ASE transform/morph-base UV/topology recovery and regression tests.
  • .NET10 + SDL3 + Vulkan1.3 shared source; real scene/model/texture rendering.
  • Original LV1B lab plus original Jimmy morph preview at GAM startpoint.
  • Correct normal atlas and null-material visibility from binary evidence.
  • Recovered impulse/gravity/speed/RNG arithmetic fragments with tests.
  • Native Linux Vulkan offscreen and SDL3 window/input/resize verification.
  • SDL3 recovered WAV stream consumption test (dummy device).
  • Self-contained Linux and Windows local packages, matching SDL3 libraries.
  • Packaged Linux runtime isolated from SDK/source/originals; renders successfully.
  • Preliminary Wine64 Windows-package render; exact fixed-time readback matches Linux.
  • Isolated copied-original Wine attempts; actual failures documented.

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.