mudora-analysis

Analysis of item placement in A Link to the Past Randomizer (ALttPR), based on a dataset of ~28k randomized games generated by the PHP randomizer and inspected with Mudora.

What's here

• dataset.ipynb - build a dataset from your own randomized games.
• main.ipynb - performs analysis over the dataset (loaded from Kaggle).
• Mudora binary not included, grab one here: https://github.com/alttpr-mudora

Setup

You'll need your own legally-acquired unheadered Japanese v1.0 ALttP ROM to generate randomized seeds — none are included here.

1. Set up the PHP randomizer and generate a batch of ROMs, e.g.:

   php artisan alttp:randomize <ROM> <output_dir> \
     --goal=ganon --state=open --weapons=randomized --glitches=none \
     --crystals_ganon=7 --crystals_tower=7 --item_placement=advanced \
     --dungeon_items=standard --accessibility=items --hints=on \
     --item_pool=normal --item_functionality=normal

2. Acquire a mudora.exe binary and verify it works: ./mudora.exe -v.

3. Copy the env template and point it at your generated ROMs:

   cp .env.example .env
   # set ROM_PATH=/path/to/roms

4. Run dataset.ipynb to produce alttpr.csv, then main.ipynb to reproduce the analysis (or just load the published dataset from Kaggle, as main.ipynb does by default).

Contact

Ty Porter

tyler.b.porter@gmail.com