Paper Mario Randomizer - Seed Generator

This python project is the seed generator for the Open World Paper Mario Randomizer mod for Paper Mario 64. This generator runs in the backend of the web generator, but can also be used locally, although we do not offer support for that.

Related repositories

Web generator repo: https://github.com/Pronyo-Chan/paper-mario-randomizer Base mod repo: (currently private)

Requirements

This project requires python 3.9 with a handful of additional dependencies. Furthermore a base-modded US-ROM of Paper Mario 64 is required and has to be provided by the user; automatically patching the base mod is not part of the generator. For this purpose the patch file for turning the vanilla US ROM into the base mod is provided within the project's /res folder.

Running from the command line

First, install dependencies (or run the project inside of a virtual environment like pipenv). Then, to generate a game with default settings: py randomizer.py -t PATH_TO_PREMODDED_ROM To generate a game with custom settings, create or modify a settings yaml file and then: py randomizer.py -c PATH_TO_SETTINGS_YAML -t PATH_TO_PREMODDED_ROM Note that the seed generator writes to the provided file destructively, so make a backup of your pre-modded ROM.

Code of interest

For curious users, this project can show the internal workings of the generator. A few interesting files and directories are:

/maps/graph_edges/base_graph The files in here define the item location requirements, as well as requirements for traversing the ingame world.
Default Settings All options, toggles and their default values that the generator can use can be found here.
Placement Logic This file handles the item placement logic (graph based using DFS).

Credits

The Paper Mario Randomizer as a whole was built by

clover
Icebound777
Pronyo

with assistance and contributions by

Jdog
Quackles
Rain
Jdaster64
MrN829
MrCheeze
AmazingAmpharos
Boingboingsplat