Reconstruct lab story, interactions, patrol and jet pack practice flow

This commit is contained in:
UnixNight committed 2026-10-24 20:33:03 -04:00
1 parent 58424120bb
commit c929f942e1
84 files changed
+7957 -305

No files matched your search

+42 -15
View File
@@ -4,11 +4,12 @@ Local reconstruction of the supplied **Jimmy Neutron: Boy Genius** installation
using C#/.NET 10, Silk.NET.Vulkan (Vulkan 1.3), and SDL3. Original files remain
untouched in `../Original`. There are no Git remotes or runtime online services.
**Current milestone: controllable original lab with walking, jumping, collision,
chase camera and original animation clips.** Recovered controller arithmetic is
integrated; collision/pivot/cadence and animation timing remain provisional.
Introductory cutscenes, interactions, progression and saves remain incomplete.
See [progress](docs/progress.md) and [compatibility](docs/compatibility.md).
**Current milestone: original lab story, interactions and jet pack practice flow.**
The runtime includes recovered camera/speech triggers, moving props, Carl/Goddard
patrol logic, pickups, objectives, the practice prompt, VR04 powered jumping and
checkpoint transitions. Collision response, timing and visual fidelity remain
provisional. The full game is incomplete; see [progress](docs/progress.md) and
[compatibility](docs/compatibility.md) for tested scope and remaining work.
## Build and run locally
@@ -21,12 +22,34 @@ python3 tools/extractors/prepare.py --audio sounds musicsecretlab
dotnet run
```
The default is the original secret lab (LV1B), starting at the GAM location after
settling onto source floor geometry. **Arrows** walk/backpedal/turn; **Shift,
Insert, numpad 0 or right mouse** jump. **R** resets, **C** pauses into inspection
and resumes the chase camera, **F11** toggles fullscreen, **Escape** quits.
No-gadget held jump can repeat on landing; normal midair arrows do not steer.
The original STARTEXP/LABEXP intro is skipped for this checkpoint.
The default starts the original secret lab (LV1B), including the recovered intro
camera/speech sequence. **Escape or Space** skips the current sequence and restores
control. **Arrows** walk/backpedal/turn; **Shift, Insert, numpad 0 or right mouse**
jump, and holding jump uses the jet pack after obtaining it. **O** raises/lowers
the objective panel. **R** resets the scene placement with current progression;
**C** pauses into inspection, **F11** toggles fullscreen, **Escape** quits during
ordinary play. Use `--skip-intro` to begin with control or `--mute` for silent play.
The original lab pickup is internally tagged `shrinkray`; the original objective
art identifies it as the **jet pack**. Its practice prompt accepts **Y** or a click
on Yes to enter VR04, and **N** or a click on No to resume. Enter selects the
hovered Yes region, otherwise No. The original practice return uses the saved
lab start tag. Runtime checkpoint-position restoration is still unrecovered.
Normal midair arrows do not steer. Source patrol/door logic is integrated, while
sensing, full collision response, alpha/lighting and audio effects remain incomplete.
`--load-save PATH` reads original TSK task/items/score/checkpoint state;
`--write-save PATH` writes that state outside the asset directory. This resumes the
saved STRT checkpoint; arbitrary current-position/complete game-state saving is
not implemented. `--start TAG` selects an original checkpoint for investigation.
Prepare all available scenes for other save files with
`python3 tools/extractors/prepare.py --all-scenes --audio sounds musicsecretlab`.
All35 GAM entity files are supplied;33 have matching OMT geometry archives.
Level3B.gam and Level3E.gam each contain the same four entities apart from their
level identifier. Their registered OMT archives are absent, but no incoming GAM
transition or supplied save selects them. Their use in normal gameplay remains
unverified; this is not an established blocker. The manifest records the absent
geometry without substitution. See [level resource evidence](docs/analysis/level-resource-mapping.md).
Use `--inspect` for the previous inspector: arrows/WASD orbit, plus/minus zoom;
1 idle, 2 run, 3 jump, 4 scratch preview. With no simulation, C toggles stored/orbit
@@ -39,6 +62,8 @@ Headless verification on a machine with Vulkan 1.3 (Mesa lavapipe works):
```bash
dotnet run -- --headless --with-player --time 0.05 --screenshot artifacts/lab.ppm
dotnet run -- --headless --smoke-walk --screenshot artifacts/walk.ppm
dotnet run -- --headless --story --story-time 12 --screenshot artifacts/story.ppm
dotnet run -- --headless --skip-intro --write-save artifacts/checkpoint.tsk
dotnet run -- --headless --model ASE/jimstop.ase --texture png/jimycarl.png
dotnet run -- --audio artifacts/extracted/musicsecretlab/Wave_00000000_HuntingBuildupVar2_11k.wav --loop-audio
dotnet run -- --help
@@ -77,14 +102,16 @@ dotnet publish -c Release -r win-x64 --self-contained true
Packages are local directories `dist/linux-x64` and `dist/win-x64`. Run
`launch-scene.sh` or `launch-scene.cmd`; append `--headless --frames 1` for a
render smoke test. They include the .NET runtime, SDL3 native library, SPIR-V,
original asset copies, prepared lab/Jimmy resources, audio and limitations.
original asset copies, all33 available prepared scenes, actor/UI resources, audio
and limitations.
Windows cross-publishing and preliminary headless Wine64 rendering are verified.
A user confirmed native Windows loading/rendering; this movement update still
needs native Windows input/physics testing. Full native Windows functionality is unverified.
A user confirmed native Windows loading/rendering of the earlier checkpoint;
this story/tutorial update still needs native Windows input/physics testing. Full native Windows functionality is unverified.
These are investigation packages, not a finished game release.
`scripts/test.sh` runs Python regressions, native C# data/collision/movement checks,
all PNG/ASE decoders, actual Vulkan GPU readback, dummy-device SDL3 audio, and
all PNG/ASE decoders, source-backed interaction/AI/support/jetpack/UI checks,
actual Vulkan GPU readback, dummy-device SDL3 audio, and
original SHA-256 verification. Set `NEUTRON_WINDOW_TEST=1` with a working DISPLAY
to include injected keyboard and swapchain-resize verification. Full OMT audit: