stewmath/oracles-randomizer-ng

Overhaul of jangler's oracles-randomizer

Zelda Oracles Randomizer NG

This program reads a Zelda: Oracle of Seasons or Oracle of Ages ROM, shuffles the locations of (most) items and mystical seeds, and writes the modified ROM to a new file.

You can get more information and generate seeds using the Web UI.

Development

The simplest way to set things up is to use the instructions in the Web UI repository. The "build-rando" command outlined there will build both the required baseroms in the oracles-disasm submodule, and the oracles-randomizer-ng executable file itself.

Alternatively, to compile oracles-randomizer-ng on its own, run:

go generate
go build

Then, assuming the baseroms from the oracles-disasm submodule have already been built, you can generate a seed from the commandline with:

./oracles-randomizer-ng oracles-disasm/<ages|seasons>.gbc <output>.gbc TODO

In the oracles-disasm folder, there should be a file named seasons.sym (or ages.sym) created along with seasons.gbc. It is very important that this file is in the same directory as seasons.gbc, otherwise this won't work.

For more information

• WebUI Documentation
• Differences in oracles-randomizer-ng
• Seasons notes
• Ages notes

oracles-randomizer-ng's Issues

Softlocked while using Tune of Ages

I was playing a seed where I talked to the Soldier who wants Mystery Seeds for his reward. Immediately after, I used Tune of Ages on the tile above where the soldier stands, and for some reason it placed me in the very top left tile of the screen on resolution. From there, it endlessly tries to teleport me "back" to the other timeline since it's an illegal space, and thus softlocks the game.

Edit: After a little more testing, it seems to happen if you try standing "on" the tile where the soldier is by slightly clipping into the sprite.

Shooting gallery can be won without sword

It seems to be possible to win at the shooting gallery even without owning the sword.
Not sure which items are actually needed for this, but it seems that the seed shooter is needed.
When starting the minigame, I had the rod of seasons equipped but not the seed shooter.
As soon as the minigame is going on, the seed shooter is automatically equipped and using it triggers the sword slash animation.
Hitting the balls with normal slashes seems to not be possible, but hitting them with a charge attack works, and the balls can hit the statues as usual.

Here is the seed log:

oracles randomizer master-aec8b6c
generated 2023-01-17T19:02:18Z
seed: d15770a3
sha-1 sum: 81798906998d85512cbe69d51d255f7285100f96
difficulty: normal


-- progression items --

sphere 0:
nayru's house                <- zora's flippers / mermaid suit
starting item                <- tune of echoes/currents/ages

sphere 1:
black tower worker           <- power bracelet/glove

sphere 2:
deku forest cave east        <- tune of echoes/currents/ages

sphere 3:
fairies' woods chest         <- rupees, 200
lynna city chest             <- rod of seasons
symmetry city brother        <- D7 small key
talus peaks chest            <- seed shooter
tokkey's composition         <- tune of echoes/currents/ages

sphere 4:
deku forest cave west        <- D2 small key
deku forest tree             <- ember seeds
shop, 150 rupees             <- D0 small key
south lynna tree             <- pegasus seeds

sphere 5:
cheval's invention           <- D6 present small key
cheval's test                <- zora's flippers / mermaid suit
grave under tree             <- D8 small key

sphere 6:
first goron dance            <- shovel
hidden tokay cave            <- D7 boss key
pool in d6 entrance          <- D7 small key
under crescent island        <- D6 present small key

sphere 7:
maku path key chest          <- switch/long hook
maku tree                    <- mermaid key

sphere 8:
D7 diamond puzzle            <- slate
D7 spike chest               <- bombs, 10
fairies' coast chest         <- D3 small key
goron diamond cave           <- tuni nut
ridge NE cave present        <- D2 small key
target carts 2               <- graveyard key
zora village present         <- D2 boss key
zora village tree            <- mystery seeds

sphere 9:
D3 B1F east                  <- rock brisket
D3 bridge chest              <- dimitri's flute
D3 crossroads                <- switch/long hook
D3 six-block drop            <- rupees, 10
D4 first chest               <- cane of somaria
D5 blue peg chest            <- D6 past small key
D6 past rope chest           <- bomb flower
deku forest soldier          <- D6 present small key
goron's hiding place         <- D1 small key
graveyard poe                <- D8 small key
tokay bomb cave              <- rupees, 30

sphere 10:
D6 present channel chest     <- rupees, 30
D7 stairway chest            <- old mermaid key
fisher's island cave         <- rupees, 30
goron elder                  <- D8 small key
mayor plen's house           <- D8 boss key
nuun highlands cave          <- rupees, 30

sphere 11:
D8 B1F NW chest              <- rupees, 50
D8 blue peg chest            <- D7 small key
D8 stalfos                   <- rupees, 100

sphere 12:
king zora                    <- fairy powder

sphere 13:
D1 basement                  <- D6 past small key
D1 crossroads                <- D6 boss key
D1 ghini drop                <- seed satchel
zora seas chest              <- D7 small key

sphere 14:
defeat great moblin          <- roc's feather/cape
zora's reward                <- brother emblem

sphere 15:
D4 minecart chest            <- D1 small key
D5 two-statue puzzle         <- D5 boss key
balloon guy's gift           <- D6 past small key
tokay crystal cave           <- slate
trade rock brisket           <- tokay eyeball

sphere 16:
D1 two-button chest          <- D2 small key
D2 basement drop             <- D7 small key
D2 moblin drop               <- D2 small key
D2 thwomp tunnel             <- D7 small key
D6 boss                      <- zora scale

sphere 17:
D2 rope room                 <- D8 small key
D2 statue puzzle             <- power bracelet/glove
D7 hallway chest             <- D8 small key

sphere 18:
D4 large floor puzzle        <- D4 boss key
D8 floor puzzle              <- fool's ore

sphere 19:
D6 present vire chest        <- D7 small key
D8 NE slate chest            <- slate
D8 NW slate chest            <- D1 boss key
rescue nayru                 <- D3 boss key

sphere 20:
D1 boss                      <- D2 small key
D7 miniboss chest            <- slate


-- other items --

sphere 4:
ambi's palace chest          <- D6 present dungeon map
ambi's palace tree           <- gale seeds
shop, 30 rupees              <- wooden shield
symmetry city tree           <- gale seeds

sphere 7:
maku path basement           <- steadfast ring
south shore dirt             <- D8 dungeon map

sphere 8:
D6 present diamond chest     <- D5 small key
D7 crab chest                <- D1 compass
ridge base west present      <- gasha seed
ridge diamonds past          <- D8 compass
ridge past bush cave         <- piece of heart
ridge west top present       <- lava juice
rolling ridge east tree      <- scent seeds
rolling ridge west tree      <- pegasus seeds
target carts 1               <- D4 small key
zora palace chest            <- gasha seed

sphere 9:
D3 armos drop                <- heart ring L-2
D3 conveyor belt room        <- maple's ring
D3 moldorm drop              <- first gen ring
D3 pols voice chest          <- D5 small key
D3 statue drop               <- D6 past dungeon map
D3 torch chest               <- gasha seed
D5 dark room                 <- D4 small key
D5 eyes chest                <- gasha seed
D5 like-like chest           <- D1 dungeon map
D6 past pool chest           <- D2 compass
D6 past stalfos chest        <- heart ring L-1
D6 past wizzrobe chest       <- D4 small key
bomb goron head              <- D6 past compass
ridge base west past         <- D6 present compass
trade lava juice             <- red joy ring
wild tokay game              <- bombs, 10

sphere 10:
D7 right wing                <- island chart
tokay pot cave               <- D4 compass

sphere 11:
D8 1F chest                  <- heart container
D8 blade trap chest          <- blue luck ring
D8 ghini chest               <- book of seals

sphere 12:
D7 boxed chest               <- D5 compass
D7 cane/diamond puzzle       <- letter of introduction

sphere 13:
D1 crystal room              <- heart container
D1 east terrace              <- (magic) boomerang
D1 pot chest                 <- heart container
D1 west terrace              <- rupees, 30
goron dance, with letter     <- (magic) boomerang

sphere 14:
D6 present rope chest        <- heart container
D7 3F terrace                <- heart container
D7 boss                      <- goron vase
D7 left wing                 <- gold joy ring

sphere 15:
D4 cube chest                <- D3 dungeon map
D4 first crystal switch      <- armor ring L-1
D4 second crystal switch     <- crown key
D5 diamond chest             <- D7 dungeon map
D6 past color room           <- rupees, 50
D6 past diamond chest        <- gasha seed
D6 past spear chest          <- bombproof ring
D6 present RNG chest         <- D1 small key
D6 present beamos chest      <- iron shield
D6 present cube chest        <- rupees, 100
D6 present spinner chest     <- library key
D7 flower room               <- rupees, 20
balloon guy's upgrade        <- D3 small key
trade goron vase             <- goronade
under moblin keep            <- gasha seed

sphere 16:
D1 one-button chest          <- heart container
D1 wide room                 <- ricky's gloves
D2 basement chest            <- rupees, 50
D2 bombed terrace            <- D4 dungeon map
D2 thwomp shelf              <- gasha seed
big bang game                <- (hyper) slingshot
library past                 <- rupees, 30
library present              <- toss ring

sphere 17:
D2 ladder chest              <- peace ring
D2 moblin platform           <- heart container
piratian captain             <- D4 small key
sea of storms past           <- roc's feather/cape

sphere 18:
D4 color tile drop           <- seed satchel
D4 small floor puzzle        <- gasha seed
D8 sarcophagus chest         <- pegasus ring
sea of no return             <- D7 compass
zora NW cave                 <- D3 compass

sphere 19:
D4 boss                      <- heart container
D5 boss                      <- wooden/noble sword
D8 B3F chest                 <- cheval rope
D8 SE slate chest            <- scent seedling
D8 SW slate chest            <- D5 small key
D8 maze chest                <- gasha seed
D8 tile room                 <- magnetic gloves

sphere 20:
D3 boss                      <- wooden/noble sword
D7 post-hallway chest        <- D3 small key
D7 pot island chest          <- protection ring
crescent island tree         <- mystery seeds
goron shooting gallery       <- D5 small key

sphere 21:
D2 boss                      <- D2 dungeon map
D2 color room                <- D5 small key
D3 bush beetle room          <- (hyper) slingshot
D8 boss                      <- D4 small key

sphere 22:
D4 lava pot chest            <- green holy ring
D5 owl puzzle                <- rupees, 30
D5 red peg chest             <- D3 small key
D5 six-statue puzzle         <- D5 dungeon map
D5 three-statue puzzle       <- rupees, 50

sphere 23:
D3 mimic room                <- like-like ring


-- dungeon entrances --

D1 entrance <- D4
D2 past entrance <- D5
D2 present entrance <- D3
D3 entrance <- D6 present
D4 entrance <- D6 past
D5 entrance <- D5
D6 past entrance <- D7
D6 present entrance <- D8
D7 entrance <- D1
D8 entrance <- D2


-- subrosia portals --

Duplicate power bracelet in OoA cross items

The first was at Nayru's house and the second one was under Chavel's grave.
Haven't finished the seed yet, so I can't say anything about its completeability.

Here's the log:

oracles randomizer master-b9808ae
generated 2023-01-16T17:50:02Z
seed: 7cbc4191
sha-1 sum: 85b15a98dd0788022d288e7abf991af6dd70c0bc
difficulty: normal


-- progression items --

sphere 0:
nayru's house                <- power bracelet/glove
starting item                <- zora's flippers / mermaid suit

sphere 1:
black tower worker           <- switch/long hook
deku forest cave east        <- zora's flippers / mermaid suit

sphere 2:
D1 crossroads                <- switch/long hook
D1 east terrace              <- D1 boss key
D1 pot chest                 <- D1 small key
deku forest cave west        <- D7 boss key
fairies' woods chest         <- library key
hidden tokay cave            <- seed satchel

sphere 3:
mayor plen's house           <- roc's feather/cape

sphere 4:
ridge diamonds past          <- fist ring
tokay crystal cave           <- tune of echoes/currents/ages

sphere 5:
ambi's palace tree           <- scent seeds
deku forest tree             <- gale seeds

sphere 6:
rolling ridge east tree      <- ember seeds

sphere 7:
D1 basement                  <- bombs, 10
D1 crystal room              <- book of seals
cheval's invention           <- power bracelet/glove
grave under tree             <- tune of echoes/currents/ages

sphere 8:
D3 statue drop               <- tune of echoes/currents/ages
D6 past color room           <- D5 small key
D6 past stalfos chest        <- D7 small key
D6 past wizzrobe chest       <- D7 small key
bomb goron head              <- D4 boss key
first goron dance            <- mermaid key
goron diamond cave           <- zora scale
goron's hiding place         <- D3 small key
pool in d6 entrance          <- shovel
ridge NE cave present        <- D4 small key
rolling ridge west tree      <- mystery seeds
talus peaks chest            <- D5 small key
tokay bomb cave              <- D5 small key
under moblin keep            <- D7 small key

sphere 9:
D3 armos drop                <- tuni nut
D3 moldorm drop              <- D5 small key
D4 first chest               <- D6 past small key
fairies' coast chest         <- rod of seasons
fisher's island cave         <- dimitri's flute
library past                 <- D7 small key
library present              <- fairy powder
piratian captain             <- D5 small key
zora palace chest            <- D4 small key
zora village present         <- D3 small key

sphere 10:
D2 bombed terrace            <- D5 boss key
D2 thwomp shelf              <- graveyard key
D4 minecart chest            <- old mermaid key
maku tree                    <- D1 small key
nuun highlands cave          <- tokay eyeball
zora seas chest              <- D8 small key

sphere 11:
D1 boss                      <- D7 small key
D7 3F terrace                <- D2 small key
D7 crab chest                <- cane of somaria
D7 diamond puzzle            <- D2 small key
D7 right wing                <- D2 small key
D8 1F chest                  <- D6 boss key
graveyard poe                <- slate

sphere 12:
D6 past spear chest          <- slate
D6 present rope chest        <- D3 boss key
sea of no return             <- D8 boss key

sphere 13:
D5 blue peg chest            <- slate
D5 dark room                 <- seed shooter
D5 owl puzzle                <- bomb flower
D5 two-statue puzzle         <- wooden/noble sword

sphere 14:
D3 B1F east                  <- D2 small key
D4 first crystal switch      <- D6 past small key
D6 present vire chest        <- D3 small key
D8 B1F NW chest              <- D8 small key
goron elder                  <- D7 small key
goron shooting gallery       <- D8 small key

sphere 15:
D3 bush beetle room          <- lava juice
D8 stalfos                   <- D2 small key

sphere 16:
trade lava juice             <- D8 small key

sphere 17:
D8 NE slate chest            <- D8 small key
D8 maze chest                <- D2 boss key

sphere 18:
D8 SW slate chest            <- D7 small key

sphere 19:
D7 pot island chest          <- slate


-- other items --

sphere 2:
D1 ghini drop                <- D6 past dungeon map
D1 west terrace              <- rupees, 50
ambi's palace chest          <- D6 present small key
under crescent island        <- letter of introduction

sphere 3:
shop, 30 rupees              <- wooden shield
tokay pot cave               <- heart container

sphere 4:
goron dance, with letter     <- spin ring
ridge past bush cave         <- heart container

sphere 5:
south lynna tree             <- pegasus seeds

sphere 7:
cheval's test                <- D3 dungeon map
lynna city chest             <- rupees, 30

sphere 8:
D3 pols voice chest          <- rupees, 50
D6 past pool chest           <- goron vase
defeat great moblin          <- D6 present small key
ridge base west past         <- D6 present dungeon map
ridge base west present      <- gasha seed
ridge west top present       <- D8 compass
symmetry city brother        <- (hyper) slingshot
symmetry city tree           <- gale seeds
target carts 1               <- heart ring L-2
target carts 2               <- (magic) boomerang
tokkey's composition         <- snowshoe ring
wild tokay game              <- ricky's gloves

sphere 9:
D3 bridge chest              <- D0 small key
D3 conveyor belt room        <- heart container
D3 crossroads                <- D4 compass
D3 six-block drop            <- D5 compass
D4 cube chest                <- heart container
balloon guy's gift           <- armor ring L-3
balloon guy's upgrade        <- gasha seed
deku forest soldier          <- gasha ring
maku path key chest          <- heart container
sea of storms past           <- D6 past compass
south shore dirt             <- D1 dungeon map
zora NW cave                 <- D8 dungeon map
zora village tree            <- mystery seeds

sphere 10:
D2 basement chest            <- goronade
D2 basement drop             <- island chart
D2 moblin drop               <- gasha seed
D2 thwomp tunnel             <- D5 dungeon map
maku path basement           <- rupees, 30

sphere 11:
D1 one-button chest          <- rupees, 30
D1 two-button chest          <- red joy ring
D1 wide room                 <- scent seedling
D7 boss                      <- rupees, 30
D7 boxed chest               <- D4 small key
D7 flower room               <- D7 compass
D7 left wing                 <- gasha seed
D7 spike chest               <- rupees, 50
D7 stairway chest            <- bombs, 10
big bang game                <- gasha seed
zora's reward                <- gold luck ring

sphere 12:
D2 moblin platform           <- rupees, 10
D2 statue puzzle             <- rupees, 30
D6 past diamond chest        <- D6 present small key
D6 present cube chest        <- blue holy ring
D6 present diamond chest     <- crown key
D6 present spinner chest     <- rupees, 30
D7 cane/diamond puzzle       <- rupees, 200
D7 hallway chest             <- D1 small key
crescent island tree         <- pegasus seeds
shop, 150 rupees             <- heart ring L-1

sphere 13:
D3 boss                      <- rupees, 100
D5 diamond chest             <- steadfast ring
D5 like-like chest           <- gasha seed
D5 red peg chest             <- roc's feather/cape
D5 three-statue puzzle       <- toss ring
king zora                    <- rock brisket

sphere 14:
D3 torch chest               <- gasha seed
D4 boss                      <- first gen ring
D4 large floor puzzle        <- rupees, 20
D4 second crystal switch     <- seed satchel
D4 small floor puzzle        <- heart container
D5 boss                      <- piece of heart
D5 eyes chest                <- (hyper) slingshot
D5 six-statue puzzle         <- D2 compass
D6 past rope chest           <- quicksand ring
D6 present RNG chest         <- fool's ore
D6 present beamos chest      <- rupees, 50
D6 present channel chest     <- heart container
D8 ghini chest               <- D3 compass
rescue nayru                 <- wooden/noble sword

sphere 15:
D2 ladder chest              <- D2 dungeon map
D2 rope room                 <- D4 small key
D6 boss                      <- D4 small key
D8 blade trap chest          <- heart container
D8 blue peg chest            <- D3 small key
D8 sarcophagus chest         <- D4 dungeon map

sphere 16:
D2 color room                <- rupees, 30
D3 mimic room                <- gasha seed
D4 color tile drop           <- D7 dungeon map
D4 lava pot chest            <- expert's ring

sphere 17:
D8 B3F chest                 <- (magic) boomerang
D8 NW slate chest            <- magnetic gloves
D8 SE slate chest            <- like-like ring
D8 tile room                 <- gasha seed

sphere 18:
D2 boss                      <- brother emblem
D8 floor puzzle              <- iron shield

sphere 19:
D7 miniboss chest            <- D1 compass
D7 post-hallway chest        <- rupees, 100
trade goron vase             <- cheval rope
trade rock brisket           <- D6 present compass

sphere 20:
D8 boss                      <- D6 past small key


-- dungeon entrances --

D1 entrance <- D7
D2 past entrance <- D6 past
D2 present entrance <- D3
D3 entrance <- D1
D4 entrance <- D2
D5 entrance <- D5
D6 past entrance <- D4
D6 present entrance <- D8
D7 entrance <- D5
D8 entrance <- D6 present

Key chime still triggers after buried key was found

Affects the dirt pile which contains Ricky's gloves in vanilla.
If it contains a key (i.e. keysanity enabled) and the related compass is "equipped", i.e. the key chime is played, it will always play when entering that screen even after the key was picked up.

Found in ooarando_keysanity-alpha4-webpatch-fba5b8a_be290740-tdk.