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

New here or looking to install? Check our website.

• Another Metroid 2 Remake
• Cave Story
• Metroid Dread
• Metroid Prime
• Metroid Prime 2: Echoes

• Metroid Prime 3: Corruption
• Metroid: Samus Returns
• 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.

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

For Linux users, we recommend using our Flatpak instead.

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.

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.

Website created by Hugoshido.

Installer is powered by Advanced Installer, which has graciously provided us with an open source license.

Linux Flatpak build contributed by Ethan Lee.

• Game patching via randomprime. Originally authored by April Wade, it is now maintained and developed by toasterparty with contributions from others
• Room data collected by UltiNaruto, EthanArmbrust and SolventMercury.
• Converting Metroid Prime 2 models by Migs.

• 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.
• Converting Metroid Prime models by Migs.

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

• 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.

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

• Game Patching by:

  • Henrique "Darkszero" Gemignani
  • duncathan_salt
  • ScorelessPine
  • Arcanox
  • Migs
  • hyperbola0
  • Thanatos

• Logic Database by:

  • KirbymastaH
  • Dyceron
  • XenoWars
  • Mayberry
  • Hugoshido
  • Tyranisaur

• Assets by:

  • Morph Ball and Speed Booster pickup textures created by BigSharkZ.
  • Spider Magnet pickup texture by duncathan_salt with help from BigSharkZ.
  • New map icons by SkyTheLucario.

• Game Patching by:

  • Miepee
  • JesRight

• Logic Database by:

  • Miepee
  • DruidVorse
  • JeffGainsNGames

• Assets by:

  • Morph Ball, and the Missile Launcher sprites were made by ShirtyScarab554 licensed under CC BY-SA 4.0.
  • Power Grip and the Shiny Nothing Orb were made by ShirtyScarab554, used under CC BY-SA 4.0, modified by AbyssalCreature and licensed under CC BY-SA 4.0.
  • New door sprites and other AM2R item sprites were made by AbyssalCreature licensed under CC BY-SA 4.0.

• Game theme assets were provided by MaskedTAS.
• Pixel theme assets were provided by Uncle Reggie.
• AM2R 1.5.5 item sprites were made by Eskimode7 licensed under CC BY-SA 4.0.
• The AM2R DNA sprite was made by AbyssalCreature licensed under CC BY-SA 4.0.
• The AM2R Morph Ball and Power Grip sprites were made by ShirtyScarab554 licensed under CC BY-SA 4.0.

Server and logic written by Henrique "Darkszero" Gemignani.

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

Cave Story Doukutsu and CSE2 Tweaked integations written by duncathan_salt, periwinkle and ikuyo.

Integration written by Thanatos and Henrique "Darkszero" Gemignani.
The "unplug" icon is by tezar tantular from Noun Project (licensed under CC BY 3.0).

Integration written by Miepee. Offworld sprites are licensed under CC BY-SA 4.0 and are made by AbyssalCreature, ShirtyScarab554 and many others.

• Python 3.11 64-bit
• Git

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 update your repository:

1. Update the git repository. (With git pull or anything else)
2. Make sure that Randovania is closed.
3. Re-run the steps from "Getting Started", starting at step 2.
   1. In case of unexpected errors, delete the venv in the root of the repository and start again.
4. Open Randovania normally.

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 and client. You can this on
   1. Windows with tools/start_dev_server.bat for the server and tools/start_debug_client.bat for the client
   2. Linux/macOS with tools/start_dev_server.sh for the server and tools_start_debug_client.sh for client

This repository uses pre-commit. The hook is automatically configured with the prepare_virtual_env scripts.

Suggested IDE: PyCharm Community

*If using Visual Studio Code, make sure to set "qtForPython.uic.liveExecution.enabled": false when using the QT extension.

• 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?
  • Read how the database is organized.
  • Read the unfinished script for a video on how to use the data editor.