Skip to content
N64 development tools
C Shell Other
Branch: master
Clone or download

README.md

About

This is a collection of files and tools used to compile and test code for the n64.

Toolchain

install-toolchain provides binutils, gcc, newlib, and gdb targeting mips64, with -march=vr4300 and -mabi=32 as defaults for gcc.

Programs

  • ed64rdb: ED64v3 USB packet translator, for remote debugging of gz with gdb.
  • gfxdis: F3DEX2 display list disassembler / decompiler.
  • grc: Resource compiler for creating linkable n64 texture objects.
  • gru: Lua environment for manipulating raw binaries, n64 roms, zelda64 file systems, ups patches, and gameshark codes.
  • gs: Gameshark upload tool for use with a Moschip USB Parallel Cable.
  • luapatch: Tool to generate lua sources from binaries, to inject into emulated RAM in BizHawk.

Headers

  • list/list.c/h: Doubly linked list implementation.
  • memory/memory.c/h: Minimal malloc implementation.
  • set/set.c/h: Ordered set implementation.
  • vector/vector.c/h: Vector implementation.
  • grc.c/h: API for resources created by grc.
  • mips.h: VR4300 mips3 header, with convenience definitions and assembler macros.
  • n64.h: Mostly-compatible definitions for a subset of the ultra library.
  • startup.c/h: Basic program initialization routines.
  • vr4300.c/h: Disassembler library.

Libraries

  • gl-n64.ld: Linker script for n64 binaries.

Prerequisites

You'll need to have these packages installed: wget tar make diffutils texinfo gcc g++ lua5.3 jansson libusb-1.0. See Installation, step 4. If you want to use the included luapatch program with BizHawk, you should set the EMUDIR environment variable to the path to your BizHawk installation.

Installation

  1. Download and unpack the n64 repository.
  2. If you're on Windows, download and install MSYS2 from here.
  3. Open a GNU/Linux or MSYS2 MinGW 32-bit shell and navigate to n64-master.
  4. Optionally, have the included script try to install the prerequisite packages automatically by running ./install_deps. You'll need root privileges for this.
  5. Configure the package with ./configure --prefix=/opt/n64. You may use another installation prefix if you wish. To enable Wii VC compatibility, append --enable-vc to the configure command. To produce portable Windows executables (that don't need additional dynamic libraries) under MSYS2, append --enable-static-executables to the configure command.
  6. Install the GNU Toolchain for MIPS by running make install-toolchain. You may want to use make's -j option speed up this process.
  7. Compile and install the included programs by running make && make install.
  8. Install the included headers and libraries by running make install-sys. Optionally, install prefixless binaries to your-prefix/mips64/bin by running make install-local-exec.
  9. The n64 tools and MIPS toolchain will have been installed to /opt/n64 (or the prefix you chose). Add /opt/n64/bin to your PATH variable (or your-prefix/bin, C:\msys64\opt\n64\bin on Windows). If you're using MSYS2, also add the path to the directory containing the make program (typically C:\msys64\usr\bin).
You can’t perform that action at this time.