adituv / ghidra-gamecube-loader

A Nintendo GameCube binary loader for Ghidra

Ghidra GameCube Loader

A Nintendo GameCube binary loader for Ghidra.

Includes optional symbol map importing, automatic namespace creation, and demangling support.

Supported Formats

• DOL Executables (.dol)
• Relocatable Modules (.rel)

Dependencies

This loader requires the Gekko/Broadway processor definitions for Ghidra. These must be installed prior to using the loaders. https://github.com/aldelaro5/ghidra-gekko-broadway-lang

Building

• Ensure you have JAVA_HOME set to the path of your JDK 11 installation.
• Set GHIDRA_INSTALL_DIR to your Ghidra install directory. This can be done in one of the following ways:
  • Windows: Running set GHIDRA_INSTALL_DIR=<Absolute path to Ghidra without quotations>
  • macos/Linux: Running export GHIDRA_INSTALL_DIR=<Absolute path to Ghidra>
  • Using -PGHIDRA_INSTALL_DIR=<Absolute path to Ghidra> when running ./gradlew
  • Adding GHIDRA_INSTALL_DIR to your Windows environment variables.
• Run ./gradlew
• You'll find the output zip file inside /dist

Installation

• Copy the zip file to <Ghidra install directory>/Extensions/Ghidra.
• Start Ghidra and use the "Install Extensions" dialog to finish the installation. (File -> Install Extensions...).