Skip to content

Latest commit

 

History

History
86 lines (53 loc) · 2.44 KB

README.md

File metadata and controls

86 lines (53 loc) · 2.44 KB

OoTMM Logo

The Ocarina of Time/Majora's Mask Combo Randomizer

badge-version badge-license badge-build badge-stars badge-discord

Overview

OoTMM is a randomizer for the N64 games Ocarina of Time and Majora's Mask. It combines both games into a single rom and randomizes the placement of most items in the games. A large number of settings are available to customize the experience.

What's new?

We maintain a comprehensive changelog that details all the changes in each release.

Usage

We strongly recommend that you use the Web-based generator.

Support

If you need help, you can ask for help on our Discord server.

Manual Setup

You need the following roms:

  • Ocarina of Time (U or J, 1.0)
  • Majora's Mask (U only)

The roms need to be in their native byte-order (big endian). You can use programs such as Tool 64 to convert the roms to the correct format. The roms need to be named oot.z64 and mm.z64 respectively and placed in the roms folder.

Build

You can build OoTMM with either a DevContainer or your native environment.

DevContainer (recommended)

You need:

  • Docker
  • Visual Studio Code
  • Remote - Containers extension

Open the project in Visual Studio Code and click on the "Reopen in Container" button that appears in the bottom right corner. That's it.

Native

You need:

  • A C/C++ toolchain for your system
  • CMake
  • Ninja
  • n64-ultra
  • Node 22 or newer
  • Git

On windows, we recommend using WSL2 to build OoTMM.

Install everything you need:

./setup.sh

Using the build

You can generate a seed:

pnpm start:core:config

The output will be out/OoTMM.z64.

License

This project is licensed under the MIT license.

Author

This project was created by Maxime Bacoux "Nax".