Files
Neutron/docs/compatibility.md
T

15 KiB

Compatibility and validation

Compilation, native runtime, original behavior and full feature completion are separate evidence categories. The game is not fully reconstructed/playable yet.

Debug expansion (2026-10-25): full scripts/test.sh passes, with70 Python checks, 21 movement groups, debug page/overlay groups, real SDL dummy pause/mute timing, remaining managed/GPU routes and539 unchanged original hashes. Native Linux GTX1070 at1920x1080 passes F1/Tab/F3, flight during a source cutscene, input capture, camera/audio controls, checkpoint save/load and same-window rebuild. Enabled Vulkan validation reports zero errors. Headless Player1920x1080 and Systems2560x1080 screenshots fit; see artifacts/debug-expansion/. SDL_SetAudioStreamGain is present in the packaged Windows SDL3 DLL export table. Cross-build/export evidence does not add native Windows runtime or original-game behavior verification.

Latest implementation continuation: controlled player phase ordering, route static camera query and PostLoad gadget availability pass the full scripts/test.sh. Evidence: artifacts/implementation/integration-final.log;70 Python regressions, 20 movement groups,11 new camera groups,13 existing support groups, remaining managed groups, GPU story/practice/RETURN/Carl/objective/jetpack/animation checks, SDL dummy lifecycle and539 unchanged original hashes. GPU validation is enabled and every run reports zero errors. Native Windows runtime and original-game comparison are not added by these tests. Known limits remain explicit in the current checkpoint coverage/implementation reports. Both self-contained packages now identify clean09cf117. Linux release smoke from /tmp passes practice/RETURN (including input order and gadget availability) and outside load; see linux-package-return.log and linux-package-outside.log under artifacts/implementation/. Those release invocations have validation unavailable; the enabled-validation evidence is the full integration run above. Windows is cross-published, with no additional native Windows runtime claim.

Architecture checkpoint: see checkpoint/review.md for coverage and remaining gates. C1 objective/task order and C2 per-actor Carl callback corrections pass the full scripts/test.sh integration, all GPU runs with zero Vulkan validation errors. Final Python discovery passes62 tests including the additional source evidence follow-ups. All539 original hashes remain unchanged. These checks do not add native Windows or original whole-game runtime verification; earlier Windows user reports remain limited to their tested builds and route. Self-contained Linux/Windows packages rebuilt from clean531883a. The Linux release package passes the60-frame Carl held-input/control-lock smoke from /tmp; validation layers were unavailable for that invocation. Current Windows release is cross-published, not newly native-runtime verified. Later loader-provenance edits affect evidence/tests only; runtime code is unchanged from that package.

Feature Implemented / tested Evidence and limits
Original preservation Verified after extraction/runtime tests All539 original SHA-256 hashes unchanged
GAM Python / C# All35 files,3299 entities Exact Python round-trip; C# corpus/start/corruption checks
OMT recovery All100 archives audited 2155meshes,2183materials,1614textures,875RIFF, zero failures
C# original loaders Linux runtime All128 PNG /254 ASE base meshes; morph/base UV tests
.NET10 Linux build Pass, zero warnings/errors Local SDK10.0.402/runtime10.0.13
Windows x64 publish Pass Correct PE32+ app and SDL3.dll; initial native rendering user-reported
Windows story/practice package under Wine64 Preliminary headless/window pass 12s story;12-frame practice pause/N/resume/resize and original streams; simulation matches Linux; validation disabled
Corrected Windows preview under Wine64 Preliminary window pass Six frames, key2 animation switch, resize800x600, exit0; validation disabled
Windows walking package under Wine64 Preliminary240-step window pass SDL arrows/Shift, walking/jump/landing and800x600 resize; matches Linux movement statistics; validation disabled
Linux self-contained package Native headless/window verified 12s story without SDK/source/Original mounted; GTX1070 practice pause/N/resume/resize, zero validation errors
Vulkan1.3 lab llvmpipe + GTX1070 Real indexed/textured/depth frame/readback; validation enabled, zero errors
Original camera/projection Source mapping/math + outside GPU before/after All35 level far overrides; outside28000/tutorial50000; merged layer maximum is a port policy, per-layer masks/dynamic fog incomplete
Jimmy normal texture / morph Native preview verified Correct atlas slot0, base topology/UV retained; state speed/loop unverified
Standing preview placement Corrected / Linux tested +38.503Y from actual visible floor/base soles; exact original actor transform unresolved
Idle/run/jump/scratch preview Linux keyboard + GPU tests Default idle samples identical; 1/2/3/4 select clips; run image changes across frames
Null-material visibility Binary rule implemented/tested Original DX renderer skips null pointers; proxy geometry retained
SDL3 presentation/input Linux Xvfb + GTX1070 Six frames; injected keyboard event received
Swapchain resize Linux tested 960x720 ->800x600, zero validation errors
Persistent level presentation Native GTX1070 six-load pass One window/renderer; stable IDs/core resources, bounds/focus/fullscreen; invalid load retains rendering; zero cumulative Vulkan errors
Widescreen HUD/debug UI Managed matrix + native captures/pointer pass Uniform proportions, centered modal/F1, anchored HUD/F2;4:3/16:9/21:9/32:9, DPI and strict boundary checks
F1 debug menu Managed/SDL audio tests + native Linux GTX1070 window pass Pause/actions/input capture/resume/800x600 resize, zero validation errors;33 prepared scene/start choices; intentional modern tools, no new Windows runtime claim
F1 Force Control Menu/director/interaction checks + native Linux SDL pass Persistent override through source shots; disable/reset restores normal ownership; actual movement with neutron1a active, zero Vulkan errors; music handoff regression passes
F2 live debug overlay Managed timing/layout/menu + native Linux SDL pass Non-pausing movement, visibility/repeat/menu priority and800x600 resize; all checks true, zero Vulkan errors; session persistence; modern tools, no new Windows runtime claim
Focus / fullscreen Code present, partial/unverified Focus clears keys; fullscreen toggle not dynamically tested
Mouse/relative input/controller Incomplete SDL entry point declaration alone is not behavior
Audio stream Linux dummy device Original11025Hz mono WAV consumed10752bytes/500ms; speakers untested
Physics fragments/RNG Standalone C# tests Recovered arithmetic; controller/jump/collision state incomplete
Walking/jump/air controller 18 movement groups + GPU replay pass Corrected mode1 fall-through to source air handler: acceleration/braking/turning during jumps and bursts; RETURN root placement; phase/collision/lean remain provisional
Static source collision 11 deterministic groups + source NC byte checks pass 2851 lab collision triangles after excluding18 NC-shape triangles; all2869 render/source triangles and325 null-material proxies retained; solver/dimensions provisional
Simulation cadence 18 movement groups pass Fixed60Hz independent of60/120/144Hz rendering, ten-minute finite run; original cadence unresolved
Walking camera and animation Linux headless/window pass Original five motion clips, recovered eye180/target99; pivot, timing and obstruction solver provisional
Walk SDL input/resize GTX1070/Xvfb input replay pass Current corrected managed/headless replay1252.09; all five jump bindings produce identical300-frame powered replays,403.88 travel; zero validation errors
TSK saves/task gates All12 originals byte-round-trip Bounded parse/write, task/items/score/checkpoint CLI resume; full game-state/menu save incomplete
Lab CAM/MCA/AI interpreter Source sequence/Carl lock tests + Linux GPU pass 16 intro cues; neutron1a locks move/turn/jump for all active MCA shots, restores JIM1 at completion/skip; no original comparison
Dynamic actors/sprites/models Linux GPU pass Carl/Goddard/Jimmy morphs, source Canv timing and9 original lab props; billboard/alpha, pivots and playback timing remain provisional
Scene music/speech Linux dummy-device pass CAM stops music before speech; full lab chain stays silent, DEFAULT restarts on completion/skip; reset tested. Packaged Linux/Wine64 lifecycle checks pass; speakers/latency/native Windows unverified
VR01 star/trophy contacts Source-data tests pass 5-point stars,300 trophy, acquired flags and contact-enter semantics; distance/exclusions/box approximation
RETURN / scene reload Source/director tests + Linux headless pass Lab/VR04/lab restores departure root/companion using one renderer, retains STRT yaw and suppresses intro; fresh TSK loading separate; original fades unverified
Supplied scene availability All35 GAMs supplied;33 have OMT geometry Level3B/E GAMs are duplicate four-entity records apart from level code; registered OMT archives absent, normal gameplay use unverified; no substitution or established blocker
Lab task/contact route Managed input replay + headless GPU pass 887 input-only movement steps with live contacts/NPC updates reachSCENE60, score150, jetpack andlevel1; separate direct-contact GPU rebuild check
Lab underground passage 2763-step managed input replay pass Both switches,2 clear crossings and timed reclosure; closed-gate negative sweep; explicit riverlab/SCENE65 fixture, prior progression and original comparison unverified
Patrol/support 10 patrol +13 support groups pass Source phases/profiles and8 DLL magnitude refs; Carl sensing, Goddard follow and full wall response incomplete
Buttons/doors Source state tests and GPU props pass Cooldown, hold/reversal, original model transforms; source broadphase/box order with modern narrowphase
Dynamic collision 10 managed groups pass Includes actual closed/open lab bars; full source solver/activation exclusions incomplete
Lab objectives/practice Source timer/O tests + managed/headless/SDL pass Original popup slide/timeout and O latch integrated; pad/content separate; modal pause/No reset; practice highlights/controller still incomplete
Jetpack tutorial 14 vertical groups +16 movement groups +300-step VR04 GPU pass Powered horizontal travel403.88, turn/brake/release and landing; rise418.98, zero validation errors; phase/shadow/collision/lean approximations
Powered SDL/package steering Linux GTX1070 and preliminary Wine64 window pass 300 frames, Up/Left/Down/Shift received, resize800x600, travel403.88/landing; Linux zero validation errors, Wine validation disabled; native Windows pending
Default effects bank 251 exact RIFF exports, SDL dummy pass Pickup/button/door sounds and owner-loop stop; positional/volume/channel policy incomplete; MPEG-in-RIFF bird1/id162 unsupported by SDL WAV
Complete scene/gameplay loop Incomplete Lab navigation, exact collision/pivot/cadence and original reference comparison still required
Menus/AI/combat/progression/saves Incomplete Required future work
Original execution Attempted under isolated Wine11 Window created, GL/Vulkan rendering unusable; no reference comparison
Native Windows functionality User confirms lab/tutorial/lab/outside and corrected build works User built/tested Windows; comprehensive native input/audio/resize/driver coverage and original comparison remain unverified by the agent

Generated evidence: artifacts/full-integration-test.log, practice-window.log, practice-transition.log, jetpack-runtime.log, final-tests.log, test-level1b.ppm, test-player.ppm, resize-input.ppm, package-linux.ppm, extracted/audit.json and reference*/ logs. The lab/player images have been visually inspected; they do not establish original visual equivalence. Windows cross-publishing must not be represented as Windows runtime validation. Package scope and prerequisites are in infrastructure.md.

Current four-fix regression evidence: artifacts/four-bugs-full-tests.log (complete suite and539 preserved hashes), jump-binding-parity.json, outside-fixed-clip.png, package-objective-window.log and package-carl-cutscene.log. Both platforms publish successfully; packaged Linux popup/Carl checks pass with zero Vulkan validation errors. The already-started Wine64 popup/O/resize check passes with validation disabled. Further package checks were skipped at the user's request after they reported their own Windows build works. No new agent native Windows claim is made.

Subsequent RETURN/underground checkpoint: artifacts/return-underground-tests.log passes the complete suite (41 Python checks,18 movement groups, source checkpoint checks, actual lab/VR04/lab rendering, underground input replay and539 unchanged originals). RETURN restores the exact departure root and companion, retains STRT yaw and suppresses intro, with zero Vulkan validation errors. NC registration exclusion fixes the underground water-plane rise while retaining rendering. Both Linux x64 and Windows x64 self-contained executables republish successfully. No subsequent native Windows/Wine runtime check is claimed.

F1 menu checkpoint: artifacts/debug-menu-full-tests.log passes the full suite, including actual SDL audio pause/resume and539 unchanged originals. Native Linux window/input/action/resize evidence is artifacts/debug-window.log; screenshots were visually inspected. Both Linux and Windows self-contained packages publish successfully. No new Windows/Wine runtime check was run for this addition.

Live F2 diagnostics: artifacts/live-debug-full-tests.log passes the full suite and539 original hashes. Native SDL live movement/menu/visibility/resize and the existing force-control check pass with zero Vulkan errors. Headless lab/VR04/lab retains visibility and samples1/2/3 with zero errors; camera/layout/timing groups pass. See artifacts/live-debug-window.log and live-debug-return.log. No new Windows runtime claim is made. Both self-contained platform packages rebuild successfully with this addition.

Persistent presentation/widescreen checkpoint: full regression suite passes in artifacts/persistent-widescreen-full-tests.log, including539 preserved hashes. Native6-load/one-window/one-renderer fullscreen/bounds/focus/pointer checks pass with zero enabled-layer errors (artifacts/window-transition-final.log). F1/force and F2 input checks still pass. Both packages rebuild; packaged Linux1920x1080 lab/VR04/lab retains one renderer and exact RETURN state with validation unavailable. No new native Windows runtime claim is made.

Known visual/behavior limits include incomplete lighting/fog/blend/culling/material mapping, inferred model/root pivot, provisional collision/cadence/animation timing, close-wall camera clipping near Jimmy, incomplete class-specific triggers/interactions, and no original comparison captures. Walk evidence: artifacts/walk-tests.log, test-walk.ppm, walk-start.png and walk-window.ppm. Original fidelity is unverified.