Big among us rolling down the hill

Old leaked source code for "Project B-Roll". Do NOT file issues involving compiling. Credits in "copyright"

Quick Start (for Ubuntu)

Install prerequisites: sudo apt install -y build-essential git binutils-mips-linux-gnu python3 libaudiofile-dev
Clone the repo from within Linux: git clone https://github.com/n64decomp/sm64.git
Place a Super Mario 64 ROM called baserom.<VERSION>.z64 into the project folder for asset extraction, where VERSION can be us, jp, or eu.
Run make to build. Qualify the version through make VERSION=<VERSION>. Add -j4 to improve build speed (hardware dependent).

Ensure the repo path length does not exceed 255 characters. Long path names result in build errors.

Installation

Windows

Install WSL and a distro of your choice following Windows Subsystem for Linux Installation Guide for Windows 10. We recommend either Debian or Ubuntu 18.04 Linux distributions under WSL. Note: WSL1 does not currently support Ubuntu 20.04.

Next, clone the SM64 repo from within the Linux shell: git clone https://github.com/n64decomp/sm64.git

Then continue following the directions in the Linux installation section below.

Linux

There are 3 steps to set up a working build.

Step 1: Install dependencies

The build system has the following package requirements:

binutils-mips
python3 >= 3.6
libaudiofile
qemu-irix

Dependency installation instructions for common Linux distros are provided below:

Debian / Ubuntu

To install build dependencies:

sudo apt install -y build-essential git binutils-mips-linux-gnu python3 libaudiofile-dev

Download latest package from qemu-irix Releases.

Install this package with:

sudo dpkg -i qemu-irix-2.11.0-2169-g32ab296eef_amd64.deb

Arch Linux

To install build dependencies:

sudo pacman -S base-devel python audiofile

Install the following AUR packages:

mips64-elf-binutils (AUR)
qemu-irix-git (AUR)

Other Linux distributions

Most modern Linux distributions should have equivalent packages to the other two listed above. You may have to use a different version of GNU binutils. Listed below are fully compatible binutils distributions with support in the makefile, and examples of distros that offer them:

mips64-elf- (Arch AUR)
mips-linux-gnu- (Ubuntu and other Debian-based distros)
mips64-linux-gnu- (RHEL/CentOS/Fedora)

You may also use Docker to handle installing an image with minimal dependencies.

Step 2: Copy baserom(s) for asset extraction

For each version (jp/us/eu) for which you want to build a ROM, put an existing ROM at ./baserom.<VERSION>.z64 for asset extraction.

Step 3: Build the ROM

Run make to build the ROM (defaults to VERSION=us). Other examples:

make VERSION=jp -j4       # build (J) version instead with 4 jobs
make VERSION=eu COMPARE=0 # build (EU) version but do not compare ROM hashes

Resulting artifacts can be found in the build directory.

The full list of configurable variables are listed below, with the default being the first listed:

VERSION: us, jp, eu, sh (WIP)
GRUCODE: f3d_old, f3d_new, f3dex, f3dex2, f3dzex
COMPARE: 1 (compare ROM hash), 0 (do not compare ROM hash)
NON_MATCHING: Use functionally equivalent C implementations for non-matchings. Also will avoid instances of undefined behavior.
CROSS: Cross-compiler tool prefix (Example: mips64-elf-).
QEMU_IRIX: Path to a qemu-irix binary.

macOS

Installing Docker is the recommended avenue for macOS users. This project does not support macOS natively due to lack of macOS host support.

Docker Installation

Create Docker image

Create the docker image with docker build -t sm64.

Build

To build, mount the local filesystem into the Docker container and build the ROM with docker run.

macOS example for (U):

docker run --rm --mount type=bind,source="$(pwd)",destination=/sm64 sm64 make VERSION=us -j4

Linux example for (U):

For a Linux host, Docker needs to be instructed which user should own the output files:

docker run --rm --mount type=bind,source="$(pwd)",destination=/sm64 --user $UID:$UID sm64 make VERSION=us -j4