N64LoaderWV

Project Url: zeroKilo/N64LoaderWV
Introduction: Ghidra Loader Module for N64 ROMs
More: Author   ReportBugs   
Tags:
Star Pilipinas-

A Ghidra loader extension for Nintendo 64 cartridges and 64DD disk images, supporting disassembly, decompilation and runtime memory analysis.

Features

  • N64 cartridges (.z64, .n64, .v64) with automatic byte order detection and normalization
  • 64DD disk images (retail and development NDD, D64 and retail MAME formats)
  • N64 memory mapping, hardware register symbols and optional 4 MiB or 8 MiB RDRAM dumps
  • Optional 64DD IPL, PIF and modem ROM loading
  • Cartridge-based 64DD expansion disk support
  • Embedded modem ELF analysis using Ghidra's native ELF parsing and MIPS relocation functionality, with function names, global objects, cross-references and selected SDK prototypes
  • N64sym address/name files and byte-pattern signature files
  • Headless import support

Usage

Install the extension using File → Install Extensions in Ghidra, restart Ghidra and import an N64 cartridge or a 64DD disk image.

Additional firmware, RDRAM dumps, expansion disks and signature files can be selected in the loader options. Game images and firmware must be supplied separately.

For code loaded or decompressed at runtime, use an RDRAM dump captured after the code of interest has been loaded.

Modem ELF modules are analyzed in separate memory overlays. Their addresses are synthetic analysis addresses, not verified runtime locations. Some external symbols and SDK types remain unresolved.

Tested with Ghidra 12.2 on Windows, including cartridge, retail NDD, expansion disk and embedded modem analysis. D64, retail MAME and development NDD support still require host regression testing. Physical development MAME images are not supported.

Build from Source

Requirements

  • Ghidra 12.2
  • 64-bit JDK 25
  • Gradle 9.1 or newer (use a version compatible with your Ghidra installation)

Run the following commands from the project directory.

Windows

In Command Prompt, set the path to your Ghidra installation and build:

set "GHIDRA_INSTALL_DIR=C:\path\to\ghidra"
gradle

macOS (Homebrew)

Install the dependencies:

brew install openjdk@25 gradle ghidra

Configure the environment and build:

export JAVA_HOME="$(brew --prefix openjdk@25)/libexec/openjdk.jdk/Contents/Home"
export GHIDRA_INSTALL_DIR="$(brew --prefix ghidra)/libexec"
gradle

Linux

Install the required JDK, Gradle and Ghidra versions, then configure the path and build:

export GHIDRA_INSTALL_DIR="/path/to/ghidra"
gradle

The extension ZIP will be created in the dist directory. Install it in the corresponding Ghidra version. The macOS and Linux build instructions have not been tested with this release.

Credits

Videos

Video 1

Video 2

image
Apps
About Me
GitHub: Trinea
Facebook: Dev Tools
AI Daily Digest