# Jimmy Neutron reconstruction 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). ## Build and run locally From `GamePort/`, using an installed .NET 10 SDK or the already provisioned local SDK: ```bash source scripts/env.sh dotnet build 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. 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 ``` 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. 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. If tooling is missing on Linux, `scripts/bootstrap.sh` downloads pinned official SDK/SDL dependencies and obtains build tools using the existing Ubuntu apt index, all under `.tools`. It needs network access for dependencies, Python 3.12+, CMake, a C compiler and ordinary native runtime libraries. It does not install host packages. Restore uses NuGet; subsequent builds/tests use local caches. The runtime needs a Vulkan 1.3 driver/loader, plus X11/Wayland on Linux for visible windows. ## Test and package ```bash scripts/test.sh scripts/build-linux.sh scripts/build-windows.sh scripts/package.sh ``` The publish scripts perform equivalent self-contained publishes: ```bash dotnet publish -c Release -r linux-x64 --self-contained true 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. 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. 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 original SHA-256 verification. Set `NEUTRON_WINDOW_TEST=1` with a working DISPLAY to include injected keyboard and swapchain-resize verification. Full OMT audit: ```bash python3 tools/extractors/audit.py ../Original --report artifacts/extracted/audit.json python3 tools/recon/inventory.py ../Original --verify docs/original-manifest.json ``` ## Investigation and continuity Start with [AGENTS.md](AGENTS.md), [tasks](docs/tasks.md), [reverse-engineering index](docs/reverse-engineering.md), and [architecture](docs/architecture.md). Detailed binary/graphics/asset/gameplay reports are under `docs/analysis`. `tools/extractors` contains bounded OMT/ASE/PNG decoders; `tools/levels/gam.py` round-trips all original level records. Original reference capture uses `tools/recon/reference_capture.py` with local Wine/Xvfb, bubblewrap and ImageMagick. It executes a separate copy with no network and no original-directory mount. Wine is for investigation only; the port does not use Wine, DirectX or OpenGL. See `docs/reference-testing.md` for actual results. All generated extraction output, local SDK/native dependencies, captures and packages are ignored by the nested local Git repository. Never configure a remote, upload assets, or overwrite the original installation.