A Windows-first workflow toolkit for taking a legally obtained N64 ROM through Splat metadata, a big-endian MIPS ELF, N64Recomp code generation, and a host-runtime scaffold. Includes readiness audits, ROM matching gates, Podman tooling, CDB evidence helpers, and an optional read-only Mupen64MCP workflow.
Everything you need to go from a dumped ROM to a debuggable PC port — no game code shipped, no assumptions made.
Inspect, convert, and manage ROMs. Validate workspace structure with rom-info, convert-rom, and workspace-status.
Initialize, split, and refine Splat configurations. Build matching ROMs with the assembly-only match gate when applicable.
Build MIPS ELF files from Splat output. Run symbol audits, toolchain checks, and MIPS smoke tests.
Generate C code from your ELF via N64Recomp. Validate TOML configs, summarize output, and iteratively refine ignored functions.
Scan for unsupported instructions, filter ELF exports, repair TOML/YAML configs with atomic replacement and dry-run reports.
Generate a complete SDL2 + RT64 + RmlUi runtime project from a template. Includes CMake, vcpkg, and build scripts.
Read-only-by-default Mupen64MCP integration with local LLM agents. Controller and memory-write tools require explicit opt-in.
Non-destructive validation against a dumped ROM. Validates all core generators, repair helpers, and project discovery.
The evidence-driven loop that takes you from ROM to a debugged PC port.
Validate and convert your dumped ROM to the correct byte-order format for Splat consumption.
Configure and run Splat to disassemble the ROM into manageable source files with proper metadata.
Verify the disassembly builds to a byte-identical image of the original ROM (optional but recommended).
Produce a big-endian MIPS ELF that N64Recomp can consume. Run symbol audits and readiness checks.
Validate your TOML configuration and generate C++ from the ELF via N64Recomp.
Compile the generated C++ with the RT64 + RmlUi runtime scaffold into a Windows executable.
Use CDB or Mupen64MCP to investigate runtime behavior. Fix the owning source of truth and rebuild the narrowest affected stage.
All commands are accessible via python -m n64recomp_kit or the thin wrappers in tools/.
Comprehensive guides for every stage of the pipeline, from setup through debugging.