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.
Web generator repo: https://github.com/Pronyo-Chan/paper-mario-randomizer Base mod repo: (currently private)
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.
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.
For curious users, this project can show the internal workings of the generator. A few interesting files and directories are:
/maps/graph_edges/base_graphThe 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).
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