Files
Neutron/docs/progress.md
T

6.2 KiB

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.

Latest user-reported preview fix

The user ran the Windows build and observed a static Jimmy partially inside the lab floor. This verifies initial Windows startup/rendering by user report, with OS/GPU/version/input/audio details unspecified. Updated native Windows testing remains pending.

Both issues were reproduced from actual assets: jimstop has two byte-identical vertex poses, and its minimum local Y=-64.6165 plus GAM Y=26.6619 places the soles at -37.9546 while the original visible floor is near Y=0.5486. Calling the default an animated idle was inaccurate. The idle stays faithful to its still source pose; 1/2/3/4 now explicitly select idle/run/jump/scratch previews and the window title states the mode/controls. A source-data-based preview correction of +38.503 Y places the standing model on visible floor triangles, leaving GAM data unchanged. This is an explicit preview policy, not the recovered game collision solver.

Tests verify real lab grounding, ceiling/invisible-proxy rejection, still idle and moving clips, automatic animation advance in actual GPU readbacks, and SDL keyboard switching to a run cycle. Khronos validation reports zero errors on llvmpipe and GTX1070. Source assets remain unchanged. See rendering.md for evidence/scope. The rebuilt Windows package additionally passed an isolated Wine64 window test: six frames, animation key2 selected moving source samples, resize800x600, exit0. Validation was disabled in that Wine test; corrected native Windows retest is pending.

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. Initial Windows rendering is now user-reported as noted above.
  • 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 (checkpoint670adb4). Broader 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.