Welcome to Randovania, a randomizer for Metroid Prime and Metroid Prime 2: Echoes.

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.

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

Join the Metroid Prime Randomizer Discord: https://discord.gg/metroid-prime-randomizer

Game patching written by Claris.

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

Many thanks to Claris for making the original Echoes Randomizer and both collecting and providing this incredible initial set of data which powers Randovania.

Claris also made the included Menu Mod, a tool for practicing Echoes. For more information, see the Menu Mod README.

Also thanks to Dyceron for motivation and testing.

• Python 3.9 64-bit
• Git

1. Clone this repository
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

Alternatively, install requirements.txt to run tests or server. Suggested IDE: PyCharm Community

• Adding a new game? Check the dedicated guide.
• Changing a data format? Check the migrations documentation.