Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Project516/sm64dx/llms.txt
Use this file to discover all available pages before exploring further.
Building sm64dx natively on macOS requires Homebrew to supply a modern GNU make and a MIPS cross-compiler toolchain, because the versions of make and the toolchain shipped with Xcode are either absent or too old. Alternatively, you can use Docker to run an Ubuntu-based build environment without touching your host system’s toolchain at all. Both approaches are documented below.
Install dependencies
Install Homebrew if you haven’t already, then install the required packages:brew update
brew install coreutils make pkg-config tehzz/n64-dev/mips64-elf-binutils
gmake), pkg-config, and a MIPS64 ELF binutils cross-toolchain from the tehzz/n64-dev tap.macOS ships with a BSD version of make that is too old to build sm64dx. Always use gmake (the Homebrew GNU make) instead of make when building on macOS.
Build steps
Clone the repository
git clone https://github.com/Project516/sm64dx.git
cd sm64dx
</Step>
<Step title="Place your baserom">
Copy your original Super Mario 64 ROM into the project root, naming it `baserom.<VERSION>.z64`:
```bash
cp /path/to/your/rom.z64 baserom.us.z64
Run gmake
Use gmake (not make) to build. The default version is us:To build the Japanese version with 4 parallel jobs:Build artifacts are placed in the build/ directory. Prerequisites
Install and start Docker Desktop for Mac. No MIPS toolchain or GNU make is needed on the host.Build steps
Clone the repository
git clone https://github.com/Project516/sm64dx.git
cd sm64dx
</Step>
<Step title="Place your baserom">
Copy your original Super Mario 64 ROM into the project root:
```bash
cp /path/to/your/rom.z64 baserom.us.z64
Build the Docker image
Build the image once. This step only needs to be repeated if the Dockerfile changes: Build the ROM
Mount the current directory into the container and run make:docker run --rm --mount type=bind,source="$(pwd)",destination=/sm64 sm64 make VERSION=us -j4
build/ directory of your local checkout. --user flag, see the Docker build guide.