/sm64tools

Collection of tools for Super Mario 64 ROM hacking

Primary LanguageCMIT LicenseMIT

sm64tools

Collection of tools for manipulating the Super Mario 64 ROM

n64split

N64 ROM Splitter and Build System

  • splits ROM into assets: asm, textures, models, levels, behavior data
  • generates build files to rebuild the ROM
  • intelligent recursive disassembler
  • generic config file system to support multiple games

Usage

n64split [-c CONFIG] [-k] [-m] [-o OUTPUT_DIR] [-s SCALE] [-t] [-v] [-V] ROM

Options:

  • -c CONFIG ROM configuration file (default: auto-detect)
  • -k keep going as much as possible after error
  • -m merge related instructions in to pseudoinstructions
  • -o OUTPUT_DIR output directory (default: {CONFIG.basename}.split)
  • -s SCALE amount to scale models by (default: 1024.0)
  • -t generate large texture for MIO0 blocks
  • -v verbose output
  • -V print version information

sm64extend

Super Mario 64 ROM Extender

  • accepts Z64 (BE), V64 (byte-swapped), or N64 (little-endian) ROMs as input
  • works with US, European, Japanese, and Shindou ROMs
  • decompresses all MIO0 blocks from ROM to extended area
  • configurable extended ROM size (default 64 MB)
  • configurable padding between MIO0 blocks (default 32 KB)
  • configurable MIO0 block alignment (default 1 byte)
  • changes all 0x18 level commands to 0x17
  • creates MIO0 headers for all 0x1A level commands
  • optionally fills old MIO0 blocks with 0x01
  • optionally dump compressed and uncompressed MIO0 data to files
  • updates assembly reference to MIO0 blocks
  • recalculates ROM header checksums

Usage

sm64extend [-a ALIGNMENT] [-p PADDING] [-s SIZE] [-d] [-f] [-v] FILE [OUT_FILE]

Options:

  • -a ALIGNMENT Byte boundary to align MIO0 blocks (default = 1).
  • -p PADDING Padding to insert between MIO0 blocks in KB (default = 32).
  • -s SIZE Size of the extended ROM in MB (default: 64).
  • -d Dump MIO0 blocks to files in mio0 directory.
  • -f Fill old MIO0 blocks with 0x01.
  • -v verbose output.

Output file: If unspecified, it is constructed by replacing input file extension with .ext.z64

Examples

64 MB extended ROM that is bit compatible with with generated from the M64ROMExtender1.3b, after extending to 64 MB

sm64extend sm64.z64

24 MB extended ROM that is bit compatible with the ROM generated from the M64ROMExtender1.3b

sm64extend -s 24 sm64.z64

Enable verbose messages and specify output filename:

sm64extend -v sm64.z64 sm64_output.ext.z64

Pad 64 KB between blocks, align blocks to 16-byte boundaries, fill old MIO0 blocks with 0x01:

sm64extend -p 64 -a 16 -f sm64.z64

sm64compress

Experimental Super Mario 64 ROM alignment and compression tool

  • packs all MIO0 blocks together, reducing unused space
  • optionally compresses MIO0 blocks (and converts 0x17 commands to 0x18)
  • configurable MIO0 block alignment (default 16 byte)
  • reduces output ROM size to 4 MB boundary
  • updates assembly reference to MIO0 blocks
  • recalculates ROM header checksums

Usage

sm64compress [-a ALIGNMENT] [-c] [-d] [-v] FILE [OUT_FILE]

Options:

  • -a alignment Byte boundary to align MIO0 blocks (default = 16).
  • -c compress all blocks using MIO0.
  • -d dump MIO0 blocks to files in mio0 directory.
  • -v verbose output.

Output file: If unspecified, it is constructed by replacing input file extension with .out.z64

Other Tools

There are many other smaller tools included to help with SM64 hacking. They are:

  • f3d: tool to decode Fast3D display lists
  • mio0: standalone MIO0 compressor/decompressor
  • n64cksum: standalone N64 checksum generator. can either do in place or output to a new file
  • n64graphics: converts graphics data from PNG files into RGBA or IA N64 graphics data
  • mipsdisasm: standalone recursive MIPS disassembler
  • sm64geo: standalone SM64 geometry layout decoder

License

MIT License. Copyright 2015 queueRAM.