andrelikesdogs / sm64-randomizer

Super Mario 64 Randomizer

Join our Discord Server for development updates, discussion and support

This project is retired. Consider checking out Arthurtilly's randomizer: https://romhacking.com/hack/sm64-randomizer

Super Mario 64 ROM Randomizer Generator

This is a work in progress project to build an OoT-Randomizer-style randomizer for Super Mario 64, that is highly configurable but easy to use.

Features

• Works on all endianess' (.z64, .n64, .v64) and all regions (America, Europe, China, Japan, Japan Shindou).
• Randomizes level entries - Every level will be a different one
• Randomizes Castle paintings - To visually match the entrance of the level it now leads to.
  • New: Levels without a castle painting will show a painting visually matching the original style, by the talented Mika
• Byte alignment for running on real hardware. Default is 8
• Randomizes dialog
• Randomizes music
• Randomizes mario's outfit
• Randomizes coin colors
• Randomizes objects in level
• Randomizes musical instruments
• Randomizes skybox
• Disables cutscenes and level intros
• ...many more to come

This program theoretically works on romhacks. I don't have the time to create and maintain configurations for romhacks. If you have experience and want to contribute, please ping me and I will try and help you out.

The application is supported on everdrive. To ensure everdrive compatibility, please change the name to a shorter one, as that seems to cause issues. For further help, please visit the Discord Server.

Also auto extends ROM to work with the randomizer. If this fails, extend your ROM manually and use either sm64extender or Super Mario 64 ROM Extender.

Web

For extremely simple usage, simply use our existing web generator, found here: https://andrelikesdogs.github.io/sm64-randomizer/

Offline. Please download the program to use it.

Usage

Follow instructions on the website. Upload your original SM64 rom, select the settings and press "Queue for generation" you'll quickly receive your randomized ROM.

GUI

The randomizer includes a simple GUI for easy setup without any knowledge about the command line. Simply download the latest release and open SM64 Randomizer GUI.

Install

1. Download the latest release
2. Extract all files in a folder of your liking
3. Run SM64 Randomizer Generator.exe

Usage

1. Select an Input ROM
2. Select an Output (will be automatically determined to .out.)
3. Select your settings

• Choose a custom seed to share with friends who use the same tool
• Copy the settings string to copy your current settings to share with friends. Does not include seed.

4. Press "Generate"
5. Run output file on your emulator/console. 🎉

CLI

For expert users who want to tinker with configurations, settings and test various roms, it's easier to use the program in CLI mode. To do this, run the application with additional arguments, and it will automatically work as a terminal tool.

Install

1. Download the latest release
2. Extract all files in a folder of your liking
3. Run SM64 Randomizer Generator.exe in your terminal

Usage

python main.py ./Super_Mario_64_(U)_[!].z64 --shuffle-levels --shuffle-mario-color --shuffle-paintings match --seed 123

Note: Works on all regions of the original SM64

Output will be a file with the same name, ending in .out.z64. Run this on your emulator/console.

  Super Mario 64 Randomizer  (Version: 0.10.1)

usage: main.py [-h] [--no-extend] [--alignment ALIGNMENT] [--out OUT] [--version] [--seed SEED] [--shuffle-paintings {vanilla,match,replace-unknown,random}] [--custom-painting-author {disable,mika}] [--shuffle-skybox] [--shuffle-entries]
               [--shuffle-mario-outfit] [--shuffle-music] [--shuffle-objects] [--shuffle-colors] [--shuffle-text] [--shuffle-instruments] [--disable-cutscenes]
               rom

positional arguments:
  rom

optional arguments:
  -h, --help            show this help message and exit
  --no-extend           disable auto-extend of ROM, which might fail on some systems
  --alignment ALIGNMENT
                        Specify the byte alignment. If you know this value, you have a higher change of successfully randomizing romhacks.
  --out OUT             target of randomized rom
  --version             show program's version number and exit
  --seed SEED           Allows you to play the same version as a friend, simply enter the same seed as them and you will be playing the exact same ROM.
  --shuffle-paintings {vanilla,match,replace-unknown,random}
                        Change the behaviour of how the paintings in the castle are shuffled ("match" - matches randomized levels, i.e. painting = level, "random" - independently randomize paintings, "off" - leave paintings untouched)
  --custom-painting-author {disable,mika}
                        This property allows changing the custom paintings to a different author, if you want to add your own, see the sm64.vanilla.yml
  --shuffle-skybox      Randomizes the sky-texture between different levels. The black skybox is excluded.
  --shuffle-entries     Shuffles the levelentries. When you enter a level, you will end up at a random one.
  --shuffle-mario-outfit
                        Randomizes parts of Marios Outfit.
  --shuffle-music       Randomizes most songs in the game.
  --shuffle-objects     Shuffles Objects in Levels
  --shuffle-colors      Shuffle various colors in the game
  --shuffle-text        Shuffle Dialog text, for signs, npc dialog, level dialog and prompts.
  --shuffle-instruments
                        Shuffles instrument sounds around. Many different objects and songs use different instrument sets, as the N64 can't load all at once. This will shuffle them around. Might be wacky.
  --disable-cutscenes   Disables some of the games cutscenes. (Peach Intro, Lakitu Intro, Bowser-Text on Entry)

Contributing: Getting Started

To work on this repository, follow the following steps. Please also definitely join the discord for help.

1. git clone this repository
2. Make sure you somehow have python >3.6 (Mac OSX I suggest brew install, Linux I suggest apt install python3, windows I suggest the installer)
3. Create a venv via python3 -m venv . while inside the folder
4. Install dependencies via pip install -r requirements-dev.txt

Special Thanks

• hack64's wonderful SM64 hacking resources, clean, easy to use and great in-depth details
• SimpleFlips Discord-Server for help with SM64 hacking/weirdness (especially Felegg)
• Durkhaz for the amazing logo
• CJay for server hosting of the generator
• Beta Testers and people from the discord
• Special thanks to 2003041 for beating the game countless times so I can find bugs!
• smwcentral's community and forum