Files
Neutron/docs/infrastructure.md
T

5.0 KiB

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.
  • Controllable lab with separate60Hz simulation, source-triangle capsule collision, original no-gadget walking/jump formulas, chase camera and original motion clips.

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. Initial Windows rendering is user-reported; broader native functionality remains unverified. Wine reference testing is a separate investigation path.
  • Preliminary Windows-package Wine64 check: standalone .NET10 executable rendered two frames, exit0, with byte-identical PPM to Linux on the same software driver. Validation was disabled for this Wine test; SDL window/input/audio and native Windows drivers remain untested. See reference-testing.md for exact scope.
  • Corrected Windows preview also passes a six-frame Wine64 window/input/animation selection/resize smoke (validation disabled). Native Windows retest is pending.
  • Movement checkpoint packages rebuilt: Linux GTX1070 window and Windows Wine64 window each pass240 steps, SDL arrows/Shift, jump/landing and resize800x600. Movement statistics match (travel1250.12, maxrise137.62, grounded final). Linux Khronos validation is enabled with zero errors; Wine validation is disabled.

Scope limits

This is a controllable lab checkpoint, not complete reconstructed gameplay. Collision solver/masks/dimensions, pivot,60Hz cadence, camera obstruction and animation state timing remain provisional. Original task/trigger execution, introductory cutscene, inventory, combat, enemies, progression, save/load, mouse steering and remaining scenes are incomplete. The default now walks/jumps from the original start area; --inspect retains clip selection with keys1/2/3/4. Default idle samples remain identical. The floor-derived visual transform is separate from original physics; details are in the movement/collision reports.

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. Initial native Windows rendering is user-reported; the movement checkpoint and broader native Windows functionality remain unverified.