A randomizer for Splatoon 1's Octo Valley singleplayer campaign with a basic GUI.

As of writing, these are the aspects that are able to be randomized/shuffled:
- Kettles (bosses as well, though the boss kettles are randomized with each other with the exception of DJ Octavio, who is still the final boss)
- Ink colors (with the option to choose the color sets from either Octo Valley or multiplayer battles)
- Mission dialogue
- Stage music
- Hero Weapons (the Hero Shot, Hero Roller, and Hero Charger)
Requires Python 3.12 with the following dependencies installed from pip:
Important
Due to issues with oead not installing on Python 3.12 and the library PyLibMS only working on Python versions 3.12+, the randomizer currently ONLY works with Python 3.12!
To run the randomizer assuming Python 3.12 or new is installed, simply open a command prompt/terminal session in the folder containing the randomizer, then run python3 main.py. (python3 is to be replaced with py -3 if you're on Windows.) Alternatively, Windows users can also just double-click the helper batch script named run-randomizer-windows.bat.
Upon running the randomizer, the program will check all of the above dependencies installed and if not, offer to install them should the user agree to do so.
Alternatively, you can also run python3 -m pip install --r requirements.txt beforehand to install of the dependencies for you.
This randomizer is compatiable with both real Wii U hardware using Aroma custom firmware (installation guide can be found here) and the Cemu emulator. If you need details on how to legally obtain the files required to use the randomizer, consult this guide on the wiki.
The randomizer supports any region of the game on the latest update (version 2.12.1 as of writing). Any version other than 2.12.1 will not work with the randomizer, as the program will check on whether the required files are valid or not.
Please consult the wiki for information on how to use the randomizer tool and applying the randomizer patch onto your copy of the game.
- Pirlo - Making a patch that lets the Hero Roller work properly in singleplayer
- Archipelago Discord Server - Feedback, feature suggestions
- Kinnay - Author of the .hax patch format used for code patching on real Wii U hardware
- theawesomecoder61 - Author of CodePatchPlugin, documentation of the .hax file format and the assembler that was used for creating the .hax patch files
