Randovania

Welcome to Randovania, a randomizer platform for a multitude of games.

Supported Games

• Metroid Prime
• Metroid Prime 2: Echoes
• Cave Story

Experimental Games

• Metroid Prime 3: Corruption
• Metroid Dread
• Super Metroid

Here you will be able to randomize many aspects of either game, while still being ensured it's possible to finish without any trick or glitch! What can be randomized?

• Randomize what can be found in each pickup location, including major upgrades, expansions, keys and artifacts.

• Play with multiple people, via multiworld sessions. Your pickups will be shuffled among the games of everyone involved, no matter what game they're playing!

• Randomize where each teleporter goes, or what you need to unlock a translator gate. In either case, there's advanced options for how they're shuffled.

• The location you start the game in as well as the items you start with. If you're feeling brave, you can even shuffle items you normally start with, like the Power Beam and Scan Visor.

So have fun and start randomizing.

Installation

Windows

In the releases page, we have zip files with everything ready to use. Just extract and run!

Community

Join the Randovania Discord: https://discord.gg/M23gCxj6fw

Invite links for specific games' servers can be found in the #game-communities channel in our server.

Credits

GUI and logic written by Henrique Gemignani, with contributions by SpaghettiToastBook, gollop and many others.

BashPrime, Pwootage, and April Wade made https://randomizer.metroidprime.run/, from which the GUI was based.

Games

Metroid Prime 1

• Game patching via randomprime from April Wade, with contributions from UltiNaruto, BashPrime and toasterparty.
• Room data collected by UltiNaruto, EthanArmbrust and SolventMercury.

Metroid Prime 2: Echoes

• Game patching written by Claris.
• Room data initially collected by Claris, revamped by Dyceron.
• Menu Mod created by Claris. For more information, see the Menu Mod README.

Metroid Prime 3: Corruption

• Game patching written by gollop.
• Room data collected by Dyceron and KirbymastaH.

Super Metroid

• Game Patching and Logic Database by SolventMercury.
• Custom Item PLMs patch by Kazuto.
• Skip Intro Saves patch by PHOSPHOTiDYL.
• Other individual patches by Total, Foosda, Leodox, and others.

Cave Story

• Patcher and logic written by duncathan_salt.
• Based on the original randomizer by shru.
• Features contributions from many others.

Auto Tracker

Classic theme uses assets derived from this spritesheet from ChaosMiles07 and Ridleymaster, with edits from SpaghettiToastBook.

Game theme assets were provided by MaskedTAS.

Multiworld

Server and logic written by Henrique, including Dolphin and Nintendont integrations. These were based on Dolphin Memory Engine and Pwootage's Nintendont fork, respectively. In-game message alert initially written by encounter.

Developer Help

Dependencies

• Python 3.9 64-bit
• Git

Setup

Getting started:

1. Clone this repository (downloading the zip is not supported and will not work)
2. Open a terminal in the repository root
3. Run the following file:
   1. Windows: tools/prepare_virtual_env.bat
   2. Linux/macOS: tools/prepare_virtual_env.sh
4. You should see "Setup finished successfully." visible when the command finishes.

In order to start Randovania, open:

1. Windows: tools/start_client.bat
2. Linux/macOS: tools/start_client.sh

In order to run the tests:

1. Run both "Getting started" and "Start Randovania" steps.
2. Activate the virtual env. Check start_client.bat/sh for details.
3. Run python -m pip install -r requirements.txt.
4. Run python -m pytest test.

In order to run the server:

1. Run both "Getting started" and "Start Randovania" steps.
2. Activate the virtual env. Check start_client.bat/sh for details.
3. Run python -m pip install -r requirements.txt.
4. Run python tools/prepare_dev_server_config.py once.
5. If you wish to use any Discord functionality, you'll need to create an app in Discord and fill both ids in tools/dev-server-configuration.json.
6. Run the server with tools/start_dev_server.bat and the client with tools/start_debug_client.bat.

Suggested IDE: PyCharm Community

Documentation

• Unfamiliar with a term? Check the glossary.
• Adding a new game? Check the dedicated guide.
• Changing a data format? Check the migrations documentation.
• Working with the logic database? Check the guide.