Files
Neutron/docs/tasks.md
T

4.5 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.
  • Correct preview floor overlap, identify still idle, add explicit animation inspection controls/tests.
  • Retest corrected Windows build natively; initial rendering is user-reported.

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. 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.
  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.
  • Full native Windows input/audio/resize/driver testing (initial rendering is user-reported).
  • 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.