Readme

The Ocarina of Time Item Randomizer offers many different settings to customize your play experience. Here’s a fully detailed list!

Release Notes and Changelogs for the latest release versions can be found here.

Description

This program takes The Legend of Zelda: Ocarina of Time and randomizes the locations of the items for a new, more dynamic play experience. Proper logic is used to ensure every seed is possible to complete without the use of glitches and will be safe from the possibility of softlocks with any possible usage of keys in dungeons.

The randomizer will ensure a glitchless path through the seed will exist, but the randomizer will not prevent the use of glitches for those players who enjoy that sort of thing though we offer no guarantees that all glitches will have identical behavior to the original game. Glitchless can still mean that clever or unintuitive strategies may be required involving the use of things like Hover Boots, the Hookshot, or other items that may not have been as important in the original game.

Each major dungeon will earn you a random Spiritual Stone or Medallion once completed. The particular dungeons where these can be found, as well as other relevant dungeon information can be viewed in the pause menu by holding the "A" button on the C-Item Menu.

As a service to the player in this very long game, many cutscenes have been greatly shortened, and text is as often as possible either omitted or sped up. It is likely that someone somewhere will miss the owl's interjections; to that person, I'm sorry I guess?

Getting Stuck

With a game the size of Ocarina of Time, it's quite easy for new Randomizer players to get stuck in certain situations with no apparent path to progressing. Before reporting an issue, please make sure to check out the Logic page which contains a list of what items are required to access various areas of the game.

Known issues

Unfortunately, a few known issues exist. These will hopefully be addressed in future versions.

• The fishing minigame sometimes refuses to allow you to catch fish when playing specifically on Bizhawk. Save and Hard Reset (do not Save State & then Load State) to fix the issue and then return to the fishing game. You should always Hard Reset prior to fishing to avoid this issue entirely (not the same as a Soft Reset).
• Draining the Bottom of the Well with Song of Storms during night time or entering the Kakariko Potion Shop sometimes crashes the game on specific configurations of Project 64. We aren't sure of the exact story, but this bug is easily avoided by playing on a different emulator and probably also avoidable by changing your settings and maybe graphics plug-in. The developers recommend that you use either Retroarch (Mupen64+ core) or Bizhawk instead of Project 64.
• Executing the collection delay glitch on various NPCs may have unpredictable and undesirable consequences. Preferably mash a C button to skip text when talking to NPC's that give you an Item.
• Saving and quitting on the very first frame after becoming an adult when you would trigger the Light Arrow cutscene can have undesired consequences. Just don't do that.
• This randomizer is based on the 1.0 version of Ocarina of Time, so some of its specific bugs remain. Some of these like "empty bomb" can be disadvantageous to the player.

Generation Options

These are located at the very bottom of the local randomizer application at all times, and at the very bottom of the generator page on the website.

(v3.0) Settings String - This is a variable length character string that specifies the totality of other gameplay relevant (non-cosmetic) settings used throughout the randomizer. This string can be shared between players and then the “Import Settings String” button can be pressed to automatically change all settings to match another player.

(v1.0) Seed - This is a string representing the particular configuration of items that will occur in your seed; the purpose is to combine a seed string with a specific settings string such that the randomizer will be able to generate the same game for multiple players. If this field is left blank, a random seed will be chosen.

(v4.0) Patch File - Patch files are used to send the patched data to other people without sending the ROM file. On the website version 3 had it's own format for patch files. Those files are not valid for this option.

(v3.0 web, v4.0 local) Update Cosmetics - Whether to use the cosmetics in a patch file, or to update them with your own cosmetics settings. On the website used to be referred to as Enable Custom Settings in v3.0, and Override Cosmetics in v4.0. On the local version it was the forced default option.

ROM Options

This is the first, and default tab of the randomizer. Options you can set here mainly affect what files are output such as the ROM and various logs. In older versions 1.0 and 2.0 called this tab Randomize.

General

(v1.0) (Local only) Base Rom - Specify the input ROM that will be used by the randomizer. Please be sure it is OoT US v1.0 or Japanese v1.0. On the website this is found on the seed patching page after generating a seed.

(v1.0) (Local only) Output Directory - Specify where the output ROM will be written on your computer. On the website the new randomizer ROM is presented as a file download. You browser settings dictate where this file ends up.

(v5.1) Enable Plandomizer - Enable the Plandomizer File file input box, and use the file there to set "pre-planned" settings and item locations.

(v5.0) Plandomizer File - Specify the JSON distribution file to use as a plandomizer file.

(v1.0) (Local only) Generation Count - Specify how many ROMs in sequence you would like to generate. On the website this is always set to 1. In versions prior to 3.0 it is referred to as simply Count.

(v1.0) Create Spoiler Log - Decide whether to output a text file detailing where every item can be found and the sequence of play that will lead to seed completion. Selecting this option will create a different item configuration than using otherwise identical settings without printing a log; this is intended to prevent cheating in race environments.

(v4.0) (Local only) Create Cosmetics Log - Decide whether to output a text file detailing which cosmetic options were chosen, including which values were selected for Random Choice and Completely Random. On the website this is always generated and available on the seed patcher page after generating the seed.

(v1.0) (Local only) Output Type - Decide the format of the output ROM.

• Compressed - Generally recommended for most users; this is necessary for injection into a .wad for use on the Virtual Console. In older versions 1.0 and 2.0 used a checkbox called Compress patched ROM.
• Uncompressed - All known N64 emulators have significant crashing problems with uncompressed ROMs. Real N64 hardware can also have issues, but if you are willing to take that risk generation time can be improved by using the uncompressed option if you are playing on a real N64 with a flash cart.
• No Output - Does not create a ROM file. Generally used for generating spoiler logs for research, development, and statistical purposes. In older versions v1.0 and 2.0 called it Do not create patched ROM.
• (v4.0) Patch Files - Used to send the patched data to other people without sending the ROM file. You can also choose not to output a ROM at all; this is useful if you just want to look at spoiler logs.
• On the website - The compressed option is always used.

(v1.0) (Local only) Open Output Directory - Opens the directory you have set as the Output Directory in your file manager. If you have not set one it opens the Randomizer's default Output directory. If the default directory does not yet exist, it is created. In certain versions, v3.0 and v4.0 do not have this button. It was restored in v5.0.

(v5.1) (Local only) Open App Directory - Opens the directory the actual randomizer application is located. With the source code version, this is just the directory you launched Gui.py from. With the standalone download version, this opens the directory deep in the directory structure of the electron application with all of the python files used in the background. This is useful for finding the Music directory for custom music and fanfares.

(v3.0) Multi-World Generation

This option allows for multiple worlds to be generated to be used in co-op play. Each player will get a different ROM designed to work in conjunction with another to allow two players to work together to complete the game. Synchronization can be achieved on Bizhawk via the following script: https://github.com/TestRunnerSRL/bizhawk-co-op

• Player Count - Use this to specify how many players will be participating in this co-op playthrough. On the website this is limited to a maximum of 4.
• (Local only) Player ID - Use this to specify which player number you are in particular. Each participant in the co-op should choose a different number starting with 1. On the website this is selected after generation on the seed patch page.

(v4.0) Settings Presets

Presets are settings that can be saved and loaded from.

• Load - Overwrites all settings that affect the seed.
• Save - Saves all current settings that affect the seed as a new custom preset.
• Remove - Removes the currently selected custom preset from the list. Built-in presets cannot be deleted.

Main Rules

These are the primary rules that affect how many item locations are available, and how many extra items are shuffled into the pool.

(v5.0) Randomize Main Rule Setttings - Randomizes most Main Rules.

(v4.0) Logic Rules - Logic provides guiding sets of rules for world generation which the Randomizer uses to ensure the generated seeds are beatable.

• Glitchless - No glitches are required, but may require some minor tricks. Add minor tricks to consider for logic in the 'Detailed Logic' tab.
• No Logic - Maximize randomization, All locations are considered available. MAY BE IMPOSSIBLE TO BEAT.
• (v5.0) Glitched - Movement-oriented glitches are likely required. No locations excluded.

Open

These rules dictate how "open" the world is from the start. They remove or reduce more tedious aspects of the world to allow you to explore more of the world with fewer item requirements.

(v1.0) Forest - Choose how Mido and the Kokiri blocking the exit to Hyrule Field behave.

• Open Forest - Mido no longer blocks the path to the Deku Tree, and the Kokiri boy no longer blocks the path out of the forest.
• Closed Forest - It is guaranteed that the Deku Tree can be completed without leaving the forest. This means that the Kokiri Sword, Slingshot, and Deku shield for sale will all be available before you need to use them.
• (v5.0) Closed Deku - The Kokiri boy no longer blocks the path out of the forest, but Mido still blocks the path to the Deku Tree, requiring Kokiri Sword and Deku Shield be shown to him as child to access the Deku Tree.

Open Door of Time - The Door of Time is open from the beginning of the game. The Song of Time is still potentially useful for moving Song of Time blocks, for playing to the frogs on Zora's River, or for other such uses. If this flag is not set, the Door of Time must be opened to travel through time as in the original game, but all that is needed to open the Door of Time is the Song of Time and any ocarina. The Ocarina of Time in particular, and the Spiritual Stones, have nothing to do with this cutscene.

(v4.0) Zora's Fountain - Choose how King Zora behaves.

• Default Behavior (Closed) - King Zora obstructs the way to Zora's Fountain. Ruto's Letter must be shown as child in order to move him for both eras.
• Always Open - King Zora starts as moved in both the child and adult eras. This also removes Ruto's Letter from the pool since it can't be used.
• (v5.2) Open For Adult - King Zora is always moved in the adult era. This means Ruto's Letter is only required to access Zora's Fountain as child.

(v3.0) Gerudo Fortress - Determines how Gerudo Fortress behaves.

• Default Behavior - All four carpenters must be rescued before the bridge is built.
• Rescue One Carpenter - Only the bottom left carpenter must be rescued.
• Open Gerudo Fortress - The carpenters are rescued the start of the game, and if 'Shuffle Gerudo Card' is disabled the player starts with the Gerudo Card in the inventory allowing access to Gerudo Training Grounds. In older versions v3.0 and v4.0 called this Start with Gerudo Card. This was before the Gerudo card prevented the guards from throwing you in jail.

(v1.0) Rainbow Bridge Requirement - This determines the condition under which the rainbow bridge to Ganon’s Castle will spawn.

• Always Open - The rainbow bridge is always present.
• Vanilla Requirements - The rainbow bridge spawns under the same conditions it did in the original game: Link must possess the Light Arrows and view the Zelda cutscene, in the Temple of Time. This cutscene is triggered by the possession of the Shadow and Spirit Medallions.
• All Medallions - All six of the medallions are required to open Ganon's Castle.
• All Dungeons - The rainbow bridge requires all medallions and spiritual stones to be in the player’s possession to spawn.
• (v4.0) All Spiritual Stones - All three of the spiritual stones are required to open Ganon's Castle.
• (v4.0) Gold Skulltula Tokens - All 100 of the gold skulltulas are required to open Ganon's Castle.

(v5.1) Skulltulas Required for Bridge - Select the amount of Gold Skulltula Tokens required to spawn the rainbow bridge. Only available if Gold Skulltula Tokens bridge is selected.

(v3.0) Random Number of Ganon’s Trials - A random number of trials within Ganon’s Castle from 0 to 6 will be chosen, and individual trials will be randomly disabled as necessary to match this number. Hints will be added to the hint pool informing the player which trials are present or missing if any.

(v3.0) Ganon's Trials Count - A specific number of trials can be specified with the slider. If a number of trials other than 0 or 6 is chosen and hints are enabled, hints will be added to the hint pool informing the player which trials are present (if 1 to 3 trials) or which are missing (if 4 or 5 trials). In older versions in v2.0 this was part of an options called Skip most of Ganon's Castle and set the value to 0.

World

These rules change the fundamental rules of how the world works

(v5.0) Starting Age - Choose which age Link will start as. Only the child option is compatible with Closed Forest.

• Child - Start as child Link in Link's house.
• Adult - Start as adult Link in Temple of Time. Starting as adult means you start with the master sword in your inventory.
• Random - Randomly choose which age to start as.

(v5.0) Entrance Shuffle - Shuffle entrances bidirectionally within different pools. If Interior or Overworld entrances are shuffled, trade timers are disabled and trade items never revert.

• Dungeons Only - Shuffle dungeon entrances with each other, including Bottom of the Well, Ice Cavern, and Gerudo Training Grounds. However, Ganon's Castle is not shuffled. Additionally, the entrances of Deku Tree, Fire Temple and Bottom of the Well are opened for both adult and child.
• Simple Indoors - Shuffle dungeon entrances along with simple Grotto and Interior entrances (i.e. most Houses and Great Fairies).
• All Indoors - Extended version of 'Simple Indoors' with some extra entrances: Adult Potion Shop, Windmill, Link's House, Temple of Time and Dampe's Grave.
• All Indoors & Overworld - Same as 'All Indoors' but with Overworld loading zones shuffled in a new separate pool. Owl drop positions are also randomized.

(v5.2) Triforce Hunt - Pieces of the Triforce have been scattered around the world. Find some of them to beat the game. Game is saved on completion, and Ganon's Castle key is given if beating the game again is desired.

(v5.2) Required Triforces Per World - Select the amount of Triforce Pieces required to beat the game. Only available when Triforce Hunt is enabled.

• In multiworld, each world will have the same number of triforces in them. The required amount will be per world collectively. For example, if this is set to 20 in a 2 player multiworld, players need 40 total, but one player could obtain 30 and the other 10.
• Extra pieces are determined by the the Item Pool setting: 'Plentiful': 100% Extra 'Balanced': 50% Extra 'Scarce': 25% Extra 'Minimal: No Extra

(v3.0) Bombchus Are Considered in Logic - This option fundamentally changes how the Bombchu items found around the world function. With this option on, Bombchus are a progression item and operate as a form of progressive item. The first Bombchu pack found will be worth 20 Bombchus and subsequent packs will be worth 10 or 5 Bombchus. Finding Bombchus will be considered as logical progression, and having found any Bombchus will be the condition to play Bombchu Bowling or buy Bombchu refills from shops. This flag will also add Bombchu (5) buyable items to the shops in Kokiri Forest, Castle Town Bazaar, and Kakariko Bazaar.

With this option off, randomly found Bombchu items are not considered as logical progression, randomly found Bombchus will have specific denominations based on the values from the original game, and finding a Bomb Bag is what enables playing Bombchu Bowling and buying Bombchus from shops which will not have their inventories edited.

(v3.0) Dungeons Have One Major Item - This option places one “major item” and one only in each of the dungeons. For the purpose of the randomizer, the dungeons are defined as the eight dungeons that contain either Medallions or Spiritual Stones as well as Bottom of the Well, Ice Cavern, Gerudo Training Grounds, and Ganon’s Castle.

The major items are any item usable with a c-button that is not simply a form of ammo, songs, Mirror Shield, swords, tunics, boots, Double Defense, Magic Meter/Double Magic, Bullet Bags, Quivers, Bomb Bags, Strength Upgrades, Scales, Wallets, the Stone of Agony, and Triforce Pieces.

To be clear, this means that rupees, ammo, Deku Stick and Deku Nut ammo expansions, Pieces of Heart, Heart Containers, Gold Skulltula Tokens, Maps, Compasses, Small Keys, Boss Keys, Deku Shields, Hylian Shields, and Ice Traps are not considered major items. However, Small Keys and Boss Keys are considered major items if the appropriate “keysanity” settings are used. Gold Skulltula Tokens are also considered major items if the bridge requirement is set to Gold Skulltula Tokens. Bombchus are also considered major items if Bombchus Are Considered in Logic is enabled.

To mirror the original game, Spirit Temple will get two items instead of just one.

(v3.0) Random Number of MQ Dungeons - If set, a random number of dungeons will have Master Quest designs. In older versions in v3.0 this setting was the Mixed option for Dungeon Quest.

(v4.0) MQ Dungeon Count - With this option you can select a number of Master Quest dungeons to be included in your game. A value of 0 leaves all dungeons in their vanilla form. A value of 12 swaps each for its Master Quest form. 6 is an even mix of both.

Shuffle

These settings shuffle more items into the item pool.

(v3.0) Shopsanity - This setting randomizes the items sold in shops. When it is used, all shop items are randomly re-arranged among all 8 of the original game’s shops. This setting causes the Bombchu Shop to be open from the very beginning of the game, and this setting considers the two shops in adult Kakariko Village to be distinct shops from the two similar shops in child Castle Town; however, the shops in Kokiri Forest, Goron City, and Zora Domain are the same shops as both ages. This setting overrides the “Bombchus considered in logic” editing of the shop item pool.

• Off - This disables the Shopsanity feature.
• Shuffled Shops (0 Items) - This causes all of the Shopsanity features described above.
• (Multiple Similar Settings) Shuffled Shops (1-4 Items) - This not only causes all of the Shopsanity features described above, but it also adds 1-4 (depending on the exact setting) items from the general item pool into shops to buy for randomly chosen amounts of money. Lower value shop items are removed to make room for this, and low value junk items are added to the item pool to fill the extra empty chests this will implicitly create. Using this feature will also replace several of the rupee items found throughout the seed with higher value rupees and will add a third Wallet upgrade, the “Tycoon’s Wallet”, to the item pool which can hold up to 999 rupees. The items from the general item pool added to shops will always be on the far left of the shop inventories, and these items can always be bought if the player has enough rupees even if they are explosives without an appropriate container or a tunic as a child.
• Shuffled Shops (Random Items) - This is similar to the 1-4 items variant but gives each shop a random number of new items from 0-4. Each shop can have a different amount of unique items with this setting.

(v4.0) Tokensanity - This setting shuffles the Gold Skulltula item drops into the general pool of locations. The player can choose only to include Gold skulltulas found in dungeons for a more mild version of this setting.

(v3.0) Scrub Shuffle - This flag makes every Business scrub in the world sell a random item instead of only the three that sold permanent upgrades in the original game. Using this flag adds the various low tier items the other scrubs sold to the item pool for the most part; the potion refills are replaced with Recovery Hearts for Red Potions and blue rupees for Green Potions. For each Business Scrub that sold arrows/seeds depending on age, there will be a 75% chance of adding a 30 arrow item and a 25% chance of adding a 30 seed item to the pool. If this is set, once the item from a Business Scrub is bought, the scrub will disappear from the world forever. The individual settings in the dropdown can be used to set the price of each Business Scrub to 10 rupees, leave the prices as what they were in the original game, or set each price to a random value from 0 to 99 rupees. In all cases, the text for the Business Scrub will not update.

(v5.0) Shuffle Cows - Enabling this causes playing Epona's song infront of cows to give an item. There are 9 cows, and an extra in MQ Jabu.

(v3.0) Shuffle Songs with Items - This flag adds the 12 standard ocarina songs to the shuffle as normal items. With this flag on, the spots that contained songs in the original game will simply give Link a random item, and the songs can be found as items freely. Without this flag on, songs are still randomized but only between each other. In either case, the Scarecrow’s Song is not affected; it is still obtained by interacting with Bonooru at Lake Hylia first as a kid and then as an adult.

(v3.0) Shuffle Kokiri Sword - This flag adds the Kokiri Sword to the shuffle. With it off, the Kokiri Sword will always be found in its original chest in the Kokiri Forest.

(v3.0) Shuffle Ocarinas - This flag adds both the Fairy Ocarina and the Ocarina of Time to the shuffle. The ocarinas are progressive items; the first found will always be the Fairy Ocarina, with the second being the Ocarina of Time, even though the two are functionally identical. Without this flag on, leaving the Kokiri Forest to the Lost Woods bridge as a child will always grant one Ocarina and the other is always available at the gate of Castle Town, as a child, when all three Spiritual Stones are in the player’s possession.

(v3.0) Shuffle Weird Egg - This flag adds the Weird Egg given by child Malon to the shuffle. With this flag on, child Malon will give a random item and the Weird Egg must be located to do the events at Hyrule Castle with Zelda and Impa. These events block interacting with Talon and Malon at Lon Lon Ranch as a child as well as Saria in Sacred Forest Meadow and the Happy Mask sidequest.

(v3.0) Shuffle Gerudo Card - This flag shuffles the Gerudo Card into the general item pool. In the randomizer, this is required to gain access to Gerudo Training Grounds (v5.0) and stops the guards being hostile. Without this flag, the Gerudo Card is always given by the Gerudo woman who spawns after the final carpenter is rescued. If Gerudo Fortress is cleared from the beginning of the game, the player starts the game with the Gerudo Card and this setting is voided. In older versions prior to v5.0 the card did not affect the hostility of the guards, and it was instead affected by you freeing all of the carpenters.

(v5.0) Shuffle Magic Beans - Enabling this adds a pack of 10 beans to the item pool and changes the Magic Bean Salesman to sell a random item once at the price of 60 Rupees.

Shuffle Dungeon Items

(Multiple Similar Settings) These setting allows the player to decide the natural distribution of dungeon items. The groups are Maps & Compasses, Small Keys, and Boss Keys.

• (v1.0) Remove - Dungeon items can be prevented from exisitng completely. If Small Keys or Boss Keys are prevented from existing, this will also remove all locks those keys would be used for from existing as well.
• (v1.0) Dungeon Only - Dungeon items can be found confined to their original dungeons. If Small Keys are left in their original dungeons and the Fire Temple is not in the form of Master Quest, the locked door in the first room that leads to the normal location of the Boss Key will be removed.
• (v3.0) Keysanity - Dungeon items can be spread freely throughout the world.
• (v5.0) Vanilla Locations - Dungeon items are found in their vanilla chest and freestanding locations. This setting will start you off with 3 Master Quest Spirit Temple keys if MQ Spirit Temple is in your seed. The vanilla placements for keys in MQ Spirit Temple are not compatible with glitchless logic.
• (v3.0) (Maps & Compasses Only) Start Wtih - Maps and Compasses are given to you from the start.

(v3.0) Ganon's Boss Key - Allows the player to decide on how and where Ganon's Castle's boss key is found. In older versions v2.0 this was part of the setting called Skip most of Ganon's Castle.

• (v2.0) Remove - The Ganon's Castle boss key is removed and the boss door in Ganon's Tower starts unlocked.
• (v3.0) Dungeon Only - The Ganon's Castle boss key can be found anywhere in Ganon's Castle. In older versions v2.0-v4.0 This is how the boss key is placed if the Remove Ganon's Boss Door Lock or Skip most of Ganon's Castle settings are not checked.
• (v5.0) Vanilla Location - The Ganon's boss key is located in the gilded chest in Ganon's Castle.
• (v5.0) Anywhere - The Ganon's boss key can be located anywhere in the world.
• (v5.0) On LACS - These settings put the boss key on the Light Arrow Cutscene location, from Zelda in Temple of Time as adult, with differing requirements.
  • Vanilla - Shadow and Spirit Medallions.
  • Medallions - All 6 Medallions.
  • Stones - All 3 Spiritual Stones.
  • Dungeons - All Spiritual Stones & Medallions.

(v3.0) Maps and Compasses Give Information - This setting disables the pedestal in the Temple of Time from giving information about the location of the Medallions and Spiritual Stones. Instead, the Compass from each of the eight eligible dungeons will tell the player which dungeon has which reward. If Master Quest dungeons are to be mixed in, each of the ten Maps will tell the player whether any given dungeon is in the vanilla or Master Quest form. The Compasses from Bottom of the Well and Ice Cavern do not give any information. Note: Removing maps and compasses and enabling this setting means you cannot find out what dungeon rewards are in which dungeons.

Detailed Logic

All Locations Reachable

This option will set the logic to try to ensure Link can reach every item location in the game with the exception of “key for key” item locations (a single item spot behind a locked door containing the key to open the door). If this option is not used, the logic will allow some items to be in impossible locations so long as the set of reachable items is sufficient to complete the game.

Exclude Locations

This is a search box to select which locations you would like to never have major items required to finish a seed. Excluded locations will be displayed in a list box below the search box.

Enable Tricks

This is a search box to select which trick flags you want enabled. Enabled tricks will be displayed in a list box below the search box.

Adult Trade Sequence

This pair of settings can be used to specify the earliest and latest items that can be allowed to randomly show up in the general item pool. Only one item will be in the item pool regardless of this setting; this can merely be used to limit the range of possibilities.

Lens of Truth

This setting alters the expectations about interacting with invisible objects without the Lens of Truth.

Required Everywhere

This setting requires the Lens of Truth to interact with any invisible object except for whatever was required in the original game to obtain the Lens of Truth.

Wasteland and Chest Minigame

This setting expects the Lens of Truth to be used only to cross the Haunted Wasteland and to win the Treasure Chest Minigame in Castle Town at night.

Only Chest Minigame

This setting expects the Lens of Truth to be used only to win the Treasure Chest Minigame in Castle Town at night.

Other

Skip Tower Collapse Sequence

This setting causes defeating Ganondorf to skip directly to the Ganon fight without the need to do the collapsing Ganon’s Tower sequence.

Skip Child Stealth

This setting causes entering the crawlspace at Hyrule Castle to deposit the player directly into the Castle Courtyard, bypassing the guard evasion sequence.

Skip Epona Race

This setting causes Epona to be stolen from Ingo from the start of the game, only requiring Epona’s Song and an ocarina as an adult to summon.

Fast Chest Cutscenes

This setting causes all chests to open with a quick animation. If this setting is off, certain important items will trigger the slow opening animation.

Nighttime Skulltulas Expect Sun’s Song

This setting causes the logic to expect the player to have an ocarina and the Sun’s Song to get Gold Skulltula locations that are only found at nighttime.

Free Scarecrow’s Song

This flag causes Pierre the Scarecrow to be available to summon for the adult from the beginning of the game. All you have to do is pull the Ocarina out near a location where he can spawn.

Start With Fast Travel

Start the game with Prelude of Light, Serenade of Water, and Farore's Wind. Two song locations will give items instead of Prelude and Serenade.

Start With Max Rupees

Start the game with 99 rupees.

Start With Tycoon's Wallet

Start the game with the largest wallet which can hold 999 rupees.

Start With Deku Equipment

Start the game with 10 Deku sticks and 20 Deku nuts. If shopsanity is off, also start with Deku Shield.

Random Big Poe Target Count

This setting causes the number of Big Poes that must be turned into the vendor to obtain his item to be random from 1-10. Alternatively, the number of Big Poes requires can be selected manually with the slider below. Note that Big Poes can be found as pre-stocked Bottle contents, and the logic can expect using them if the required number is sufficiently low.

Randomize Ocarina Song Notes

This flag randomizes the particular notes in the 12 standard ocarina songs. This can predictably be pretty obnoxious. In general, the patterns chosen for the top row songs will be simpler than the patterns chosen for warp songs.

Chest Size Matches Contents

This flag causes keys, Ice Traps, and items flagged as progression items to appear in large treasure chests, Boss Keys in gold chests like in vanilla, and Small Keys in small gold chests while other items will be in small treasure chests. This means that players can choose to skip small treasure chests since they will only contain handy, not essential, items.

Clearer Hints

This flag changes the text of Gossip Stone hints to be overwhelmingly explicit. This is helpful for players who do not have English as their first language, but the hints will be less “fun” and less like the sorts of things that would be said in the original game.

Gossip Stones

This flag changes the behavior of Gossip Stones to give hints to players. The hints will be distributed as such:

- If the required number of trials is 1-3, a hint will be added for each trial that must be done. If the required number of trials is 4 or 5, a hint will be added for each trial that can be skipped.

- Hints will be added for every one of the “always” locations that is allowed to have a random possibly valuable item under the current settings. These hints will tell the player what item is at each of these locations. These locations are the rewards for 30, 40, and 50 Gold Skulltula Tokens, the item obtained from Biggoron by showing the Claim Check, the item obtained from the Big Poe vendor, both the song and the item slots at the Ocarina of Time, and the item obtained from showing the Mask of Truth at the Deku Theater.

- Some hints will be given for items at a randomly selected number of other locations that are generally somewhat inconvenient to check. The total number of these hints will be either 11 or 12 minus the number of always hints placed. -3 or 4 hints will be given naming a specific non-dungeon specific item that can be found in a randomly chosen dungeon.

- 1 to 4 hints will be given naming a specific item found in a specific overworld region. Which part of this range is used is determined in part by how many trial hints are given.

- 4 to 6 hints will be given naming what region specific progression items other than Gold Skulltula Tokens can be found.

- 3 or 4 hints will be given naming specific regions that are “on the way of the hero” and thus contain at least one required progression item.

- All remaining hints (33 total unique Gossip Stones exist) will be filled with non-information junk hints.

This setting allows the player to specify which item is required to interact with the Gossip Stones. The Stone of Agony is the default option as it gives a fairly purposeless vanilla item a use and allows both kid and adult to interact with the Gossip Stones. The default Mask of Truth can be used, but this has the downside that the Mask of Truth can only be obtained with all Spiritual Stones which tends to make the hints not useful, and using the Mask of Truth requires being a child which is another big downside. There is also an option for the information to just be free for those wanting an easier mode.

Hint Distribution

This setting allows you to change how many useful hints are available in the game.

• Useless: Has nothing but junk hints.
• Balanced: Gives you a mix of useless and useful hints. Hints will not be repeated.
• Strong: Has some duplicate hints and no junk hints.
• Very Strong: Has only very useful hints.
• Tournament: Similar to strong but has no variation in hint types.

Text Shuffle

This setting allows all the text in the game to be shuffled. This is mostly for comedy and is not intended to be a serious gameplay option.

No Text Shuffled

Leave the text alone.

Shuffled except Hints and Keys

Shuffle all text other than the useful text giving the player information.

All Text Shuffled

Shuffle all text even to the player’s mechanical disadvantage.

Ice Traps

Changes how many ice traps are placed throughout the game.

• Off: All ice traps are removed.
• Normal: Only ice traps from base pool are placed.
• Extra ice traps: Chance to add extra ice traps when junk items are added to the item pool
• Ice trap mayhem: All junk items added will be ice traps.
• Ice trap onslaught: All junk items will be ice traps, including ones in the base pool.

Item Pool

This setting allows the player to tweak the item pool to make a somewhat harder or easier experience.

Plentiful

Some required items will be duplicated to make it easier to find them.

Balanced

Leave the item pool alone.

Scarce

Heart Containers, Double Defense, and the second Magic Upgrade are replaced with junk items. One each of the ammo expansions (Quiver, Bullet Bag, Bomb Bag Deku Stick Capacity, Deku Nut Capacity) will also be replaced with junk items, and all Bombchu pick-ups other than three will similarly be replaced with junk.

Minimal

In addition to the items from Hard, Pieces of Heart and Nayru’s Love are also replaced with junk items. One more of each ammo expansion is removed resulting in zero extra ammo capacity for those item types, and only one Bombchu pick-up can be found.

Damage Multiplier

This setting changes the amount of damage taken.

Half

Link takes half damage.

Normal

Link takes normal damage.

Double

Link takes double damage.

Quadruple

Link takes quadruple damage.

OHKO

Link dies in one hit and at least one Nayru’s Love is in the item pool.

Starting Time Of Day

Change up Link's sleep routine.

Cosmetics

Default Targeting Option

This option specifies whether Z-targeting will default to “Switch” or “Hold” style. Either way, this can still be changed in-game as per usual.

Display D-Pad HUD

This option specifies whether the D-Pad HUD display should be shown once you have an item that can be controlled by the D-Pad in your inventory.

Sword Trail Duration

Selects how long the sword trails should display when swinging a sword.

Inner Color

The color of the inside of the sword trail displayed when swinging a sword.

Outer Color

The color of the outside of the sword trail displayed when swinging a sword.

Kokiri Tunic Color

This determines the color of Link’s default Kokiri Tunic. This only affects the color when he’s wearing it, not the color of the icon in the menu.

Most Colors

Simply get the particular color selected. Available colors are Kokiri Green, Goron Red, Zora Blue, Black, White, Azure Blue, Vivid Cyan, Light Red, Fuchsia, Purple, MM Purple, Twitch Purple, Purple Heart, Persian Rose, Dirty Yellow, Blush Pink, Hot Pink, Rose Pink, Orange, Gray, Gold, Silver, Beige, Teal, Blood Red, Blood Orange, Royal Blue, Sonic Blue, NES Green, Dark Green, and Lumen.

Random Choice

Choose a random color from the set of pre-made colors.

Completely Random

Generate a random color with numerically random RGB values.

Custom Color

A special interface will pop up that will allow the user to choose any color from a diverse color wheel or input a desired RGB value.

Goron Tunic Color

This determines the color of Link’s Goron Tunic. This only affects the color when he’s wearing it, not the color of the icon in the menu or when holding it up after acquiring it. The options are identical to those for the Kokiri Tunic.

Zora Tunic Color

This determines the color of Link’s Zora Tunic. This only affects the color when he’s wearing it, not the color of the icon in the menu or when holding it up after acquiring it. The options are identical to those for the Kokiri Tunic.

Navi Colors

These options can be used to set Navi’s color in a variety of contexts. The lists of pre-set colors here is different, but the same types of options exist as for choosing tunic colors.

SFX

Background Music

Normal

Do not alter the background music.

No Music

Disable background music. Sound effects will still play. This may be desired by players who like to listen to their own music.

Random

Background music is shuffled so that different tracks may play in different areas. This may be silly.

Fanfares

Normal

Do not alter the fanfares.

No Fanfares

Disable fanfares. Sound effects will still play.

Random

Fanfares are shuffled so that different fanfares may play in different fanfare locations.

Ocarina Songs as Fanfares

Add the longer Ocarina song fanfares to the pool of fanfares.

Custom Music and Fanfares

If using the Dev build or Bundled version of the randomizer you can supply custom tracks to the randomizer to pull from when shuffling music or fanfares as Random.

In order to add custom tracks you need a track in the AudioSeq format, a custom format used by several early first-party Nintendo 64 games such as Super Mario 64, Starfox 64, Yoshi Story, etc. These sequence files need to be converted to work with Ocarina of Time and very likely need their instruments changed manually to sound appropriate in the Ocarina of Time engine. You'll want a combination of MIDI editing software and seq64 to create these files and make the necessary modifications. You can also use MIDIs to help create new AudioSeq tracks.

Place your AudioSeq files in the data/Music folder with the .seq extension. You also need to include a simple text file with the same name as the AudioSeq but with the extension .meta and the following three lines:

Music

Majora's Mask Title Theme
3
bgm

Fanfare

Majora's Mask Time Reset
23
fanfare

These lines correspond to the following mapping:

1. Sequence title to display in cosmetics log
2. AudioBank to use
3. Type

Reminder that remixes of existing tracks are a legal grey area that the Ocarina of Time Randomizer does not want to get caught up with. This is why this feature isn't included in the website release of the randomizer. Please do not share .seq files of remixed or other recreated video game music in the Discord or other communities run by ZSR and randomizer staff.

Low Health SFX

This determines which sound effect to play repeatedly when Link is very low on health. Several of these options are designed to be potentially more pleasant to listen to while a few are designed to be more amusing.

Particular Sounds

Set this particular sound for the heart beep. Available choices are Default, Softer Beep, Rupee, Timer, Tambourine, Recovery Heart, Carrot Refill, Navi - Hey!, Zelda - Gasp, Cluck, Mweep!, Iron Boots, Hammer, Sword Bounce, Bow, Gallop, Drawbridge, Switch, Bomb Bounce, Bark, Ribbit, Broken Pot, Business Scrub, Guay, and Bongo Bongo. Indeed, one of these is the sound a king might make when moving… very slowly.

Random Choice

Play a random SFX from the list of choices.

None

Disable low health heart beeps altogether.

Navi Overworld

This option sets the SFX that will play when Navi is ready to give a hint. The options are very similar to the Low Health SFX.

Navi Enemy

This option sets the SFX that will play when Navi targets an enemy. The options are very similar to the Low Health SFX.

Command Line Options

-h, --help

Show the help message and exit.

--gui

Launch the GUI

--loglevel [{error,info,warning,debug}]

Select level of logging for output. (default: info)

--settings_string SETTINGS_STRING

Enter a settings string that will encode and override most individual settings.

--convert_settings

Only convert the specified settings to a settings string. If a settings string is specified output the used settings instead.

--settings SETTINGS

Use the specified settings file to use for generation

--seed SEED

Define seed number to generate. (default: None)