Add controllable lab walking checkpoint with collision and chase camera
This commit is contained in:
1 parent
37fa18094f
commit
58424120bb
26 files changed
+1848
-110
No files matched your search
@@ -4,11 +4,11 @@ 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: recovered original assets, a native rendered lab scene with
|
||||
selectable Jimmy animation previews, and Linux/Windows investigation packages. Full
|
||||
playable gameplay has not been reconstructed.** Controls, collision, introductory
|
||||
cutscenes, interactions, progression and saves still require implementation and
|
||||
comparison. See [progress](docs/progress.md) and [compatibility](docs/compatibility.md).
|
||||
**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).
|
||||
|
||||
## Build and run locally
|
||||
|
||||
@@ -18,24 +18,27 @@ From `GamePort/`, using an installed .NET 10 SDK or the already provisioned loca
|
||||
source scripts/env.sh
|
||||
dotnet build
|
||||
python3 tools/extractors/prepare.py --audio sounds musicsecretlab
|
||||
dotnet run -- --with-player
|
||||
dotnet run
|
||||
```
|
||||
|
||||
The default scene is the original secret lab (LV1B) with its recorded start camera.
|
||||
Press **C** to switch between stored and inspection cameras; arrows/WASD orbit,
|
||||
plus/minus zoom, F11 toggles fullscreen, Escape quits. These are investigation
|
||||
controls. Original gameplay controls are documented in `docs/analysis/gameplay.md`.
|
||||
The default idle asset is a still pose: its two original samples are identical.
|
||||
Press **1** for idle, **2** for the run animation, **3** for the jump animation,
|
||||
or **4** for the scratch animation. These preview cycles do not control movement.
|
||||
The player mesh is raised onto visible floor geometry for preview; exact original
|
||||
actor/collision transforms remain under investigation. GAM positions are unchanged.
|
||||
Without a prepared scene, the app previews the original Jimmy base model.
|
||||
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.
|
||||
|
||||
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
|
||||
camera. Idle is a still original pose. Exact actor pivot and animation state timing
|
||||
remain under investigation; GAM/ASE source data is unchanged. Without a prepared
|
||||
scene the app previews the Jimmy base model.
|
||||
|
||||
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 --model ASE/jimstop.ase --texture png/jimycarl.png
|
||||
dotnet run -- --audio artifacts/extracted/musicsecretlab/Wave_00000000_HuntingBuildupVar2_11k.wav --loop-audio
|
||||
dotnet run -- --help
|
||||
@@ -43,7 +46,8 @@ dotnet run -- --help
|
||||
|
||||
Explicit original paths can be supplied with `--assets /path/to/Original`.
|
||||
`--scene` accepts generated scene JSON; `--level` accepts an original GAM relative
|
||||
to the original root. `--original-camera` uses its matching startpoint. Player
|
||||
to the original root. Use `--walk` for an explicitly selected scene/GAM pair.
|
||||
`--original-camera` uses its matching startpoint in inspection mode. Player
|
||||
preview uses `--with-player` or `--animation path/to/animation.json`. Morph sample
|
||||
interpolation is recovered; loop closure and playback speed remain preview policies.
|
||||
|
||||
@@ -75,11 +79,11 @@ Packages are local directories `dist/linux-x64` and `dist/win-x64`. Run
|
||||
render smoke test. They include the .NET runtime, SDL3 native library, SPIR-V,
|
||||
original asset copies, prepared lab/Jimmy resources, audio and limitations.
|
||||
Windows cross-publishing and preliminary headless Wine64 rendering are verified.
|
||||
A user reported initial native Windows rendering; this floor/animation update
|
||||
still needs native Windows retesting. Full native Windows functionality is unverified.
|
||||
A user confirmed native Windows loading/rendering; this movement 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 20 Python regressions, native C# data/algorithm checks,
|
||||
`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
|
||||
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