Reconstruct lab story, interactions, patrol and jet pack practice flow
This commit is contained in:
1 parent
58424120bb
commit
c929f942e1
84 files changed
+7957
-305
No files matched your search
@@ -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:
|
||||
|
||||
|
||||
Reference in new issue
Block a user