README.html

<h1 id="ootrandomizer">OoTRandomizer</h1>
<p>This is a randomizer for <em>The Legend of Zelda: Ocarina of Time</em> for the Nintendo 64.</p>
<h1 id="installation">Installation</h1>
<p>It is strongly suggested users get the latest release from here: https://github.com/AmazingAmpharos/OoT-Randomizer/releases . Simply download the .msi installer and run it. We support Windows, Mac, and Linux machines.</p>
<p>If you have an incompatible OS or you simply wish to run the script raw, clone this repository and either run '''Gui.py''' for a graphical interface or '''OoTRandomizer.py''' for the command line version. Both require Python 3.5+. This will be fully featured, but the seeds you generate will have different random factors than the bundled release.</p>
<p>This randomizer requires The Legend of Zelda: Ocarina of Time version 1.0 NTSC-US version. This randomizer includes an in-built decompressor, but if the user wishes a pre-decompressed ROM may be supplied as input. Please be sure your input ROM filename is either a .n64 or .z64 file. For users playing via any means other than on real N64 hardware, the use of the &quot;Compress patched ROM&quot; flag is strongly encouraged as uncompressed ROMs are impossible to inject for the Virtual Console and have random crashing problems on all emulators.</p>
<p>For general use, the recommended emulator is RetroArch; it has been shown to work with minimal issues. Bizhawk and Mupen64plus are generally good choices too. If you want to play on Project 64 for whatever reason, you can but you will need to set the rando to use 8 MB of RAM and will want to play with the cheat code 8109C58A 0000 to partially fix Project 64's tragically poor handling of OoT's pause menu. Project 64 also has one particular crash that only happens for some unknown settings configurations; we cannot support this. I cannot emphasize enough that it is a discouraged emulator to use.</p>
<h1 id="general-description">General Description</h1>
<p>This program takes <em>The Legend of Zelda: Ocarina of Time</em> and randomizes the locations of the items for a 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.</p>
<p>The items that randomize currently are all items within chests including those in grottos, items given as rewards by NPCs including from minigames and Deku Scrub Salesmen, the items given by freestanding Pieces of Heart, Heart Containers, and Keys, and the items obtained when getting the Bottle and the Fire Arrows at Lake Hylia or the Ocarina of Time from the Castle Town moat. All dungeons will always have the same number of Maps, Compasses, Small Keys, and Boss Keys they had in the original game, but which chests within those dungeons have those things is random. The item pool will contain a Biggoron Sword that will not interfere with Medigoron's sale of the Giant's Knife (which is always vanilla), and a randomly selected adult trading quest item other than the Odd Potion will be somewhere in the item pool.</p>
<p>Certain types of items are now &quot;progressive&quot;, meaning that no matter what order the player encounters these items they will function as a series of upgrades. The following item types will be progressive chains:</p>
<p>-Hookshot to Longshot -Bomb Bag to Big Bomb Bag to Biggest Bomb Bag -Goron Bracelet to Silver Gauntlets to Gold Gauntlets -Slingshot to Big Bullet Bag to Biggest Bullet Bag -Bow to Big Quiver to Biggest Quiver -Silver Scale to Gold Scale -Adult Wallet to Giant's Wallet -Deku Stick Capacity Upgrades -Deku Nut Capacity Upgrades -Magic Meter to Double Magic<br />-Fairy Ocarina to Ocarina of Time</p>
<p>To be more clear about which NPC items are shuffled, it's only the one time permanent item rewards for the most part like NPCs who originally gave Pieces of Heart or inventory items. The only exception is that even though in vanilla the reward for 40 Gold Skulltula Tokens was just 10 Bombchus that is still a randomized reward in randomizer (but the 200 rupees for all 100 Gold Skulltula Tokens is not randomized so the most tokens that could be required to complete a seed is 50). As a mercy to the player, the Ocarina Memory Game in the Lost Woods will start on the final round as that minigame was very long originally, the three day wait on the Claim Check is removed, Bombchu Bowling will have a fixed sequence of prizes that is of maximum convenience to the player, Dampe's Gravedigging Tour will always be won on the first dig, and the fishing minigame is made much simpler (8 lb fish for child now, 10 lb for adult). Additionally, any NPC who gives a trading quest item either for the child or for the adult other than Anju's initial gift as an adult does not have a randomized reward.</p>
<p>A special note is needed for the six Great Fairy Fountains scattered across Hyrule. All six of these fountains now give random item rewards, and the magic and life upgrades can now be found as normal items scattered around the world. Happy hunting!</p>
<p>The Ocarina songs are shuffled in a pool amongst themselves, and each learn spot will still have the original conditions it has always had. These conditions may not have all been obvious, but here are some high points. Saria will teach her song after completing the events in the Castle Courtyard. The warp songs can mostly only be learned by an adult, but the location for Requiem of Spirit is available for even a child if the Desert Colossus can be reached. The location for the Prelude of Light requires the Forest Medallion, and the location for the Nocturne of Shadow requires the Forest Medallion, Fire Medallion, and Water Medallions. A setting exists to shuffle all songs into the general item pool instead of limiting them to song specific slots.</p>
<p>Speaking of Medallions, each boss in the eight main dungeons will drop a random Spiritual Stone or Medallion, and instead of the Light Medallion being granted by the now removed &quot;becoming an adult&quot; cutscene, the player will start every seed with a random Spiritual Stone or Medallion. The pedestal in which the Spiritual Stones rest in the Temple of Time has hint text pointing to the locations of the Spiritual Stones and Medallions. A child will be able to read hints for the Spiritual Stones while an adult will be able to read hints for the Medallions. This information and some other relevant dungeon based info can be seen in the pause menu by holding the &quot;A&quot; button on the c-item menu.</p>
<p>To be very clear on this point, while the rewards for up to 50 Gold Skulltula Tokens are randomized, the tokens themselves are not.</p>
<p>As a service to the player in this very long game, many cutscenes have been greatly shortened or removed and text is as often as possible either omitted or sped up. We have been as thorough as our exploration of the game and various technical limitations will allow to make the parts of the game where you're watching and reading as short as possible to make as much of your time with this randomizer as possible actual gameplay. I'm sure someone somewhere will miss the owl's interjections; to that person, I'm sorry I guess?</p>
<p>A few bugs or other undesirable behaviors in the original game have been fixed. Of note, obtaining the Poacher's Saw will no longer prevent the player from obtaining the reward in the Deku Theater for showing the Mask of Truth, and becoming an adult will not automatically equip the child with the Kokiri Sword. Sheik will no longer prevent the player from returning to childhood before obtaining the Forest Medallion. Princess Ruto will never disappear from Jabu Jabu's Belly, and the condition for the Castle Courtyard being sealed off is now completing the events within as opposed to seeing the Ocarina of Time be thrown into the moat.</p>
<p>One small detail that is important to know is that the locked door in the Fire Temple leading to the section with the Boss Key Chest is removed. This was necessary due to the original design of the Fire Temple assuming that the player could not possibly have the Hammer before unlocking the doors leading into the depths of the dungeon. This is obviously not true in randomizer, and of all possible solutions to this problem, this seemed the least disruptive. A full clear of the Fire Temple will simply result in the player having one extra Small Key. Certain settings configurations will disable this behavior.</p>
<p>Two similar small details apply to the Master Quest versions of dungeons. In Water Temple MQ, a locked door leading to a Gold Skulltula in the northern basement was glitched such that it would not appear in the Gamecube release of Master Quest but was fixed in OoT3D's version of Master Quest. In the randomizer, the locked door works like an ordinary locked door similar to OoT3D. In Spirit Temple MQ, there is a particular chest that requires hitting a switch in a hole that the adult will later push a silver block into. The randomizer does some wizardry under the hood to ensure that the block will never be in the way for the child.</p>
<p>To be clear about the logic rules of what can be where, 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 Scarecrow's Song that may not have been important options in the original game. The Lens of Truth is guaranteed available and useable before completion of the Treasure Chest Game is required or before walking through any invisible objects or opening any invisible chests is required with the exception of the one invisible wall that is required to enter the Bottom of the Well as the original game required passing that invisible wall to reach the Lens of Truth.</p>
<p>One last detail is that the menu is now more like the Majora's Mask menu in that the player can move the cursor through empty spaces. This fixes a major problem from the original game in that certain combinations of items would create menu shapes that would be impossible to fully menu through. As of version 3.0, this fix extends to the &quot;equipment&quot; subscreen as well.</p>
<h1 id="quirks-to-know">Quirks to Know</h1>
<p>While all the details of gameplay can't be detailed here, I want to inform you of a few non-obvious game sequences that are likely to get you stuck and one little glitch we can do nothing about.</p>
<p>-The condition to open the Door of Time is merely playing the Song of Time; the Spiritual Stones are not required. If you enter the Temple of Time via the Prelude of Light, playing the Song of Time will create a glitchy cutscene and will not open the door (but you're safe to exit and re-enter and open it properly).<br />-The condition to spawn the Ocarina of Time and learn that song is the three Spiritual Stones. The condition to learn a song from Sheik in the Temple of Time is possessing the Forest Medallion. The condition to learn a song from Sheik in Kakariko is possessing Forest, Fire, and Water Medallions.<br />-The running man in Hyrule Field only spawns if you have all three Spiritual Stones.<br />-Skull Kid will only buy the Skull Mask if you have played Saria's Song for him.<br />-The center of Death Mountain Crater as an adult can be reached from the summit as an adult by going around to the left with Hover Boots or by jumping down to the right and using a combination of the Longshot and Scarecrow's Song. This allows access to Sheik and the Fire Temple without a Bomb Bag.<br />-A sword must be equipped to play the fishing minigame. A Slingshot is not required for child target shooting, but the adult does need the Bow to receive the true prize.<br />-Other than the fishing minigame, the child can do anything that would seem to require the sword with Deku Sticks. You can buy as many as you want in the Kokiri Forest shop.<br />-In the randomizer, possessing the Bomb Bag is the requirement to get bomb drops, buy bombs or Bombchus, or play Bombchu Bowling. If the setting &quot;Bombchus Are Considered in Logic&quot; is used, finding any pack of Bombchus allows purchasing Bombchus and playing Bombchu Bowling while possessing a Bomb Bag allows the purchase of bombs.<br />-Only the Hookshot, not the Longshot, is needed to do everything on the rooftops of Kakariko.<br />-Grottos can be opened with either Bombs or the Hammer.<br />-The boulder maze in Goron City can be solved with the Hammer or partially with Bombs as is obvious, but less obvious is that it can be fully solved with Silver Gauntlets.<br />-The large colored blocks only encountered by the adult require Goron Bracelet to push.<br />-In a few places, out of sight Song of Time blocks can be summoned. The lava room in Gerudo Training Grounds, the beginning of Ganon's Castle Shadow Trial, and the last hallway with a caged Goron in Fire Temple are the main cases. -Adult Link can fully clear Dodongo's Cavern. He can even skip the first section by virtue of being tall.<br />-In the Forest Temple, you can reach the room with the Floormaster (vanilla) or Redead (MQ) early by using Hover Boots in the block push room.<br />-In the Fire Temple, you can reach the Boss Key door from the beginning with Hover Boots.<br />-In the Water Temple, you can from the start with the water down jump to the middle platform level, very carefully aim the Hookshot to the target above, and pull yourself to the highest level of the central platform. Then a very well spaced rolling jump can reach the water changing station to raise the water to the highest level. If you make poor key choices in Water Temple, this may be what you need to do to untangle the situation.<br />-In the Water Temple, Hover Boots can be used to reach the vanilla Boss Key chest without going through the room that requires Bombs and block pushing. Hover Boots can also be used in this temple to avoid the Longshot requirement for the middle level chest that requires the Bow.<br />-In the Water Temple, Farore's Wind can be placed in the central pillar and then the water can be raised to the highest level in order to reach the Gold Skulltula without the Longshot.<br />-In the Shadow Temple, you can avoid the need for the Longshot in the room with the invisible spikes by backflipping onto the chest for extra height.<br />-In the Shadow Temple, you can Hookshot the ladder to avoid pushing the block to get on the boat.<br />-In the Shadow Temple, a combination of the scarecrow and the Longshot can be used to reach Bongo Bongo without needing the Bow.<br />-In the Spirit Temple, the child can obtain the vanilla Map chest with Deku Sticks. No fire magic is needed.<br />-In the Spirit Temple, you can collect the silver rupees without Hover Boots by jumping directly onto the rolling boulder or with a jump slash.<br />-In the Spirit Temple, you can use the Longshot to cross from the hand with the Mirror Shield in vanilla to the other hand.<br />-In Ganon's Castle Spirit Trial, the web can be burned with a precise shot through the torch by a normal arrow. Fire Arrows are not required.<br />-Like Likes now only eat shields and not tunics.<br />-Several Gold Skulltula Tokens can be reached by clever/precise uses of jump slashes and spin attacks (possibly magic spin attacks).<br />-This is not a randomizer exclusive mechanic, but getting the ability to summon Pierre the Scarecrow requires playing an eight note song for Bonooru the Scarecrow as a child first and then the exact same song for him again as an adult.</p>
<h1 id="known-issues">Known issues</h1>
<p>Sadly for this 3.0 release a few known issues exist. These will hopefully be addressed in future versions.</p>
<p>-The fishing minigame sometimes refuses to allow you to catch fish when playing specifically on Bizhawk. Save and quit (NOT savestate) and return to fix the issue.<br />-Draining the Bottom of the Well with Song of Storms sometimes crashes 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.<br />-Executing the collection delay glitch on various NPCs may have unpredictable and undesirable consequences. In particular this can be devastating with Biggoron; it is strongly suggested the player save before turning in the Claim Check.<br />-Saving and quitting on the very first frame after becomming an adult when you would trigger the Light Arrow cutscene can have undesired consequences. Just don't do that.<br />-This randomizer is based on the 1.0 version of Ocarina of Time so some of its specific bugs remain. Some of these like &quot;empty bomb&quot; can be disadvantagous to the player.</p>
<h1 id="settings">Settings</h1>
<p>The OoT Randomizer has many different settings users can choose to customize their play experience. Here's a fully detailed list!</p>
<h1 id="rom-options">ROM Options</h1>
<h2 id="base-rom">Base Rom</h2>
<p>Specify the input ROM that will be used by the randomizer. Please be sure it is OoT US v1.0.</p>
<h2 id="output-directory">Output Directory</h2>
<p>Specify where the output ROM will be written on your computer.</p>
<h2 id="create-spoiler-log">Create Spoiler Log</h2>
<p>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.</p>
<h2 id="compress-rom">Compress Rom</h2>
<p>Decide the format of the output ROM. Compressed is generally recommended for most users; this is necessary for injection into a .wad for use on the Virtual Console, and all known N64 emulators have significant crashing problems with uncompressed ROMs. Real N64 hardware doesn't care so generation time can be improved by using the uncompressed option if you are playing on a real N64 with a flash cart. You can also choose not to output a ROM at all; this is useful if you just want to look at spoiler logs.</p>
<h2 id="default-targeting-option">Default Targeting Option</h2>
<p>This option specifies whether Z-targeting will default to &quot;Switch&quot; or &quot;Hold&quot; style. Either way, this can still be changed in-game as per usual.</p>
<h2 id="multi-world-generation">Multi-World Generation</h2>
<p>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:</p>
<p>https://github.com/TestRunnerSRL/bizhawk-co-op</p>
<h3 id="player-count">Player Count</h3>
<p>Use this to specify how many players will be participating in this co-op playthrough.</p>
<h3 id="player-id">Player ID</h3>
<p>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.</p>
<h2 id="setting-string">Setting String</h2>
<p>This is an 18 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 &quot;Import Settings String&quot; button can be pressed to automatically change all settings to match another player.</p>
<h2 id="seed">Seed</h2>
<p>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 an identical 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.</p>
<h1 id="main-rules">Main Rules</h1>
<h2 id="open-forest">Open Forest</h2>
<p>Mido does not need to see a sword and shield to reach the Deku Tree and the Kokiri boy blocking the exit to the forest is gone. If this flag is not set, it is guaranteed that the Deku Tree can be completed without leaving the forest. This means that within the forest or the Deku Tree itself it will be possible to find the Kokiri Sword, Deku Shield for sale, and the Slingshot.</p>
<h2 id="open-kakariko-gate">Open Kakariko Gate</h2>
<p>The gate leading up Death Mountain from Kakariko Village is open from the beginning of the game. Normally this requires Zelda's Letter to open. This allows more diverse routing early in the game and prevents very long walks in seeds with the Weird Egg shuffled. Two things are important to note. Showing Zelda's Letter to the guard is still required to begin the Happy Mask sidequest and to receive a discount on purchasing Hylian Shields. The gate is simply gone for an adult no matter what.</p>
<h2 id="open-door-of-time">Open Door of Time</h2>
<p>The Door of Time is open from the beginning of the game. The Song of Time is still potentially useful to move Song of Time blocks, play songs for the frogs on Zora River, or for other such uses. If this flag is not used, the Door of Time must be opened to become an adult 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.</p>
<h2 id="gerudo-fortress">Gerudo Fortress</h2>
<h3 id="default-behavior">Default Behavior</h3>
<p>Gerudo Fortress will work the same way it did in the original game. All four carpenters must be rescued in order for the Gerudo woman who gives the Gerudo Card to appear and for the Gerudo to stop being hostile. Rescuing a carpenter requires having a Gerudo Fortress Small Key and defeating the corresponding guard.</p>
<h3 id="rescue-one-carpenter">Rescue One Carpenter</h3>
<p>Only the bottom left carpenter must be rescued to complete Gerudo Fortress. Only one Gerudo Fortress Small Key will exist because of this.</p>
<h3 id="start-with-gerudo-card">Start with Gerudo Card</h3>
<p>The player will start with the Gerudo Card from the beginning of the game. The carpenters will be pre-rescued, and the bridge to Gerudo Fortress as an adult will be repaired from the beginning. The Gerudo Card is the requirement in the randomizer to enter Gerudo Training Grounds so it will be an accessible area from the moment adulthood is available.</p>
<h2 id="rainbow-bridge-requirement">Rainbow Bridge Requirement</h2>
<p>This determines the condition under which the rainbow bridge to Ganon's Castle will spawn.</p>
<h3 id="all-dungeons">All Dungeons</h3>
<p>The rainbow bridge spawn requires all medallions and spiritual stones to be in the player's possession.</p>
<h3 id="all-medallions">All Medallions</h3>
<p>All six of the medallions are required to open Ganon's Castle.</p>
<h3 id="vanilla">Vanilla</h3>
<p>The rainbow bridge spawns under the same conditions it did in the original game, possession of the Light Arrows and having viewed the Zelda cutscene. This cutscene in the Temple of Time is triggered by possessing the Shadow and Spirit Medallions.</p>
<h3 id="open">Open</h3>
<p>The rainbow bridge is always present.</p>
<h2 id="random-number-of-ganons-trials">Random Number of Ganon's Trials</h2>
<p>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. Alternatively, a specific number of trials can be specified with the slider below. 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).</p>
<h2 id="all-locations-reachable">All Locations Reachable</h2>
<p>This option will set the logic to try to ensure Link can reach every item location in the game with the exception of &quot;key for key&quot; 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.</p>
<h2 id="bombchus-are-considered-in-logic">Bombchus Are Considered in Logic</h2>
<p>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.</p>
<h2 id="dungeons-have-one-major-item">Dungeons Have One Major Item</h2>
<p>This option places one &quot;major item&quot; 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 (Bombchus are major only if &quot;Bombchus are considered in logic&quot; is on), songs, Mirror Shield, swords, tunics, boots, Double Defense, Magic Meter/Double Magic, Bullet Bags, Quivers, Bomb Bags, Strength Upgrades, Scales, Wallets, and the Stone of Agony. 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 &quot;keysanity&quot; settings are used. Note that unlike with the distribution of dungeon specific items like keys, this flag does consider the hands of the Desert Colossus as Spirit Temple locations, and to mirror the original game, Spirit Temple will get two items instead of just one.</p>
<h2 id="dungeon-quest">Dungeon Quest</h2>
<p>This option specifies the form dungeons will take. The item pool will be updated to reflect the items originally found in the dungeons used.</p>
<h3 id="vanilla-1">Vanilla</h3>
<p>Dungeons will have the same internal layout as they did in the original The Legend of Zelda: Ocarina of Time.</p>
<h3 id="master-quest">Master Quest</h3>
<p>Dungeons will have the internal layouts found in The Legend of Zelda: Ocarina of Time Master Quest.</p>
<h3 id="mixed">Mixed</h3>
<p>Dungeons will each have a random internal layout chosen between the vanilla and Master Quest forms.</p>
<h2 id="shuffle-kokiri-sword">Shuffle Kokiri Sword</h2>
<p>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.</p>
<h2 id="shuffle-weird-egg">Shuffle Weird Egg</h2>
<p>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.</p>
<h2 id="shuffle-ocarinas">Shuffle Ocarinas</h2>
<p>This flag adds both the Fairy Ocarina and the Ocarina of Time to the shuffle. The ocarinas are a progressive item; 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.</p>
<h2 id="shuffle-songs-with-items">Shuffle Songs with Items</h2>
<p>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.</p>
<h2 id="shuffle-gerudo-card">Shuffle Gerudo Card</h2>
<p>This flag shuffles the Gerudo Card into the general item pool. In the randomizer, this is required to gain access to Gerudo Training Grounds, but it does not have any impact on the hostility of the Gerudo in Gerudo Fortress who still check for the carpenter rescue events. 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.</p>
<h2 id="shuffle-deku-salescrubs">Shuffle Deku Salescrubs</h2>
<p>This flag makes every Deku Scrub Salesman 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 Deku 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 a Deku Scrub Salesman is used, it will disappear from the world forever. The individual settings in the dropdown can be used to set the price of each Deku Scrub Salesman 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 Deku Scrub Salesmen will not update.</p>
<h2 id="shopsanity">Shopsanity</h2>
<p>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 &quot;Bombchus considered in logic&quot; editing of the shop item pool.</p>
<h3 id="off">Off</h3>
<p>This disables the Shopsanity feature.</p>
<h3 id="shuffled-shops-0-items">Shuffled Shops (0 Items)</h3>
<p>This causes all of the Shopsanity features described above.</p>
<h3 id="shuffled-shops-1-4-items">Shuffled Shops (1-4 Items)</h3>
<p>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 &quot;Tycoon's Wallet&quot;, 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.</p>
<h3 id="shuffled-shops-random-items">Shuffled Shops (Random Items)</h3>
<p>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.</p>
<h2 id="shuffle-dungeon-items">Shuffle Dungeon Items</h2>
<p>This setting allows the player to decide the natural distribution of dungeon items. Dungeon items can be found confined to their original dungeons, spread freely throughout the world, or prevented from existing completely. Items that are prevented from existing completely will be replaced in the item pool with an assortment of various low tier junk items. This feature can be specified for Maps/Compasses, Small Keys, and Boss Keys independently. 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. 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.</p>
<h2 id="maps-and-compasses-give-information">Maps and Compasses Give Information</h2>
<p>This setting, only available if you start with Maps and Compasses or they are spread across the world, 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 the dungeon quest is set to mixed, 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.</p>
<h2 id="remove-ganons-door-boss-lock">Remove Ganon's Door Boss Lock</h2>
<p>This setting removes the Boss Key lock from Ganon's Tower. This removes the need to locate the Ganon's Tower Boss Key to finish the game.</p>
<h2 id="tokensanity">Tokensanity</h2>
<p>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.</p>
<h1 id="detailed-logic">Detailed Logic</h1>
<h2 id="maximum-expected-skulltula-tokens">Maximum Expected Skulltula Tokens</h2>
<p>This setting can be used to reduce the number of Gold Skulltula Tokens that may be required to finish the game.</p>
<h2 id="no-nighttime-skulltulas-without-suns-song">No Nighttime Skulltulas without Sun's Song</h2>
<p>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.</p>
<h2 id="no-big-poes">No Big Poes</h2>
<p>This setting will guarantee that the Big Poe vendor will not have an important item.</p>
<h2 id="no-child-fishing">No Child Fishing</h2>
<p>This setting will guarantee that the reward from child fishing is not an important item. This is mostly recommended if the player simply must play on Bizhawk.</p>
<h2 id="no-adult-fishing">No Adult Fishing</h2>
<p>This setting will guarantee that the reward from adult fishing is not an important item. This is mostly recommended if the player simply must play on Bizhawk.</p>
<h2 id="no-skull-mask-reward">No Skull Mask Reward</h2>
<p>This setting will guarantee that the item obtained from showing the Skull Mask in the Deku Theater is not an important item.</p>
<h2 id="no-mask-of-truth-reward">No Mask of Truth Reward</h2>
<p>This setting will guarantee that the item obtained from showing the Mask of Truth in the Deku Theater is not an important item.</p>
<h2 id="no-1500-horseback-archery">No 1500 Horseback Archery</h2>
<p>This setting will guarantee that the item obtained from scoring 1500 points at the horseback archery challenge at Gerudo Fortress is not an important item.</p>
<h2 id="no-lost-woods-memory-game">No Lost Woods Memory Game</h2>
<p>This setting will guarantee that the item obtained from winning the ocarina memory game in the Lost Woods is not an important item.</p>
<h2 id="no-racing-dampe-a-second-time">No Racing Dampe a Second Time</h2>
<p>This setting will guarantee that the item obtained from finishing with a sub-minute time in the second Dampe race is not an important item.</p>
<h2 id="no-biggoron-reward">No Biggoron Reward</h2>
<p>This setting will guarantee that the item obtained from showing the Claim Check to Biggoron is not an important item.</p>
<h2 id="adult-trade-sequence">Adult Trade Sequence</h2>
<p>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.</p>
<h2 id="enable-all-tricks">Enable All Tricks</h2>
<p>This is a button to turn on all of the trick related flags.</p>
<h2 id="various-advanced-tricks">Various Advanced Tricks</h2>
<p>This setting allows a huge number of minor tricks to be allowed by the logic. Here is a complete list:</p>
<p>-A precise jumpslash with either a Deku Stick or the Kokiri Sword can be used to reach a Gold Skulltula on some vines in standad Deku Tree.<br />-The Bow can be used to knock down the stairs in Dodongo's Cavern with two well timed shots.<br />-The vines in Forest Temple leading to where the well drain switch is in the standard form can be barely reached with the standard Hookshot.<br />-The well in Forest Temple can be crossed with just Hookshot by shooting as low as possible on the vines from the far side and swimming under the ceiling. This is possible in both versions but can only be required in Forest Temple MQ.<br />-A Bombchu from the ground level can be used to hit the switch to bypass the block pushing puzzle in Forest Temple MQ.<br />-A rusted switch under a Song of Time block in the standard Fire Temple can be hit by using Hammer into the block.<br />-The location with the Boss Key chest in Fire Temple MQ can be reached without the Bow with very particular use of Din's Fire.<br />-The upper levels of the old boulder maze in Fire Temple MQ can be reached without explosives by using the Hammer through a wall.<br />-In the standard Spirit Temple, the bridge on child side can be lowered with a carefully timed Bombchu.<br />-The frozen switch in Spirit Temple MQ can be hit without a fire source by using the Bow and Song of Time very cleverly.<br />-The chest in the basement of the standard Bottom of the Well can be reached with only a Strength Upgrade by using a jump slash with a lit Deku Stick to access the bomb flowers in the basement.<br />-The silver rupees on the left side of Gerudo Training Grounds MQ can be collected with just Hookshot with a somewhat particular jump slash.<br />-The first room of the Spirit Trail in Ganon's Castle MQ can be cleared without the Bow by using a Hammer jump slash to hit the rusted switch through the thrones.<br />-The Gold Skulltula in adult Kokiri Forest can be reached without the Hookshot by using Hover Boots off one of the roots.<br />-The child can reach the chest on Death Mountain trail with just the Goron Bracelet by backwalking with the Bomb Flower intended to open Dodongo's Cavern and throwing the Bomb Flower at the wall very quickly.<br />-Gerudo Fortress can be cleared without any items other than those needed for access. The logic normally guarantees one of the Bow, Hookshot, or Hover Boots to help navigate the &quot;kitchen&quot;.</p>
<p>Using this setting will also pre-set all of the lower logic flags to a reasonable configuration to match the trick level. These can then be edited as the player desires if the given configuration isn't desired.</p>
<h2 id="man-on-roof-without-hookshot">Man on Roof without Hookshot</h2>
<p>This allows the logic to consider a trick in which the player does a sidehop off the tall tower in Kakariko Village to reach the man on the rooftop with no items.</p>
<h2 id="child-deadhand-without-kokiri-sword">Child Deadhand without Kokiri Sword</h2>
<p>This allows the logic to consider defeating the Deadhand in Bottom of the Well with Deku Sticks. This is not hard with use of the power crouch stab glitch, but consistently landing actual jump slashes on his unusual hitbox is pretty difficult and using normal slashes consumes 9 Deku Sticks.</p>
<h2 id="dodongos-cavern-spike-trap-room-jump-without-hover-boots">Dodongo's Cavern Spike Trap Room Jump without Hover Boots</h2>
<p>This allows the logic to consider that the adult can make a particularly useful jump in Dodongo's Cavern to reach the area with the Bomb Bag chest early. Due to the precision of the jump, normally the logic expects Hover Boots to complete this path.</p>
<h2 id="windmill-poh-as-adult-with-nothing">Windmill PoH as Adult with Nothing</h2>
<p>This allows the logic to consider a jump the adult can make in the windmill to reach the Piece of Heart within with no items. The jump requires leaping from an object on which it is not obvious Link is allowed to stand and has counterintuitive timing so it is not in standard logic.</p>
<h2 id="craters-bean-poh-with-hover-boots">Crater's Bean PoH with Hover Boots</h2>
<p>This allows the logic to consider using Hover Boots to reach the Piece of Heart atop the volcano in Death Mountain Crater. The path involves walking up a very steep slope that is not visibly walkable so it is not in normal logic.</p>
<h2 id="zoras-domain-entry-with-cucco">Zora's Domain Entry with Cucco</h2>
<p>This allows the logic to consider using a Cucco on Zora River to enter Zora's Domain as a child without playing Zelda's Lullaby. It requires slipping behind the waterfall trickily from the left side.</p>
<h2 id="zoras-domain-entry-with-hover-boots">Zora's Domain Entry with Hover Boots</h2>
<p>This allows the logic to consider this similar trick to the above except as an adult with Hover Boots. This is actually a lot more difficult even though it can be done from either side of the waterfall.</p>
<h2 id="fewer-tunic-requirements">Fewer Tunic Requirements</h2>
<p>This relaxes the tunic requirements by the logic somewhat. Normally the logic expects a Goron Tunic to enter Fire Temple or complete the Fire Trial in Ganon's Castle and a Zora Tunic to enter Water Temple, collect the underwater silver rupees in Gerudo Training Grounds, or obtain the Piece of Heart at the bottom of the frozen Zora's Fountain. With this flag set, the Goron Tunic will not be required to actually enter Fire Temple, only to fight Volvagia or to reach the upper floors. The Zora Tunic requirements are removed completely except to reach the chest at the bottom of the central pillar in Water Temple.</p>
<h2 id="morpha-with-gold-scale">Morpha with Gold Scale</h2>
<p>This setting allows entry to the Water Temple with the Gold Scale to be considered. Since you cannot backtrack into Water Temple without Iron Boots, only the Spiritual Stone or Medallion obtained from defeating Morpha can be considered by logic either way; since you need the Water Temple Boss Key and Longshot to access Morpha normally, this means that this setting is only relevant in either keysanity or keysy relative to the locations of Boss Keys.</p>
<h2 id="lens-of-truth">Lens of Truth</h2>
<p>This setting alters the expectations about interacting with invisible objects without the Lens of Truth.</p>
<h3 id="required-everywhere">Required Everywhere</h3>
<p>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.</p>
<h3 id="wasteland-and-chest-minigame">Wasteland and Chest Minigame</h3>
<p>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.</p>
<h3 id="only-chest-minigame">Only Chest Minigame</h3>
<p>This setting expects the Lens of Truth to be used only to win the Treasure Chest Minigame in Castle Town at night.</p>
<h1 id="other">Other</h1>
<h2 id="skip-tower-collapse-sequence">Skip Tower Collapse Sequence</h2>
<p>This setting causes defeating Ganondorf to skip directly to the Ganon fight without the need to do the collapsing Ganon's Tower sequence.</p>
<h2 id="skip-interior-castle-guard-stealth-sequence">Skip Interior Castle Guard Stealth Sequence</h2>
<p>This setting causes entering the crawlspace at Hyrule Castle to deposit the player directly into the Castle Courtyard, bypassing the guard evasion sequence.</p>
<h2 id="skip-epona-race">Skip Epona Race</h2>
<p>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.</p>
<h2 id="fast-chest-cutscenes">Fast Chest Cutscenes</h2>
<p>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.</p>
<h2 id="random-big-poe-target-count">Random Big Poe Target Count</h2>
<p>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.</p>
<h2 id="start-with-scarecrows-song">Start with Scarecrow's Song</h2>
<p>This flag causes Pierre the Scarecrow to be available to summon for the adult from the beginning of the game. The box below can be used to specify the particular desired Scarecrow's Song. This song must be exactly eight notes long and must contain at least two different notes.</p>
<h2 id="randomize-ocarina-song-notes">Randomize Ocarina Song Notes</h2>
<p>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.</p>
<h2 id="chest-size-matches-contents">Chest Size Matches Contents</h2>
<p>This flag causes keys, Ice Traps, and items flagged as progression items to appear in large treasure 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.</p>
<h2 id="clearer-hints">Clearer Hints</h2>
<p>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 &quot;fun&quot; and less like the sorts of things that would be said in the original game.</p>
<h2 id="gossip-stones">Gossip Stones</h2>
<p>This flag changes the behavior of Gossip Stones to give hints to players. The hints will be distributed as such:</p>
<p>-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.<br />-Hints will be added for every one of the &quot;always&quot; 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.<br />-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.<br />-3 or 4 hints will be given naming a specific non-dungeon specific item that can be found in a randomly chosen dungeon.<br />-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.<br />-4 to 6 hints will be given naming what region specific progression items other than Gold Skulltula Tokens can be found.<br />-3 or 4 hints will be given naming specific regions that are &quot;on the way of the hero&quot; and thus contain at least one required progression item.<br />-All remaining hints (33 total unique Gossip Stones exist) will be filled with non-information junk hints.</p>
<p>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.</p>
<h2 id="text-shuffle">Text Shuffle</h2>
<p>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.</p>
<h3 id="no-text-shuffled">No Text Shuffled</h3>
<p>Leave the text alone.</p>
<h3 id="shuffled-except-hints-and-keys">Shuffled except Hints and Keys</h3>
<p>Shuffle all text other than the useful text giving the player information.</p>
<h3 id="all-text-shuffled">All Text Shuffled</h3>
<p>Shuffle all text even to the player's mechanical disadvantage.</p>
<h2 id="difficulty">Difficulty</h2>
<p>This setting allows the player to tweak the item pool to make a somewhat harder experience.</p>
<h3 id="normal">Normal</h3>
<p>Leave the item pool alone.</p>
<h3 id="hard">Hard</h3>
<p>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.</p>
<h3 id="very-hard">Very Hard</h3>
<p>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.</p>
<h3 id="ohko">OHKO</h3>
<p>In addition to the item changes from Very Hard, Link dies in one hit. Ice Traps are replaced with Recovery Hearts.</p>
<h1 id="cosmetics">Cosmetics</h1>
<h2 id="background-music">Background Music</h2>
<h3 id="normal-1">Normal</h3>
<p>Do not alter the background music.</p>
<h3 id="no-music">No Music</h3>
<p>Disable background music. Sound effects will still play. This may be desired by players who like to listen to their own music.</p>
<h3 id="random">Random</h3>
<p>Background music is shuffled so that different tracks may play in different areas. This may be silly.</p>
<h2 id="kokiri-tunic-color">Kokiri Tunic Color</h2>
<p>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.</p>
<h3 id="most-colors">Most Colors</h3>
<p>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.</p>
<h3 id="random-choice">Random Choice</h3>
<p>Choose a random color from the set of pre-made colors.</p>
<h3 id="completely-random">Completely Random</h3>
<p>Generate a random color with numerically random RGB values.</p>
<h3 id="custom-color">Custom Color</h3>
<p>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.</p>
<h2 id="goron-tunic-color">Goron Tunic Color</h2>
<p>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.</p>
<h2 id="zora-tunic-color">Zora Tunic Color</h2>
<p>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.</p>
<h2 id="low-health-sfx">Low Health SFX</h2>
<p>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.</p>
<h3 id="particular-sounds">Particular Sounds</h3>
<p>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.</p>
<h3 id="random-choice-1">Random Choice</h3>
<p>Play a random SFX from the list of choices.</p>
<h3 id="none">None</h3>
<p>Disable low health heart beeps altogether.</p>
<h2 id="navi-color">Navi Color</h2>
<p>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.</p>
<h2 id="navi-hint">Navi Hint</h2>
<p>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.</p>
<h2 id="navi-enemy-target">Navi Enemy Target</h2>
<p>This option sets the SFX that will play when Navi targets an enemy. The options are very similar to the Low Health SFX.</p>
<h1 id="command-line-options">Command Line Options</h1>
<pre><code>-h, --help            </code></pre>
<p>Show the help message and exit.</p>
<pre><code>--check_version</code></pre>
<p>Check for the latest version number online (default: False)</p>
<pre><code>--checked_version CHECKED_VERSION</code></pre>
<p>Check for the specified version number instead of a number from online.</p>
<pre><code>--rom ROM</code></pre>
<p>Path to a The Legend of Zelda: Ocarina of Time NTSC-US v1.0 ROM. (default: ZOOTDEC.z64)</p>
<pre><code>--output_dir OUTPUT_DIR</code></pre>
<p>Path to output directory for rom generation.</p>
<pre><code>--seed SEED           </code></pre>
<p>Define seed number to generate. (default: None)</p>
<pre><code>--count COUNT         </code></pre>
<p>Set the count option (default: None)</p>
<pre><code>--world_count WORLD_COUNT       </code></pre>
<p>Use to create a multi-world generation for co-op seeds. World count is the number of players. Warning: Increasing the world count will drastically increase generation time. (default: 1)</p>
<pre><code>--player_num PLAYER_NUM       </code></pre>
<p>Use to select world to generate when there are multiple worlds. (default: 1)</p>
<pre><code>--create_spoiler      </code></pre>
<p>Output a Spoiler File (default: False)</p>
<pre><code>--compress_rom [{True,False,None}]</code></pre>
<p>Create a compressed version of the output rom file. True: Compresses. Improves stability. Will take longer to generate False: Uncompressed. Unstable on emulator. Faster generation None: No ROM Output. Creates spoiler log only (default: True)</p>
<pre><code>--open_forest</code></pre>
<p>Set whether Kokiri children obstruct your path at the beginning of the game. (default: False)</p>
<pre><code>--open_kakariko</code></pre>
<p>The gate in Kakariko Village to Death Mountain Trail is always open, instead of needing Zelda's Letter. (default: False)</p>
<pre><code>--open_door_of_time</code></pre>
<p>Set whether the Door of Time is open from the beginning of the game. (default: False)</p>
<pre><code>--gerudo_fortress [{normal,fast,open}]</code></pre>
<p>Select how much of Gerudo Fortress is required. (default: normal)</p>
<pre><code>--bridge [{medallions,vanilla,dungeons,open}]</code></pre>
<p>Select the condition to spawn the Rainbow Bridge to Ganon's Castle. (default: medallions)</p>
<pre><code>--all_reachable</code></pre>
<p>Enables the &quot;Only Ensure Seed Beatable&quot; option (default: False)</p>
<pre><code>--all_reachable</code></pre>
<p>Enables the &quot;Only Ensure Seed Beatable&quot; option (default: False)</p>
<pre><code>--bombchus_in_logic</code></pre>
<p>Changes how the logic considers Bombchus and other Bombchu related mechanics (default: False)</p>
<pre><code>--one_item_per_dungeon</code></pre>
<p>Each dungeon will have exactly one major item. (default: False)</p>
<pre><code>--trials_random</code></pre>
<p>Sets the number of trials that must be cleared in Ganon's Castle to a random value (default: False)</p>
<pre><code>--trials [{0,1,2,3,4,5,6}]</code></pre>
<p>Sets the number of trials that must be cleared in Ganon's Castle (default: 6)</p>
<pre><code>--no_escape_sequence</code></pre>
<p>Removes the tower collapse sequence after defeating Ganondorf (default: False)</p>
<pre><code>--no_guard_stealth</code></pre>
<p>Removes the guard evasion sequence in Hyrule Castle (default: False)</p>
<pre><code>--no_epona_race</code></pre>
<p>Removes the need to race Ingo to acquire Epona (default: False)</p>
<pre><code>--fast_chests</code></pre>
<p>Causes all chests to open with a fast animation (default: False)</p>
<pre><code>--big_poe_count_random</code></pre>
<p>Sets the number of Big Poes that must be sold to the vendor for an item to a random value (default: False)</p>
<pre><code>--big_poe_count [{1,2,3,4,5,6,7,8,9,10}]</code></pre>
<p>Sets the number of Big Poes that must be sold to the vendor for an item (default: 10)</p>
<pre><code>--free_scarecrow</code></pre>
<p>Start the game with the Scarecrow's Song activated and Pierre possible for the adult to summon (default: False)</p>
<pre><code>--scarecrow_song [SCARECROW_SONG]</code></pre>
<p>Set Scarecrow's Song if --free_scarecrow is used. Valid notes: A, U, L, R, D (default: DAAAAAAA)</p>
<pre><code>--shuffle_kokiri_sword</code></pre>
<p>Include the Kokiri Sword as a randomized item (default: False)</p>
<pre><code>--shuffle_weird_egg</code></pre>
<p>Include the Weird Egg as a randomized item (default: False)</p>
<pre><code>--shuffle_ocarinas</code></pre>
<p>Include the two ocarinas as randomized items (default: False)</p>
<pre><code>--shuffle_song_items</code></pre>
<p>Treat the ocarina songs as normal items and shuffle them into the general item pool (default: False)</p>
<pre><code>--shuffle_gerudo_card</code></pre>
<p>Include the Gerudo Card to access Gerudo Training Grounds as a randomized item (default: False)</p>
<pre><code>--shuffle_scrubs [{off,low,regular,random}]</code></pre>
<p>Include all Deku Scrub Salesmen as randomized item and determine their prices (default: off)</p>
<pre><code>--shopsanity [{off,0,1,2,3,4,random}]</code></pre>
<p>Randomize shop items and add the chosen number of items from the general item pool to shop inventories (default: off)</p>
<pre><code>--shuffle_mapcompass [{remove,startwith,dungeon,keysanity}]</code></pre>
<p>Choose the locations Maps and Compasses can be found (default: dungeon)</p>
<pre><code>--shuffle_smallkeys [{remove,dungeon,keysanity}]</code></pre>
<p>Choose the locations Small Keys can be found (default: dungeon)</p>
<pre><code>--shuffle_bosskeys [{remove,dungeon,keysanity}]</code></pre>
<p>Choose the locations Boss Keys can be found (default: dungeon)</p>
<pre><code>--enhance_map_compass</code></pre>
<p>Change the functionality of the Map and Compass to give information about their dungeons. The Temple of Time Altar will no longer provide any dungeon information. (default: False)</p>
<pre><code>--unlocked_ganondorf</code></pre>
<p>Remove the Boss Key door leading to Ganondorf (default: False)</p>
<pre><code>--tokensanity [{off,dungeons,all}]</code></pre>
<p>Include the chosen Gold Skulltula Token locations in the item shuffle (default: off)</p>
<pre><code>--quest [{vanilla,master,mixed}]</code></pre>
<p>Choose the internal layout of the dungeons (default: vanilla)</p>
<pre><code>--logic_skulltulas [{0,10,20,30,40,50}]</code></pre>
<p>Choose the maximum number of Gold Skulltula Tokens that could be required (default: 50)</p>
<pre><code>--logic_no_night_tokens_without_suns_song</code></pre>
<p>Change logic to expect Sun's Song to defeat nighttime Gold Skulltulas (default: False)</p>
<pre><code>--logic_no_big_poes</code></pre>
<p>Prevent the Big Poe vendor from having a required item (default: False)</p>
<pre><code>--logic_no_child_fishing</code></pre>
<p>Prevent the prize from fishing as a child from being a required item (default: False)</p>
<pre><code>--logic_no_adult_fishing</code></pre>
<p>Prevent the prize from fishing as an adult from being a required item (default: False)</p>
<pre><code>--logic_no_trade_skull_mask</code></pre>
<p>Prevent the item obtained by showing the Skull Mask at the Deku Theater from being a required item (default: False)</p>
<pre><code>--logic_no_trade_mask_of_truth</code></pre>
<p>Prevent the item obtained by showing the Mask of Truth at the Deku Theater from being a required item (default: False)</p>
<pre><code>--logic_no_1500_archery</code></pre>
<p>Prevent the item obtained by scoring 1500 points at horseback archery from being a required item (default: False)</p>
<pre><code>--logic_no_memory_game</code></pre>
<p>Prevent the item obtained by completing the ocarina memory game in the Lost Woods from being a required item (default: False)</p>
<pre><code>--logic_no_second_dampe_race</code></pre>
<p>Prevent the prize won by finishing the second Dampe race in under 1 minute from being a required item (default: False)</p>
<pre><code>--logic_no_trade_biggoron</code></pre>
<p>Prevent the item obtained by showing the Claim Check to Biggoron from being a required item (default: False)</p>
<pre><code>--logic_earliest_adult_trade [{pocket_egg,pocket_cucco,cojiro,odd_mushroom,poachers_saw,broken_sword,prescription,eyeball_frog,eyedrops,claim_check}]</code></pre>
<p>Set the earliest item in the adult trade sequence that can be found in the item pool (default: pocket_egg)</p>
<pre><code>--logic_latest_adult_trade [{pocket_egg,pocket_cucco,cojiro,odd_mushroom,poachers_saw,broken_sword,prescription,eyeball_frog,eyedrops,claim_check}]</code></pre>
<p>Set the latest item in the adult trade sequence that can be found in the item pool (default: claim_check)</p>
<pre><code>--logic_tricks</code></pre>
<p>Enable the logic to consider a large number of minor tricks (default: False)</p>
<pre><code>--logic_man_on_roof</code></pre>
<p>Enable the logic to consider the trick to reach the man on the roof in Kakariko Village with a sidehop from the tower (default: False)</p>
<pre><code>--logic_child_deadhand</code></pre>
<p>Enable the logic to consider the child defeating Deadhand with only Deku Sticks (default: False)</p>
<pre><code>--logic_dc_jump</code></pre>
<p>Enable the logic to consider the trick to bypass the second Lizalfos fight room in Dodongo's Cavern as an adult with a simple jump (default: False)</p>
<pre><code>--logic_windmill_poh</code></pre>
<p>Enable the logic to consider the trick to reach the Piece of Heart in the windmill as an adult with nothing (default: False)</p>
<pre><code>--logic_crater_bean_poh_with_hovers</code></pre>
<p>Enable the logic to consider the trick to reach the Piece of Heart on the volcano in Death Mountain Crater with Hover Boots (default: False)</p>
<pre><code>--logic_zora_with_cucco</code></pre>
<p>Enable the logic to consider the trick to enter Zora's Domain as a child using a Cucco instead of playing Zelda's Lullaby (default: False)</p>
<pre><code>--logic_zora_with_hovers</code></pre>
<p>Enable the logic to consider the trick to enter Zora's Domain as an adult using Hover Boots instead of playing Zelda's Lullaby (default: False)</p>
<pre><code>--logic_fewer_tunic_requirements</code></pre>
<p>Reduce the number of locations for which the logic expects a tunic upgrade (default: False)</p>
<pre><code>--logic_morpha_with_scale</code></pre>
<p>Allows entering Water Temple and beating Morpha with Gold Scale instead of Iron Boots. The Longshot and Boss Key are still required to reach the boss. This means that this option is only relevant in keysanity or keysy. (default: False)</p>
<pre><code>--logic_lens [{chest,chest-wasteland,all}]</code></pre>
<p>Set which hidden objects the logic expects the Lens of Truth to be used on (default: all)</p>
<pre><code>--ocarina_songs</code></pre>
<p>Randomize the particular notes that must be played for each of the 12 standard ocarina songs (default: False)</p>
<pre><code>--correct_chest_sizes</code></pre>
<p>Set chest sizes based on contents (default: False)</p>
<pre><code>--clearer_hints</code></pre>
<p>Reword hints to be incredibly direct (default: False)</p>
<pre><code>--hints [{none,mask,agony,always}]</code></pre>
<p>Enable hints from Gossip Stones and select the condition to read them (default: agony)</p>
<pre><code>--text_shuffle [{none,except_hints,complete}]</code></pre>
<p>Shuffle the chosen text randomly (default: none)</p>
<pre><code>--difficulty [{normal,hard,very_hard,ohko}]</code></pre>
<p>Alter the item pool to increase difficulty. The ohko option also causes Link to die in one hit. (default: normal)</p>
<pre><code>--default_targeting [{hold,switch}]</code></pre>
<p>Set the default Z-targeting setting. It can still be changed in the game's options menu. (default: hold)</p>
<pre><code>--background_music [{normal,off,random}]</code></pre>
<p>Choose whether the game's background music will be left alone, disabled, or shuffled randomly. (default: normal)</p>
<pre><code>--kokiricolor [{&#39;Random Choice&#39;, &#39;Completely Random&#39;, &#39;Kokiri Green&#39;, &#39;Goron Red&#39;, &#39;Zora Blue&#39;, &#39;Black&#39;, &#39;White&#39;, &#39;Azure Blue&#39;, &#39;Vivid Cyan&#39;, &#39;Light Red&#39;, &#39;Fuchsia&#39;, &#39;Purple&#39;, &#39;MM Purple&#39;, &#39;Twitch Purple&#39;, &#39;Purple Heart&#39;, &#39;Persian Rose&#39;, &#39;Dirty Yellow&#39;, &#39;Blush Pink&#39;, &#39;Hot Pink&#39;, &#39;Rose Pink&#39;, &#39;Orange&#39;, &#39;Gray&#39;, &#39;Gold&#39;, &#39;Silver&#39;, &#39;Beige&#39;, &#39;Teal&#39;, &#39;Blood Red&#39;, &#39;Blood Orange&#39;, &#39;Royal Blue&#39;, &#39;Sonic Blue&#39;, &#39;NES Green&#39;, &#39;Dark Green&#39;, &#39;Lumen&#39;}]</code></pre>
<p>Select the color of Link's Kokiri Tunic. Can also set Custom (#RRGGBB) using hexadecimal RGB values to set a custom color. (default: Kokiri Green)</p>
<pre><code>--goroncolor [{&#39;Random Choice&#39;, &#39;Completely Random&#39;, &#39;Kokiri Green&#39;, &#39;Goron Red&#39;, &#39;Zora Blue&#39;, &#39;Black&#39;, &#39;White&#39;, &#39;Azure Blue&#39;, &#39;Vivid Cyan&#39;, &#39;Light Red&#39;, &#39;Fuchsia&#39;, &#39;Purple&#39;, &#39;MM Purple&#39;, &#39;Twitch Purple&#39;, &#39;Purple Heart&#39;, &#39;Persian Rose&#39;, &#39;Dirty Yellow&#39;, &#39;Blush Pink&#39;, &#39;Hot Pink&#39;, &#39;Rose Pink&#39;, &#39;Orange&#39;, &#39;Gray&#39;, &#39;Gold&#39;, &#39;Silver&#39;, &#39;Beige&#39;, &#39;Teal&#39;, &#39;Blood Red&#39;, &#39;Blood Orange&#39;, &#39;Royal Blue&#39;, &#39;Sonic Blue&#39;, &#39;NES Green&#39;, &#39;Dark Green&#39;, &#39;Lumen&#39;}]</code></pre>
<p>Select the color of Link's Goron Tunic. Can also set Custom (#RRGGBB) using hexadecimal RGB values to set a custom color. (default: Goron Red)</p>
<pre><code>--zoracolor [{&#39;Random Choice&#39;, &#39;Completely Random&#39;, &#39;Kokiri Green&#39;, &#39;Goron Red&#39;, &#39;Zora Blue&#39;, &#39;Black&#39;, &#39;White&#39;, &#39;Azure Blue&#39;, &#39;Vivid Cyan&#39;, &#39;Light Red&#39;, &#39;Fuchsia&#39;, &#39;Purple&#39;, &#39;MM Purple&#39;, &#39;Twitch Purple&#39;, &#39;Purple Heart&#39;, &#39;Persian Rose&#39;, &#39;Dirty Yellow&#39;, &#39;Blush Pink&#39;, &#39;Hot Pink&#39;, &#39;Rose Pink&#39;, &#39;Orange&#39;, &#39;Gray&#39;, &#39;Gold&#39;, &#39;Silver&#39;, &#39;Beige&#39;, &#39;Teal&#39;, &#39;Blood Red&#39;, &#39;Blood Orange&#39;, &#39;Royal Blue&#39;, &#39;Sonic Blue&#39;, &#39;NES Green&#39;, &#39;Dark Green&#39;, &#39;Lumen&#39;}]</code></pre>
<p>Select the color of Link's Zora Tunic. Can also set Custom (#RRGGBB) using hexadecimal RGB values to set a custom color. (default: Zora Blue)</p>
<pre><code>--navicolordefault [{&#39;Random Choice&#39;, &#39;Completely Random&#39;, &#39;Gold&#39;, &#39;White&#39;, &#39;Green&#39;, &#39;Light Blue&#39;, &#39;Yellow&#39;, &#39;Red&#39;, &#39;Magenta&#39;, &#39;Black&#39;, &#39;Tatl&#39;, &#39;Tael&#39;, &#39;Fi&#39;, &#39;Ciela&#39;, &#39;Epona&#39;, &#39;Ezlo&#39;, &#39;King of Red Lions&#39;, &#39;Linebeck&#39;, &#39;Loftwing&#39;, &#39;Midna&#39;, &#39;Phantom Zelda&#39;}]</code></pre>
<p>Select the color of Navi in idle. Can also set Custom (#RRGGBB) using hexadecimal RGB values to set a custom color. (default: White)</p>
<pre><code>--navicolorenemy [{&#39;Random Choice&#39;, &#39;Completely Random&#39;, &#39;Gold&#39;, &#39;White&#39;, &#39;Green&#39;, &#39;Light Blue&#39;, &#39;Yellow&#39;, &#39;Red&#39;, &#39;Magenta&#39;, &#39;Black&#39;, &#39;Tatl&#39;, &#39;Tael&#39;, &#39;Fi&#39;, &#39;Ciela&#39;, &#39;Epona&#39;, &#39;Ezlo&#39;, &#39;King of Red Lions&#39;, &#39;Linebeck&#39;, &#39;Loftwing&#39;, &#39;Midna&#39;, &#39;Phantom Zelda&#39;}]</code></pre>
<p>Select the color of Navi when she is targeting an enemy. Can also set Custom (#RRGGBB) using hexadecimal RGB values to set a custom color. (default: Yellow)</p>
<pre><code>--navicolornpc [{&#39;Random Choice&#39;, &#39;Completely Random&#39;, &#39;Gold&#39;, &#39;White&#39;, &#39;Green&#39;, &#39;Light Blue&#39;, &#39;Yellow&#39;, &#39;Red&#39;, &#39;Magenta&#39;, &#39;Black&#39;, &#39;Tatl&#39;, &#39;Tael&#39;, &#39;Fi&#39;, &#39;Ciela&#39;, &#39;Epona&#39;, &#39;Ezlo&#39;, &#39;King of Red Lions&#39;, &#39;Linebeck&#39;, &#39;Loftwing&#39;, &#39;Midna&#39;, &#39;Phantom Zelda&#39;}]</code></pre>
<p>Select the color of Navi when she is targeting an NPC. Can also set Custom (#RRGGBB) using hexadecimal RGB values to set a custom color. (default: Light Blue)</p>
<pre><code>--navicolorprop [{&#39;Random Choice&#39;, &#39;Completely Random&#39;, &#39;Gold&#39;, &#39;White&#39;, &#39;Green&#39;, &#39;Light Blue&#39;, &#39;Yellow&#39;, &#39;Red&#39;, &#39;Magenta&#39;, &#39;Black&#39;, &#39;Tatl&#39;, &#39;Tael&#39;, &#39;Fi&#39;, &#39;Ciela&#39;, &#39;Epona&#39;, &#39;Ezlo&#39;, &#39;King of Red Lions&#39;, &#39;Linebeck&#39;, &#39;Loftwing&#39;, &#39;Midna&#39;, &#39;Phantom Zelda&#39;}]</code></pre>
<p>Select the color of Navi when she is targeting a prop. Can also set Custom (#RRGGBB) using hexadecimal RGB values to set a custom color. (default: Green)</p>
<pre><code>--navisfxoverworld [{&#39;Default&#39;, &#39;Random Choice&#39;, &#39;None&#39;, &#39;Cluck&#39;, &#39;Rupee&#39;, &#39;Softer Beep&#39;, &#39;Recovery Heart&#39;, &#39;Timer&#39;, &#39;Low Health&#39;, &#39;Notification&#39;, &#39;Tambourine&#39;, &#39;Carrot Refill&#39;, &#39;Zelda - Gasp&#39;, &#39;Mweep!&#39;, &#39;Ice Break&#39;, &#39;Explosion&#39;, &#39;Crate&#39;, &#39;Great Fairy&#39;, &#39;Moo&#39;, &#39;Bark&#39;, &#39;Ribbit&#39;, &#39;Broken Pot&#39;, &#39;Cockadoodledoo&#39;, &#39;Epona&#39;, &#39;Gold Skulltula&#39;, &#39;Redead&#39;, &#39;Poe&#39;, &#39;Ruto&#39;, &#39;Howl&#39;, &#39;Business Scrub&#39;, &#39;Guay&#39;, &quot;H&#39;lo!&quot;}]</code></pre>
<p>Select the sound effect that plays when Navi wishes to speak with the player. (default: Default)</p>
<pre><code>--navisfxenemytarget [{&#39;Default&#39;, &#39;Random Choice&#39;, &#39;None&#39;, &#39;Cluck&#39;, &#39;Rupee&#39;, &#39;Softer Beep&#39;, &#39;Recovery Heart&#39;, &#39;Timer&#39;, &#39;Low Health&#39;, &#39;Notification&#39;, &#39;Tambourine&#39;, &#39;Carrot Refill&#39;, &#39;Zelda - Gasp&#39;, &#39;Mweep!&#39;, &#39;Ice Break&#39;, &#39;Explosion&#39;, &#39;Crate&#39;, &#39;Great Fairy&#39;, &#39;Moo&#39;, &#39;Bark&#39;, &#39;Ribbit&#39;, &#39;Broken Pot&#39;, &#39;Cockadoodledoo&#39;, &#39;Epona&#39;, &#39;Gold Skulltula&#39;, &#39;Redead&#39;, &#39;Poe&#39;, &#39;Ruto&#39;, &#39;Howl&#39;, &#39;Business Scrub&#39;, &#39;Guay&#39;, &quot;H&#39;lo!&quot;}]</code></pre>
<p>Select the sound effect that plays when Navi targets an enemy. (default: Default)</p>
<pre><code>--healthSFX [{&#39;Default&#39;, &#39;Random Choice&#39;, &#39;None&#39;, &#39;Cluck&#39;, &#39;Softer Beep&#39;, &#39;Recovery Heart&#39;, &#39;Timer&#39;, &#39;Notification&#39;, &#39;Tambourine&#39;, &#39;Carrot Refill&#39;, &#39;Navi - Random&#39;, &#39;Navi - Hey!&#39;, &#39;Zelda - Gasp&#39;, &#39;Mweep!&#39;, &#39;Iron Boots&#39;, &#39;Hammer&#39;, &#39;Sword Bounce&#39;, &#39;Bow&#39;, &#39;Gallop&#39;, &#39;Drawbridge&#39;, &#39;Switch&#39;, &#39;Bomb Bounce&#39;, &#39;Bark&#39;, &#39;Ribbit&#39;, &#39;Broken Pot&#39;, &#39;Business Scrub&#39;, &#39;Guay&#39;, &#39;Bongo Bongo&#39;}]</code></pre>
<p>Select the sound effect that loops at low health. (default: Default)</p>
<pre><code>--gui</code></pre>
<p>Open the graphical user interface. Preloads selections with set command line parameters.</p>
<pre><code>--loglevel [{error,info,warning,debug}]</code></pre>
<p>Select level of logging for output. (default: info)</p>
<pre><code>--settings_string SETTINGS_STRING</code></pre>
<p>Enter a settings string that will encode and override most individual settings.</p>