Randomizer

Scope

Current randomizer scope.

The current randomizer shuffles dungeon chest item values in extracted YAML. It does not shuffle overworld checks, pots, NPC rewards, shops, boss prizes, entrances, exits, holes, sprites, or room layouts.

Workflow

Safe-mode workflow.

Place zelda3.sfc or zelda3.smc in the project root, then run these commands there. 

python assets/restool.py --extract-from-rom --no-build
python assets/restool-randomize.py --generate-masterlist
python assets/restool-randomize.py --seed my-first-seed --mode safe
python assets/restool.py

Options

Useful commands.

python assets/restool-randomize.py --seed 12345 --dry-run
python assets/restool-randomize.py --seed 12345 --exclude-room 260
python assets/restool-randomize.py --seed 12345 --exclude-item 0x32
python assets/restool-randomize.py --restore-vanilla
  • The same seed produces the same shuffle.
  • Omitting --seed generates and prints a random seed.
  • Spoiler logs are written to assets/randomizer-spoilers/<seed>.md.
  • Use --include-small-keys or --include-big-chests to opt into rougher shuffles.