OoT Randomizer Wiki Testing - User contributions [en]

Readme

2024-03-26T01:29:39Z

Flagrama: /* Custom Music and Fanfares */ remove outdated sentence

The Ocarina of Time Item Randomizer offers many different settings to customize your play experience. The version numbers indicate when a given feature was introduced. Find a fully detailed list below!

Release Notes and Changelogs for the latest release versions can be [https://wiki.ootrandomizer.com/index.php?title=Changelog 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 [[Logic|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).
*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.

''We have compiled [https://wiki.ootrandomizer.com/index.php?title=Common_Softlocks_And_Crashes a list of known softlocks and crashes].''

== 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.

=== Generate New Seed ===

<span style="color:green">(v3.0)</span> '''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.

<span style="color:green">(v1.0)</span> '''Seed''' - This is a string representing the particular configuration of items that will occur in the seed; its 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.

=== Generate From Patch File ===

<span style="color:green">(v4.0)</span> '''Patch File''' - Patch files are used to send the patched data to other people without sending the ROM file. ''On the website'' v3.0 had it's own format for patch files. Those files are not valid for this option.

<span style="color:green">(v3.0 web, v4.0 local)</span> '''Override Original Cosmetics''' - Indicates whether to use the cosmetics in a patch file, or to update them with your own cosmetics settings. ''On the website'' this was previously called '''Enable Custom Settings''' in v3.0, '''Override Cosmetics''' in v4.0, and '''Update Cosmetics''' in v5.0. ''On local version'' v4.0 it became the forced default option.

== ROM Options ==
This is the first, and default, tab of the randomizer generator. Options set here mainly affect what files are output, i.e. the randomized ROM and various logs.

''In versions 1.0 and 2.0'', this tab was named '''Randomize'''.

=== General ===

<span style="color:green">(v1.0)</span> '''Base Rom''' - Specify the file path for the ROM which will be patched 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, or when using a patch file with the "Generate From File" option.

<span style="color:green">(v1.0)</span> <span style="color:red">(Local only)</span> '''Output Directory''' - Specify where the output ROM will be saved on your device. ''On the website'' the new randomizer ROM is presented as a file download. Your browser settings dictate this file's destination.

<span style="color:green">(v5.1)</span> '''Enable Plandomizer (Advanced)''' - Activates the Plandomizer File file input box, and uses the file there to set "pre-planned" settings and item locations. For more information, see [[Plandomizer]].

<span style="color:green">(v5.0)</span> '''Plandomizer File''' - Specify the [[Plandomizer|JSON distribution file to use as a plandomizer file]].

<span style="color:green">(v6.0)</span> '''Enable Cosmetic Plandomizer (Advanced)''' - Activates the Cosmetic Plandomizer File input box, and uses the file there to set "pre-planned" cosmetics and sound effects. Note this option will be greyed out if No Output is selected. ''On the website'' this is also found on the seed patching page after generating a seed.

<span style="color:green">(v6.0)</span> '''Cosmetic Plandomizer File''' - Specify the JSON distribution file to use as a cosmetic plandomizer file.

<span style="color:green">(v1.0)</span> <span style="color:red">(Local only)</span> '''Generation Count''' - Specify how many ROMs in sequence to generate. ''In versions prior to 3.0'' it is referred to as simply '''Count'''. ''On the website'' this is set to 1 and cannot be changed.

<span style="color:green">(v1.0)</span> '''Create Spoiler Log''' - Indicate whether to output a text file detailing where every item can be found and a 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.

<span style="color:green">(v4.0)</span> <span style="color:red">(Local only)</span> '''Create Cosmetics Log''' - Indicate 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.

<span style="color:green">(v1.0)</span> <span style="color:red">(Local only)</span> '''Output Types''' - Indicate the format of the output ROM. ''On the website'' only the compressed option is available.
* <span style="color:green">(v4.0)</span> '''.zpf (Patch File)''' - Generate a patch file containing data which may be sent to other people without sending the ROM file. Please note it will not contain any custom models or custom voices selected.<p>''In versions 4.0 through 6.2'', this option was called '''Patch Files'''.
* '''.z64 (N64/Emulator)''' - Generally recommended for most users.<p>''In versions 1.0 and 2.0'', this was a checkbox named '''Compress patched ROM'''.''In versions 3.0 through 6.2'', this was called '''Compressed'''.
* <span style="color:green">(v7.0)</span> '''.wad (Wii VC)''' - Creates the game file used by Wii VC and the Dolphin emulator.
* '''Uncompressed ROM (Development)''' - All known N64 emulators crash often with uncompressed ROMs. Real N64 hardware can also have issues, but if you are willing to take that risk the generation time can be improved by using the uncompressed option if it will be played on a real N64 with a flash cart. However as generation time is now usually relatively quick, this option exists primarily for development purposes.<p>''In version prior to 7.0'', this was called '''Uncompressed'''.

<span style="color:green">(v7.0)</span> '''Show Seed Info on File Screen''' - Enables the text box for '''User-Configurable Message'''.

<span style="color:green">(v7.0)</span> '''User-Configurable Message''' - Anything typed here will display on the file select screen of the game. Useful for plando'd seeds intended to be shared with friends and in race settings to ensure all players have the same seed at a glance.

<span style="color:green">(v1.0)</span> <span style="color:red">(Local only)</span> '''Open Output Directory''' - Opens the directory set as the Output Directory with the computer's file manager. If not set, it opens the Randomizer's default Output directory. If the default directory does not yet exist, it is created. ''In versions v3.0 and v4.0'', this button was not present. It was restored in v5.0.

<span style="color:green">(v5.1)</span> <span style="color:red">(Local only)</span> '''Open App Directory''' - Opens the directory where the actual randomizer application is located. In the source code version, this is the directory from which Gui.py was launched. In 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.

=== Multi-World Generation ===
<span style="color:green">(v3.0)</span> This option allows the generation of multiple words for use in [[Multiworld|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''' - Specify how many players will be participating in this co-op playthrough. ''On the website'' this is limited to a maximum of 4.
* '''Player ID''' - Specify your player number to patch the correct file. 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, or when using a patch file using the "Generate From File" option.

=== Settings Presets ===
<span style="color:green">(v4.0)</span> Adjusts all settings to those previously defined within the chosen Preset.
* '''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.

<span style="color:green">(v5.0)</span> '''Randomize Main Rule Setttings''' - Randomizes most Main Rules, excluding Logic Rules and Number of MQ Dungeons.

<span style="color:green">(v4.0)</span> '''Logic Rules''' - Determines the set of guiding rules used by the Randomizer to generate beatable seeds.
* [[Logic|'''Glitchless''']] - No glitches are required, but may require some minor tricks. Minor tricks can be considered in logic by adding them in the ‘Detailed Logic’ tab.
* <span style="color:green">(v5.0)</span> [[Glitched Logic|'''Glitched''']] - Movement-oriented glitches are likely required. No locations excluded.
* '''No Logic''' - Maximize randomization, All locations are considered available. MAY BE IMPOSSIBLE TO BEAT.

=== 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.

<span style="color:green">(v1.0)</span> '''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.
* <span style="color:green">(v5.0)</span> '''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.
* '''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. (Some Entrance Randomizer settings may change this to function as Closed Deku instead during generation. Shuffle Boss Entrances, however, is compatible with Closed Forest as of v8.0.)

<span style="color:green">(v6.0)</span> '''Kakariko Gate''' - Choose under what conditions the Kakariko Gate and Happy Mask Shop open.
* '''Open Gate''' - The Kakariko Gate is open from the start of the game, but the Happy Mask Shop opens once Zelda's Letter is obtained. There is no need to show Zelda's Letter to the guard with this setting.
* '''Zelda's Letter Open Gate''' - The gate is closed at the start of the game, but opens, along with the Happy Mask Shop, once Zelda's Letter is obtained. There is no need to show Zelda's Letter to the guard with this setting.
* '''Closed Gate''' - Both the gate and the Happy Mask Shop are closed until Zelda's Letter is shown to the guard in Kakariko.

'''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.

<span style="color:green">(v4.0)</span> '''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.
* <span style="color:green">(v5.2)</span> '''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.
* '''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.

<span style="color:green">(v3.0)</span> '''Gerudo Fortress''' - Choose how many carpenters must be saved.
* '''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.<br>''In versions v3.0 and v4.0'', this was named '''Start with Gerudo Card'''. This was before the Gerudo card prevented the guards from throwing Link in jail.</p>

<span style="color:green">(7.0)</span> '''Dungeon Boss Shortcuts Mode''' - Choose which dungeons will have the path to the boss open. This does not affect any elements outside of the direct path to the boss. For example, in the Forest Temple the final poe will be defeated and elevator will already be raised, but the other three poes will still be present in the dungeon.
* '''Off''' - Retains vanilla function.
* '''Specific Dungeons''' - Makes the '''Dungeon Boss Shortcuts''' drop-down visible to select which dungeons should have the open path.
* '''All Dungeons''' - All dungeons will have their paths to the bosses open.
* '''Random Dungeons''' - The generator will open the boss shortcuts for a random number of dungeons.

<span style="color:green">(7.0)</span> '''Dungeon Boss Shortcuts''' - Select the checkboxes for the dungeons which should have the shortcuts enabled. Only available when Specific Dungeons is selected under Dungeon Boss Shortcuts Mode.

<span style="color:green">(v1.0)</span> '''Rainbow Bridge Requirement''' - Choose the conditions 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''' - All medallions and spiritual stones must be in the player’s possession to open Ganon's Castle.
* <span style="color:green">(v4.0)</span> '''All Spiritual Stones''' - All three of the spiritual stones are required to open Ganon's Castle.
* <span style="color:green">(v4.0)</span> '''Gold Skulltula Tokens''' - A configurable number of the gold skulltulas are required to open Ganon's Castle. A slider appears below this setting when this option is chosen.
* <span style="color:green">(v7.0)</span> '''Hearts''' - A configurable number of maximum hearts are required to open Ganon's Castle. A slider appears below this setting when this option is chosen.
* <span style="color:green">(v6.1)</span> '''Random''' - One of the above options, excluding tokens and hearts, will be randomly chosen as the requirement to enter Ganon's Castle.

<span style="color:green">(v5.1)</span> '''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.

<span style="color:green">(v7.0)</span> '''Hearts Required for Bridge''' - Select the amount of maximum Hearts required to spawn the rainbow bridge. Only available if Hearts bridge is selected.

<span style="color:green">(v3.0)</span> '''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.

<span style="color:green">(v3.0)</span> '''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 version v2.0'', this was part of an option named '''Skip most of Ganon's Castle''' which set the value to 0.

=== World ===
These rules affect the fundamentals for how the world works.

<span style="color:green">(v5.0)</span> '''Starting Age''' - Choose whether Link starts as a child or adult. 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 selects Link’s starting age.

<span style="color:green">(v7.0)</span> '''MQ Dungeon Mode''' - Choose which style of dungeon will be used.
* '''Vanilla''' - All dungeons will be in their ordinary configuration.
* '''Master Quest''' - All dungeons will be in their Master Quest configuration.
* '''Specific Dungeons''' - Select which dungeons will be in their Master Quest configuration. Enables the '''MQ Dungeons''' drop-down.
* '''Count''' - Select how many dungeons will be in their Master Quest configuration, but not which dungeons it will apply to.
* '''Completely Random''' - The configuration will be assigned randomly for each dungeon.

<span style="color:green">(v7.0)</span> '''MQ Dungeons''' - Select which dungeons will be in their Master Quest configuration. Only available if Specific Dungeons is selected in the MQ Dungeon Mode option.

<span style="color:green">(v7.0)</span> '''Pre-completed Dungeons Mode''' - Pre-completed dungeons will guaranteed to be barren and the dungeon reward will be given at the start of the seed. This setting only applies to dungeons with a blue warp.
* '''Off''' - No dungeons are affected.
* '''Specific Dungeons''' - Enables the '''Pre-completed Dungeons''' drop-down visible to select which dungeons should be barren and the reward given.
* '''Count''' - Enables a slider to select how many dungeons should be barren and the reward given without selecting specifically which ones.

<span style="color:green">(v7.0)</span> '''Pre-completed Dungeons''' - Select which dungeons will be barren and their rewards given. Only available if Specific Dungeons is selected in the Pre-completed Dungeons Mode option.

<span style="color:green">(v7.0)</span> '''Pre-completed Dungeon Count''' - Select how many dungeons will be barren and their rewards given, but not which ones. Only available if Count is selected in the Pre-completed Dungeons Mode option.

<span style="color:green">(v6.0)</span> '''Shuffle Interior Entrances''' - Shuffle interior entrances bidirectionally within different pools. When enabled, trade timers are disabled and trade items never revert.
* '''Simple Interiors''' - Shuffle dungeon entrances along with simple Grotto and Interior entrances (i.e. most Houses and Great Fairies).

* '''All Interiors''' - Extended version of 'Simple Indoors' with some extra entrances: Link's House, Temple of Time, Kakariko Potion Shop, and the Windmill. However, Richard's owner's house is never shuffled.

<span style="color:green">(v8.0)</span> '''Shuffle Thieves' Hideout Entrances''' - Shuffles the individual doorways of Thieves' Hideout into the interiors pool. Savewarping from any Thieves' Hideout interior will return Link to the first jail room. '''Shuffle Interior Entrances''' must be enabled in order to turn on this toggle.

<span style="color:green">(v6.0)</span> '''Shuffle Grotto Entrances''' - Shuffle grotto and grave entrances, including small fairy fountains and the Deku Theater.

<span style="color:green">(v6.0)</span> '''Shuffle Dungeon Entrances ''' - Shuffle dungeon and mini-dungeon entrances. Enabling this option also allows access to the Deku Tree, Fire Temple, and Bottom of the Well entrances as both ages. Note that Deku Tree and Bottom of the Well must still be opened as child before adult can access.
* '''Dungeon''' - Shuffle the dungeon entrances, including Bottom of the Well, Ice Cavern, and Gerudo Training Grounds.
* <span style="color:green">(v7.0)</span> '''Dungeon and Ganon''' - Shuffle the dungeon entrances, including Bottom of the Well, Ice Cavern, Gerudo Training Grounds, and Ganon's Castle.

<span style="color:green">(v7.0)</span> '''Shuffle Boss Entrances ''' -
* '''Off''' - Bosses will remain in their respective dungeons.
* '''Age-Restricted''' - Bosses are separated into child and adult pools and shuffled amongst themselves separately.
* '''Full''' - Bosses may appear in any dungeon. Child may be expected to defeat Phantom Ganon and/or Bongo Bongo.

<span style="color:green">(v6.0)</span> '''Shuffle Overworld Entrances''' - Shuffle the overworld entrances, which includes nearly all loading zones between overworld areas with a few exceptions.
*Hyrule Castle Courtyard and Gardent entrances
*Both Market Back Alley entrances
*Gerudo Valley to Lakey Hylia

<span style="color:green">(v8.0)</span> '''Shuffle Gerudo Valley River Exit''' - Randomizes the one-way exit of diving into the Gerudo Valley waterway.

When enabled, trade timers are disabled and trade items never revert.

<span style="color:green">(v6.0)</span> '''Randomize Owl Drops''' - Randomize where Kaepora Gaebora (the owl) drops Link after accepting his offer at Lake Hylia or the top of Death Mountain Trail.

<span style="color:green">(v6.0)</span> '''Randomize Warp Song Destinations''' - Randomize where warp songs go. With All Locations Reachable enabled, this will usually result in warps connecting to the Bolero warp pad, Nocturne warp pad, and the Desert Colossus. However Colossus may not be incldued when overworld or dungeon entrance randomizer is enabled.

<span style="color:green">(v7.0)</span> '''Randomize Overworld Spawns''' - Randomize where Link will spawn as child and/or adult. This means child and adult Link may spawn nowhere near Link's House and Temple of Time, respectively. These locations will stay consistent even after saving and reloading the game. ''In versions 6.0 through 6.2'', this option was a single toggle for both ages.

<span style="color:green">(v5.2)</span> '''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.

<span style="color:green">(v5.2)</span> '''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

<span style="color:green">(v8.0)</span> '''Add Bombchu Bag and Drops''' - This option fundamentally changes how the Bombchu items found around the world function. With this option on, Bombchus are considered a progression item by logic. The first Bombchus found will give a bag to hold them, like a bomb bag, along with the number of Bombchus in that pack. This will unlock Bombchu Bowling (if not already unlocked by finding a bomb bag first), buying Bombchu refills from shops, and buying Bombchus from the wasteland carpet salesman. Once a Bombchu Bag is found, Bombchus can be found in grace and rocks in the same manner as regular bombs.

With this option off, randomly found Bombchu items are not considered as logical progression. Finding a Bomb Bag is the sole condition to play Bombchu Bowling and buy Bombchus from shops which are available for repeatable purchase. Shopsanity one-time purchase Bombchus do not require a Bomb Bag.

<span style="color:green">(v3.0)</span> '''Dungeons Have One Major Item''' - This option places one and only one [[Major Items|Major Item]] in each of the dungeons, except Spirit Temple which receives two. 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.

=== Shuffle ===
These settings shuffle more items into the item pool.

<span style="color:green">(v6.0)</span> '''Shuffle Songs''' - This setting changes where songs will be placed.
* '''Song Locations''' - Songs will only appear in places where songs are located in vanilla. However songs will be shuffled amongst each other.
* '''Dungeon Rewards''' - Songs wil be placed at the ends of dungeons, plus one in the Zelda's Lullaby location. The dungeon reward locations are the 9 boss heart containers, the Lens of Truth chest (BotW), the Ice Arrows chest (GTG), the song reward in Ice Cavern, and the song from Impa in Hyrule Castle.
* '''Anywhere''' - Songs can be placed in any location in the game.

<span style="color:green">(v3.0)</span> '''Shopsanity''' - This setting randomizes the items sold in shops. When enabled, all shop items are randomly re-arranged amongst 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 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. If Bombchus are considered in logic, a minimum of two shops are guaranteed to have Bombchus. ''In version 7.0'', all settings except Off will enable the '''Shopsanity Prices''' option.
* '''Off''' - Disables the Shopsanity feature.
* '''Shuffled Shops (0 Items)''' - This causes all of the Shopsanity features described above.
* <span style="color:cornflowerblue">(Multiple Similar Settings)</span> '''Shuffled Shops (1-4 Items)''' - This causes the Shopsanity features described above while also adding 1-4 (depending on the exact setting) items from the general item pool into shops to buy for randomly chosen amounts of rupees. 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.
* '''Random # of Items Per Shop''' - 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. ''In versions 3.0 through 6.2'', this setting was called '''Shuffled Shops (Random Items'''.

<span style="color:green">(v7.0)</span> '''Shopsanity Prices''' - Select the maximum number of rupees that may be required to purchase a randomized shop item. All settings price items in multiples of 5.
* '''Random''' - Prices will range from 0 to 300 rupees with a bias towards just below the middle of the range.
* <span style="color:cornflowerblue">(Multiple Similar Settings)</span> '''X Wallet''' - Prices will range between 0 and the maximum amount held by the wallet selected.
* '''Affordable''' - All randomized items will be priced at 10 rupees.

<span style="color:green">(v3.0)</span> '''Tokensanity''' - This setting shuffles the Gold Skulltula item drops into the general pool of locations.
* '''Off''' - The default setting. Gold Skulltulas appear in their normal locations and only provide tokens.
* '''Dungeons Only''' - The Gold Skulltulas that appear in dungeons can hold any item. Overworld skulltulas will only provide tokens and tokens taken from dungeon Skulltulas can be found anywhere in the world.
*<span style="color:green">(v5.1)</span> '''Overworld Only''' - The Gold Skulltulas that appear in the overworld can hold any item. Dungeon skulltulas will only provide tokens and tokens taken from overworld Skulltulas can be found anywhere.
* '''All Tokens''' - All of the Gold Skulltulas in the overworld and in dungeons can hold any item. Tokens can be found in any item location.

<span style="color:green">(v3.0)</span> '''Scrub Shuffle''' - This setting 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 text for the Business Scrub will update to state they are selling a "mysterious item."
* '''Off''' - Only the 3 scrubs which sell permanent upgrades in the base game will be randomized. That is, the scrub under the Lost Woods bridge, the left scrub in the Lost Woods Grotto, and the scrub inside the fences in Hyrule Field by Lake Hylia.
* '''On (Affordable)''' - All scrubs will have randomized items and sell them for 10 rupees.
* '''On (Expensive)''' - All scrubs will have randomized items but sell them at their usual rates. Be aware, this will mean the game can expect over 1,000 rupees to be spent on scrubs.
* '''On (Random Prices)''' - All scrubs will have randomized items and sell them at rates ranging from 0 to 99 rupees. Likely to be very expensive.

<span style="color:green">(v8.0)</span> '''Shuffled Child Trade Sequence Items''' - Shuffles the location of items in the child trade quest. If both Weird Egg and Chicken are set to shuffle, only the Weird Egg will appear in the item pool. Shuffling the masks unlocks items in the mask shop in the same way as usual. For example, the item in the Keaton Mask slot is immediately available, but the item in the Bunny Hood slot is not available until the Spooky Mask has been given to the graveyard child. Right side masks require the Bunny Hood be given to the running man.

<span style="color:green">(v8.0)</span> '''Shuffle All Adult Trade Items''' - Shuffles the location of the items selected in the ''Adult Trade Sequence Items'' dropdown menu anywhere in the world. Once the item is found, it should be returned to it's usual NPC in exchange for another item.

<span style="color:green">(v7.0)</span> '''Adult Trade Sequence Items''' - If ''Shuffle All Adult Trade Items'' is enabled, this selects which adult trade quest items may be found somewhere besides the NPC who ordinarily provides them. If some items are selected but not others, the items left unselected will be obtainable from the NPC who ordinarily gives them in exchange for the previous trade quest item.

If ''Shuffle All Adult Trade Items'' is disabled, this selects which adult trade quest items could potentially appear in the 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. ''In versions 7.0 and 7.1'', this setting was in the Item Pool section of the Other tab.

<span style="color:green">(v7.0)</span> '''Shuffle Rupees & Hearts''' - Randomize visible free-standing rupees and recovery hearts. For location assistance see [https://wiki.ootrandomizer.com/index.php?title=Freestanding_Rupee_and_Heart_Locations this page].
* '''Off''' - Free-standing rupees and recovery hearts will be left unchanged.
* '''All''' - All visible free-standing rupees and recovery hearts will be randomized.
* '''Overworld Only''' - Only visible free-standing rupees and recovery hearts found in the overworld will be randomized.
* '''Dungeons only''' - Only visible free-standing rupees and recovery hearts found in the dungeons will be randomized.

<span style="color:green">(v7.0)</span> '''Shuffle Pots''' - Randomize pot contents, excluding pots containing fairies. Pots that are empty in vanilla will not have a randomized item under this setting either. This setting moves Ganon's boss door lock to the next door up in order to grant access to the pots in the lower area of the boss arena without the boss key. For location assistance see [https://wiki.ootrandomizer.com/index.php?title=Pot_and_Crate_Locations this page].
* '''Off''' - Pot contents will be left unchanged.
* '''All''' - All pots with contents other than fairies will be randomized.
* '''Overworld Only''' - Overworld pots with contents other than fairies will be randomized.
* '''Dungeons only''' - Dungeon pots with contents other than fairies will be randomized.

<span style="color:green">(v7.0)</span> '''Shuffle Crates''' - Randomize large and small crate contents. Only crates which contain something in the base game will be shuffled. For location assistance see [https://wiki.ootrandomizer.com/index.php?title=Pot_and_Crate_Locations this page].
* '''Off''' - Crate will be left unchanged.
* '''All''' - All crates with contents are randomized.
* '''Overworld Only''' - Overworld crates with contents are randomized.
* '''Dungeons only''' - Dungeon crates with contents are randomized.

<span style="color:green">(v5.0)</span> '''Shuffle Cows''' - This setting causes cows to give an item when Epona's song is played. Playing the song a second time will give milk as normal. There are 9 cows, plus one in MQ Jabu, if enabled.

<span style="color:green">(v7.0)</span> '''Shuffle Beehives''' - This setting adds random contents to the 32 beehives in grottos and Zora's Domain. Beehives will shake if they contain an important item. Beehives can be broken by boomerang, hookshot, and explosives. For location assistance see [https://wiki.ootrandomizer.com/index.php?title=Freestanding_Rupee_and_Heart_Locations#Grotto_Beehives this page].

<span style="color:green">(v3.0)</span> '''Shuffle Kokiri Sword''' - This setting 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.

<span style="color:green">(v3.0)</span> '''Shuffle Ocarinas''' - This setting 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 and the second the Ocarina of Time. However the two are functionally identical. Without this setting enabled, leaving the Kokiri Forest to the Lost Woods bridge as a child will always grant one Ocarina and the other is available at the gate of Castle Town, as a child, when all three Spiritual Stones are in Link’s possession.

<span style="color:green">(v3.0)</span> '''Shuffle Gerudo Card''' - This setting shuffles the Gerudo Card into the general item pool. In the randomizer, this is required to gain access to Gerudo Training Grounds <span style="color:green">(v5.0)</span> and stops the guards being hostile. Without this enabled, 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 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.

<span style="color:green">(v5.0)</span> '''Shuffle Magic Beans''' - This setting 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.

<span style="color:green">(v6.0)</span> '''Shuffle Medigoron & Carpet Salesman''' - This setting adds the Giant's Knife and a pack of Bombchus to the pool while Medigoron and Carpet Salesman each sell a randomly placed item once for 200 rupees.

While Giant's Knife and Biggoron Sword are not progressive items, do not worry that finding the Giant's Knife second will remove Biggoron Sword. In the case where Biggoron Sword is found before Giant's Knife, that slot will still remain as Biggoron Sword even after picking up the Giant's Knife.

<span style="color:green">(v7.0)</span> '''Shuffle Frog Song Rupees''' - This setting gives the frogs randomized items which can be earned by playing the 5 songs learned by child in the base game. The 5 purple rupees normally given are added to the item pool.

<span style="color:green">(v8.0)</span> '''Shuffle Hyrule Loach Reward''' - Shuffles the reward for catching the Hyrule Loach in the Fishing Pond.
* '''Vanilla Behavior''' - The loach only appears every 4th time the minigame is played and the sinking lure is only findable after obtaining the fishing prize for Link's current age.
* '''Easier Behavior''' - The loach and sinking lure will be available every time the minigame is played. The ordinary prizes are also available even while using the sinking lure.

<span style="color:green">(v8.0)</span> '''Shuffle Individual Ocarina Notes''' - Shuffles new items for each of the ocarina sounds. For example, Zelda's Lullaby will not be playable until the left, up, and right notes are found. (Note: The skull kid ocarina minigame is not considered to be in glitchless logic until all 5 notes are found, for ease of play.)

=== Shuffle Dungeon Items ===
<span style="color:cornflowerblue">(Multiple Similar Settings)</span> These settings allow the player to decide the natural distribution of dungeon items. The groups are '''Maps & Compasses''', '''Small Keys''', '''Thieves' Hideout Keys''', <span style="color:green">(v8.0)</span> '''Treasure Chest Game Keys''', '''Boss Keys''', and <span style="color:green">(v8.0)</span> '''Silver Rupees'''. ''Prior to v7.0'', Thieves' Hideout Keys were known as '''Gerudo Fortress Keys'''.
* <span style="color:green">(v1.0)</span> '''Remove (Keysy)''' - Dungeon items can be prevented from existing completely. If Small Keys or Boss Keys are eliminated, this will also remove all locks those keys would open as well.
* <span style="color:green">(v5.0)</span> '''Vanilla Locations''' - Dungeon items are found in their vanilla chests and freestanding locations. This setting will start Link with 3 Master Quest Spirit Temple keys, if MQ Spirit Temple is in the seed. The vanilla placements for keys in MQ Spirit Temple are not compatible with glitchless logic.
* <span style="color:green">(v6.0)</span> '''Own Dungeon''' - 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. ''In v5.0'', this setting was named '''Dungeon Only'''.
* <span style="color:green">(v7.0)</span> '''Regional''' - Dungeon items can only appear within the areas associated with their dungeon. Please see [https://wiki.ootrandomizer.com/index.php?title=Hints#Hint_Regions this page] for a list of areas which comprise each region.
* <span style="color:green">(v6.0)</span> '''Overworld Only''' - Dungeon items are spread throughout the overworld and none will appear in any dungeon. This setting is likely to require some backtracking.
* <span style="color:green">(v6.0)</span> '''Any Dungeon''' - Dungeon items will only appear in dungeons, not the overworld, but may be for a different dungeon than the one they were found in. This setting is likely to require a good deal of backtracking.
* <span style="color:green">(v3.0)</span> '''Anywhere (Keysanity)''' - Dungeon items can be spread freely throughout the world. This setting is likely to require a good deal of backtracking.
* <span style="color:green">(v3.0)</span> <span style="color:cornflowerblue">(Maps & Compasses Only)</span> '''Start Wtih''' - Maps and Compasses are given to Link from the start.

<span style="color:green">(v7.0)</span> '''Key Rings Mode''' - This settings allows all the keys for an area to be combined into a single unique item. Can apply to dungeons and the Thieves' Hideout keys. Setting has no effect if small keys are removed or set to vanilla for the selected dungeon or Thieves Hideout is set to vanilla locations, one carpenter, or open.
* '''Off''' - No dungeons are affected.
* '''Choose Dungeons''' - Enables the '''Key Rings''' drop-down visible to select which areas should have a key ring.
* '''All Dungeons''' - All areas will have their keys replaced by key rings.
* '''Random Selection''' - A random number of areas will have their keys replaced by key rings. ''In versions 7.0 and 7.1'', setting was called ''Random Dungeons''.

<span style="color:green">(v7.0)</span> '''Key Rings''' - Select which key groupings should be available as a key ring. Only available if Key Rings Mode is set to Choose dungeons.

<span style="color:green">(v8.0)</span> '''Key Rings give Boss Keys''' - Adds the boss key to any keyrings in the item pool. <span style="color:red">Warning</span>: In v8.0, do not enable this toggle if small keys are set to Remove (keysy) while boss keys are not, as this will remove boss keys entirely resulting in an unbeatable seed.

<span style="color:green">(v3.0)</span> '''Ganon's Boss Key''' - Allows the player to decide on how and where Ganon's Castle's boss key is found. The last 5 options enable a corresponding slider to set the number required.

''Note: This setting is incompatible with Triforce Hunt as that setting will force the Ganon's Castle boss key to be given on collection of the last Triforce piece as the credits start.''
* <span style="color:green">(v2.0)</span> '''Remove (Keysy)''' - The Ganon's Castle boss key is removed and the boss door in Ganon's Tower starts unlocked.<p>''In version v2.0'' this was part of the setting called '''Skip most of Ganon's Castle'''.</p>
* <span style="color:green">(v5.0)</span> '''Vanilla Location''' - The Ganon's boss key is located in the gilded chest in Ganon's Castle.
* <span style="color:green">(v6.0)</span> '''Own Dungeon''' - The Ganon's Castle boss key can be found anywhere in Ganon's Castle.<p>''In versions v2.0-v4.0'', this was how the boss key is placed if the '''Remove Ganon's Boss Door Lock''' or '''Skip most of Ganon's Castle''' settings were not checked. ''In v5.0'', setting was named '''Dungeon Only'''.</p>
* <span style="color:green">(v6.0)</span> '''Overworld Only''' - The Ganon's Castle boss key can be found anywhere in the overworld, but will not be in any dungeon.
* <span style="color:green">(v6.0)</span> '''Any Dungeon''' - The Ganon's Castle boss key will be in one of the dungeons, not the overworld. This has the possibility of the key still appearing in Ganon's Castle.
* <span style="color:green">(v5.0)</span> '''Anywhere (Keysanity)''' - The Ganon's boss key can be located anywhere in the world.
* <span style="color:green">(v6.1)</span> '''Light Arrow Cutscene''' - The Ganon's boss key will be received in the Temple of Time once the Shadow and Spirit medallions are obtained.
* <span style="color:green">(v6.1)</span> '''Stones''' - The Ganon's boss key will be received once the specified number of stones are obtained.
* <span style="color:green">(v6.1)</span> '''Medallions''' - The Ganon's boss key will be received once the specified number of Medallions are obtained.
* <span style="color:green">(v6.1)</span> '''Dungeons''' - The Ganon's boss key will be received once the specified number of Dungeons are completed.
* <span style="color:green">(v6.1)</span> '''Tokens''' - The Ganon's boss key will be received once the specified number of gold skulltula tokens are obtained.
* <span style="color:green">(v7.0)</span> '''Hearts''' - The Ganon's boss key will be received once the specified number of hearts are obtained.

<span style="color:green">(v7.0)</span> '''Shuffle Silver Rupees''' - The Silver Rupees required to complete puzzle rooms throughout the game are shuffled elsewhere. The vanilla locations of these rupees will contain shuffled items. Each rupee's text box will indicate which puzzle room it is for and counts can be checked on the item menu by holding A or D-Pad, depending on the cosmetic setting chosen.

<span style="color:green">(v3.0)</span> 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. This is viewable in the pause screen item menu by pressing and holding 'A'.<br>'''Note''': Removing maps and compasses and enabling this setting means you cannot find out what dungeon rewards are in which dungeons.

== Detailed Logic ==
These are settings that affect logic in very specific and situational ways.

<span style="color:green">(v6.1)</span> '''Guarantee Reachable Locations''' - This setting will set the logic for how many item locations are guaranteed to be logically accessible.
* '''All''' - Ensures all locations in the game can be reached.
* '''All Goals''' - Ensures Link has logical access to every potentially required item to unlock Ganon's Boss Key and spawn the Rainbow Bridge. For example, if one spiritual stone is required, all three will still be logically accessible. In Triforce Hunt, all pieces will be accessible.
* '''Required Only''' - Only enough goal items to complete the game are guaranteed to be accessible. For example, if one spiritual stone is required, the game will only check to ensure one of the three is reachable. In Triforce Hunt, only enough pieces to complete the game are guaranteed to be accessible.

''In versions v1.0 and v2.0'', this was named '''Only ensure seed is beatable, not all items must be reachable''' and worked inverse of how this setting now works. ''Prior to v4.0'', “key for key” item locations (a single item spot behind a locked door containing the key to open the door) could exist. ''Prior to v6.1'', this was named '''All Locations Reachable''' and functioned similarly.

<span style="color:green">(v3.0)</span> '''Nighttime Skulltulas Expect Sun’s Song''' - This setting causes the logic to expect the player to have an ocarina and the Sun’s Song before getting nighttime only Gold Skulltula locations. It does not change the behavior of the Gold Skulltulas in the game.

<span style="color:green">(v3.0)</span> '''Exclude Locations''' - This is a search box and drop down search to select which locations should never have major items required to finish a seed. The search box searches the location names as written, the drop down checks for hidden tags associated with each location. Locations selected here will always contain junk items. Excluded locations will be displayed in a list box below the search box on the right.

''In version v3.0'', this section was named '''Remove Specific Locations''' and had a very specific set of locations you could exclude via check boxes. ''Prior to v5.0'', junk locations could hold any non-major item.

<span style="color:green">(v3.0)</span> '''Enable Tricks''' - This is a search box and drop down search to enable trick flags. The search box searches the location names as written, the drop down checks for hidden tags associated with each location. Enabled tricks will be displayed in a list box below the search box on the right. Hover the mouse over a trick to see its description. Video tutorials for most of these tricks can be found in [https://www.youtube.com/playlist?list=PLqsXSioZwQyoa23_27l5NZq5IZdKRi5Sm this playlist].<br>
''In version v3.0'', this section was called '''Specific Expected Tricks''' and had a small number of checkboxes to choose very specific tricks.

== Starting Inventory ==
<span style="color:green">(v5.2)</span> Allows you to choose the items Link has at the beginning of the game.

'''Starting Equipment''' - Begin the game with the selected equipment.

'''Starting Items''' - Begin the game with the selected inventory items. Selecting multiple progressive items will give the appropriate number of upgrades.<br>If playing with Open Zora Fountain, the Bottle with Letter is converted to a regular Bottle.

'''Starting Songs''' - Begin the game with the selected songs already learnt.

=== Other ===

'''Start with Consumables''' - Start the game with maxed out Deku Sticks and Deku Nuts.

'''Start with Max Rupees''' - Start the game with a full wallet. Wallet upgrades will also fill the wallet.

'''Starting Hearts''' - Start the game with the selected number of hearts. Heart Containers and Pieces of Heart are removed from the item pool in equal proportion.

== Other ==
These are various other settings which do not majorly affect gameplay and instead customize the play experience.

=== Timesavers ===
These are settings that save time by cutting tedious content.

<span style="color:green">(v3.0)</span> '''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.

''In version v2.0'', this was part of the setting called '''Skip most of Ganon's Castle'''.

<span style="color:green">(v3.0)</span> '''Skip Child Stealth''' - This setting causes entering the crawlspace at Hyrule Castle to warp Link directly into the Castle Courtyard, bypassing the guard evasion sequence.<br> ''In versions v3.0'', this was called '''Skip Interior Castle Guard Stealth'''.

<span style="color:green">(v3.0)</span> '''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.

<span style="color:green">(v6.0)</span> '''Skip Some Minigame Phases''' - This setting skips the first phase of both Horseback Archery and Dampé Race. This means achieving 1500 in the first archery attempt grants both prizes and completing Dampé's Race in under a minute grant's both prizes. The first reward of each is still available for 1000 archery points and over one minute, respectively. ''In 5.1'', the option to skip Dampé's first race was available (Skip First Dampé Race), but not Horseback Archery.

<span style="color:green">(v6.0)</span> '''Complete Mask Quest''' - This setting makes all masks available to be borrowed as soon as the Happy Mask Shop opens.

<span style="color:green">(v5.0)</span> '''Enable Specific Glitch-Useful Cutscenes''' - The cutscenes of the Poes in Forest Temple, Darunia in Fire Temple, and the introduction to Twinrova will not be skipped. ''In version prior to 7.0'', this setting was called '''Enable Useful Cutscenes'''.

<span style="color:green">(v3.0)</span> '''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.

<span style="color:green">(v3.0)</span> '''Free Scarecrow’s Song''' - This setting 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.<br>''In version v3.0'', this was called '''Start with Scarecrow's Song''' and forced you to set a song at generation time that everyone had to share.

<span style="color:green">(v6.0)</span> '''Fast Bunny Hood''' - This setting causes the Bunny Hood to act like Majora's Mask and speed up Link's movement speed. The speed matches Link's backwalking speed and does not increase Link's backwalking speed.

<span style="color:green">(v8.0)</span> '''Maintain Mask Equips through Scene Changes''' - This setting keeps masks equipped when going through loading zones and savewarping. (Bare in mind masks alter NPC reactions to Link, so remove the mask before speaking to anyone.)

<span style="color:green">(v7.0)</span> '''Plant Magic Beans''' - Game begins with all 10 beans pre-planted. Does not remove the magic beans from the item pool and beans collected with this toggle on have no use.

<span style="color:green">(v5.0)</span> '''Random Cucco Count''' - This setting requires a random number of Cuccos from 1-7 to be returned to Anju for a reward.

<span style="color:green">(v5.0)</span> '''Cucco Count''' - The number of Cuccos required can be selected manually with this slider.

<span style="color:green">(v3.0)</span> '''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.

<span style="color:green">(v3.0)</span> '''Big Poe Target Count''' - The number of Big Poes required can be selected manually with this slider.

'''Note''': Big Poes can be found as pre-stocked Bottle contents, and the logic can expect using them if the required number is sufficiently low.

<span style="color:green">(v7.0)</span> '''Easier Fire Arrow Entry''' - Enables '''Fire Arrow Entry Torch Count''' slider.

<span style="color:green">(v7.0)</span> '''Fire Arrow Entry Torch Count''' - Select how many torches must be lit in order for the Shadow Temple door to open.

<span style="color:green">(v8.0)</span> '''Ruto Already at F1''' - Moves Ruto to the top floor immediately so Link does not have to carry her up from the basement of Jabu Jabu.

=== Misc ===

<span style="color:green">(v3.0)</span> '''Randomize Ocarina Song Notes''' - This setting 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. ''In versions 3.0 through 6.2'', this setting was a toggle for all songs.
* '''Off''' - All songs retain their normal pattern.
* <span style="color:green">(v7.0)</span> '''Frog Songs Only''' - Only the top row of songs will have shuffled notes.
* <span style="color:green">(v7.0)</span> '''Warp Songs Only''' - Only the bottom row of songs will have shuffled notes.
* '''All Songs''' - All songs will have shuffled notes.

<span style="color:green">(v7.0)</span> '''Chest Appearance Matches Contents''' - These options change the appearance of chests depending on if they contain [https://wiki.ootrandomizer.com/index.php?title=Major_Items Major Items], keys, ice traps, or logically irrelevant items. If enabled, this also enables the ''Minor Items in Big/Gold Chests'' toggle.
* '''Off''' - Chests retain their regular form.
* '''Texture''' - Chests containing major items, small keys, boss keys, skulltula tokens, and <span style="color:green">(v8.0)</span> heart pieces/containers are all given unique textures. All other items will be placed in ordinary wooden chests. Chests will remain the same size as in the base game.
* '''Both Size and Texture''' - Chests containing major items, small keys, boss keys, skulltula tokens, and <span style="color:green">(v8.0)</span> heart pieces/containers are all given unique textures. Chests containing major items, boss keys, and ice traps are placed in large chests, while all other items are placed in small chests.
* '''Classic''' - Major items, boss keys, and ice traps appear in large chests. Small keys and all other items will appear in small treasure chests. All key chests will have the golden texture of boss key chests in vanilla. This option was available ''in versions 3.0 through 6.2'' under the name '''Chest Size Matches Contents'''.
<br>''Warning:'' Changing the sizes of chests will also affect the size of their collision which may render some chests difficult to hookshot as well as cause other unintended side-effects.

<span style="color:green">(v7.0)</span> '''Minor Items in Big/Gold Chests''' - This setting places deku shields, Hylian shields, and bombchus in major item style chests.

<span style="color:green">(v7.0)</span> '''Invisible Chests''' - This setting makes all chests invisible except when Lens of Truth is used. Does not affect logic so enable only if confident you can find the chests without Lens of Truth.

<span style="color:green">(v7.0)</span> '''Pot, Crate, & Beehive Appearance Matches Contents''' - This setting changes pot and crate textures based on the item inside. ''In version 7.0'', this setting was called ''Pot & Crate Appearance Matches Contents''.
* '''Texture (Match Content)''' - Pots and crates containing major items will have a gold texture, those with small keys will have a key on them, those with boss keys will have a variation of the boss key chest texture, those with gold skulltula tokens will have a spider web on them, and those with heart pieces/containers will have hearts on them. All other items will be placed in ordinary pots and crates. Once the item has been collected, the pot or crate texture will revert to the ordinary texture. Beehives containing any non-junk item will wiggle until the item is collected.
* '''Texture (Unchecked)''' - All pots and crates containing a shuffled item will have a gold texture, regardless of contents. Once the item has been collected, the pot or crate texture will revert to the ordinary texture. Beehives will wiggle until their item is collected.

<span style="color:green">(v8.0)</span> '''Key Appearance Matches Dungeon''' - Changes the appearance of small keys and boss keys to be distinct based on the dungeon in both color and design.

<span style="color:green">(v3.0)</span> '''Clearer Hints''' - This setting changes the text of Gossip Stone hints to be overwhelmingly explicit. This is helpful for players whose first language is not English, but the hints will be less “fun” and less similar to the original game.

<span style="color:green">(v1.0)</span> '''Gossip Stones''' - This setting allows the player to specify which item is required to interact with the Gossip Stones.
* <span style="color:green">(v3.0)</span> '''No Hints''' - Gossip Stones use vanilla behavior.
* <span style="color:green">(v3.0)</span> '''Hints; Need Mask of Truth''' - The Mask of Truth can only be obtained with all Spiritual Stones and only used as a child, which tends to make the hints less useful as they are inconvenient to view and only acessible later in the game.
* <span style="color:green">(v1.0)</span> '''Hints; Need Stone of Agony''' - 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.
* <span style="color:green">(v3.0)</span> '''Hints; Need Nothing''' - Gossip Stones will share hints without any requirements.

<span style="color:green">(v4.0)</span> '''Hint Distribution''' - This setting affects the number of useful hints available in the game.
* '''Balanced''' - Provides a mix of useless and useful hints. Hints will not be repeated.
* <span style="color:green">(v6.0)</span> '''Bingo''' - Intended to hint items required for squares on a bingo board generated on [https://bingosync.com/ Bingosync].
* <span style="color:green">(v7.0)</span> '''Chaos!!!''' - Any hint type may appear in the game. Each hint will have only one copy.
* <span style="color:green">(v7.0)</span> '''Chaos!!! (no goal hints)''' - Any hint type may appear in the game except for goal hints. Each hint will have only one copy.
* <span style="color:green">(v6.1)</span> '''Co-op''' - The hints used for the Season 2 Co-op Tournament races.
* <span style="color:green">(v6.1)</span> '''DDR''' - Hints most often used for races using the [DDR] ruleset.
* <span style="color:green">(v7.0)</span> '''League S3''' - The hints used by the OoTR League season 3. ''In previous versions, this setting matched the current season.''
* <span style="color:green">(v7.0)</span> '''MW Season 3''' - The hints used for the Season 3 Multi-world Tournament races. ''In previous versions, this setting matched the current season.''
* <span style="color:green">(v6.0)</span> '''Scrubs''' - The hints used for the [https://discord.gg/A9E5nYjN Scrub Central] races. This can also be used to simulate the OoTR Season 3 Tournament hints.
* '''Strong''' - Has some duplicate hints and no junk hints.
* '''Tournament''' - The hints used for the OoTR Season 6 Tournament. ''In previous versions, this setting matched the distribution used for the tournament active during that version's time.''
* '''Useless''' - Has nothing but junk hints.
* '''Very Strong''' - Has only very useful hints.
* <span style="color:green">(v7.0)</span> '''Very Strong with Magic''' - Has only very useful hints and adds Path of Magic hints. This setting is primarily used for No Logic seeds. Warning: Due to the addition of a path style hint while omitting all regular path hints, this setting is not compatible with the "All Goals" option under '''Guarantee Reachable Locations'''.
* <span style="color:green">(v7.0)</span> '''Weekly''' -

For detailed information on hints, check [[Hints|our hints page]].

<span style="color:green">(v7.0)</span> '''Misc. Hints''' - Select which hints not found on Gossip Stones are enabled.
* '''Temple of Time Altar''' - Reading the altar will reveal where the dungeon rewards are, the conditions to spawn the rainbow bridge, and the conditions to receive Ganon's boss key. Reading it as child will state the spiritual stone locations and reading it as adult will state the remaining hints. Note that the altar will only reveal the bridge and boss key conditions when ''Maps and Compasses Give Information'' is enabled.
* '''Dampé's Diary (Hookshot)''' - Reading the diary in the gravekeeper's hut as adult will hint an area containing one of the hookshots.
* '''Ganondorf (Light Arrows)''' - When talking to Ganondorf he will state an area that contains Light Arrows.
* <span style="color:green">(v8.0)</span> '''Warp Songs and Owls''' - Changes the text of the warp songs' Yes/No text box to state where it will actually take Link when ''Randomize warp Song Destinations'' is enabled, and change Kaepora Geobora's dialogue to specify where he will take Link from each location. In versions 7.0 and 7.1, setting was called '''Warp Songs''' and did not include Kaepora Gaebora.
* <span style="color:cornflowerblue">(Multiple Similar Settings)</span> '''House of Skulltula: X''' - These settings will cause the cursed skulltula children to say what item they will give as a reward for their specific token count.
* <span style="color:green">(v8.0)</span> '''Frogs Ocarina Game''' - The text that displays when Link stands on the log is changed to specify the item given for playing all top row songs and then playing the frog fly song.
* <span style="color:green">(v8.0)</span> '''Shuffled Mask Shop''' - When the mask shop is shuffled, the non-trade quest masks will display before completing the trade quests, but will remain unobtainable.
* <span style="color:green">(v8.0)</span> '''Unique Merchants''' - Characters that sell an item for the Shuffle Expensive Merchants setting and Shuffle Magic Beans setting will state the name of the item they sell.

<span style="color:green">(v3.0)</span> '''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 Important Text''' - Shuffle all text other than the useful text giving the player information. ''In versions 3.0 through 6.2'', this setting was called '''Shuffled except Hints and Keys'''.
* '''All Text Shuffled''' - Shuffle all text even to the player’s mechanical disadvantage.

<span style="color:green">(v4.0)</span> '''Damage Multiplier''' - This setting changes the amount of damage taken.
* '''Half''' - Link takes 1/2 damage.
* '''Normal''' - Link takes regular damage.
* '''Double''' - Link takes 2x damage.
* '''Quadruple''' - Link takes 4x damage.
* '''OHKO''' - Link dies in one hit. Nayru's Love and fairies are considered by logic.

''In version v3.0'', this was part of the '''Difficulty''' setting which mixed Item Pool and Damage Multiplier under the same setting.

<span style="color:green">(v7.0)</span> '''Bonks Do Damage''' - This setting causes Link to take damage for rolling into walls and objects. This setting is unaffected by the ''Damage Multiplier'' setting.
* '''No Damage''' - Link will not be hurt by rolling into anything.
* '''Quarter Heart''' - Rolling into walls and objects will deal one quarter of a heart of damage.
* '''Half Heart''' - Rolling into walls and objects will deal half a heart of damage.
* '''Whole Heart''' - Rolling into walls and objects will deal one heart of damage.
* '''Two Hearts''' - Rolling into walls and objects will deal two hearts of damage.
* '''One Bonk KO''' - Rolling into walls and objects will instantly kill Link. If ''Shuffle Crates'' is enabled and glitchless logic used, crates will expect access to explosives, Nayru's Love, or a bottle to hold a fairy in order to break the crates.

<span style="color:green">(v6.0)</span> '''Hero Mode''' - This setting prevents recovery hearts from dropping from enemies and objects. However if there are recovery hearts in the item pool, they will still appear in chests or on free standing items.

<span style="color:green">(v4.0)</span> '''Starting Time Of Day''' - Change up Link’s sleep routine by choosing what time Link wakes up at the start of the game.

<span style="color:green">(v7.0)</span> '''Blue Fire Arrows''' - Ice arrows have the blue fire damage type added to them. When enabled and glitchless logic is used, this can be an expected source of blue fire for red ice but not for mud walls (e.g. the start of Dodongo's Cavern). ''As of version 7.1'', the item will be called blue fire arrows by hint and shop text as well.

<span style="color:green">(v7.0)</span> '''Fix Broken Drops''' - Fixes pot contents which should have contained items in the vanilla game do not spawn because the item models are not loaded in the respective scenes. Adds a deku shield to the vanilla Spirit Temple room with the Anubis and a magic jar drop to Gerudo Training Ground on top of the eye statue.

=== Item Pool ===
These settings allow the player to tweak the item pool.

<span style="color:green">(v4.0)</span> '''Item Pool''' - This setting changes the amount of bonus items that are available in the game. This setting allows the player to tweak the item pool to make a somewhat harder or easier experience.
* <span style="color:green">(v7.0)</span> '''Ludicrous''' - Every randomized item will be a major item. As a result, this setting is incompatible with ''One Major Item per Dungeon''.
* '''Plentiful''' - Major items will have one more copy added to the item pool 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 Scarce, 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.

''In version v3.0'', this was part of the '''Difficulty''' setting which mixed Item Pool and Damage Multiplier under the same setting.

<span style="color:green">(v4.0)</span> '''Ice Traps''' - This setting changes how many ice traps are placed throughout the game.
* '''No Ice Traps''' - All ice traps are removed. ''In versions 4.0 through 6.2''', this setting was called '''Off'''.
* '''Normal Ice Traps''' - Only ice traps from base pool are placed. ''In versions 4.0 through 6.2''', this setting was called '''Normal'''.
* '''Extra Ice Traps''' - Chance to add extra ice traps when junk items are added to the item pool.
* '''Ice Trap Mayhem''' - All added junk items will be ice traps.
* '''Ice Trap Onslaught''' - All junk items will be ice traps, including ones in the base pool.

<span style="color:green">(v5.2)</span> '''Ice Trap Appearance''' - This setting changes the categories of items Ice Traps may appear as, both when freestanding and when in chests with Chest Size Matches Contents enabled.
* '''Major Items Only''' - Ice Traps appear as Major Items (and in large chests if CSMC enabled).
* '''Junk Items Only''' - Ice Traps appear as Junk Items (and in small chests if CSMC enabled).
* '''Anything''' - Ice Traps may appear as anything.

== Cosmetics ==
These options change graphical elements of various visuals in the game.

<span style="color:green">(v3.0)</span> '''Default Targeting Option''' - This setting specifies whether Z-targeting will default to “Switch” or “Hold” style. Either way, this can still be changed in-game as per usual.

<span style="color:green">(v4.0)</span> '''Display D-Pad HUD''' - Enable an additional HUD element to display the D-Pad once an item which can be controlled by the D-Pad is in Link's inventory.
* '''Off''' - The D-Pad will not be displayed.
* '''On the Right''' - The D-Pad will display just below the C buttons.
* <span style="color:green">(v8.0)</span> '''On the Left''' - The D-Pad will display below the hearts and magic meter.
''Prior to v8.0,'' this setting specified only whether the D-Pad HUD display should be shown and it was always on the right.

<span style="color:green">(v7.0)</span> '''Display D-Pad Dungeon Info''' - This setting enables separated menus for D-Pad directions left, down, and right, and displays the D-Pad HUD in the item menu to indicate what is viewable on each. Regardless of whether these menus are enabled or disabled, holding A on the item menu will still display the old style of the reference menu.

<span style="color:green">(v6.0)</span> '''Item Model Colors Match Cosmetics''' - This setting changes freestanding models of heart containers, gauntlets, mirror shield, and heart/magic drops to match their respective color settings. However freestanding tunics are not affected in order to keep them recognizable.

<span style="color:green">(v5.0)</span> '''Randomize All Cosmetics''' - This setting randomizes all of the cosmetic options every time a ROM is generated. Custom models are not included in this toggle.

<span style="color:green">(v8.0)</span> '''Uninvert Y-Axis in First Person Camera''' - This setting switch the first person camera controls for up and down.

=== Equipment ===
This changes the colors various equipment displays.

<span style="color:green">(v2.0)</span> <span style="color:cornflowerblue">(Multiple Similar Settings)</span> '''Tunic Colors''' - These settings determine the color of Link’s Tunics. This affects the color when he’s wearing it. As of <span style="color:green">(v5.2)</span> this also affects the color of the icon in the menu. Each tunic can be set individually.
*'''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. You can preview these colors using [https://docs.google.com/spreadsheets/d/1p9faND81NAFhlsZJs_icfn93etGtTQU8Sex4VZm6cLI/edit?usp=sharing this Google Docs page].
*'''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.
*'''Rainbow''' - The color will smoothly cycle through the entire range of hues.

<span style="color:green">(v5.0)</span> '''Silver Gauntlets Color''' - Sets the color the silver gauntlets appear. Contains the same options as Tunic Colors.

<span style="color:green">(v5.0)</span> '''Gold Gauntlets Color''' - Sets the color the gold gauntlets appear. Contains the same options as Tunic Colors.

<span style="color:green">(v6.0)</span> '''Mirror Shield Frame Color''' - Sets the color the edges and back of the Mirror Shield. Contains the same options as Tunic Colors.

=== UI Colors ===
<span style="color:green">(v5.0)</span> '''Heart Color''' - Sets the color of the hearts in the HUD. As of <span style="color:green">(v5.2)</span> this also affects the heart drops.

<span style="color:green">(v5.0)</span> '''Magic Color''' - Sets the color of the magic meter in the HUD. As of <span style="color:green">(v5.2)</span> this also affects the magic drops.

<span style="color:green">(v6.0)</span> <span style="color:cornflowerblue">(Multiple Similar Settings)</span> '''Button Color''' - Sets the color the specified button(s) in the HUD.

=== Misc. Colors ===
''Section was named Navi Colors prior to version 6.0.''

<span style="color:green">(v3.0)</span> <span style="color:cornflowerblue">(Multiple Similar Settings)</span> '''Navi''' - These settings determine 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. <span style="color:green">(v5.0)</span> You are able to choose the inner colors and outer colors separately, or have the outer color set based on the inner color.

<span style="color:green">(v6.0)</span> '''Bombchu Trail Inner''' & '''Outer''' - Sets the colors of the light trail behind a moving Bombchu.

<span style="color:green">(v6.0)</span> '''Boomerang Trail Inner''' & '''Outer''' - Sets the colors of the light trail behind a thrown boomerang.

<span style="color:green">(v4.0)</span> '''Sword Trail Inner''' & '''Outer''' - Sets the colors of the sword trail displayed when swinging a sword. ''Prior to v6.0'', these settings were part of Equipment Colors.

<span style="color:green">(v4.0)</span> '''Sword Trail Duration''' - Sets how long the sword trails should display when swinging a sword. ''Prior to v6.0'', this setting was part of '''Equipment Colors'''.

=== Player Models ===
<span style="color:green">(v7.0)</span> Replace Link's model with a custom model. Please see [https://wiki.ootrandomizer.com/index.php?title=Custom_Models this page] for more detail instructions to use this feature.
* <span style="color:green">(v7.0)</span> '''Adult Link Model''' - Replace the adult player model and items via a custom .zobj file.
* <span style="color:green">(v7.0)</span> '''Child Link Model''' - Replace the child player model and items via a custom .zobj file.

== SFX ==
Changes various audio cues in the game.

=== General ===

<span style="color:green">(v5.0)</span> '''Randomize All Sound Effects''' - This setting randomizes all of the SFX options every time a ROM is generated. Voices are not included in this toggle.

<span style="color:green">(v7.1)</span> '''Disable Battle Music''' - Background music will not change when near enemies, so the standard background music is not interrupted by the battle theme. ''In version 7.0'', this was under the General section.

<span style="color:green">(v8.0)</span> '''Speed Up Music For Last Triforce Piece''' - Background music plays faster when only one more Triforce Piece is needed to beat the game.

<span style="color:green">(v8.0)</span> '''Slow Down Music When Low HP''' - When Link has 1 heart or less remaining, the background music plays slower.

=== Music ===

<span style="color:green">(v4.0)</span> '''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.
*<span style="color:red">(Local only)</span> '''Random (Custom Only)''' - Shuffles the music provided in the data/Music folder as the background music and does not include any tracks from the base game.

<span style="color:green">(v5.0)</span> '''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. Enables the ''Ocarina Songs as Fanfares'' toggle.
*<span style="color:red">(Local only)</span> '''Random (Custom Only)''' - Shuffles the fanfares provided in the data/Music folder as the sounds and does not include any from the base game.

<span style="color:green">(v5.1)</span> '''Ocarina Songs as Fanfares''' - Add the longer Ocarina song fanfares to the pool of fanfares. Only present when fanfares are shuffled.

<span style="color:green">(v8.0)</span> '''Credits music as BGM''' - Adds the credits music to the background music pool when background music is shuffled.

=== Items ===

<span style="color:cornflowerblue">(Multiple Similar Settings)</span> These are the sound options available for most of the remaining SFX options.
*'''Particular Sounds''' - Select one of these sounds to know what sound the item will make. Specific sounds available differ between items. Several of these options are designed to be potentially more pleasant to listen to while a few are designed to be more amusing.
*'''Random Choice''' - Play a random SFX from the list of choices.
*'''None''' - Disable this item from making any sound at all.
*'''Completely Random''' - Play a random SFX from nearly the entire library of OoT's sound effects.
*<span style="color:green">(v4.0)</span> '''Random Ear-Safe''' - Attempts to choose a completely random sound that does not hurt your ears to listen to when used in this context.

<span style="color:green">(v4.0)</span> '''Ocarina''' - Select the sound the ocarina makes while playing notes. See [https://youtu.be/WeO7H-zV9Cg this video] to quickly hear all options.

<span style="color:green">(v4.0)</span> '''Hover Boots''' - Select the sound which plays while walking on nothing with Hover Boots equipped. ''As of v8.0,'' the sound no longer repeats over itself and will instead complete fully before beginning again.

<span style="color:green">(v8.0)</span> '''Boomerang Throw''' - Select the sound that plays when the boomerang is in the air.

<span style="color:green">(v8.0)</span> '''Arrow Shot''' - Select the sound that plays when releasing a normal arrow.

<span style="color:green">(v8.0)</span> '''Magic Arrow Shot''' - Select the sound that play when releasing fire, ice, or light arrows.

<span style="color:green">(v8.0)</span> '''Bombchu''' - Select the sound that plays when releasing a Bombchu.

<span style="color:green">(v8.0)</span> '''Iron Boots''' - Select the sound that plays when walking in iron boots.

<span style="color:green">(v8.0)</span> '''Hookshot Chain''' - Select the sound that plays when the hookshot is extending and retracting.

<span style="color:green">(v8.0)</span> '''Slingshot Shot''' - Select the sound that plays when a the slingshot is fired.

<span style="color:green">(v8.0)</span> '''Bomb Explosion''' - Select the sound that plays when bombs explode.

=== Voices ===

<span style="color:green">(v7.0)</span> '''Adult Voice''' - Choose from the default voice, a feminine voice, no sounds, or a random choice.

<span style="color:green">(v7.0)</span> '''Child Voice''' - Choose from the default voice, a feminine voice, no sounds, or a random choice.

'''Navi Overworld''' - This setting changes 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 setting changes the SFX that will play when Navi targets an enemy. The options are very similar to the Low Health SFX.

<span style="color:green">(v4.0)</span> '''Horse''' - Select the sound Epona makes.

<span style="color:green">(v8.0)</span> '''Cucco''' - Select the sound that cuccos make when picked up.

=== Misc Sound Effects ===

<span style="color:green">(v8.0)</span> '''Daybreak''' - Select the sound that plays when night switches to day.

<span style="color:green">(v4.0)</span> '''Nightfall''' - Select the sound that plays when day switches to night.

'''Menu Cursor''' - This setting changes the sound the menu cursor when moved.

'''Menu Select''' - This setting changes the sound the menu makes when you select an option.

<span style="color:green">(v2.0)</span> '''Low Health SFX''' - This determines which sound effect to play repeatedly when Link is very low on health.

<span style="color:green">(v8.0)</span> '''Silver Rupee Jingle''' - Select the sound that plays when collecting a silver rupee.

<span style="color:green">(v8.0)</span> '''Get Refill''' - Select the sound that plays when collecting a recovery heart, magic refill, or any type of ammo.

=== Custom Music and Fanfares ===
<span style="color:green">(v5.0)</span> 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 [https://github.com/sauraen/seq64 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 <code>data/Music</code> folder with the <code>.ootrs</code> extension.

On the website, you can select a single folder to randomize in through the filepicker or drag multiple directories onto the custom music field.

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. 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.

=== Custom Voices ===
<span style="color:green">(v7.0)</span> Additional voices can be created and used with the bundled or offline dev versions of the randomizer. See [https://docs.google.com/document/d/1Z3lJMURqCWPZzulMot_OMELgaODJKxs6CZGe_rP6WsE/edit?usp=sharing this document] for instructions.

== Command Line Options ==

Run with ootrandomizer.py:

<pre>-h, --help</pre>

Show the help message and exit.
<pre>--gui</pre>

Launch the GUI
<pre>--loglevel [{error,info,warning,debug}]</pre>

Select level of logging for output. (default: info)
<pre>--settings_string SETTINGS_STRING</pre>

Enter a settings string that will encode and override most individual settings.
<pre>--convert_settings</pre>

Only convert the specified settings to a settings string. If a settings string is specified output the used settings instead.
<pre>--settings SETTINGS</pre>

Use the specified settings file to use for generation
<pre>--seed SEED</pre>

Define seed number to generate. (default: None)
<pre>--no_log</pre>

Supresses the generation of a log file.
<pre>--output_settings</pre>

Always outputs a settings.json file even when spoiler is enabled.

== Plando Exclusive Features ==

<span style="color:green">(v6.1)</span>'''LACS Condition''' - If a plando is not used, the generator defaults this to the vanilla requirement of the Shadow and Spirit medallions. Otherwise, it may be set to a specified number of one of the following:
*Medallions
*Stones
*Dungeons
*Tokens

== Removed or Replaced Features ==
<span style="color:green">(v2.0)</span> <span style="color:red">Removed in 3.0</span> '''Skip most of Ganon's Castle''' - Disables all trials in Ganon's Castle, removes the lock on the boss door in Ganon's Castle, and skips the escape sequence after beating Ganondorf.

Replaced by separating it into Ganon's Trials Count, Remove Ganon's Boss Key, and Skip Tower Collapse Escape Sequence options.

<span style="color:green">(v3.0)</span> <span style="color:red">Removed in 4.0</span> '''Difficulty''' - Makes health less available and ammo expanisons.

Replaced by separate Item Pool and Damage Multiplier options.

<span style="color:green">(v3.0)</span> <span style="color:red">Removed in 5.0</span> <span style="color:green">Reinstated in v6.0</span> '''Open Kakariko Gate''' - The gate from Kakariko Village to Death Mountain Trail is always open.

Open Kakariko Gate was the result of fixing a vanilla bug - In vanilla, opening the gate shares a flag with pulling the Master Sword for the first time. This unintentionally causes the gate to open permanently (even if you haven't delivered Zelda's letter to the guard first), and leaves it open for both Child and Adult.

When this bug was fixed for rando, the result was the setting for Open Kakakiro Gate. This was intended to be the result of the fix, and was always scheduled for removal. However due to interest in the option, it was reinstated for version 6.0.

<span style="color:green">(v4.0)</span> <span style="color:red">Removed in 5.2</span> '''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.

Replaced by the Starting Items tab.

<span style="color:green">(v4.0)</span> <span style="color:red">Removed in 5.2</span> '''Start With Tycoon's Wallet''' - Start the game with the largest wallet which can hold 999 rupees.

Replaced by the Starting Items tab.

<span style="color:green">(v4.0)</span> <span style="color:red">Removed in 5.2</span> '''Start With Deku Equipment''' - Start the game with 10 Deku sticks and 20 Deku nuts. If shopsanity is off, also start with Deku Shield.

Replaced by the Starting Items tab and the Start with Consumables option.

<span style="color:green">(v5.0)</span> <span style="color:red">Removed in 6.0</span> '''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.

Replaced by seven independent settings.

<span style="color:green">(v3.0)</span> <span style="color:red">Removed in 6.0</span> '''Shuffle Songs with Items''' - This setting adds the 12 standard ocarina songs to the shuffle as normal items. 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 setting enabled, 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 child and then as an adult.

Replaced by Shuffle Songs options.

<span style="color:green">(v5.1)</span> <span style="color:red">Removed in 6.0</span> '''Skip First Dampe Race''' - Dampe will start on the second race so that both rewards can be obtained at the end of any race under a minute. The first reward is still obtainable if the race is completed over a minute.

Replaced by the Skip Some Minigame Phases option.

<span style="color:green">(v3.0)</span> <span style="color:red">Removed in 6.0</span> '''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 invisible objects except those required by the original game to obtain the Lens of Truth (i.e. Bottom of the Well).
* '''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.

Replaced by separated tricks for each area requiring Lens of Truth.

<span style="color:green">(v1.0)</span> <span style="color:red">Removed in 6.1</span> '''All Locations Reachable''' - This setting will set the logic to ensure Link can reach every item location in the game. 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.

Replaced by the Guarantee Reachable Locations option.

'''Ganon's Boss Key''' Option: <span style="color:red">Removed in 6.1</span>
* <span style="color:green">(v5.0)</span> '''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 (''Note that these sliders are not randomized by the '''Randomize Main Rules''' setting''):
** '''Vanilla''' - Shadow and Spirit Medallions.
** '''Stones''' - A number of Spiritual Stones, as specified by the slider. ''In v5.0'', this setting required all 3 Stones.
** '''Medallions''' - A number of Medallions, as specified by the slider. ''In v5.0'', this setting required all 36 Medallions.
** '''Dungeons''' - A number of dungeon rewards, as specified by the slider. Does not distinguish between stones and medallions. ''In v5.0'', this setting required all Stones and Medallions.
** <span style="color:green">(v6.0)</span> '''Tokens''' - A number of Gold Skulltula Tokens, as specified by the slider.

Replaced by individual settings not tied to the light arrow cutscene.

'''Output Type''' Option: <span style="color:red">Removed in 7.0</span>
* '''No Output''' - Does not create a ROM file. Generally used for generating spoiler logs for research, development, and statistical purposes.<p>''In versions v1.0 and 2.0'', this was named '''Do not create patched ROM'''.</p>
Rendered obsolete by the option change from radio buttons to toggles.

<span style="color:green">(v3.0)</span> <span style="color:red">Removed in 7.0</span> '''Random Number of MQ Dungeons''' - If set, a random number of dungeons will have Master Quest designs.
''In version v3.0'', this setting was the '''Mixed''' option for '''Dungeon Quest'''.

<span style="color:green">(v4.0)</span> <span style="color:red">Removed in 7.0</span> '''MQ Dungeon Count''' - Select the number of Master Quest dungeons to be included in the 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.

Replaced by the MQ Dungeons Mode options.

<span style="color:green">(v3.0)</span> <span style="color:red">Removed in 7.0</span> '''Shuffle Weird Egg''' - This setting adds the Weird Egg, given by child Malon, to the shuffle. With this setting enabled, 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, Saria in Sacred Forest Meadow, and the Happy Mask sidequest.

<span style="color:green">(v6.0)</span> <span style="color:red">Removed in 7.0</span> '''Skip Child Zelda''' - Skips the Weird Egg and the Hyrule Castle visit as child, which returns Malon and Talon to Lon Lon Ranch and grants Link Zelda's Letter and the song from Impa at the start of the game. Depending on the '''Kakariko Gate''' and '''Complete Mask Quest''' settings, this may also start with the gate/shop open and with masks available. This setting is incompatible with '''Shuffle Weird Egg''' and '''Skip Child Stealth''' since those segments are entirely skipped.

Replaced by the Shuffle Child Trade Item option.

<span style="color:green">(v3.0)</span> <span style="color:red">Removed in 7.0</span> '''Chest Size Matches Contents''' - This setting causes items flagged as progression, boss keys, and ice traps to appear as large treasure chests. Small keys and all other items will appear in small treasure chests. All key chests will have the golden texture of boss key chests in vanilla. This means the player can safely choose to skip small, wooden chests since they will only contain handy, but non-essential, items.
<br>''Warning:'' Changing the sizes of chests will also affect the size of their collision which may render some chests difficult to hookshot as well as cause other unintended side-effects.

Replaced by Chest Appearance Matches Contents.

<span style="color:green">(v3.0)</span> <span style="color:red">Removed in 7.0</span> '''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.

Replaced by Adult Trade Sequence Items.

<span style="color:green">(v3.0)</span> <span style="color:red">Removed in 8.0</span> '''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 contain 20 Bombchus and subsequent packs will contain 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. Finding a Bomb Bag is the condition to play Bombchu Bowling and buy Bombchus from shops which do not have their inventories edited (i.e. Shopsanity).

Replaced by Add Bombchu Bag and Drops.

<span style="color:green">(v7.0)</span> <span style="color:red">Removed in 8.0</span> '''Shuffle Child Trade Item''' - Changes the beginning item for the child trade quest and how it is obtained.
* '''Vanilla Locations''' - Malon will have the Weird Egg and the trade quest will proceed as normal.
* '''Shuffle Weird Egg''' - Weird Egg must be found to begin the trade quest. Malon will have a randomized item.
* '''Skip Child Zelda''' - Game will begin with Zelda's Letter in the inventory and Malon will have returned to the ranch.

Replaced by Shuffled Child Trade Sequence Items.

Logic

2024-03-01T16:47:03Z

Flagrama: move the paragraph up

'''“My Seed Is Broken!” (Glitchless Logic)''' - Solutions to completing randomized runs of ''Ocarina of Time'' can sometimes be unintuitive. While your seed may appear to be unbeatable, this isn’t often the case. Thanks to the diligent efforts of the developers, OoTR’s logic is incredibly robust. Listed below are some common sources of confusion, grouped by location. If you don’t mind spoiling the rest of the playthrough, instructions to finding your next step will be listed [[#Knowing_the_Way_with_the_Spoiler_Log|here]].

If you were linked here for one of the other Ocarina of Time Randomizer projects, note first that not all of this page will be accurate to that project. As well, if you get stuck you should ask in that project's Discord to get the most accurate and up-to-date help as each one is different enough people more familiar with other projects will only be able guess at how to help you.

If you follow these steps and still need help, you’re welcome to ask for support in the {{discord|gameplay-and-tricks}} channel of the {{discord}}. Please provide the seed and setting string along with any important details about the issue. If it turns out there is indeed a logical flaw, kind members of our team will report issues from there.

{{TOClimit|1}}

= Other Logic Pages =
This page of the Wiki is for Glitchless Logic; for more information on Glitched and Entrance Randomizer Logic, please view the [[Glitched_Logic|Glitched]] and [[Entrance_Randomizer|Entrance Randomizer]] pages of the Wiki.

The logical item requirements for each dungeon are also available on the [[Vanilla_Dungeon_Requirements | Vanilla]] and [[Master_Quest_Dungeon_Requirements | Master Quest]] dungeon requirements pages.

It is also to document unusual logic that is '''absolutely required''' know in a seed to finish most randomizer seeds. Anyone who wish to contribute to the randomizer by adding features with logical requirements will likely need to be familiar with the logic on a deeper level. The [[Advanced Logic]] page will provide a better explanation of some of the more difficult to comprehend, but unnecessary to know by heart, logic quirks.

= Vanilla Help =
For a quick refresher regarding the most basic aspects of Ocarina of Time, see these [https://strategywiki.org/wiki/The_Legend_of_Zelda:_Ocarina_of_Time/Getting_Started getting Started pages for Ocarina of Time].

For players who have not played randomizer before, it is strongly recommended to play the original game (i.e. vanilla) before attempting a randomizer seed. Strategy guides such as those from [https://strategywiki.org/wiki/The_Legend_of_Zelda:_Ocarina_of_Time/Table_of_Contents StrategyWiki] and [https://www.zeldadungeon.net/ocarina-of-time-walkthrough/ Zelda Dungeon] can be very helpful. Video guides are also available, the user [https://www.youtube.com/user/ScarecrowScythe Krow's Graveyard] has a playlist for [https://www.youtube.com/playlist?list=PLC4ADFACDF4946595 Vanilla Ocarina of Time] and [https://www.youtube.com/playlist?list=PLDgypNs3MY2Rd1jlYqNTWIfeLW7AiuoOK Master Quest Ocarina of Time]. Understanding how to beat vanilla is '''vital''' to beating a randomized seed.

For those who would prefer a quicker experience, [https://ootrandomizer.com/seed/vanilla Vanilla] and [https://ootrandomizer.com/seed/MQvanilla Master Quest] are available as randomizer seeds with all the QoL changes inherent to randomizer.



<div style="font-size:larger;">'''Spinning Pottery'''</div>
The spinning Goron Pot is activated by lighting the torches surrounding it. This can be accomplished by lighting sticks from Darunia's chamber OR by casting Din's Fire.
The Spinning Pot has 3 faces - Happy, Neutral, and Mad. The Happy face will always give a randomized reward. If freestanding Rupees & hearts are also shuffled, then each face will give 3 randomized rewards.

<div style="font-size:larger;">'''Scarecrow’s Song'''</div>
Link must teach it to Bonooru (the scarecrow nearer the lake) as a child and then remind him again as an adult. The song cannot be all the same note; many alternate between two notes for simplicity.

<div style="font-size:larger;">'''Save Quits'''</div>
Saving and quitting, then reloading the game, inside dungeons will send you back to the beginning of the dungeon. If you get stuck somewhere without a warp song, you can save and quit outside the dungeon. Even if you have a warp song, certain locations like Dampe's Grave and Windmill don't let you warp and require you to save and quit if you get stuck. Reloading the game will return Link to the Temple of Time (if adult) or Link's house (if child).

<div style="font-size:larger;">'''Opening Grottos without Bombs'''</div>
Any grotto which can be opened with Bombs can also be opened with Hammer. However some grottos open when the Song of Storms is played and not with explosives.

= Misunderstood Vanilla Mechanics =
A lot of randomizer uses the vanilla requirements to do certain things. It just so happens that vanilla takes logic shortcuts in some locations because it's impossible to do some events before others. Meanwhile other events have requirements which do not come up in ordinary play. These are the most common issues people have starting randomizer after vanilla.

<div style="font-size:larger;">'''Open the Door of Time'''</div>
Play the Song of Time while standing in front of the pedestal. The only requirements are a '''Fairy Ocarina''' and the '''Song of Time'''. The Spiritual Stones are '''not''' required, and the Ocarina of Time is also '''not''' required.

<div style="font-size:larger;">'''Skull Kid Ignores the Skull Mask'''</div>
Skull Kid must be befriended with Saria's Song before he will buy the Skull Mask. This is '''not''' required for the Skull Mask check- that is done by showing the Skull Mask to the Deku Scrubs inside the Lost Woods Theater.

<div style="font-size:larger;">'''Saria Missing from Sacred Forest Meadow'''</div>
Link must have Zelda's Letter or later in the child trade sequence before Saria arrives to teach her song. This means finding the Weird Egg, waking Talon, and visiting Zelda first.

<div style="font-size:larger;">'''Ocarina of Time and Song of Time Cutscenes'''</div>
This is the Zelda & Impa's escape cutscene initiated by approaching the Castle Town draw bridge as a child. Link must have all 3 Spiritual Stones before approaching the draw bridge, Zora's Sapphire alone is not enough.

<div style="font-size:larger;">'''Can't Find the Running Man'''</div>
Link must possess all 3 Spiritual Stones before the Running Man appears in Hyrule Field. Zora's Sapphire alone is not enough.

<div style="font-size:larger;">'''Big Poe Hunt'''</div>
Without Epona, there is a 2/5 (40%) chance of a Big Poe spawning while passing their spawn areas. While on Epona, there is a 100% chance that the poe that spawns will be a Big Poe. Due to this, default logic does '''not''' expect hunting Big Poes without Epona. However, logic may expect them to be found as the random contents of bottles if the Big Poe Count setting is low enough.

<div style="font-size:larger;">'''Burning Village/Nocturne of Shadow Cutscene'''</div>
Link must have the <span style="color: green">Forest</span>, <span style="color: crimson">Fire</span>, and <span style="color: blue">Water</span> Medallions and then enter Kakariko Village as Adult. In vanilla Ocarina of Time you must enter from Hyrule Field, but in the randomizer it has been changed to entering from any entrance.

<div style="font-size:larger;">'''Castle Town Shooting Gallery'''</div>
Even though the Kakariko Shooting Gallery requires the bow for the special prize, you do not need to have the slingshot for the Castle Town Shooting Gallery's special prize.

<div style="font-size:larger;">'''Kakariko Shooting Gallery Gives 50 Rupees'''</div>
The Fairy Bow/Quiver is required to win the special prize, otherwise you will receive 50 rupees.

<div style="font-size:larger;">'''Requiem of Spirit'''</div>
The song typically acquired by leaving Spirit Temple as an adult can be collected as a child too. Exiting Spirit Temple is the vanilla requirement, since outside sequence breaks child would never reach the Colossus before adult.

In Entrance Randomizer, exit whichever dungeon is placed at Desert Colossus.

<div style="font-size:larger;">'''Zelda Light Arrow Cutscene'''</div>
Enter the Temple of Time as adult with the Shadow and Spirit medallions to receive this item check. Make sure you don't save and reset after entering the Temple of Time and before obtaining the item, [https://wiki.ootrandomizer.com/index.php?title=Common_Softlocks_And_Crashes or you could get locked out of it entirely].

= Vanilla Mechanics Changed by Randomizer =
Randomizer has also changed some vanilla mechanics in an attempt to make randomization of certain elements more valuable. Those ''very'' familiar with Ocarina of Time may want to take note of the following differences.

<div style="font-size:larger;">'''Ocarina Memory Game'''</div>
Randomizer changed this mini-game to only require completing the 5 note version of the game to obtain the item. The mini-game does not need to be done a second time.

<div style="font-size:larger;">'''Malon or Talon Missing from Ranch'''</div>
Malon and Talon normally appear in Lon Lon Ranch after speaking to Zelda and receiving Zelda's Letter. Due to Weird Egg being able to be shuffled some changes have had to be made to this to avoid softlocks. Waking Talon up at Hyrule Castle with the Cucco from the Weird Egg and obtaining Zelda's Letter will have him appear at the ranch. If the Weird Egg is not shuffled, Malon will also appear at the ranch after this. If Weird Egg is shuffled, she will not appear at the ranch until Link speaks to her at Hyrule Castle and receives an item from her.

<div style="font-size:larger;">'''Dampe's Heart-Pounding Gravedigging Tour'''</div>
Dampe no longer requires a random number of attempts and will instead dig up the Heart Piece on the first attempt. He doesn't even need to be over a dirt patch.

There is a bug in vanilla where if Link leaves the area before picking up the Heart Piece it is lost forever. The randomizer has ''mostly'' resolved this issue. Don't die before picking up the Heart Piece because this seems to do the same thing the vanilla bug does and isn't handled properly by the randomizer yet.

<div style="font-size:larger;">'''Sheik at Temple'''</div>
The Sheik cutscene at the Master Sword pedestal to obtain Prelude of Light has been changed from beating Forest Temple to obtaining the Forest Medallion. Once Link has the Forest Medallion, approaching the pedestal as adult either from the door of time, or from pulling the sword out as child will give you the reward.

<div style="font-size:larger;">'''Sheik in Ice Cavern'''</div>
The Sheik cutscene in Ice cavern to obtain Serenade of Water can be triggered as either age in OoTR instead of as adult only.

<div style="font-size:larger;">'''Fishing Pond'''</div>
The fishing reward minimums were lowered so an 8 pound fish is required as Child and a 10 pound fish is required as Adult. However, the lure must still be in deep enough water to cause the fish to bite.

<div style="font-size:larger;">'''Biggoron's Claim Check'''</div>
Biggoron no longer requires three days between giving him the eyedrops and claim check. The claim check can now be immediately returned to Biggoron for a randomized item.

<div style="font-size:larger;">'''Bombchu Bowling'''</div>
Randomizer changed this mini-game so that the two randomized prizes are always the first two prizes offered by the lady- if you lose the game, leave and re-enter to reset the prize order. The requirements for unlocking this check have also been changed- if bombchus are in logic, then finding a bombchu pack is required, otherwise a bomb bag is required if bombchus are not in logic.

== Forest ==
This section covers the following areas '''Kokiri Forest''', '''The Lost Woods''', and '''The Sacred Forest Meadow'''.

<div style="font-size:largest;">'''Closed Forest'''</div>
When the "Closed Forest" setting is active, Link is expected to stay in the aforementioned areas until beating Gohma in the Great Deku Tree. Do not leave these areas, even if there is a bomb bag, silver scale, or ocarina and a warp song. The Kokiri Sword will be in one of these forest areas and the shop will have a repeatably purchasable Deku Shield, even with Shopsanity active.

<div style="font-size:larger;">'''Slingshot'''</div>
If Closed Forest is enabled a Slingshot will always be found somewhere in '''Kokiri Forest''', '''The Lost Woods''', '''The Sacred Forest Meadow''' or '''[[#Inside the Deku Tree|The Great Deku Tree]]'''.

<div style="font-size:larger;">'''Hidden Grottos'''</div>
Hidden grottos in these areas can be required, especially with the Closed Forest setting enabled. The Stone of Agony must be found before logic can expect these locations, provided the trick that removes the SoA requirement is not enabled.

<div style="font-size:larger;">'''Tokensanity'''</div>
With Tokensanity enabled the three dirt patch Skulltulas can be required, especially if the Closed Forest setting is enabled. In the Lost Woods, jump slashing the bushes outside of the Goron City warp with a stick will release bugs which can be caught in a bottle and used on the dirt patches. Since the sword could be in a dirt patch, keep this in mind.

== Kakariko Village ==

<div style="font-size:larger;">'''Rear Entrance to Impa's House as Child'''</div>
Take a cucco to the incomplete building. Toss it onto the top of the pile of bricks and climb up after it. Once on top of the pile of bricks with the cucco, pick it up and fly across to the Scaffolding. From here follow behind the carpenter to reach a good position to jump towards the entrance above the chicken coop.

<div style="font-size:larger;">'''Reach Rooftops without Longshot'''</div>
It's possible to get on the important rooftops with only Hookshot. Get a little closer and try again.

<div style="font-size:larger;">'''Draining Kakariko Well'''</div>
Play the Song of Storms to the Windmill Operator as a child.

*Project 64 will have this issue if not configured correctly. Be sure you have followed the instructions in [[Project64]] if you run into it: ''Draining the well at night can crash the game; attempting it during the day is less likely to cause this crash.''

<div style="font-size:larger;">'''Freestanding PoH in Windmill'''</div>
The freestanding heart piece in the windmill doesn't always expect an ocarina or the Song of Time. Use the boomerang to grab the item here or, if the trick is enabled, [https://www.youtube.com/watch?v=vDl7lr4Ecv8| reach it as adult with no other items required].

== Death Mountain Trail ==

<div style="font-size:larger;">'''Freestanding Piece of Heart above Dodongo's Cavern'''</div>
If you're a child and you don't have the Goron's Bracelet, you can still backflip onto the ledge from where the bomb flower is by angling it correctly and backflipping from outside the grab range. Using C-Up will help. If you're an adult, the bomb flower isn't there.

<div style="font-size:larger;">'''Death Mountain Summit As Child Without Hylian Shield'''</div>
If you're a child and you don't have the Hylian Shield, you can still make your way up to the summit of Death Mountain Trail. The falling rocks can be avoided by holding Z and walking backwards, or by using invincibility frames while rolling to prevent damage when they hit you.

== Goron City ==

<div style="font-size:larger;">'''Reach Goron City from Lost Woods without Bombs'''</div>
Ignite the Bomb Flowers behind the boulders using Din’s Fire. Alternatively, if Adult Link destroys the boulders with Hammer, Strength, or Bow they'll be destroyed in the past so Child Link can enter.

<div style="font-size:larger;">'''Get Large Rolling Goron to Relinquish Goods'''</div>
Bomb the Goron in the dark tunnel near the sign (Bomb/Bombchu).

''In version 4.0 and older the Large Rolling Goron also requires Link to have a Bomb Bag''

<div style="font-size:larger;">'''Boulder Maze without Bombs or Hammer'''</div>
Silver Guantlets are effective at clearing a path to each of the chests in the room. This will take some time, however.

<div style="font-size:larger;">'''Reaching the Grotto'''</div>
This grotto is adult only, and contains three business scrubs. Requirements to reach this grotto are as follows: Goron Tunic + Hookshot, or Ocarina + Song of Time, or Nayru's Love + Hookshot. If one-hit KO or 4x damage is on, then the glitchless logical requirements are either Ocarina + Song of Time + Goron Tunic/Longshot/Nayru's Love, or Nayru's Love + Hookshot. Further explanation [[Grottos#Goron_City:_1_Grotto|here]].

== Death Mountain Crater ==

<div style="font-size:larger;">'''Reach the lower Exit'''</div>
From the top of the tall ladder, use the Hover Boots to hover over the boulder blocking the shortcut to Goron City (lower exit). Hover Boots can also be used at the bottom of the ladder to bypass the Boulder.

<div style="font-size:larger;">'''Reach the Bottom Area for Bolero of Fire and Access to Fire Temple'''</div>
Use Hover Boots to cross the dilapidated bridge to reach the Warp Platform & Fire Temple.

Alternatively, reach this bottom area with the Longshot by jumping from the upper area onto the lava platforms below and shooting a wooden plank to pull Link across the pool of lava.

== Zora’s Domain ==

<div style="font-size:larger;">'''Access with Silver Scale'''</div>
Silver Scale allows access to Zora's Domain as child from Lake Hylia.

<div style="font-size:larger;">'''Need Blue Fire to Unfreeze King Zora/Zora Shop'''</div>
In Ganon’s Castle, Blue Fire can be found in Water Trial. Blue Fire may also be a purchasable item for 300 rupees in shops.

== Lake Hylia ==

<div style="font-size:larger;">'''Go fishing'''</div>
The fishing man rewards an 8 pound fish as a Child and a 10 pound fish as an Adult. Make sure to toss the lure in deep enough water to entice fish to bite. There's a minimum depth required for the mini-game to work. Tossing the Lure in very shallow water may cause the fish may swim around the Lure but never bite.

<div style="font-size:larger;">'''Lake Hylia - Shooting the Sun with an Arrow'''</div>
The tall rectangle island can be reached without filling the lake by using Scarecrow's Song and Longshot. You may not need to complete the Water Temple and raise the water level at Lake Hylia to acquire the item. The arrow must be fired at the sun during the early morning as per the written instructions on the stone platform.

== Gerudo Fortress/Gerudo Valley ==

<div style="font-size:larger;">'''Traversing the Gerudo Valley Broken Bridge'''</div>
Cross the Broken Bridge as an Adult by using either Epona to jump it or using the Longshot on the sign above the gate on the other side.

<div style="font-size:larger;">'''Entering Gerudo Training Grounds without Being Captured'''</div>
Link must have the Gerudo Membership Card and also rescue all of the Carpenters that have been captured. If the Gerudo Membership Card is shuffled, then only the card is needed and the Carpenters do not need to be rescued to access the area.

<div style="font-size:larger;">'''Getting Caught without a Hookshot'''</div>
If caught by a Gerudo Guard, either inside during combat or outside by being seen, without a Hookshot, Link will be thrown into the valley outside the tent, rather than into the jail cell from which Link could not escape.

<div style="font-size:larger;">'''Horse Archery NPC is Missing or Won't Initiate the Mini-game'''</div>
This mini-game requires the Fairy Bow, Epona, and the Gerudo Membership Card. It must also be day time.

<div style="font-size:larger;">'''Fortress Rooftop Chest without Longshot'''</div>
The chest can be reached from the top with the Hover Boots or by spawning a scarecrow and using the Hookshot. You'll have to stand close to the edge of the top level for the Hookshot to reach. Note that you won't see the Hookshot's red dot on the scarecrow.

== Haunted Wasteland ==

<div style="font-size:larger;">'''Bombchu Salesman'''</div>
As an adult, jump off the edge and use a jump-slash to land on the carpet. If the trick "Reverse Haunted Wasteland" or "Wasteland Crossing" is activated you may also have to do this as child. Either a Deku Stick or sword will work.

== Inside the Deku Tree ==

<div style="font-size:larger;">'''Access F3 without Slingshot'''</div>
The slingshot is not required to get to the top floor of the Deku Tree. In fact, in Master Quest Link doesn't get the slingshot until climbing all the way up the tree in the first place. Skulltulas don't rush Link when he is not moving. Sneak past them while they are looking away.

<div style="font-size:larger;">'''Two Chests in Slingshot Room'''</div>
In vanilla Deku Tree there are two chests in the Slingshot room. The first is the obvious one that has the slingshot, but there are climbable vines on the wall to the left of it which lead to a second chest.

== Dodongo's Cavern ==

<div style="font-size:larger;">'''Gold Skulltula on top of the Sinking Staircase'''</div>
Progress through the right side of the dungeon and hit the switch that makes the platforms in the entrance room rise higher, then leave the dungeon and re-enter it, progress through the dungeon backwards by taking the right platform in the entrance room to the top floor and going through the door on the upper level. This will grant you access to vines on the side of the stairs before the stairs have been lowered by the bomb blasts.

== Inside Jabu-Jabu's Belly ==

<div style="font-size:larger;">'''First Switch'''</div>
The switch on the ceiling in the first room of Jabu Jabu's Belly can be hit using explosives.

== Forest Temple ==

<div style="font-size:larger;">'''Get Outside without Song of Time or Bow'''</div>
With Hover Boots, float to the door connecting the large block-pushing room with the courtyard.

<div style="font-size:larger;">'''Cross to the Other Courtyard via Well'''</div>
With Gold Scale or Iron Boots, Link can cross from one courtyard to the other through the well.

<div style="font-size:larger;">'''Can’t Push Large Colored Blocks as Adult'''</div>
In the Forest Temple, the Goron’s Bracelet is required to push these blocks, even as adult. Link only put on gauntlets to keep his hands from drying out.

<div style="font-size:larger;">'''Triggering the Frozen Eye Switch without Bow'''</div>
Use Din's Fire from the platform below the frozen eye switch to activate it.

== MQ Forest Temple ==

<div style="font-size:larger;">'''Get Outside with just Hover Boots'''</div>
The western courtyard can be reached from the room with the block-push puzzle by hovering towards the crystal switch behind the transparent wall and then jump slashing to hit the switch from the other side. This will remove the transparent wall, allowing you to hover to this door leading to the courtyard. The ledge from which you'll want to hover is behind the first blocks, but if you lack strength then this ledge can also be hovered to from where you end up after climbing the second ladder. If you have trouble making these hovers, then try rolling for extra distance.

== Fire Temple ==

<div style="font-size:larger;">'''Can’t Push Large Colored Blocks as Adult'''</div>
In the Fire Temple, the Goron’s Bracelet is required to push these blocks, even as adult. Link only put on gauntlets to keep his hands from drying out.

<div style="font-size:larger;">'''Reach Volvagia without Hammer'''</div>
With Hover Boots equipped, it’s a simple matter of floating over to the boss door. That said, the Hammer is still required to defeat the boss.

<div style="font-size:larger;">'''Skip the Topmost Locked Door'''</div>
Similarly to Volvagia, skip the topmost locked door by using Hover boots to float over to the pillar. Then use the Hammer to open the door leading to the Highest Goron and Hammer Chest.

<div style="font-size:larger;">'''Extra Key'''</div>
When key-sanity is disabled (that is, keys are in their own dungeon), the lock in the basement behind the hammer blocks is removed. This results in a spare key for this dungeon.

== MQ Ice Cavern ==

<div style="font-size:larger;">'''Hitting the Crystal Switches'''</div>

The pot at the entrance of the Ice Cavern is the only thing required to hit the first crystal switch.

For the crystal switch hanging from the ceiling, the pot in the previous room is the only thing required.

== Water Temple ==

<div style="font-size:larger;">'''Entering without Iron Boots'''</div>
The entryway is in logic with just longshot and gold scale. However, nothing inside Water Temple is in default logic without Iron Boots, except for beating Morpha and part of the Dark Link loop (Longshot chest, whirlpool river chest and the Gold Skulltula in the falling platforms room). Therefore this is only logically relevant in Entrance Randomizer or various Boss/Small Key settings. Nevertheless, there are [https://www.youtube.com/watch?v=4_3GPW8xVuo strats for getting most of the checks in Water Temple without Iron Boots].

<div style="font-size:larger;">'''Boss Key Chest without Bombs or Goron’s Bracelet'''</div>
Use the Hover Boots to reach the chest.

<div style="font-size:larger;">'''Getting Past the Timed Gate without Longshot'''</div>
After shooting the eye switch, cross the gap with Hover Boots.

<div style="font-size:larger;">'''Center Room Gold Skulltula without Longshot'''</div>
Cast Farore’s Wind inside the center room. Raise the water to its highest level and cast Farore's Wind again to return to the warp point. Swim to the surface to reach the Gold Skulltula. '''In versions 6.0 and newer''', this is no longer in default logic.

<div style="font-size:larger;">'''Extra Key'''</div>
The door leading to the highest water level changer is never locked in rando. This results in a spare key for this dungeon.

<div style="font-size:larger;">'''Can’t Raise the Water Level'''</div>
''This is only relevant prior to version 4.0 of randomizer''

With the water level lowered, jump down to the second level of the central structure. This may require savewarping to the beginning of the dungeon to reach. Use the Hookshot to climb onto the top level. With a well-spaced rolling jump you should be able to reach the ledge where you can raise the water to its highest level. This isn't required but it's a handy time saver.

== Shadow Temple ==

<div style="font-size:larger;">'''Crossing the First Gap without Hookshot'''</div>
Hoverboots will reach the other side. If you fall short, start from the wall to build up speed before leaving the ledge.

<div style="font-size:larger;">'''First Silver Rupee Room without Hookshot'''</div>
Reach raised platform in the corner of the room by using the Hover Boots from the nearby low wall.

<div style="font-size:larger;">'''Spike floor room without Longshot'''</div>
Backflip onto the chest spawned in the middle of the room. From there, use the Hookshot to reach the upper ledge.

<div style="font-size:larger;">'''Reach the Boat without Goron’s Bracelet'''</div>
Bypass pushing the large block by shooting the top of the ladder with a Hookshot.

<div style="font-size:larger;">'''Reach Bongo Bongo without the Fairy Bow'''</div>
Play the Scarecrow’s Song to summon Pierre. Use Longshot to get to the other side.

<div style="font-size:larger;">'''Go through the Wind Tunnel without Iron Boots'''</div>
Timing is key. Move when the fans stop. Tip: You can stand between the fans in the final section. There are lines in the floor that mark the safe zones.

== MQ Shadow Temple ==

<div style="font-size:larger;">'''Spike floor room without Longshot'''</div>
Backflip onto the chest spawned in the middle of the room. From there, use the Hookshot to reach the upper ledge. The Silver Rupees can be collected with just the Hookshot (and Hover Boots) since the Hookshot targets on the ceiling are just low enough for the Hookshot to reach them.

== Gerudo Training Ground ==

<div style="font-size:larger;">'''Lava room without Longshot'''</div>
The torch at the end of this room is in reach using only the Hookshot.

<div style="font-size:larger;">'''Timed Boulder Room without Longshot'''</div>
The target on the ceiling is just within range of the Hookshot when standing almost directly under it. A wallmaster can also lift Link into the rupee if it’s the last to be collected.

== Spirit Temple ==

<div style="font-size:larger;">'''Child Side Enemy Room'''</div>
In order to kill the Armos in this room, you're expected to have at least one of the following item combinations: Deku Sticks (jumpslashes can hit), Kokiri Sword, or Deku Nuts + Slingshot.

<div style="font-size:larger;">'''Lower Metal Bridge on Child Side without Boomerang'''</div>
You can just barely hit the switch with a well-placed slingshot shot. Alternatively, hit the crystal switch with a well-timed Bombchu placement in the opposite direction.

<div style="font-size:larger;">'''Map chest without Din’s Fire or Magic'''</div>
Child Link is perfectly capable of lighting the torches using only a Deku Stick.

<div style="font-size:larger;">'''Collect Silver Rupees in the Boulder Room without Hover Boots'''</div>
Reach the floating rupee by jumping into the boulder with a jump slash, or even without hitting the boulder with a properly timed jump slash.

<div style="font-size:larger;">'''Silver Gauntlets Chest from Adult Side using Longshot'''</div>
With a Longshot, shoot the chest opposite from the Mirror Shield chest to gain access to its contents and the end of child-side.

<div style="font-size:larger;">'''Boss Key Chest'''</div>
The Eye Switch can be accessed by hitting the fake door with something to make it fall over. You do not necessarily need to destroy the fake door.

== Inside Ganon’s Castle ==

<div style="font-size:larger;">'''Spirit Trial without Fire Arrows'''</div>
A precise shot of an arrow through the torch will burn the web to reveal the light.

<div style="font-size:larger;">'''Water Trial Blue Fire'''</div>
With your bridge requirement set to Open, Blue Fire can be brought from the Water Trial to thaw King Zora or, if you have shopsanity active, to open the Zora Shop as adult if inaccessible as child.

<div style="font-size:larger;">'''Shadow Trial First Chest without Hookshot and Fire Arrows'''</div>
Playing the Song of Time will spawn Song of Time blocks leading to the first chest. Hover boots will also work.

<div style="font-size:larger;">'''Shadow Trial (Second Chest or Trial Completion) without Fire Arrows'''</div>
There are 2 scenarios possible here, either with Hover Boots or with Din's Fire. Obviously, Link may have both, in which case either method will work.<br/>
With Hover Boots, Longshot the torch to the right as you enter. From there, Link can reach the Like-Like with the Longshot. Once to the middle platform, equip the Hover Boots and roll across the gap to the platform where the chest spawns. From here open the chest and finish the trial.<br/>
With Din's Fire as a fire source, do the same thing as with Hover Boots, but instead of going to the Like-Like immediately, cast Din's Fire first. This will spawn the glass platform to the chest platform so Link can jump across.

== MQ Inside Ganon's Castle ==

<div style="font-size:larger;">'''MQ Forest Trial'''</div>

Getting to the room where the Forest Crystal is only requires the Song of Time. While on the ledge that has the door leading to the Forest Crystal room, go to the edge of the corner near where the Blue Switch is and play the Song of Time. You do not need to be on the platform where the Beamos is.

<div style="font-size:larger;">'''MQ Shadow Trial Bomb Flower Chest'''</div>

For the Bomb Flower Chest, logic expects you to either use the Bow, Explosives, Strength, or Din's Fire to blow up the bomb flower. To get to the platform where the chest spawns, either the Hookshot or Hover Boots are required.

= Knowing the Way with the Spoiler Log =

The spoiler log contains information about your personally randomized copy of the game and can be very helpful when looking for important items you've missed. Please be aware that the Playthrough presented is intended to prove the seed is beatable in logic. It does not represent the only way to logically beat the seed. It takes only a few steps to find:

= How do I find my Spoiler Log? =
*[[Frequently_Asked_Questions#How_Do_I_Find_My_Spoiler_Log_Again.3F|How do I find my spoiler log again?]]

<div style="font-size:larger;">'''Versions 1.0 - 3.0 and Standalone Download'''</div>
Open the spoiler log generated in the same folder that the randomized ROM is located in. It should be formatted as <code>OoT_SETTINGSTR_SEED_Spoiler.txt</code>.

Logic

2024-03-01T16:45:58Z

Flagrama: little blurb added to mention going to the right discord for help

'''“My Seed Is Broken!” (Glitchless Logic)''' - Solutions to completing randomized runs of ''Ocarina of Time'' can sometimes be unintuitive. While your seed may appear to be unbeatable, this isn’t often the case. Thanks to the diligent efforts of the developers, OoTR’s logic is incredibly robust. Listed below are some common sources of confusion, grouped by location. If you don’t mind spoiling the rest of the playthrough, instructions to finding your next step will be listed [[#Knowing_the_Way_with_the_Spoiler_Log|here]].

If you follow these steps and still need help, you’re welcome to ask for support in the {{discord|gameplay-and-tricks}} channel of the {{discord}}. Please provide the seed and setting string along with any important details about the issue. If it turns out there is indeed a logical flaw, kind members of our team will report issues from there.

If you were linked here for one of the other Ocarina of Time Randomizer projects, note first that not all of this page will be accurate to that project. As well, if you get stuck you should ask in that project's Discord to get the most accurate and up-to-date help as each one is different enough people more familiar with other projects will only be able guess at how to help you.

{{TOClimit|1}}

= Other Logic Pages =
This page of the Wiki is for Glitchless Logic; for more information on Glitched and Entrance Randomizer Logic, please view the [[Glitched_Logic|Glitched]] and [[Entrance_Randomizer|Entrance Randomizer]] pages of the Wiki.

The logical item requirements for each dungeon are also available on the [[Vanilla_Dungeon_Requirements | Vanilla]] and [[Master_Quest_Dungeon_Requirements | Master Quest]] dungeon requirements pages.

It is also to document unusual logic that is '''absolutely required''' know in a seed to finish most randomizer seeds. Anyone who wish to contribute to the randomizer by adding features with logical requirements will likely need to be familiar with the logic on a deeper level. The [[Advanced Logic]] page will provide a better explanation of some of the more difficult to comprehend, but unnecessary to know by heart, logic quirks.

= Vanilla Help =
For a quick refresher regarding the most basic aspects of Ocarina of Time, see these [https://strategywiki.org/wiki/The_Legend_of_Zelda:_Ocarina_of_Time/Getting_Started getting Started pages for Ocarina of Time].

For players who have not played randomizer before, it is strongly recommended to play the original game (i.e. vanilla) before attempting a randomizer seed. Strategy guides such as those from [https://strategywiki.org/wiki/The_Legend_of_Zelda:_Ocarina_of_Time/Table_of_Contents StrategyWiki] and [https://www.zeldadungeon.net/ocarina-of-time-walkthrough/ Zelda Dungeon] can be very helpful. Video guides are also available, the user [https://www.youtube.com/user/ScarecrowScythe Krow's Graveyard] has a playlist for [https://www.youtube.com/playlist?list=PLC4ADFACDF4946595 Vanilla Ocarina of Time] and [https://www.youtube.com/playlist?list=PLDgypNs3MY2Rd1jlYqNTWIfeLW7AiuoOK Master Quest Ocarina of Time]. Understanding how to beat vanilla is '''vital''' to beating a randomized seed.

For those who would prefer a quicker experience, [https://ootrandomizer.com/seed/vanilla Vanilla] and [https://ootrandomizer.com/seed/MQvanilla Master Quest] are available as randomizer seeds with all the QoL changes inherent to randomizer.



<div style="font-size:larger;">'''Spinning Pottery'''</div>
The spinning Goron Pot is activated by lighting the torches surrounding it. This can be accomplished by lighting sticks from Darunia's chamber OR by casting Din's Fire.
The Spinning Pot has 3 faces - Happy, Neutral, and Mad. The Happy face will always give a randomized reward. If freestanding Rupees & hearts are also shuffled, then each face will give 3 randomized rewards.

<div style="font-size:larger;">'''Scarecrow’s Song'''</div>
Link must teach it to Bonooru (the scarecrow nearer the lake) as a child and then remind him again as an adult. The song cannot be all the same note; many alternate between two notes for simplicity.

<div style="font-size:larger;">'''Save Quits'''</div>
Saving and quitting, then reloading the game, inside dungeons will send you back to the beginning of the dungeon. If you get stuck somewhere without a warp song, you can save and quit outside the dungeon. Even if you have a warp song, certain locations like Dampe's Grave and Windmill don't let you warp and require you to save and quit if you get stuck. Reloading the game will return Link to the Temple of Time (if adult) or Link's house (if child).

<div style="font-size:larger;">'''Opening Grottos without Bombs'''</div>
Any grotto which can be opened with Bombs can also be opened with Hammer. However some grottos open when the Song of Storms is played and not with explosives.

= Misunderstood Vanilla Mechanics =
A lot of randomizer uses the vanilla requirements to do certain things. It just so happens that vanilla takes logic shortcuts in some locations because it's impossible to do some events before others. Meanwhile other events have requirements which do not come up in ordinary play. These are the most common issues people have starting randomizer after vanilla.

<div style="font-size:larger;">'''Open the Door of Time'''</div>
Play the Song of Time while standing in front of the pedestal. The only requirements are a '''Fairy Ocarina''' and the '''Song of Time'''. The Spiritual Stones are '''not''' required, and the Ocarina of Time is also '''not''' required.

<div style="font-size:larger;">'''Skull Kid Ignores the Skull Mask'''</div>
Skull Kid must be befriended with Saria's Song before he will buy the Skull Mask. This is '''not''' required for the Skull Mask check- that is done by showing the Skull Mask to the Deku Scrubs inside the Lost Woods Theater.

<div style="font-size:larger;">'''Saria Missing from Sacred Forest Meadow'''</div>
Link must have Zelda's Letter or later in the child trade sequence before Saria arrives to teach her song. This means finding the Weird Egg, waking Talon, and visiting Zelda first.

<div style="font-size:larger;">'''Ocarina of Time and Song of Time Cutscenes'''</div>
This is the Zelda & Impa's escape cutscene initiated by approaching the Castle Town draw bridge as a child. Link must have all 3 Spiritual Stones before approaching the draw bridge, Zora's Sapphire alone is not enough.

<div style="font-size:larger;">'''Can't Find the Running Man'''</div>
Link must possess all 3 Spiritual Stones before the Running Man appears in Hyrule Field. Zora's Sapphire alone is not enough.

<div style="font-size:larger;">'''Big Poe Hunt'''</div>
Without Epona, there is a 2/5 (40%) chance of a Big Poe spawning while passing their spawn areas. While on Epona, there is a 100% chance that the poe that spawns will be a Big Poe. Due to this, default logic does '''not''' expect hunting Big Poes without Epona. However, logic may expect them to be found as the random contents of bottles if the Big Poe Count setting is low enough.

<div style="font-size:larger;">'''Burning Village/Nocturne of Shadow Cutscene'''</div>
Link must have the <span style="color: green">Forest</span>, <span style="color: crimson">Fire</span>, and <span style="color: blue">Water</span> Medallions and then enter Kakariko Village as Adult. In vanilla Ocarina of Time you must enter from Hyrule Field, but in the randomizer it has been changed to entering from any entrance.

<div style="font-size:larger;">'''Castle Town Shooting Gallery'''</div>
Even though the Kakariko Shooting Gallery requires the bow for the special prize, you do not need to have the slingshot for the Castle Town Shooting Gallery's special prize.

<div style="font-size:larger;">'''Kakariko Shooting Gallery Gives 50 Rupees'''</div>
The Fairy Bow/Quiver is required to win the special prize, otherwise you will receive 50 rupees.

<div style="font-size:larger;">'''Requiem of Spirit'''</div>
The song typically acquired by leaving Spirit Temple as an adult can be collected as a child too. Exiting Spirit Temple is the vanilla requirement, since outside sequence breaks child would never reach the Colossus before adult.

In Entrance Randomizer, exit whichever dungeon is placed at Desert Colossus.

<div style="font-size:larger;">'''Zelda Light Arrow Cutscene'''</div>
Enter the Temple of Time as adult with the Shadow and Spirit medallions to receive this item check. Make sure you don't save and reset after entering the Temple of Time and before obtaining the item, [https://wiki.ootrandomizer.com/index.php?title=Common_Softlocks_And_Crashes or you could get locked out of it entirely].

= Vanilla Mechanics Changed by Randomizer =
Randomizer has also changed some vanilla mechanics in an attempt to make randomization of certain elements more valuable. Those ''very'' familiar with Ocarina of Time may want to take note of the following differences.

<div style="font-size:larger;">'''Ocarina Memory Game'''</div>
Randomizer changed this mini-game to only require completing the 5 note version of the game to obtain the item. The mini-game does not need to be done a second time.

<div style="font-size:larger;">'''Malon or Talon Missing from Ranch'''</div>
Malon and Talon normally appear in Lon Lon Ranch after speaking to Zelda and receiving Zelda's Letter. Due to Weird Egg being able to be shuffled some changes have had to be made to this to avoid softlocks. Waking Talon up at Hyrule Castle with the Cucco from the Weird Egg and obtaining Zelda's Letter will have him appear at the ranch. If the Weird Egg is not shuffled, Malon will also appear at the ranch after this. If Weird Egg is shuffled, she will not appear at the ranch until Link speaks to her at Hyrule Castle and receives an item from her.

<div style="font-size:larger;">'''Dampe's Heart-Pounding Gravedigging Tour'''</div>
Dampe no longer requires a random number of attempts and will instead dig up the Heart Piece on the first attempt. He doesn't even need to be over a dirt patch.

There is a bug in vanilla where if Link leaves the area before picking up the Heart Piece it is lost forever. The randomizer has ''mostly'' resolved this issue. Don't die before picking up the Heart Piece because this seems to do the same thing the vanilla bug does and isn't handled properly by the randomizer yet.

<div style="font-size:larger;">'''Sheik at Temple'''</div>
The Sheik cutscene at the Master Sword pedestal to obtain Prelude of Light has been changed from beating Forest Temple to obtaining the Forest Medallion. Once Link has the Forest Medallion, approaching the pedestal as adult either from the door of time, or from pulling the sword out as child will give you the reward.

<div style="font-size:larger;">'''Sheik in Ice Cavern'''</div>
The Sheik cutscene in Ice cavern to obtain Serenade of Water can be triggered as either age in OoTR instead of as adult only.

<div style="font-size:larger;">'''Fishing Pond'''</div>
The fishing reward minimums were lowered so an 8 pound fish is required as Child and a 10 pound fish is required as Adult. However, the lure must still be in deep enough water to cause the fish to bite.

<div style="font-size:larger;">'''Biggoron's Claim Check'''</div>
Biggoron no longer requires three days between giving him the eyedrops and claim check. The claim check can now be immediately returned to Biggoron for a randomized item.

<div style="font-size:larger;">'''Bombchu Bowling'''</div>
Randomizer changed this mini-game so that the two randomized prizes are always the first two prizes offered by the lady- if you lose the game, leave and re-enter to reset the prize order. The requirements for unlocking this check have also been changed- if bombchus are in logic, then finding a bombchu pack is required, otherwise a bomb bag is required if bombchus are not in logic.

== Forest ==
This section covers the following areas '''Kokiri Forest''', '''The Lost Woods''', and '''The Sacred Forest Meadow'''.

<div style="font-size:largest;">'''Closed Forest'''</div>
When the "Closed Forest" setting is active, Link is expected to stay in the aforementioned areas until beating Gohma in the Great Deku Tree. Do not leave these areas, even if there is a bomb bag, silver scale, or ocarina and a warp song. The Kokiri Sword will be in one of these forest areas and the shop will have a repeatably purchasable Deku Shield, even with Shopsanity active.

<div style="font-size:larger;">'''Slingshot'''</div>
If Closed Forest is enabled a Slingshot will always be found somewhere in '''Kokiri Forest''', '''The Lost Woods''', '''The Sacred Forest Meadow''' or '''[[#Inside the Deku Tree|The Great Deku Tree]]'''.

<div style="font-size:larger;">'''Hidden Grottos'''</div>
Hidden grottos in these areas can be required, especially with the Closed Forest setting enabled. The Stone of Agony must be found before logic can expect these locations, provided the trick that removes the SoA requirement is not enabled.

<div style="font-size:larger;">'''Tokensanity'''</div>
With Tokensanity enabled the three dirt patch Skulltulas can be required, especially if the Closed Forest setting is enabled. In the Lost Woods, jump slashing the bushes outside of the Goron City warp with a stick will release bugs which can be caught in a bottle and used on the dirt patches. Since the sword could be in a dirt patch, keep this in mind.

== Kakariko Village ==

<div style="font-size:larger;">'''Rear Entrance to Impa's House as Child'''</div>
Take a cucco to the incomplete building. Toss it onto the top of the pile of bricks and climb up after it. Once on top of the pile of bricks with the cucco, pick it up and fly across to the Scaffolding. From here follow behind the carpenter to reach a good position to jump towards the entrance above the chicken coop.

<div style="font-size:larger;">'''Reach Rooftops without Longshot'''</div>
It's possible to get on the important rooftops with only Hookshot. Get a little closer and try again.

<div style="font-size:larger;">'''Draining Kakariko Well'''</div>
Play the Song of Storms to the Windmill Operator as a child.

*Project 64 will have this issue if not configured correctly. Be sure you have followed the instructions in [[Project64]] if you run into it: ''Draining the well at night can crash the game; attempting it during the day is less likely to cause this crash.''

<div style="font-size:larger;">'''Freestanding PoH in Windmill'''</div>
The freestanding heart piece in the windmill doesn't always expect an ocarina or the Song of Time. Use the boomerang to grab the item here or, if the trick is enabled, [https://www.youtube.com/watch?v=vDl7lr4Ecv8| reach it as adult with no other items required].

== Death Mountain Trail ==

<div style="font-size:larger;">'''Freestanding Piece of Heart above Dodongo's Cavern'''</div>
If you're a child and you don't have the Goron's Bracelet, you can still backflip onto the ledge from where the bomb flower is by angling it correctly and backflipping from outside the grab range. Using C-Up will help. If you're an adult, the bomb flower isn't there.

<div style="font-size:larger;">'''Death Mountain Summit As Child Without Hylian Shield'''</div>
If you're a child and you don't have the Hylian Shield, you can still make your way up to the summit of Death Mountain Trail. The falling rocks can be avoided by holding Z and walking backwards, or by using invincibility frames while rolling to prevent damage when they hit you.

== Goron City ==

<div style="font-size:larger;">'''Reach Goron City from Lost Woods without Bombs'''</div>
Ignite the Bomb Flowers behind the boulders using Din’s Fire. Alternatively, if Adult Link destroys the boulders with Hammer, Strength, or Bow they'll be destroyed in the past so Child Link can enter.

<div style="font-size:larger;">'''Get Large Rolling Goron to Relinquish Goods'''</div>
Bomb the Goron in the dark tunnel near the sign (Bomb/Bombchu).

''In version 4.0 and older the Large Rolling Goron also requires Link to have a Bomb Bag''

<div style="font-size:larger;">'''Boulder Maze without Bombs or Hammer'''</div>
Silver Guantlets are effective at clearing a path to each of the chests in the room. This will take some time, however.

<div style="font-size:larger;">'''Reaching the Grotto'''</div>
This grotto is adult only, and contains three business scrubs. Requirements to reach this grotto are as follows: Goron Tunic + Hookshot, or Ocarina + Song of Time, or Nayru's Love + Hookshot. If one-hit KO or 4x damage is on, then the glitchless logical requirements are either Ocarina + Song of Time + Goron Tunic/Longshot/Nayru's Love, or Nayru's Love + Hookshot. Further explanation [[Grottos#Goron_City:_1_Grotto|here]].

== Death Mountain Crater ==

<div style="font-size:larger;">'''Reach the lower Exit'''</div>
From the top of the tall ladder, use the Hover Boots to hover over the boulder blocking the shortcut to Goron City (lower exit). Hover Boots can also be used at the bottom of the ladder to bypass the Boulder.

<div style="font-size:larger;">'''Reach the Bottom Area for Bolero of Fire and Access to Fire Temple'''</div>
Use Hover Boots to cross the dilapidated bridge to reach the Warp Platform & Fire Temple.

Alternatively, reach this bottom area with the Longshot by jumping from the upper area onto the lava platforms below and shooting a wooden plank to pull Link across the pool of lava.

== Zora’s Domain ==

<div style="font-size:larger;">'''Access with Silver Scale'''</div>
Silver Scale allows access to Zora's Domain as child from Lake Hylia.

<div style="font-size:larger;">'''Need Blue Fire to Unfreeze King Zora/Zora Shop'''</div>
In Ganon’s Castle, Blue Fire can be found in Water Trial. Blue Fire may also be a purchasable item for 300 rupees in shops.

== Lake Hylia ==

<div style="font-size:larger;">'''Go fishing'''</div>
The fishing man rewards an 8 pound fish as a Child and a 10 pound fish as an Adult. Make sure to toss the lure in deep enough water to entice fish to bite. There's a minimum depth required for the mini-game to work. Tossing the Lure in very shallow water may cause the fish may swim around the Lure but never bite.

<div style="font-size:larger;">'''Lake Hylia - Shooting the Sun with an Arrow'''</div>
The tall rectangle island can be reached without filling the lake by using Scarecrow's Song and Longshot. You may not need to complete the Water Temple and raise the water level at Lake Hylia to acquire the item. The arrow must be fired at the sun during the early morning as per the written instructions on the stone platform.

== Gerudo Fortress/Gerudo Valley ==

<div style="font-size:larger;">'''Traversing the Gerudo Valley Broken Bridge'''</div>
Cross the Broken Bridge as an Adult by using either Epona to jump it or using the Longshot on the sign above the gate on the other side.

<div style="font-size:larger;">'''Entering Gerudo Training Grounds without Being Captured'''</div>
Link must have the Gerudo Membership Card and also rescue all of the Carpenters that have been captured. If the Gerudo Membership Card is shuffled, then only the card is needed and the Carpenters do not need to be rescued to access the area.

<div style="font-size:larger;">'''Getting Caught without a Hookshot'''</div>
If caught by a Gerudo Guard, either inside during combat or outside by being seen, without a Hookshot, Link will be thrown into the valley outside the tent, rather than into the jail cell from which Link could not escape.

<div style="font-size:larger;">'''Horse Archery NPC is Missing or Won't Initiate the Mini-game'''</div>
This mini-game requires the Fairy Bow, Epona, and the Gerudo Membership Card. It must also be day time.

<div style="font-size:larger;">'''Fortress Rooftop Chest without Longshot'''</div>
The chest can be reached from the top with the Hover Boots or by spawning a scarecrow and using the Hookshot. You'll have to stand close to the edge of the top level for the Hookshot to reach. Note that you won't see the Hookshot's red dot on the scarecrow.

== Haunted Wasteland ==

<div style="font-size:larger;">'''Bombchu Salesman'''</div>
As an adult, jump off the edge and use a jump-slash to land on the carpet. If the trick "Reverse Haunted Wasteland" or "Wasteland Crossing" is activated you may also have to do this as child. Either a Deku Stick or sword will work.

== Inside the Deku Tree ==

<div style="font-size:larger;">'''Access F3 without Slingshot'''</div>
The slingshot is not required to get to the top floor of the Deku Tree. In fact, in Master Quest Link doesn't get the slingshot until climbing all the way up the tree in the first place. Skulltulas don't rush Link when he is not moving. Sneak past them while they are looking away.

<div style="font-size:larger;">'''Two Chests in Slingshot Room'''</div>
In vanilla Deku Tree there are two chests in the Slingshot room. The first is the obvious one that has the slingshot, but there are climbable vines on the wall to the left of it which lead to a second chest.

== Dodongo's Cavern ==

<div style="font-size:larger;">'''Gold Skulltula on top of the Sinking Staircase'''</div>
Progress through the right side of the dungeon and hit the switch that makes the platforms in the entrance room rise higher, then leave the dungeon and re-enter it, progress through the dungeon backwards by taking the right platform in the entrance room to the top floor and going through the door on the upper level. This will grant you access to vines on the side of the stairs before the stairs have been lowered by the bomb blasts.

== Inside Jabu-Jabu's Belly ==

<div style="font-size:larger;">'''First Switch'''</div>
The switch on the ceiling in the first room of Jabu Jabu's Belly can be hit using explosives.

== Forest Temple ==

<div style="font-size:larger;">'''Get Outside without Song of Time or Bow'''</div>
With Hover Boots, float to the door connecting the large block-pushing room with the courtyard.

<div style="font-size:larger;">'''Cross to the Other Courtyard via Well'''</div>
With Gold Scale or Iron Boots, Link can cross from one courtyard to the other through the well.

<div style="font-size:larger;">'''Can’t Push Large Colored Blocks as Adult'''</div>
In the Forest Temple, the Goron’s Bracelet is required to push these blocks, even as adult. Link only put on gauntlets to keep his hands from drying out.

<div style="font-size:larger;">'''Triggering the Frozen Eye Switch without Bow'''</div>
Use Din's Fire from the platform below the frozen eye switch to activate it.

== MQ Forest Temple ==

<div style="font-size:larger;">'''Get Outside with just Hover Boots'''</div>
The western courtyard can be reached from the room with the block-push puzzle by hovering towards the crystal switch behind the transparent wall and then jump slashing to hit the switch from the other side. This will remove the transparent wall, allowing you to hover to this door leading to the courtyard. The ledge from which you'll want to hover is behind the first blocks, but if you lack strength then this ledge can also be hovered to from where you end up after climbing the second ladder. If you have trouble making these hovers, then try rolling for extra distance.

== Fire Temple ==

<div style="font-size:larger;">'''Can’t Push Large Colored Blocks as Adult'''</div>
In the Fire Temple, the Goron’s Bracelet is required to push these blocks, even as adult. Link only put on gauntlets to keep his hands from drying out.

<div style="font-size:larger;">'''Reach Volvagia without Hammer'''</div>
With Hover Boots equipped, it’s a simple matter of floating over to the boss door. That said, the Hammer is still required to defeat the boss.

<div style="font-size:larger;">'''Skip the Topmost Locked Door'''</div>
Similarly to Volvagia, skip the topmost locked door by using Hover boots to float over to the pillar. Then use the Hammer to open the door leading to the Highest Goron and Hammer Chest.

<div style="font-size:larger;">'''Extra Key'''</div>
When key-sanity is disabled (that is, keys are in their own dungeon), the lock in the basement behind the hammer blocks is removed. This results in a spare key for this dungeon.

== MQ Ice Cavern ==

<div style="font-size:larger;">'''Hitting the Crystal Switches'''</div>

The pot at the entrance of the Ice Cavern is the only thing required to hit the first crystal switch.

For the crystal switch hanging from the ceiling, the pot in the previous room is the only thing required.

== Water Temple ==

<div style="font-size:larger;">'''Entering without Iron Boots'''</div>
The entryway is in logic with just longshot and gold scale. However, nothing inside Water Temple is in default logic without Iron Boots, except for beating Morpha and part of the Dark Link loop (Longshot chest, whirlpool river chest and the Gold Skulltula in the falling platforms room). Therefore this is only logically relevant in Entrance Randomizer or various Boss/Small Key settings. Nevertheless, there are [https://www.youtube.com/watch?v=4_3GPW8xVuo strats for getting most of the checks in Water Temple without Iron Boots].

<div style="font-size:larger;">'''Boss Key Chest without Bombs or Goron’s Bracelet'''</div>
Use the Hover Boots to reach the chest.

<div style="font-size:larger;">'''Getting Past the Timed Gate without Longshot'''</div>
After shooting the eye switch, cross the gap with Hover Boots.

<div style="font-size:larger;">'''Center Room Gold Skulltula without Longshot'''</div>
Cast Farore’s Wind inside the center room. Raise the water to its highest level and cast Farore's Wind again to return to the warp point. Swim to the surface to reach the Gold Skulltula. '''In versions 6.0 and newer''', this is no longer in default logic.

<div style="font-size:larger;">'''Extra Key'''</div>
The door leading to the highest water level changer is never locked in rando. This results in a spare key for this dungeon.

<div style="font-size:larger;">'''Can’t Raise the Water Level'''</div>
''This is only relevant prior to version 4.0 of randomizer''

With the water level lowered, jump down to the second level of the central structure. This may require savewarping to the beginning of the dungeon to reach. Use the Hookshot to climb onto the top level. With a well-spaced rolling jump you should be able to reach the ledge where you can raise the water to its highest level. This isn't required but it's a handy time saver.

== Shadow Temple ==

<div style="font-size:larger;">'''Crossing the First Gap without Hookshot'''</div>
Hoverboots will reach the other side. If you fall short, start from the wall to build up speed before leaving the ledge.

<div style="font-size:larger;">'''First Silver Rupee Room without Hookshot'''</div>
Reach raised platform in the corner of the room by using the Hover Boots from the nearby low wall.

<div style="font-size:larger;">'''Spike floor room without Longshot'''</div>
Backflip onto the chest spawned in the middle of the room. From there, use the Hookshot to reach the upper ledge.

<div style="font-size:larger;">'''Reach the Boat without Goron’s Bracelet'''</div>
Bypass pushing the large block by shooting the top of the ladder with a Hookshot.

<div style="font-size:larger;">'''Reach Bongo Bongo without the Fairy Bow'''</div>
Play the Scarecrow’s Song to summon Pierre. Use Longshot to get to the other side.

<div style="font-size:larger;">'''Go through the Wind Tunnel without Iron Boots'''</div>
Timing is key. Move when the fans stop. Tip: You can stand between the fans in the final section. There are lines in the floor that mark the safe zones.

== MQ Shadow Temple ==

<div style="font-size:larger;">'''Spike floor room without Longshot'''</div>
Backflip onto the chest spawned in the middle of the room. From there, use the Hookshot to reach the upper ledge. The Silver Rupees can be collected with just the Hookshot (and Hover Boots) since the Hookshot targets on the ceiling are just low enough for the Hookshot to reach them.

== Gerudo Training Ground ==

<div style="font-size:larger;">'''Lava room without Longshot'''</div>
The torch at the end of this room is in reach using only the Hookshot.

<div style="font-size:larger;">'''Timed Boulder Room without Longshot'''</div>
The target on the ceiling is just within range of the Hookshot when standing almost directly under it. A wallmaster can also lift Link into the rupee if it’s the last to be collected.

== Spirit Temple ==

<div style="font-size:larger;">'''Child Side Enemy Room'''</div>
In order to kill the Armos in this room, you're expected to have at least one of the following item combinations: Deku Sticks (jumpslashes can hit), Kokiri Sword, or Deku Nuts + Slingshot.

<div style="font-size:larger;">'''Lower Metal Bridge on Child Side without Boomerang'''</div>
You can just barely hit the switch with a well-placed slingshot shot. Alternatively, hit the crystal switch with a well-timed Bombchu placement in the opposite direction.

<div style="font-size:larger;">'''Map chest without Din’s Fire or Magic'''</div>
Child Link is perfectly capable of lighting the torches using only a Deku Stick.

<div style="font-size:larger;">'''Collect Silver Rupees in the Boulder Room without Hover Boots'''</div>
Reach the floating rupee by jumping into the boulder with a jump slash, or even without hitting the boulder with a properly timed jump slash.

<div style="font-size:larger;">'''Silver Gauntlets Chest from Adult Side using Longshot'''</div>
With a Longshot, shoot the chest opposite from the Mirror Shield chest to gain access to its contents and the end of child-side.

<div style="font-size:larger;">'''Boss Key Chest'''</div>
The Eye Switch can be accessed by hitting the fake door with something to make it fall over. You do not necessarily need to destroy the fake door.

== Inside Ganon’s Castle ==

<div style="font-size:larger;">'''Spirit Trial without Fire Arrows'''</div>
A precise shot of an arrow through the torch will burn the web to reveal the light.

<div style="font-size:larger;">'''Water Trial Blue Fire'''</div>
With your bridge requirement set to Open, Blue Fire can be brought from the Water Trial to thaw King Zora or, if you have shopsanity active, to open the Zora Shop as adult if inaccessible as child.

<div style="font-size:larger;">'''Shadow Trial First Chest without Hookshot and Fire Arrows'''</div>
Playing the Song of Time will spawn Song of Time blocks leading to the first chest. Hover boots will also work.

<div style="font-size:larger;">'''Shadow Trial (Second Chest or Trial Completion) without Fire Arrows'''</div>
There are 2 scenarios possible here, either with Hover Boots or with Din's Fire. Obviously, Link may have both, in which case either method will work.<br/>
With Hover Boots, Longshot the torch to the right as you enter. From there, Link can reach the Like-Like with the Longshot. Once to the middle platform, equip the Hover Boots and roll across the gap to the platform where the chest spawns. From here open the chest and finish the trial.<br/>
With Din's Fire as a fire source, do the same thing as with Hover Boots, but instead of going to the Like-Like immediately, cast Din's Fire first. This will spawn the glass platform to the chest platform so Link can jump across.

== MQ Inside Ganon's Castle ==

<div style="font-size:larger;">'''MQ Forest Trial'''</div>

Getting to the room where the Forest Crystal is only requires the Song of Time. While on the ledge that has the door leading to the Forest Crystal room, go to the edge of the corner near where the Blue Switch is and play the Song of Time. You do not need to be on the platform where the Beamos is.

<div style="font-size:larger;">'''MQ Shadow Trial Bomb Flower Chest'''</div>

For the Bomb Flower Chest, logic expects you to either use the Bow, Explosives, Strength, or Din's Fire to blow up the bomb flower. To get to the platform where the chest spawns, either the Hookshot or Hover Boots are required.

= Knowing the Way with the Spoiler Log =

The spoiler log contains information about your personally randomized copy of the game and can be very helpful when looking for important items you've missed. Please be aware that the Playthrough presented is intended to prove the seed is beatable in logic. It does not represent the only way to logically beat the seed. It takes only a few steps to find:

= How do I find my Spoiler Log? =
*[[Frequently_Asked_Questions#How_Do_I_Find_My_Spoiler_Log_Again.3F|How do I find my spoiler log again?]]

<div style="font-size:larger;">'''Versions 1.0 - 3.0 and Standalone Download'''</div>
Open the spoiler log generated in the same folder that the randomized ROM is located in. It should be formatted as <code>OoT_SETTINGSTR_SEED_Spoiler.txt</code>.

Wii Virtual Console

2024-01-31T16:36:05Z

Flagrama: /* Using the Webpatcher */ link to xyzzy-mod-common-key-only by me for acquiring common key

One platform that supports OoTR is the Wii's built-in, official "Virtual Console" emulator. The advantages are fast load times, less lag and improved graphics compared to the other options available. Some also prefer the stick sensitivity and deadzone settings of the Wii VC over that of pc emulators. The downsides are random (but extremely rare) crashes, installing new seeds is a longer process than on pc emulators, and potentially additional costs if you don't already own a Wii and/or compatible controllers or if you wish to stream your gameplay. This page aims to help readers setup rando seeds on their Wii as well as offer basic tech troubleshooting and other useful advice. To avoid possible complications readers are '''strongly encouraged''' to fully read this page.

''OoTR can also be played on the Wii U's Virtual Wii mode, but due to its unpopularity we don't know a lot about it and can therefore offer very limited support. However, since vWii is running on Wii hardware we expect that many things that are true about Wii VC will also be true for vWii.''

{{TOClimit|4}}

== Setting Up Your Wii or Wii U==

=== Softmodding Your Wii ===
{{race rule|rule=Ensure the original IOS9 v1034 is installed|1=Modified and "Updated" versions of this IOS have significantly faster loading times. A guide on how to install the original IOS9 can be found [https://www.youtube.com/watch?v=j1v2SYTTKTc here].}}

Unfortunately, this is something that we do not offer support for. We recommend following [https://wii.guide/ this guide]. If there are any issues or questions we suggest seeking out a Wii softmodding community. If you own a PAL Wii you will need to force NTSC output for OoTR, or your game will run at 5/6 the frame rate.

=== Softmodding Your Wii U's Virtual Wii Mode ===

Unfortunately, this is something that we do not offer support for. We recommend following [https://wiiu.hacks.guide/#/vwii-modding this guide]. If there are any issues or questions we suggest seeking out a Wii U softmodding community.

'''Note''': Do not confuse the Wii U's Virtual Wii mode with Wii U Virtual Console. They are two different things and the latter is not supported.

=== Generating a Seed ===

==== Using the Webpatcher ====

Start off by going to the [https://ootrandomizer.com/generator Webpatcher] and set up the settings you want for the seed. Then press the green button below that says <code>GENERATE SEED!</code>. When the seed has been generated a new webpage will load. On this page, select <code>.wad (WiiVC)</code> for the <code>Output Type</code>. This will show several new fields. The <code>Base ROM</code> field requires a vanilla 1.0 NTSC (= NA/JAP) OoT ROM and the <code>WAD File</code> field requires a vanilla 1.2 NTSC OoT WAD. You can choose to either use a Wii Common Key File, or to enter the Wii Common Key explicitly. '''<span style="color:red">We are unable to provide any of these things for you.</span>''' If you are using a softmodded Wii or vWii and not Dolphin you can use [https://github.com/flagrama/xyzzy-mod-common-key-only/releases/tag/common-key-only this modified Wii homebrew app] to dump the key in both a binary format and a text format on your SD card that you can use with the generator. Leave the <code>WAD Channel ID</code> and <code>WAD Channel Title</code> fields as they are. Optionally set your cosmetics and then hit the green button below that says <code>PATCH ROM!</code>. Don't forget to also download a copy of your spoiler log. ;)

[[File:Wadseed.png|600px]]

==== Using the Offline Version ====

If you wish to use the offline seed generator, then you will have to create your WAD in two steps. After you have selected your seed's settings go to the <code>ROM Options</code> tab. The <code>Base ROM</code> field requires a vanilla 1.0 NTSC (= NA/JAP) OoT ROM, and the <code>Output Directory</code> is where the seed and logs will be placed. Select <code>Compressed [Stable]</code> as your <code>Output Type</code> and make sure <code>Create Spoiler Log</code> is turned on. ;) Then hit the big green button below that says <code>Generate!</code> to create a ROM file.

[[File:Romseed.png|700px]]

====Injecting the ROM====

Step two is to use this ROM file to create a WAD file that you can install on your Wii. There are two methods to do this.

=====gzinject-gui=====

Download, unzip and run [https://drive.google.com/file/d/1RSgRY-Gms5p0T6aFUWfqu7CawJ5nsHSr/view gzinjectGUI] in that order. Input the ROM file you just created in the <code>Compressed ROM (32MB)</code> field and a vanilla 1.2 NTSC OoT WAD in the <code>Donor WAD (Vanilla OOT)</code> field. Leave the <code>Channel ID</code> and <code>Channel Title</code> fields as they are. Tick only the <code>DPad-Up</code> and <code>C-Stick Down > L</code> boxes as shown on the image, optionally change the output directory and then hit the big button below that says <code>Generate WAD</code>. A new window saying "Wad Created!" should pop up after a few seconds, whilst a WAD file is created in your output directory. If not then hit the button again until it does. The created file is what you will install on your Wii or run in Dolphin.

[[File:Gzinjectgui.png|200px]]

=====gzinject=====
Download and unzip [https://github.com/krimtonz/gzinject/releases gzinject]. If on Linux, the WSL build should work as there are no major library dependencies, but if you have issues just rebuild using the install instructions in the readme file.

Open a terminal window, drag gzinject.exe into the window, then type a space followed by {{kbd|-a inject -m}} followed by a space, drag your randomizer ROM into the window, type another space and {{kbd|-w}} followed by another space. Drag the WAD into the window now. Lastly, type another space then {{kbd|-p patches/NACE.gzi -p patches/ootr_dpad_remap.gzi}} and press {{kbd|Enter}}. Note that if you are using the Japanese WAD you need to use {{example|NACJ.gzi}} instead of {{example|NACE.gzi}}. An example of the full line is {{example|./gzinject -a inject -m ROM-comp.z64 -w OoT.wad -p patches/NACE.gzi -p patches/ootr_dpad_remap.gzi}} as well as an image below. Your WAD should be in the same location as your donor WAD but have the word {{example|-inject}} in it. That is the file you install on your Wii or run in Dolphin.

[[File:Gzinject example.png]]

=== Installing the Seed ===

Put the rando WAD created with gzinjectGUI on your SD card and put it in your Wii. Open whichever WAD manager you've downloaded, such as WiiMod Lite, and follow their instructions for installing the WAD. These steps are different for every WAD manager so we cannot give specific advice, but fortunately the steps are straightforward.

=== Playing the Seed ===

Simply select the OoTR channel that is now on your home menu and have fun. :) Don't forget to [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#My_Game_Crashed save often].

The only known compatible controllers for Wii VC are any Wii Classic Controller and the Gamecube Controller. For Virtual Wii a Wii Classic Controller is your only option. An image of the controller mappings for the Gamecube Controller on Wii VC can be seen below. Note that "L-Targeting" is typically called "Z-targeting" by the OoT community as that technique was bound to <code>Z</code> on the N64, whilst toggling the mini-map was bound to <code>L</code>.

[[File:Gamecube Controls.png]]

=== After You Have Finished a Seed ===

To avoid future complications it is extremely important that old seeds are taken care of properly. The right way to dispose of old seeds is to either uninstall the old WAD through a WAD manager, or to overwrite the old WAD with a new one through the WAD manager. Boot up your WAD manager and follow whatever steps are needed for that specific WAD manager to uninstall or overwrite the WAD. When choosing to overwrite the old WAD ensure that the new WAD uses the same Channel ID as the old one did. When using the webpatcher to generate a WAD the default Channel ID is <code>NICE</code> (previously <code>OOTE</code>) and when using gzinjectGUI the default Channel ID is <code>NRKE</code>. It is recommended to not change these. If you're unsure about what Channel ID you used, you can copy your save file to your SD card using the Wii system menu and then on your SD card navigate to <kbd><samp>private</samp> ⇒ <samp>wii</samp> ⇒ <samp>title</samp> ⇒ <samp>[Channel ID]</samp></kbd> to find your Channel ID.

'''<span style="color:red">Never delete OoTR channels through the Wii system menu.</span>''' This does not properly remove the seed's save data, which means that it'll take up precious space in your Wii's memory. As a consequence you will not be able to install new WADs, or save data from old seeds could affect the save data of new seeds. If this happens, install and uninstall WADs onto the channel(s) where you've incorrectly removed WADs from. If you need to free up more space, you can uninstall other WADs temporarily. If this still does not fix the issue(s), then you'll have to use a homebrew app like AnyTitleDeleter which has full access to your whole Wii to remove the leftover save data. '''<span style="color:red">Caution:</span>''' because these apps have full access to your Wii it is possible to cause severe damage or even brick your Wii if you don't know what you're doing. We are not responsible if such a thing should happen and we recommend reaching out to a Wii homebrewing community for help if needed. It is for this reason that we warn users not to delete OoTR channels through the Wii system menu. Alternatively, should you still have enough space to install new WADs, you could install them on a different channel to avoid the mixing of flags from old and current seeds. See [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Multiple_Seeds_Installed_Simultaneously the next section] for help deciding alternative Channel IDs.

== Optional: Multiple Seeds Installed Simultaneously ==

It is possible to have multiple seeds installed on your Wii simultaneously. All you have to do is create each WAD with a different Channel ID. A Channel ID consists of 4 characters that can be letters [A-Z] or numbers [0-9]. To avoid possible interference with other WADs it is important to select an unused Channel ID. A list of Channel IDs used by official Nintendo software can be found [https://wiibrew.org/wiki/Title_database here]. If you wish to follow the same convention, the first character of your Channel ID should be "N" and the last character should be "E". For the other two characters make sure to avoid [https://wiibrew.org/wiki/Title_database#00010001-Nxxx_:_Nintendo_64_Games the combinations already in use].

Warning: if you have multiple OoTR WADs with different channel IDs installed, then the game could crash on a soft reset. If this is the case, then uninstall the other wads. [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#There_Is_No_More_Space_to_Install_New_WADs See this section for more info].

== Troubleshooting ==

=== My Game Crashed ===

Unfortunately random crashes can occur. These are due to a bug with the Virtual Console and are therefore out of our reach to fix. All you can do is save often to mitigate progress lost. [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Crash_on_a_Soft_Reset Read this if you crash on soft resetting].

=== My Control Stick Is Too Sensitive ===

This is due to the Virtual Console's controller mapping and is also out of our reach to fix. You will either have to learn to live with it, or get a so-called "ESS adapter". Keep in mind that these are quite expensive and typically have a waiting list.

=== My Game Seems To Run Slower Than Normal ===

PAL Wiis run NTSC games at 5/6 the normal frame rate. In order to play OoTR at normal speeds on a PAL Wii you will need to force NTSC output for OoTR. This can be done with WiiMod Lite and possibly other homebrew as well. You also need to make sure that your PAL TV can support NTSC signals. Most modern ones can do this, but it's always good to verify that first.

=== My SD Card Is Unusable ===

Older homebrew apps typically had issues with SDHC cards (4GB+), but newer apps should work fine with either SDHC or SDXC cards. Make sure you format your card with FAT32.

=== There Is No More Space to Install New WADs ===

Delete some WADs through your WAD manager to make room. If you don't have the original WADs anymore, then you can create new WADs to delete channels so long as they have the same Channel ID. If there isn't anything to uninstall left, then you'll likely have to use a homebrew app like AnyTitleDeleter to free up space. '''<span style="color:red">Caution:</span>''' keep in mind these apps can cause major damage to your Wii if you don't know what you're doing, and we are not responsible for what may happen. It's best to reach out to a Wii homebrewing community to ask for help.

=== A Fresh Seed Already Has Some Flags Set ===

If you delete your old seeds through the Wii system menu then old save data will remain on your Wii and interfere with new seeds on the same channel. [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Multiple_Seeds_Installed_Simultaneously Create WADs with a different Channel ID] from now on and [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#There_Is_No_More_Space_to_Install_New_WADs uninstall old seeds through your WAD manager to prevent future issues].

=== Crash/Black Screen on a Soft Reset ===

This could be caused by having multiple seeds installed at the same time, or due to improper removal of past seeds. Make sure to always uninstall old WADs through your WAD manager and not through the Wii system menu. [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#There_Is_No_More_Space_to_Install_New_WADs Read this section for info on how to remove leftover data from WADs uninstalled through the system menu].

=== Installing ticket...ERROR (ret=-2011) ===

Make sure you've followed [https://wii.guide/cios this section of the Wii softmodding guide] or [https://wii.guide/cios-mini this section of the Wii Mini softmodding guide] or [https://wiiu.hacks.guide/#/vwii-modding?id=installing-cioses this section of the vWii softmodding guide].

Setup

2024-01-23T22:37:34Z

Flagrama: /* Online Generator */ fix link

It is usually recommended to use the online generator on the website instead of the download or source code versions of the randomizer. The [[#Video Tutorial|video tutorial]] is also available as a walk through for the website. The [[Readme]] explains what the different options do. You can also check out the [[Changelog]] to see what changes have happened between randomizer versions. Recent [https://ootrandomizer.com/generatorDev Dev] and [https://ootrandomizer.com/generatorDev?version=devR_ Dev-R] versions are also available on the website.

Ocarina of Time Randomizer is compatible with emulators, Wii Virtual Console, and original Nintendo 64 hardware. Learn more about these options in the [[#Playing the Randomizer|Playing the Randomizer]] section.

Base files (ROMs, Wii common key, etc.) that are needed to play Ocarina of Time Randomizer are copyrighted and will not be provided by the community nor staff.

''If you want to run the [https://ootrandomizer.com/downloads standalone download] version of the randomizer, you should skip to [[#Install Python|installing Python]].''

''If you want to run the [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/master release source code] or [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/Dev Dev source code] version of randomizer, you should skip to [[#Install Node.js|installing Node.js]].''

''We have compiled [https://wiki.ootrandomizer.com/index.php?title=Common_Softlocks_And_Crashes a list of known softlocks and crashes]. It is recommended to read it through to potentially save you from frustration later.''

{{TOClimit|3}}

== Online Generator ==

This section contains information similar to what is presented in the video by TreZc0, but does not go into as much detail regarding randomization options or emulator setup. The [[Readme]] and [[Setup#Emulators|emulator]] pages available to help with those details. The video is highly recommended, especially since it will provide visuals to aid in setup.

=== Video Tutorial ===
<youtube dimensions="480x270">https://www.youtube.com/watch?v=-xNjTtcA4Es</youtube>

Once you have viewed the video, generated a seed, and patched a randomizer ROM file, head to [[#Playing the Randomizer|Playing the Randomizer]].

=== Generating a Seed ===
The online randomizer does not require any downloads except for the final randomized rom, however you will be required to have one or more base files to create the randomized rom. Some of these are copyrighted files that you will need to have prior to receiving any help with setup in the {{discord|text=randomizer discord}}. Please read all rules of the discord and peruse the resources channel before requesting assistance there.
* '''Always Required'''
** OoT v1.0 NTSC-U/NTSC-J ROM - Copyrighted file
** A device with a multicore CPU & at least 2GB of available ram
*** Even most modern mobile devices (i.e. 2019 or newer) meet these requirements
** A modern browser (2020 or later): Chrome, Firefox, Edge, Safari, or Opera
** A method to play the game, which is covered later in the [[#Playing the Randomizer|Playing the Randomizer]] section.
* '''Only Required for WiiVC/vWii/Dolphin'''
** OoT v1.2 NTSC WAD - Copyrighted file
** Wii Common Key - Copyrighted file

Once prepared, go to https://ootrandomizer.com and click on the <samp><kbd>Play Now</kbd></samp> button for the latest stable version.
[[File:Setup-Website-PlayNow.jpeg|none|thumb|Click the <samp>Play Now</samp> button on the website to open the online generator.]]

Just below the "Ocarina of Time Item Randomizer v6.2" title is the button <samp><kbd>INSTRUCTIONS/HELP</kbd></samp> which effectively repeats the information available here and in the video at a quick glance.

Detailed explanations of the settings can be found on the [[Readme]] page and quick tooltips can be seen by hovering over any setting in the generator.

'''For a first seed, we recommend using either the Default/Beginner or Easy presets available on the "ROM Options" tab of the generator.''' The Default/Beginner preset is aimed at those familiar with vanilla who desire a similar progression. It uses base glitchless logic with no added tricks and no additional timesavers enabled (see the tab "Other" in the GUI). The world begins closed. Expect a long playthrough. The Easy Preset is aimed at those who have perhaps seen a few Randomizer runs previously and/or wish to dive right in. It uses base glitchless logic with no added tricks, but it does use additional timesavers (see the tab "Other" in the GUI). The world is more open after leaving Kokiri Forest.

Once a preset is selected from the dropdown, click <samp><kbd>LOAD</kbd></samp> and all settings shown in the generator, except Cosmetics and SFX, will change to match the preset. Feel free to look at the other tabs to see which settings are enabled by each preset before deciding which to use.

[[File:Presets.png|none|thumb|Presets location on the ROM Options tab of the generator.]]

If you're feeling a little more bold, settings may still be changed from those loaded by the preset to any you desire. '''However''', on the first tab of the randomizer, ROM Options, please never disable "'''Create Spoiler Log'''." The Spoiler Log is a file containing all the item locations, settings, and entrances when applicable of the randomized seed. Though you may never look at it, it is vital for those helping in the randomizer discord to be able to check this log if you require help at any point in the seed.

Once the settings are prepared, there are two options to generate the seed, <samp><kbd>GENERATE SEED!</kbd></samp> and <samp><kbd>GENERATE RACE SEED!</kbd></samp>. For most purposes, '''we highly recommend to only use the first option'''. Race seeds are encrypted and lock away the spoiler log even if it is generated. These locked logs will not be unlocked except for community races organized by the race mods.

Seed generation takes, on average, 15 seconds but may be longer depending on the current workload of the website. Now you will be on the seed page. The URL follows the naming convention of "https://ootrandomizer.com/seed/get?id=680574" where the 6 digit ID at the end is unique to your seed. This is particularly useful for sharing seeds with friends or sharing the spoiler log when asking for help. (Note that the seed ID at the end of the URL is also present in the default file name of randomized roms. We recommend not changing rom names to keep this piece of information always with the seed.)

Now it is time to direct the website to your base rom (OoT v1.0 NTSC-U/NTSC-J). The version is important, Rev A/B and MQ roms will not work. However, you can convert those ROMs to the proper one with the [https://oot.flagrama.com Ocarina of Time Downgrader and Converter]. For a normal N64 seed for use on everdrive or most emulators, leave the Output type toggle on <samp>.z64 (N64/Emulator)</samp> and browse to your rom file. For WiiVC/vWii/Dolphin, swap to <samp>WAD (WiiVC)</samp> and in addition to the Base Rom, also browse to your 1.2 WAD and Wii Common Key files. You can only patch a randomizer seed if you have the correct files given, so this is very important.

This page also offers the option to change the cosmetics and SFX from those generated with the seed. Please be aware that if you set your desired cosmetics and SFX previously, the option "Override Original Cosmetics" should be disabled before patching the rom as it is enabled by default.

[[File:Override_Cosmetics.PNG|none|thumb|Disable if cosmetics were previously set, enable if cosmetics are set on this page.]]

Once everything is set, simply click <samp>PATCH ROM!</samp> The patching process uses your device's CPU, so how long this takes is dependent on your hardware. Once the process is complete, a download will begin. Save this new rom file separately from the original rom, and now it's time to proceed to the [[#Playing the Randomizer|Playing the Randomizer]] section.

== Windows Setup ==
If you desire for any reason to use the offline randomizer program instead, you will need one or two other programs first. The randomizer itself will work on Windows, macOS, and Linux. The ROM will work on any device that has a Nintendo 64 emulator available. However, the following setup steps focus on getting the randomizer working on the Windows operating system.

=== Install Node.js ===
As of version 4.14 of the randomizer, the source code versions of the randomizer require [https://nodejs.org/en/ Node.js] to be installed. (Please skip this step for the executable version of the randomizer found on [https://ootrandomizer.com/downloads the website's download page].)

Open the [https://nodejs.org/en/ Node.js website] and click on the <samp><kbd>LTS</kbd></samp> button on their home page.<sup>1</sup> Save the <samp>msi</samp> installer file then, locate it in your <samp>Downloads</samp> folder, or wherever you saved it. Launch the installer by double-clicking it. Click <samp><kbd>Next</kbd></samp> until you get to the <samp>Tools for Native Modules</samp> screen. Make sure the <samp>Automatically install the necessary tools. [...]</samp> checkbox is '''not''' checked.<sup>2</sup> Click <samp><kbd>Next</kbd></samp> once you have made sure of this. Next click the <samp><kbd>Install</kbd></samp> button, then once that is completed, click the <samp><kbd>Finish</kbd></samp> button.

<gallery>
File:Setup-NodeJs-LTSButton.jpeg|1. Choose the <samp>LTS</samp> version which was <samp>12.16.2</samp> here, but may be different for you.
File:Setup-NodeJs-NativeModulesUnchecked.jpeg|2. Make sure the checkbox is unchecked before clicking <samp>Next</samp>.
</gallery>

=== Install Python ===
To run the randomizer on your computer you will need to install [https://www.python.org Python]. This is not needed when using the [https://ootrandomizer.com online generator] but in all other cases you '''must''' have Python installed. The randomizer requires at least <samp>Python 3.9.0</samp> installed, however we recommend installing the latest stable version of Python available when you install it.

Go to the [https://www.python.org Python website] and hover your mouse over the <samp>Downloads</samp> tab. A little dialog will appear and should have a <samp>Download for Windows</samp> section displayed. Click on the button labeled <samp>Python</samp> with a version number next to it.<sup>1</sup> Save the <samp>exe</samp> installer file, then locate it in your <samp>Downloads</samp> folder, or wherever you saved it. Launch the installer by double-clicking it. Click <samp><kbd>Install Now</kbd></samp> on the installer.<sup>2</sup>

<gallery>
File:Setup-Python-DownloadPythonButton.jpeg|1. Click this button. In this case the latest version was <samp>3.8.2</samp> but the version displayed for you is the one you want.
File:Setup-Python-InstallNow.jpeg|2. Choose to <samp>Install Now</samp>.
</gallery>

== Downloading the Randomizer ==
Please ensure Node and/or Python are properly installed per the instructions above before downloading the randomizer. Once your computer is prepared, you can follow the instructions for the [[#Standalone Download|standalone download]] version or the [[#Source Code|source code and Dev]] version of the randomizer.

=== Standalone Download ===
Download the current standalone download version of the randomzier by going to the [https://ootrandomizer.com/downloads downloads page on the website] and select the appropriate download for your operating system. The provided installers should install the randomizer to the appropriate place for your operating system and you should be able to launch the randomizer from your operating system's application launcher—Start Menu in Windows, Applications folder in macOS, and whichever application launcher you prefer for Linux. ''You must have [[#Install Python|Python 3.8 or higher]] installed for the standalone download randomizer to work''.

Once you have generated a randomizer ROM file, head to [[#Playing the Randomizer|playing the randomizer]].

==== Windows Troubleshooting ====
[[File:Setup-Standalone-WindowsSmartScreen.jpeg|none|thumb|Click <samp>More info</samp> then <samp>Run anyway</samp> to run the installer.]]

Often when a new version of the randomizer is released the standalone download is not trusted by the Windows operating system. When you try to run the installer it will pop up a Windows Smartscreen window. All you have to do is click <samp><kbd>More info</kbd></samp> and then the <samp><kbd>Run anyway</kbd></samp> button. The installer will then launch and install the randomizer.

=== Source Code ===
You can download either the release source code, or the development (Dev) branch source code to run the randomizer. Most users will want to use the [[#Standalone Download|standalone download]] for the release version, so this section will focus on running the latest development version from source code. ''You must have the latest [[#Install Node.js|Node.js LTS version]] and [[#Install Python|Python 3.8 or higher]] installed for the source code version of the randomizer to work''.

Head to the [https://ootrandomizer.com website] and in the navigation bar at the top, click on <samp><kbd>Resources</kbd></samp> and then choose the <samp><kbd>Dev Github</kbd></samp> option.<sup>1</sup> Next click on the <samp><kbd>releases</kbd></samp> button to reach the page with all of the randomizer releases.<sup>2</sup> Click on the <samp><kbd>zip</kbd></samp> button for the latest development version of the randomizer to download it.<sup>3</sup> ''The Dev branch of the randomizer is known to be unstable. The latest version may not work properly. If you run into issues you may want to join the {{discord|text=Discord server}} and ask which Dev version of the randomizer you should download''.

Locate the <samp>zip</samp> file you just downloaded in your <samp>Downloads</samp> folder, or wherever you saved it. <kbd>Right-click</kbd> the file and click <samp><kbd>Extract All...</kbd></samp> and extract the files from the zip archive.<sup>4</sup> A new folder should appear which may contain another folder inside. Open the folders until you see a folder with many folders and files inside. Locate the <samp>Gui.py</samp> file inside and <kbd>Double-click</kbd> it to launch the randomizer.<sup>5</sup> The first time you run the randomizer many files need to be downloaded from the internet. Wait patiently as they download.<sup>6</sup> ''This process will be faster every time you run the randomizer after this since it will only have to download the files once. Even if you download a new version it will be slightly faster as most of the files will be located in the Node.js cache and most will simply be used from there''.

The randomizer will launch once the initial installation has finished. Once you have generated a randomizer ROM file, head to [[#Playing the Randomizer|playing the randomizer]].

<gallery>
File:Setup-SourceCode-GitHubLink.jpeg|1. Open the <samp>Dev Github</samp> link to open the GitHub page for the main fork of the randomizer.
File:Setup-SourceCode-GitHubReleases.jpeg|2. The <samp>releases</samp> button will display all of the different randomizer versions.
File:Setup-SourceCode-GitHubZip.jpeg|3. A <samp>zip</samp> button should appear on the top release that you can click on.
File:Setup-SourceCode-WindowsExtract.jpeg|4. On Windows, choose to <samp>Extract All...</samp> from the zip file.
File:Setup-SourceCode-Gui-py.jpeg|5. Run the <samp>Gui.py</samp> Python script.
File:Setup-SourceCode-InitialInstall.jpeg|6. Wait patiently as Node.js downloads the randomizer's dependencies.
</gallery>

==== Alternative Source Code Download Method ====
You can alternatively use [https://git-scm.com/ Git] to download the source code. This is the easiest way to keep up to date with the latest changes. We have a guide on using [[GitKraken]], a GUI for git that many of the developers use if you want to try to download the source code this way. You still need to install [[#Source Code|the other software mentioned above]].

== Playing the Randomizer ==
===Emulators===
The Ocarina of Time Randomizer can be played on PC via an emulator. Given the emulation quality difference between emulators, not every emulator can be recommended.

The emulators we support are available for free and have been extensively tested to work well with OoTR, assuming proper setup.

[https://wiki.ootrandomizer.com/index.php?title=Project64 Project64 v3.0+] (Windows) is the least resource-intensive emulator and the easiest to setup. However, it is important that versions 3.0+ are used since these are currently the only ones that provide a stable game experience. Furthermore, '''<span style="color:red">please keep in mind that using Project64 v2.x for racing is against our community's racing rules</span>'''.

[[Bizhawk]] (Windows) is the most resource-intensive, but easier to setup than RetroArch. Bizhawk is also the only race-legal emulator to support [[Multiworld]] currently.

[https://wiki.ootrandomizer.com/index.php?title=Retroarch RetroArch] (Windows, macOS, Linux, and more) isn't as resource-intensive as Bizhawk. However, setting up RetroArch can be a frustrating experience, and especially so for certain controllers.

[[Dolphin]] (Windows, macOS, and possibly Linux and Android) is capable of running OoTR through emulating Wii Virtual Console. As a result, it also has the Wii VC advantage of having less lag when opening the item menu. Other advantages include being lightweight and being easy to set up, especially with Gamecube controllers and either the official Nintendo or the Mayflash adapter. Downsides include random Wii VC crashes, having to inject the OoTR ROM into a WAD for every seed and additional lag in some areas (e.g. Market) due to shortcomings in how Wii VC is emulated.

=== Wii Virtual Console ===

The Ocarina of Time Randomizer can be played on a [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console Wii] (or [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Playing_On_The_Wii_U.27s_Virtual_Wii Wii U]). The advantages are fast load times, less lag and improved graphics compared to the other options available. Some also prefer the stick sensitivity and deadzone settings of the Wii VC over that of pc emulators. The downsides are random (but extremely rare) crashes, installing new seeds is a longer process than on pc emulators, and potentially additional costs if you don't already own a Wii and/or compatible controllers or if you wish to stream your gameplay.

=== EverDrive ===

The Ocarina of Time Randomizer can be played on a N64 by using the [https://wiki.ootrandomizer.com/index.php?title=Everdrive EverDrive]. Keep in mind that EverDrives are expensive and that the N64 is very laggy. The randomizer also requires the memory pak, even though base Ocarina of Time does not.

== Patch Files ==
If someone shares a ZPF or ZPFZ file with you, these are [[Patch Files]]. They are a copyright-free method to share randomizer seeds with people. The [[Patch Files|patch files]] page will explain what to do with them.

Frequently Asked Questions

2024-01-23T20:12:01Z

Flagrama: /* I Saw Someone Streaming Feature {x}. Why Isn't Feature {x} Available On The Website? */ update/generalize

Here are some common questions asked that don't belong to any particular guide, and their answers.

==I Cannot Get All Of The Stones To Open The Door Of Time, What Do I Do?==
The Door of Time doesn't work like the game made you think it does, the original Ocarina of Time programmers took shortcuts to reduce the amount of code they needed to write to check that you can open the door and you only need an ocarina and the Song of Time to open the door. See [[Logic#Misunderstood Vanilla Mechanics|the Misunderstood Vanilla Mechanics section of the Logic page]] for more information and other such programmer shortcuts you might run into.

==I'm Missing A Key In Fire Temple, Where Is It?==
Due to the way the Fire Temple and Water Temple are set up with no Small Keys required to access the bosses, Volvagia and Morpha are able to hold a Small Key you may need to progress. See [[Logic#Fire Temple|the Fire Temple section of the Logic page]] for more information.

==I Cannot Leave A Room, What Do I Do?==
If you break the platform in the Slingshot room without having the Slingshot, or finish the race with Dampe without the Song of Time, and several other situations you may find yourself stuck in a room. The Save and Quit functionality of Ocarina of Time is a feature the randomizer expects you to utilize. See [[Logic#Vanilla Help|the Vanilla Help section of the Logic page]] for more information.

== Why Are My Cosmetics Different Than What I Set? ==
Cosmetics can be set in two places. When you are generating a seed you can set them as the default cosmetics for the patch file you are creating. The seed generation page is the one where you select your gameplay options before pressing <samp>Generate Seed!</samp>

Once you are on the patching screen, you can override those settings by turning on <samp><kbd>Override Original Cosmetics</kbd></samp> above the <samp>Patch Rom!</samp> button. Then you can set cosmetics on this page to override the ones set in the patch file.

If you want to use the settings in the patch file instead, turn off <samp><kbd>Override Original Cosmetics</kbd></samp>
[[File:overridecosmetics.png|thumb|750px|none|Override Original Cosmetics]]

== How Do I Find My Spoiler Log Again? ==
If you generated on the website and forgot to download the spoiler log before closing the tab, there are several methods to return to your seed's page where you can find the spoiler log again.

If this seed was the most recent one you generated, open [https://ootrandomizer.com the generator home page]. At the top of the screen you can find a <samp><kbd>Recent Seed</kbd></samp> link in the navigation bar. Clicking this will take you to the last seed you generated. Keep in mind this is based on which browser you are using, so make sure you use the same browser as you did when you generated the seed that you want the spoiler log of.

A newer feature on the website on larger screens is a sidebar on the randomizer home page. It has a heading of <samp>Your most recent seed:</samp>. Click the <samp><kbd>ID</kbd></samp> number; which links to the most recent seed you generated with that browser.

If you have generated another seed since then, the file name of the ROM you generated is your next possibility. ROMs generated on the website are of the format <samp>OoTR_<var><id></var>_<var><seed></var>.z64</samp>.

Using the following URL: <samp><nowiki>https://ootrandomizer.com/seed/get?id=</nowiki></samp>

Insert the ID value after the equals sign. This should take you to the proper seed patch page.

If you renamed your file, your absolute last chance to find your seed page is by using your browser history. You'll have to search through all the OoTR website entries until you find the right one. To avoid this issue, never rename your ROM files.

== What Do I Do If My Seed Page Says It Is Expired? ==
If your seed page is expired and you did not download the spoiler log beforehand, you'll have to join the {{discord}}. Go to {{discord|gameplay-and-tricks}} and mention your seed ID and the fact that it is expired. Once someone on the Support staff sees your message they can retrieve your spoiler log. Please do not ping the support role, someone will likely see your message soon after you post it and be able to help you.

This is not a feature to be relied upon though. You should download your spoiler log when you generate your seed.

== Why Does My Seed Page Not Have A Spoiler Log Even Though I Generated With One? ==
There are two kinds of seeds that can be generated on the website. Normal seeds, and Race seeds. If you press the blue button on the generator labeled <samp>Generate Race Seed</samp> then you will generate a seed with a locked spoiler log. These are not intended to be used unless you are actually generating a race, and even then other methods such as distributing [[Patch Files]] directly would be a better idea since the spoiler log will still be available to the race organizer if needed.

Always choose <samp><kbd>Generate Seed!</kbd></samp> to ensure that you have access to your spoiler log.

== I Saw Someone Streaming Feature {x}. Why Isn't Feature {x} Available On The Website? ==
It might be available on one of the [https://ootrandomizer.com/forks Dev versions available on the website].

If it is not, then the feature you are looking for might be a feature that is pending approval and is being playtested by the streamer, or it might be a feature from their own fork that they are playtesting. There are also several similar randomizers that have their own settings and development teams. Either way, it is advised to ask the streamer where you might find that fork or which randomizer they are playing. If you cannot reach them, then folks in the {{discord}} will probably know where to find these branches.

To run forks of the randomizer not on the website, you'll have to follow the [[Setup#Windows_Setup|Setup]] page to download the fork and install the Python and Node prerequisites.

== Why Do Songs Not Work After Learning Them? ==
The game Zelda: Ocarina of Time has a few little known features when playing an ocarina song. First, holding the L button will ensure songs do not "complete" so that you can compose longer custom songs if they may use note patterns already known to the game as in-game songs. In the same vein, holding R, Z, or the control stick will change the sounds the ocarina produces. These will also cause in-game songs to fail to complete if used.

The easiest way to know if this is affecting you is by going somewhere where a staff appears for you to play a song. When a staff is displayed, a song will always complete. Skull Kid is probably the easiest accessible location to test this. If the song works here, you are somehow altering the output of the ocarina with one of the above features.

One of the most common issues is having L double bound. Make sure L is only bound to one button, and that you are not holding it while playing the song.

== How Can I Bring Up The Menu Where I See Dungeon Rewards, Key Counts, Etcetera? ==
[[File:Pausemenu.png|thumb|200px|Hold A]]
Go to your <samp>Select Item</samp> menu and hold <samp>A</samp>. Typically you need to interact with the pedestal in the Temple of Time to see which dungeon awards which stone or medallion, though this is also settings-dependent.

== What Items Do I Need To Beat Dungeon X? ==
Please see this page for [[Vanilla_Dungeon_Requirements | Dungeon Requirements]], including Ganon's Castle.

== What Bugs & Errors Exist In The Game That I Should Be Aware Of? ==
[[Common Softlocks And Crashes]]

Setup

2024-01-15T16:35:10Z

Flagrama: /* Install Python */ 3.12.1 has been released, 3.9.0 seems to be required for full custom music support

It is usually recommended to use the online generator on the website instead of the download or source code versions of the randomizer. The [[#Video Tutorial|video tutorial]] is also available as a walk through for the website. The [[Readme]] explains what the different options do. You can also check out the [[Changelog]] to see what changes have happened between randomizer versions. Recent [https://ootrandomizer.com/generatorDev Dev] and [https://ootrandomizer.com/generatorDev?version=devR_ Dev-R] versions are also available on the website.

Ocarina of Time Randomizer is compatible with emulators, Wii Virtual Console, and original Nintendo 64 hardware. Learn more about these options in the [[#Playing the Randomizer|Playing the Randomizer]] section.

Base files (ROMs, Wii common key, etc.) that are needed to play Ocarina of Time Randomizer are copyrighted and will not be provided by the community nor staff.

''If you want to run the [https://ootrandomizer.com/downloads standalone download] version of the randomizer, you should skip to [[#Install Python|installing Python]].''

''If you want to run the [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/master release source code] or [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/Dev Dev source code] version of randomizer, you should skip to [[#Install Node.js|installing Node.js]].''

''We have compiled [https://wiki.ootrandomizer.com/index.php?title=Common_Softlocks_And_Crashes a list of known softlocks and crashes]. It is recommended to read it through to potentially save you from frustration later.''

{{TOClimit|3}}

== Online Generator ==

This section contains information similar to what is presented in the video by TreZc0, but does not go into as much detail regarding randomization options or emulator setup. The [[Readme]] and [[https://wiki.ootrandomizer.com/index.php?title=Setup#Emulators emulator]] pages available to help with those details. The video is highly recommended, especially since it will provide visuals to aid in setup.

=== Video Tutorial ===
<youtube dimensions="480x270">https://www.youtube.com/watch?v=-xNjTtcA4Es</youtube>

Once you have viewed the video, generated a seed, and patched a randomizer ROM file, head to [[#Playing the Randomizer|Playing the Randomizer]].

=== Generating a Seed ===
The online randomizer does not require any downloads except for the final randomized rom, however you will be required to have one or more base files to create the randomized rom. Some of these are copyrighted files that you will need to have prior to receiving any help with setup in the {{discord|text=randomizer discord}}. Please read all rules of the discord and peruse the resources channel before requesting assistance there.
* '''Always Required'''
** OoT v1.0 NTSC-U/NTSC-J ROM - Copyrighted file
** A device with a multicore CPU & at least 2GB of available ram
*** Even most modern mobile devices (i.e. 2019 or newer) meet these requirements
** A modern browser (2020 or later): Chrome, Firefox, Edge, Safari, or Opera
** A method to play the game, which is covered later in the [[#Playing the Randomizer|Playing the Randomizer]] section.
* '''Only Required for WiiVC/vWii/Dolphin'''
** OoT v1.2 NTSC WAD - Copyrighted file
** Wii Common Key - Copyrighted file

Once prepared, go to https://ootrandomizer.com and click on the <samp><kbd>Play Now</kbd></samp> button for the latest stable version.
[[File:Setup-Website-PlayNow.jpeg|none|thumb|Click the <samp>Play Now</samp> button on the website to open the online generator.]]

Just below the "Ocarina of Time Item Randomizer v6.2" title is the button <samp><kbd>INSTRUCTIONS/HELP</kbd></samp> which effectively repeats the information available here and in the video at a quick glance.

Detailed explanations of the settings can be found on the [[Readme]] page and quick tooltips can be seen by hovering over any setting in the generator.

'''For a first seed, we recommend using either the Default/Beginner or Easy presets available on the "ROM Options" tab of the generator.''' The Default/Beginner preset is aimed at those familiar with vanilla who desire a similar progression. It uses base glitchless logic with no added tricks and no additional timesavers enabled (see the tab "Other" in the GUI). The world begins closed. Expect a long playthrough. The Easy Preset is aimed at those who have perhaps seen a few Randomizer runs previously and/or wish to dive right in. It uses base glitchless logic with no added tricks, but it does use additional timesavers (see the tab "Other" in the GUI). The world is more open after leaving Kokiri Forest.

Once a preset is selected from the dropdown, click <samp><kbd>LOAD</kbd></samp> and all settings shown in the generator, except Cosmetics and SFX, will change to match the preset. Feel free to look at the other tabs to see which settings are enabled by each preset before deciding which to use.

[[File:Presets.png|none|thumb|Presets location on the ROM Options tab of the generator.]]

If you're feeling a little more bold, settings may still be changed from those loaded by the preset to any you desire. '''However''', on the first tab of the randomizer, ROM Options, please never disable "'''Create Spoiler Log'''." The Spoiler Log is a file containing all the item locations, settings, and entrances when applicable of the randomized seed. Though you may never look at it, it is vital for those helping in the randomizer discord to be able to check this log if you require help at any point in the seed.

Once the settings are prepared, there are two options to generate the seed, <samp><kbd>GENERATE SEED!</kbd></samp> and <samp><kbd>GENERATE RACE SEED!</kbd></samp>. For most purposes, '''we highly recommend to only use the first option'''. Race seeds are encrypted and lock away the spoiler log even if it is generated. These locked logs will not be unlocked except for community races organized by the race mods.

Seed generation takes, on average, 15 seconds but may be longer depending on the current workload of the website. Now you will be on the seed page. The URL follows the naming convention of "https://ootrandomizer.com/seed/get?id=680574" where the 6 digit ID at the end is unique to your seed. This is particularly useful for sharing seeds with friends or sharing the spoiler log when asking for help. (Note that the seed ID at the end of the URL is also present in the default file name of randomized roms. We recommend not changing rom names to keep this piece of information always with the seed.)

Now it is time to direct the website to your base rom (OoT v1.0 NTSC-U/NTSC-J). The version is important, Rev A/B and MQ roms will not work. However, you can convert those ROMs to the proper one with the [https://oot.flagrama.com Ocarina of Time Downgrader and Converter]. For a normal N64 seed for use on everdrive or most emulators, leave the Output type toggle on <samp>.z64 (N64/Emulator)</samp> and browse to your rom file. For WiiVC/vWii/Dolphin, swap to <samp>WAD (WiiVC)</samp> and in addition to the Base Rom, also browse to your 1.2 WAD and Wii Common Key files. You can only patch a randomizer seed if you have the correct files given, so this is very important.

This page also offers the option to change the cosmetics and SFX from those generated with the seed. Please be aware that if you set your desired cosmetics and SFX previously, the option "Override Original Cosmetics" should be disabled before patching the rom as it is enabled by default.

[[File:Override_Cosmetics.PNG|none|thumb|Disable if cosmetics were previously set, enable if cosmetics are set on this page.]]

Once everything is set, simply click <samp>PATCH ROM!</samp> The patching process uses your device's CPU, so how long this takes is dependent on your hardware. Once the process is complete, a download will begin. Save this new rom file separately from the original rom, and now it's time to proceed to the [[#Playing the Randomizer|Playing the Randomizer]] section.

== Windows Setup ==
If you desire for any reason to use the offline randomizer program instead, you will need one or two other programs first. The randomizer itself will work on Windows, macOS, and Linux. The ROM will work on any device that has a Nintendo 64 emulator available. However, the following setup steps focus on getting the randomizer working on the Windows operating system.

=== Install Node.js ===
As of version 4.14 of the randomizer, the source code versions of the randomizer require [https://nodejs.org/en/ Node.js] to be installed. (Please skip this step for the executable version of the randomizer found on [https://ootrandomizer.com/downloads the website's download page].)

Open the [https://nodejs.org/en/ Node.js website] and click on the <samp><kbd>LTS</kbd></samp> button on their home page.<sup>1</sup> Save the <samp>msi</samp> installer file then, locate it in your <samp>Downloads</samp> folder, or wherever you saved it. Launch the installer by double-clicking it. Click <samp><kbd>Next</kbd></samp> until you get to the <samp>Tools for Native Modules</samp> screen. Make sure the <samp>Automatically install the necessary tools. [...]</samp> checkbox is '''not''' checked.<sup>2</sup> Click <samp><kbd>Next</kbd></samp> once you have made sure of this. Next click the <samp><kbd>Install</kbd></samp> button, then once that is completed, click the <samp><kbd>Finish</kbd></samp> button.

<gallery>
File:Setup-NodeJs-LTSButton.jpeg|1. Choose the <samp>LTS</samp> version which was <samp>12.16.2</samp> here, but may be different for you.
File:Setup-NodeJs-NativeModulesUnchecked.jpeg|2. Make sure the checkbox is unchecked before clicking <samp>Next</samp>.
</gallery>

=== Install Python ===
To run the randomizer on your computer you will need to install [https://www.python.org Python]. This is not needed when using the [https://ootrandomizer.com online generator] but in all other cases you '''must''' have Python installed. The randomizer requires at least <samp>Python 3.9.0</samp> installed, however we recommend installing the latest stable version of Python available when you install it.

Go to the [https://www.python.org Python website] and hover your mouse over the <samp>Downloads</samp> tab. A little dialog will appear and should have a <samp>Download for Windows</samp> section displayed. Click on the button labeled <samp>Python</samp> with a version number next to it.<sup>1</sup> Save the <samp>exe</samp> installer file, then locate it in your <samp>Downloads</samp> folder, or wherever you saved it. Launch the installer by double-clicking it. Click <samp><kbd>Install Now</kbd></samp> on the installer.<sup>2</sup>

<gallery>
File:Setup-Python-DownloadPythonButton.jpeg|1. Click this button. In this case the latest version was <samp>3.8.2</samp> but the version displayed for you is the one you want.
File:Setup-Python-InstallNow.jpeg|2. Choose to <samp>Install Now</samp>.
</gallery>

== Downloading the Randomizer ==
Please ensure Node and/or Python are properly installed per the instructions above before downloading the randomizer. Once your computer is prepared, you can follow the instructions for the [[#Standalone Download|standalone download]] version or the [[#Source Code|source code and Dev]] version of the randomizer.

=== Standalone Download ===
Download the current standalone download version of the randomzier by going to the [https://ootrandomizer.com/downloads downloads page on the website] and select the appropriate download for your operating system. The provided installers should install the randomizer to the appropriate place for your operating system and you should be able to launch the randomizer from your operating system's application launcher—Start Menu in Windows, Applications folder in macOS, and whichever application launcher you prefer for Linux. ''You must have [[#Install Python|Python 3.8 or higher]] installed for the standalone download randomizer to work''.

Once you have generated a randomizer ROM file, head to [[#Playing the Randomizer|playing the randomizer]].

==== Windows Troubleshooting ====
[[File:Setup-Standalone-WindowsSmartScreen.jpeg|none|thumb|Click <samp>More info</samp> then <samp>Run anyway</samp> to run the installer.]]

Often when a new version of the randomizer is released the standalone download is not trusted by the Windows operating system. When you try to run the installer it will pop up a Windows Smartscreen window. All you have to do is click <samp><kbd>More info</kbd></samp> and then the <samp><kbd>Run anyway</kbd></samp> button. The installer will then launch and install the randomizer.

=== Source Code ===
You can download either the release source code, or the development (Dev) branch source code to run the randomizer. Most users will want to use the [[#Standalone Download|standalone download]] for the release version, so this section will focus on running the latest development version from source code. ''You must have the latest [[#Install Node.js|Node.js LTS version]] and [[#Install Python|Python 3.8 or higher]] installed for the source code version of the randomizer to work''.

Head to the [https://ootrandomizer.com website] and in the navigation bar at the top, click on <samp><kbd>Resources</kbd></samp> and then choose the <samp><kbd>Dev Github</kbd></samp> option.<sup>1</sup> Next click on the <samp><kbd>releases</kbd></samp> button to reach the page with all of the randomizer releases.<sup>2</sup> Click on the <samp><kbd>zip</kbd></samp> button for the latest development version of the randomizer to download it.<sup>3</sup> ''The Dev branch of the randomizer is known to be unstable. The latest version may not work properly. If you run into issues you may want to join the {{discord|text=Discord server}} and ask which Dev version of the randomizer you should download''.

Locate the <samp>zip</samp> file you just downloaded in your <samp>Downloads</samp> folder, or wherever you saved it. <kbd>Right-click</kbd> the file and click <samp><kbd>Extract All...</kbd></samp> and extract the files from the zip archive.<sup>4</sup> A new folder should appear which may contain another folder inside. Open the folders until you see a folder with many folders and files inside. Locate the <samp>Gui.py</samp> file inside and <kbd>Double-click</kbd> it to launch the randomizer.<sup>5</sup> The first time you run the randomizer many files need to be downloaded from the internet. Wait patiently as they download.<sup>6</sup> ''This process will be faster every time you run the randomizer after this since it will only have to download the files once. Even if you download a new version it will be slightly faster as most of the files will be located in the Node.js cache and most will simply be used from there''.

The randomizer will launch once the initial installation has finished. Once you have generated a randomizer ROM file, head to [[#Playing the Randomizer|playing the randomizer]].

<gallery>
File:Setup-SourceCode-GitHubLink.jpeg|1. Open the <samp>Dev Github</samp> link to open the GitHub page for the main fork of the randomizer.
File:Setup-SourceCode-GitHubReleases.jpeg|2. The <samp>releases</samp> button will display all of the different randomizer versions.
File:Setup-SourceCode-GitHubZip.jpeg|3. A <samp>zip</samp> button should appear on the top release that you can click on.
File:Setup-SourceCode-WindowsExtract.jpeg|4. On Windows, choose to <samp>Extract All...</samp> from the zip file.
File:Setup-SourceCode-Gui-py.jpeg|5. Run the <samp>Gui.py</samp> Python script.
File:Setup-SourceCode-InitialInstall.jpeg|6. Wait patiently as Node.js downloads the randomizer's dependencies.
</gallery>

==== Alternative Source Code Download Method ====
You can alternatively use [https://git-scm.com/ Git] to download the source code. This is the easiest way to keep up to date with the latest changes. We have a guide on using [[GitKraken]], a GUI for git that many of the developers use if you want to try to download the source code this way. You still need to install [[#Source Code|the other software mentioned above]].

== Playing the Randomizer ==
===Emulators===
The Ocarina of Time Randomizer can be played on PC via an emulator. Given the emulation quality difference between emulators, not every emulator can be recommended.

The emulators we support are available for free and have been extensively tested to work well with OoTR, assuming proper setup.

[https://wiki.ootrandomizer.com/index.php?title=Project64 Project64 v3.0+] (Windows) is the least resource-intensive emulator and the easiest to setup. However, it is important that versions 3.0+ are used since these are currently the only ones that provide a stable game experience. Furthermore, '''<span style="color:red">please keep in mind that using Project64 v2.x for racing is against our community's racing rules</span>'''.

[[Bizhawk]] (Windows) is the most resource-intensive, but easier to setup than RetroArch. Bizhawk is also the only race-legal emulator to support [[Multiworld]] currently.

[https://wiki.ootrandomizer.com/index.php?title=Retroarch RetroArch] (Windows, macOS, Linux, and more) isn't as resource-intensive as Bizhawk. However, setting up RetroArch can be a frustrating experience, and especially so for certain controllers.

[[Dolphin]] (Windows, macOS, and possibly Linux and Android) is capable of running OoTR through emulating Wii Virtual Console. As a result, it also has the Wii VC advantage of having less lag when opening the item menu. Other advantages include being lightweight and being easy to set up, especially with Gamecube controllers and either the official Nintendo or the Mayflash adapter. Downsides include random Wii VC crashes, having to inject the OoTR ROM into a WAD for every seed and additional lag in some areas (e.g. Market) due to shortcomings in how Wii VC is emulated.

=== Wii Virtual Console ===

The Ocarina of Time Randomizer can be played on a [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console Wii] (or [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Playing_On_The_Wii_U.27s_Virtual_Wii Wii U]). The advantages are fast load times, less lag and improved graphics compared to the other options available. Some also prefer the stick sensitivity and deadzone settings of the Wii VC over that of pc emulators. The downsides are random (but extremely rare) crashes, installing new seeds is a longer process than on pc emulators, and potentially additional costs if you don't already own a Wii and/or compatible controllers or if you wish to stream your gameplay.

=== EverDrive ===

The Ocarina of Time Randomizer can be played on a N64 by using the [https://wiki.ootrandomizer.com/index.php?title=Everdrive EverDrive]. Keep in mind that EverDrives are expensive and that the N64 is very laggy. The randomizer also requires the memory pak, even though base Ocarina of Time does not.

== Patch Files ==
If someone shares a ZPF or ZPFZ file with you, these are [[Patch Files]]. They are a copyright-free method to share randomizer seeds with people. The [[Patch Files|patch files]] page will explain what to do with them.

MH MW

2024-01-09T21:23:38Z

Flagrama: Redirected page to Mido's House Multiworld

#REDIRECT [[Mido's House Multiworld]]

MH Multiworld

2024-01-09T21:23:13Z

Flagrama: Redirected page to Mido's House Multiworld

#REDIRECT [[Mido's House Multiworld]]

File:Github-mark-white.png

2024-01-09T20:56:11Z

Flagrama:

Logic

2023-11-15T16:15:29Z

Flagrama: /* Death Mountain Trail */ DMT summit without hylian shield (in logic currenlty)

'''“My Seed Is Broken!” (Glitchless Logic)''' - Solutions to completing randomized runs of ''Ocarina of Time'' can sometimes be unintuitive. While your seed may appear to be unbeatable, this isn’t often the case. Thanks to the diligent efforts of the developers, OoTR’s logic is incredibly robust. Listed below are some common sources of confusion, grouped by location. If you don’t mind spoiling the rest of the playthrough, instructions to finding your next step will be listed [[#Knowing_the_Way_with_the_Spoiler_Log|here]].

If you follow these steps and still need help, you’re welcome to ask for support in the {{discord|gameplay-and-tricks}} channel of the {{discord}}. Please provide the seed and setting string along with any important details about the issue. If it turns out there is indeed a logical flaw, kind members of our team will report issues from there.

{{TOClimit|1}}

= Other Logic Pages =
This page of the Wiki is for Glitchless Logic; for more information on Glitched and Entrance Randomizer Logic, please view the [[Glitched_Logic|Glitched]] and [[Entrance_Randomizer|Entrance Randomizer]] pages of the Wiki.

The logical item requirements for each dungeon are also available on the [[Vanilla_Dungeon_Requirements | Vanilla]] and [[Master_Quest_Dungeon_Requirements | Master Quest]] dungeon requirements pages.

It is also to document unusual logic that is '''absolutely required''' know in a seed to finish most randomizer seeds. Anyone who wish to contribute to the randomizer by adding features with logical requirements will likely need to be familiar with the logic on a deeper level. The [[Advanced Logic]] page will provide a better explanation of some of the more difficult to comprehend, but unnecessary to know by heart, logic quirks.

= Vanilla Help =
For a quick refresher regarding the most basic aspects of Ocarina of Time, see these [https://strategywiki.org/wiki/The_Legend_of_Zelda:_Ocarina_of_Time/Getting_Started getting Started pages for Ocarina of Time].

For players who have not played randomizer before, it is strongly recommended to play the original game (i.e. vanilla) before attempting a randomizer seed. Strategy guides such as those from [https://strategywiki.org/wiki/The_Legend_of_Zelda:_Ocarina_of_Time/Table_of_Contents StrategyWiki] and [https://www.zeldadungeon.net/ocarina-of-time-walkthrough/ Zelda Dungeon] can be very helpful. Video guides are also available, the user [https://www.youtube.com/user/ScarecrowScythe Krow's Graveyard] has a playlist for [https://www.youtube.com/playlist?list=PLC4ADFACDF4946595 Vanilla Ocarina of Time] and [https://www.youtube.com/playlist?list=PLDgypNs3MY2Rd1jlYqNTWIfeLW7AiuoOK Master Quest Ocarina of Time]. Understanding how to beat vanilla is '''vital''' to beating a randomized seed.

For those who would prefer a quicker experience, [https://ootrandomizer.com/seed/vanilla Vanilla] and [https://ootrandomizer.com/seed/MQvanilla Master Quest] are available as randomizer seeds with all the QoL changes inherent to randomizer.



<div style="font-size:larger;">'''Spinning Pottery'''</div>
The spinning Goron Pot is activated by lighting the torches surrounding it. This can be accomplished by lighting sticks from Darunia's chamber OR by casting Din's Fire.
The Spinning Pot has 3 faces - Happy, Neutral, and Mad. The Happy face will always give a randomized reward. If freestanding Rupees & hearts are also shuffled, then each face will give 3 randomized rewards.

<div style="font-size:larger;">'''Scarecrow’s Song'''</div>
Link must teach it to Bonooru (the scarecrow nearer the lake) as a child and then remind him again as an adult. The song cannot be all the same note; many alternate between two notes for simplicity.

<div style="font-size:larger;">'''Save Quits'''</div>
Saving and quitting, then reloading the game, inside dungeons will send you back to the beginning of the dungeon. If you get stuck somewhere without a warp song, you can save and quit outside the dungeon. Even if you have a warp song, certain locations like Dampe's Grave and Windmill don't let you warp and require you to save and quit if you get stuck. Reloading the game will return Link to the Temple of Time (if adult) or Link's house (if child).

<div style="font-size:larger;">'''Opening Grottos without Bombs'''</div>
Any grotto which can be opened with Bombs can also be opened with Hammer. However some grottos open when the Song of Storms is played and not with explosives.

= Misunderstood Vanilla Mechanics =
A lot of randomizer uses the vanilla requirements to do certain things. It just so happens that vanilla takes logic shortcuts in some locations because it's impossible to do some events before others. Meanwhile other events have requirements which do not come up in ordinary play. These are the most common issues people have starting randomizer after vanilla.

<div style="font-size:larger;">'''Open the Door of Time'''</div>
Play the Song of Time while standing in front of the pedestal. The only requirements are a '''Fairy Ocarina''' and the '''Song of Time'''. The Spiritual Stones are '''not''' required, and the Ocarina of Time is also '''not''' required.

<div style="font-size:larger;">'''Skull Kid Ignores the Skull Mask'''</div>
Skull Kid must be befriended with Saria's Song before he will buy the Skull Mask. This is '''not''' required for the Skull Mask check- that is done by showing the Skull Mask to the Deku Scrubs inside the Lost Woods Theater.

<div style="font-size:larger;">'''Saria Missing from Sacred Forest Meadow'''</div>
Link must have Zelda's Letter or later in the child trade sequence before Saria arrives to teach her song. This means finding the Weird Egg, waking Talon, and visiting Zelda first.

<div style="font-size:larger;">'''Ocarina of Time and Song of Time Cutscenes'''</div>
This is the Zelda & Impa's escape cutscene initiated by approaching the Castle Town draw bridge as a child. Link must have all 3 Spiritual Stones before approaching the draw bridge, Zora's Sapphire alone is not enough.

<div style="font-size:larger;">'''Can't Find the Running Man'''</div>
Link must possess all 3 Spiritual Stones before the Running Man appears in Hyrule Field. Zora's Sapphire alone is not enough.

<div style="font-size:larger;">'''Big Poe Hunt'''</div>
Without Epona, there is a 2/5 (40%) chance of a Big Poe spawning while passing their spawn areas. While on Epona, there is a 100% chance that the poe that spawns will be a Big Poe. Due to this, default logic does '''not''' expect hunting Big Poes without Epona. However, logic may expect them to be found as the random contents of bottles if the Big Poe Count setting is low enough.

<div style="font-size:larger;">'''Burning Village/Nocturne of Shadow Cutscene'''</div>
Link must have the <span style="color: green">Forest</span>, <span style="color: crimson">Fire</span>, and <span style="color: blue">Water</span> Medallions and then enter Kakariko Village as Adult. In vanilla Ocarina of Time you must enter from Hyrule Field, but in the randomizer it has been changed to entering from any entrance.

<div style="font-size:larger;">'''Castle Town Shooting Gallery'''</div>
Even though the Kakariko Shooting Gallery requires the bow for the special prize, you do not need to have the slingshot for the Castle Town Shooting Gallery's special prize.

<div style="font-size:larger;">'''Kakariko Shooting Gallery Gives 50 Rupees'''</div>
The Fairy Bow/Quiver is required to win the special prize, otherwise you will receive 50 rupees.

<div style="font-size:larger;">'''Requiem of Spirit'''</div>
The song typically acquired by leaving Spirit Temple as an adult can be collected as a child too. Exiting Spirit Temple is the vanilla requirement, since outside sequence breaks child would never reach the Colossus before adult.

In Entrance Randomizer, exit whichever dungeon is placed at Desert Colossus.

<div style="font-size:larger;">'''Zelda Light Arrow Cutscene'''</div>
Enter the Temple of Time as adult with the Shadow and Spirit medallions to receive this item check. Make sure you don't save and reset after entering the Temple of Time and before obtaining the item, [https://wiki.ootrandomizer.com/index.php?title=Common_Softlocks_And_Crashes or you could get locked out of it entirely].

= Vanilla Mechanics Changed by Randomizer =
Randomizer has also changed some vanilla mechanics in an attempt to make randomization of certain elements more valuable. Those ''very'' familiar with Ocarina of Time may want to take note of the following differences.

<div style="font-size:larger;">'''Ocarina Memory Game'''</div>
Randomizer changed this mini-game to only require completing the 5 note version of the game to obtain the item. The mini-game does not need to be done a second time.

<div style="font-size:larger;">'''Malon or Talon Missing from Ranch'''</div>
Malon and Talon normally appear in Lon Lon Ranch after speaking to Zelda and receiving Zelda's Letter. Due to Weird Egg being able to be shuffled some changes have had to be made to this to avoid softlocks. Waking Talon up at Hyrule Castle with the Cucco from the Weird Egg and obtaining Zelda's Letter will have him appear at the ranch. If the Weird Egg is not shuffled, Malon will also appear at the ranch after this. If Weird Egg is shuffled, she will not appear at the ranch until Link speaks to her at Hyrule Castle and receives an item from her.

<div style="font-size:larger;">'''Dampe's Heart-Pounding Gravedigging Tour'''</div>
Dampe no longer requires a random number of attempts and will instead dig up the Heart Piece on the first attempt. He doesn't even need to be over a dirt patch.

There is a bug in vanilla where if Link leaves the area before picking up the Heart Piece it is lost forever. The randomizer has ''mostly'' resolved this issue. Don't die before picking up the Heart Piece because this seems to do the same thing the vanilla bug does and isn't handled properly by the randomizer yet.

<div style="font-size:larger;">'''Sheik at Temple'''</div>
The Sheik cutscene at the Master Sword pedestal to obtain Prelude of Light has been changed from beating Forest Temple to obtaining the Forest Medallion. Once Link has the Forest Medallion, approaching the pedestal as adult either from the door of time, or from pulling the sword out as child will give you the reward.

<div style="font-size:larger;">'''Sheik in Ice Cavern'''</div>
The Sheik cutscene in Ice cavern to obtain Serenade of Water can be triggered as either age in OoTR instead of as adult only.

<div style="font-size:larger;">'''Fishing Pond'''</div>
The fishing reward minimums were lowered so an 8 pound fish is required as Child and a 10 pound fish is required as Adult. However, the lure must still be in deep enough water to cause the fish to bite.

<div style="font-size:larger;">'''Biggoron's Claim Check'''</div>
Biggoron no longer requires three days between giving him the eyedrops and claim check. The claim check can now be immediately returned to Biggoron for a randomized item.

<div style="font-size:larger;">'''Bombchu Bowling'''</div>
Randomizer changed this mini-game so that the two randomized prizes are always the first two prizes offered by the lady- if you lose the game, leave and re-enter to reset the prize order. The requirements for unlocking this check have also been changed- if bombchus are in logic, then finding a bombchu pack is required, otherwise a bomb bag is required if bombchus are not in logic.

== Forest ==
This section covers the following areas '''Kokiri Forest''', '''The Lost Woods''', and '''The Sacred Forest Meadow'''.

<div style="font-size:largest;">'''Closed Forest'''</div>
When the "Closed Forest" setting is active, Link is expected to stay in the aforementioned areas until beating Gohma in the Great Deku Tree. Do not leave these areas, even if there is a bomb bag, silver scale, or ocarina and a warp song. The Kokiri Sword will be in one of these forest areas and the shop will have a repeatably purchasable Deku Shield, even with Shopsanity active.

<div style="font-size:larger;">'''Slingshot'''</div>
If Closed Forest is enabled a Slingshot will always be found somewhere in '''Kokiri Forest''', '''The Lost Woods''', '''The Sacred Forest Meadow''' or '''[[#Inside the Deku Tree|The Great Deku Tree]]'''.

<div style="font-size:larger;">'''Hidden Grottos'''</div>
Hidden grottos in these areas can be required, especially with the Closed Forest setting enabled. The Stone of Agony must be found before logic can expect these locations, provided the trick that removes the SoA requirement is not enabled.

<div style="font-size:larger;">'''Tokensanity'''</div>
With Tokensanity enabled the three dirt patch Skulltulas can be required, especially if the Closed Forest setting is enabled. In the Lost Woods, jump slashing the bushes outside of the Goron City warp with a stick will release bugs which can be caught in a bottle and used on the dirt patches. Since the sword could be in a dirt patch, keep this in mind.

== Kakariko Village ==

<div style="font-size:larger;">'''Rear Entrance to Impa's House as Child'''</div>
Take a cucco to the incomplete building. Toss it onto the top of the pile of bricks and climb up after it. Once on top of the pile of bricks with the cucco, pick it up and fly across to the Scaffolding. From here follow behind the carpenter to reach a good position to jump towards the entrance above the chicken coop.

<div style="font-size:larger;">'''Reach Rooftops without Longshot'''</div>
It's possible to get on the important rooftops with only Hookshot. Get a little closer and try again.

<div style="font-size:larger;">'''Draining Kakariko Well'''</div>
Play the Song of Storms to the Windmill Operator as a child.

*Project 64 will have this issue if not configured correctly. Be sure you have followed the instructions in [[Project64]] if you run into it: ''Draining the well at night can crash the game; attempting it during the day is less likely to cause this crash.''

<div style="font-size:larger;">'''Freestanding PoH in Windmill'''</div>
The freestanding heart piece in the windmill doesn't always expect an ocarina or the Song of Time. Use the boomerang to grab the item here or, if the trick is enabled, [https://www.youtube.com/watch?v=vDl7lr4Ecv8| reach it as adult with no other items required].

== Death Mountain Trail ==

<div style="font-size:larger;">'''Freestanding Piece of Heart above Dodongo's Cavern'''</div>
If you're a child and you don't have the Goron's Bracelet, you can still backflip onto the ledge from where the bomb flower is by angling it correctly and backflipping from outside the grab range. Using C-Up will help. If you're an adult, the bomb flower isn't there.

<div style="font-size:larger;">'''Death Mountain Summit As Child Without Hylian Shield'''</div>
If you're a child and you don't have the Hylian Shield, you can still make your way up to the summit of Death Mountain Trail. The falling rocks can be avoided by holding Z and walking backwards, or by using invincibility frames while rolling to prevent damage when they hit you.

== Goron City ==

<div style="font-size:larger;">'''Reach Goron City from Lost Woods without Bombs'''</div>
Ignite the Bomb Flowers behind the boulders using Din’s Fire. Alternatively, if Adult Link destroys the boulders with Hammer, Strength, or Bow they'll be destroyed in the past so Child Link can enter.

<div style="font-size:larger;">'''Get Large Rolling Goron to Relinquish Goods'''</div>
Bomb the Goron in the dark tunnel near the sign (Bomb/Bombchu).

''In version 4.0 and older the Large Rolling Goron also requires Link to have a Bomb Bag''

<div style="font-size:larger;">'''Boulder Maze without Bombs or Hammer'''</div>
Silver Guantlets are effective at clearing a path to each of the chests in the room. This will take some time, however.

<div style="font-size:larger;">'''Reaching the Grotto'''</div>
This grotto is adult only, and contains three business scrubs. Requirements to reach this grotto are as follows: Goron Tunic + Hookshot, or Ocarina + Song of Time, or Nayru's Love + Hookshot. If one-hit KO or 4x damage is on, then the glitchless logical requirements are either Ocarina + Song of Time + Goron Tunic/Longshot/Nayru's Love, or Nayru's Love + Hookshot. Further explanation [[Grottos#Goron_City:_1_Grotto|here]].

== Death Mountain Crater ==

<div style="font-size:larger;">'''Reach the lower Exit'''</div>
From the top of the tall ladder, use the Hover Boots to hover over the boulder blocking the shortcut to Goron City (lower exit). Hover Boots can also be used at the bottom of the ladder to bypass the Boulder.

<div style="font-size:larger;">'''Reach the Bottom Area for Bolero of Fire and Access to Fire Temple'''</div>
Use Hover Boots to cross the dilapidated bridge to reach the Warp Platform & Fire Temple.

Alternatively, reach this bottom area with the Longshot by jumping from the upper area onto the lava platforms below and shooting a wooden plank to pull Link across the pool of lava.

== Zora’s Domain ==

<div style="font-size:larger;">'''Access with Silver Scale'''</div>
Silver Scale allows access to Zora's Domain as child from Lake Hylia.

<div style="font-size:larger;">'''Need Blue Fire to Unfreeze King Zora/Zora Shop'''</div>
In Ganon’s Castle, Blue Fire can be found in Water Trial. Blue Fire may also be a purchasable item for 300 rupees in shops.

== Lake Hylia ==

<div style="font-size:larger;">'''Go fishing'''</div>
The fishing man rewards an 8 pound fish as a Child and a 10 pound fish as an Adult. Make sure to toss the lure in deep enough water to entice fish to bite. There's a minimum depth required for the mini-game to work. Tossing the Lure in very shallow water may cause the fish may swim around the Lure but never bite.

<div style="font-size:larger;">'''Lake Hylia - Shooting the Sun with an Arrow'''</div>
The tall rectangle island can be reached without filling the lake by using Scarecrow's Song and Longshot. You may not need to complete the Water Temple and raise the water level at Lake Hylia to acquire the item. The arrow must be fired at the sun during the early morning as per the written instructions on the stone platform.

== Gerudo Fortress/Gerudo Valley ==

<div style="font-size:larger;">'''Traversing the Gerudo Valley Broken Bridge'''</div>
Cross the Broken Bridge as an Adult by using either Epona to jump it or using the Longshot on the sign above the gate on the other side.

<div style="font-size:larger;">'''Entering Gerudo Training Grounds without Being Captured'''</div>
Link must have the Gerudo Membership Card and also rescue all of the Carpenters that have been captured. If the Gerudo Membership Card is shuffled, then only the card is needed and the Carpenters do not need to be rescued to access the area.

<div style="font-size:larger;">'''Getting Caught without a Hookshot'''</div>
If caught by a Gerudo Guard, either inside during combat or outside by being seen, without a Hookshot, Link will be thrown into the valley outside the tent, rather than into the jail cell from which Link could not escape.

<div style="font-size:larger;">'''Horse Archery NPC is Missing or Won't Initiate the Mini-game'''</div>
This mini-game requires the Fairy Bow, Epona, and the Gerudo Membership Card. It must also be day time.

<div style="font-size:larger;">'''Fortress Rooftop Chest without Longshot'''</div>
The chest can be reached from the top with the Hover Boots or by spawning a scarecrow and using the Hookshot. You'll have to stand close to the edge of the top level for the Hookshot to reach. Note that you won't see the Hookshot's red dot on the scarecrow.

== Haunted Wasteland ==

<div style="font-size:larger;">'''Bombchu Salesman'''</div>
As an adult, jump off the edge and use a jump-slash to land on the carpet. If the trick "Reverse Haunted Wasteland" or "Wasteland Crossing" is activated you may also have to do this as child. Either a Deku Stick or sword will work.

== Inside the Deku Tree ==

<div style="font-size:larger;">'''Access F3 without Slingshot'''</div>
The slingshot is not required to get to the top floor of the Deku Tree. In fact, in Master Quest Link doesn't get the slingshot until climbing all the way up the tree in the first place. Skulltulas don't rush Link when he is not moving. Sneak past them while they are looking away.

<div style="font-size:larger;">'''Two Chests in Slingshot Room'''</div>
In vanilla Deku Tree there are two chests in the Slingshot room. The first is the obvious one that has the slingshot, but there are climbable vines on the wall to the left of it which lead to a second chest.

== Dodongo's Cavern ==

<div style="font-size:larger;">'''Gold Skulltula on top of the Sinking Staircase'''</div>
Progress through the right side of the dungeon and hit the switch that makes the platforms in the entrance room rise higher, then leave the dungeon and re-enter it, progress through the dungeon backwards by taking the right platform in the entrance room to the top floor and going through the door on the upper level. This will grant you access to vines on the side of the stairs before the stairs have been lowered by the bomb blasts.

== Inside Jabu-Jabu's Belly ==

<div style="font-size:larger;">'''First Switch'''</div>
The switch on the ceiling in the first room of Jabu Jabu's Belly can be hit using explosives.

== Forest Temple ==

<div style="font-size:larger;">'''Get Outside without Song of Time or Bow'''</div>
With Hover Boots, float to the door connecting the large block-pushing room with the courtyard.

<div style="font-size:larger;">'''Cross to the Other Courtyard via Well'''</div>
With Gold Scale or Iron Boots, Link can cross from one courtyard to the other through the well.

<div style="font-size:larger;">'''Can’t Push Large Colored Blocks as Adult'''</div>
In the Forest Temple, the Goron’s Bracelet is required to push these blocks, even as adult. Link only put on gauntlets to keep his hands from drying out.

<div style="font-size:larger;">'''Triggering the Frozen Eye Switch without Bow'''</div>
Use Din's Fire from the platform below the frozen eye switch to activate it.

== MQ Forest Temple ==

<div style="font-size:larger;">'''Get Outside with just Hover Boots'''</div>
The western courtyard can be reached from the room with the block-push puzzle by hovering towards the crystal switch behind the transparent wall and then jump slashing to hit the switch from the other side. This will remove the transparent wall, allowing you to hover to this door leading to the courtyard. The ledge from which you'll want to hover is behind the first blocks, but if you lack strength then this ledge can also be hovered to from where you end up after climbing the second ladder. If you have trouble making these hovers, then try rolling for extra distance.

== Fire Temple ==

<div style="font-size:larger;">'''Can’t Push Large Colored Blocks as Adult'''</div>
In the Fire Temple, the Goron’s Bracelet is required to push these blocks, even as adult. Link only put on gauntlets to keep his hands from drying out.

<div style="font-size:larger;">'''Reach Volvagia without Hammer'''</div>
With Hover Boots equipped, it’s a simple matter of floating over to the boss door. That said, the Hammer is still required to defeat the boss.

<div style="font-size:larger;">'''Skip the Topmost Locked Door'''</div>
Similarly to Volvagia, skip the topmost locked door by using Hover boots to float over to the pillar. Then use the Hammer to open the door leading to the Highest Goron and Hammer Chest.

<div style="font-size:larger;">'''Extra Key'''</div>
When key-sanity is disabled (that is, keys are in their own dungeon), the lock in the basement behind the hammer blocks is removed. This results in a spare key for this dungeon.

== MQ Ice Cavern ==

<div style="font-size:larger;">'''Hitting the Crystal Switches'''</div>

The pot at the entrance of the Ice Cavern is the only thing required to hit the first crystal switch.

For the crystal switch hanging from the ceiling, the pot in the previous room is the only thing required.

== Water Temple ==

<div style="font-size:larger;">'''Entering without Iron Boots'''</div>
The entryway is in logic with just longshot and gold scale. However, nothing inside Water Temple is in default logic without Iron Boots, except for beating Morpha and part of the Dark Link loop (Longshot chest, whirlpool river chest and the Gold Skulltula in the falling platforms room). Therefore this is only logically relevant in Entrance Randomizer or various Boss/Small Key settings. Nevertheless, there are [https://www.youtube.com/watch?v=4_3GPW8xVuo strats for getting most of the checks in Water Temple without Iron Boots].

<div style="font-size:larger;">'''Boss Key Chest without Bombs or Goron’s Bracelet'''</div>
Use the Hover Boots to reach the chest.

<div style="font-size:larger;">'''Getting Past the Timed Gate without Longshot'''</div>
After shooting the eye switch, cross the gap with Hover Boots.

<div style="font-size:larger;">'''Center Room Gold Skulltula without Longshot'''</div>
Cast Farore’s Wind inside the center room. Raise the water to its highest level and cast Farore's Wind again to return to the warp point. Swim to the surface to reach the Gold Skulltula. '''In versions 6.0 and newer''', this is no longer in default logic.

<div style="font-size:larger;">'''Extra Key'''</div>
The door leading to the highest water level changer is never locked in rando. This results in a spare key for this dungeon.

<div style="font-size:larger;">'''Can’t Raise the Water Level'''</div>
''This is only relevant prior to version 4.0 of randomizer''

With the water level lowered, jump down to the second level of the central structure. This may require savewarping to the beginning of the dungeon to reach. Use the Hookshot to climb onto the top level. With a well-spaced rolling jump you should be able to reach the ledge where you can raise the water to its highest level. This isn't required but it's a handy time saver.

== Shadow Temple ==

<div style="font-size:larger;">'''Crossing the First Gap without Hookshot'''</div>
Hoverboots will reach the other side. If you fall short, start from the wall to build up speed before leaving the ledge.

<div style="font-size:larger;">'''First Silver Rupee Room without Hookshot'''</div>
Reach raised platform in the corner of the room by using the Hover Boots from the nearby low wall.

<div style="font-size:larger;">'''Spike floor room without Longshot'''</div>
Backflip onto the chest spawned in the middle of the room. From there, use the Hookshot to reach the upper ledge.

<div style="font-size:larger;">'''Reach the Boat without Goron’s Bracelet'''</div>
Bypass pushing the large block by shooting the top of the ladder with a Hookshot.

<div style="font-size:larger;">'''Reach Bongo Bongo without the Fairy Bow'''</div>
Play the Scarecrow’s Song to summon Pierre. Use Longshot to get to the other side.

<div style="font-size:larger;">'''Go through the Wind Tunnel without Iron Boots'''</div>
Timing is key. Move when the fans stop. Tip: You can stand between the fans in the final section. There are lines in the floor that mark the safe zones.

== MQ Shadow Temple ==

<div style="font-size:larger;">'''Spike floor room without Longshot'''</div>
Backflip onto the chest spawned in the middle of the room. From there, use the Hookshot to reach the upper ledge. The Silver Rupees can be collected with just the Hookshot (and Hover Boots) since the Hookshot targets on the ceiling are just low enough for the Hookshot to reach them.

== Gerudo Training Ground ==

<div style="font-size:larger;">'''Lava room without Longshot'''</div>
The torch at the end of this room is in reach using only the Hookshot.

<div style="font-size:larger;">'''Timed Boulder Room without Longshot'''</div>
The target on the ceiling is just within range of the Hookshot when standing almost directly under it. A wallmaster can also lift Link into the rupee if it’s the last to be collected.

== Spirit Temple ==

<div style="font-size:larger;">'''Child Side Enemy Room'''</div>
In order to kill the Armos in this room, you're expected to have at least one of the following item combinations: Deku Sticks (jumpslashes can hit), Kokiri Sword, or Deku Nuts + Slingshot.

<div style="font-size:larger;">'''Lower Metal Bridge on Child Side without Boomerang'''</div>
You can just barely hit the switch with a well-placed slingshot shot. Alternatively, hit the crystal switch with a well-timed Bombchu placement in the opposite direction.

<div style="font-size:larger;">'''Map chest without Din’s Fire or Magic'''</div>
Child Link is perfectly capable of lighting the torches using only a Deku Stick.

<div style="font-size:larger;">'''Collect Silver Rupees in the Boulder Room without Hover Boots'''</div>
Reach the floating rupee by jumping into the boulder with a jump slash, or even without hitting the boulder with a properly timed jump slash.

<div style="font-size:larger;">'''Silver Gauntlets Chest from Adult Side using Longshot'''</div>
With a Longshot, shoot the chest opposite from the Mirror Shield chest to gain access to its contents and the end of child-side.

<div style="font-size:larger;">'''Boss Key Chest'''</div>
The Eye Switch can be accessed by hitting the fake door with something to make it fall over. You do not necessarily need to destroy the fake door.

== Inside Ganon’s Castle ==

<div style="font-size:larger;">'''Spirit Trial without Fire Arrows'''</div>
A precise shot of an arrow through the torch will burn the web to reveal the light.

<div style="font-size:larger;">'''Water Trial Blue Fire'''</div>
With your bridge requirement set to Open, Blue Fire can be brought from the Water Trial to thaw King Zora or, if you have shopsanity active, to open the Zora Shop as adult if inaccessible as child.

<div style="font-size:larger;">'''Shadow Trial First Chest without Hookshot and Fire Arrows'''</div>
Playing the Song of Time will spawn Song of Time blocks leading to the first chest. Hover boots will also work.

<div style="font-size:larger;">'''Shadow Trial (Second Chest or Trial Completion) without Fire Arrows'''</div>
There are 2 scenarios possible here, either with Hover Boots or with Din's Fire. Obviously, Link may have both, in which case either method will work.<br/>
With Hover Boots, Longshot the torch to the right as you enter. From there, Link can reach the Like-Like with the Longshot. Once to the middle platform, equip the Hover Boots and roll across the gap to the platform where the chest spawns. From here open the chest and finish the trial.<br/>
With Din's Fire as a fire source, do the same thing as with Hover Boots, but instead of going to the Like-Like immediately, cast Din's Fire first. This will spawn the glass platform to the chest platform so Link can jump across.

== MQ Inside Ganon's Castle ==

<div style="font-size:larger;">'''MQ Forest Trial'''</div>

Getting to the room where the Forest Crystal is only requires the Song of Time. While on the ledge that has the door leading to the Forest Crystal room, go to the edge of the corner near where the Blue Switch is and play the Song of Time. You do not need to be on the platform where the Beamos is.

<div style="font-size:larger;">'''MQ Shadow Trial Bomb Flower Chest'''</div>

For the Bomb Flower Chest, logic expects you to either use the Bow, Explosives, Strength, or Din's Fire to blow up the bomb flower. To get to the platform where the chest spawns, either the Hookshot or Hover Boots are required.

= Knowing the Way with the Spoiler Log =

The spoiler log contains information about your personally randomized copy of the game and can be very helpful when looking for important items you've missed. Please be aware that the Playthrough presented is intended to prove the seed is beatable in logic. It does not represent the only way to logically beat the seed. It takes only a few steps to find:

= How do I find my Spoiler Log? =
*[[Frequently_Asked_Questions#How_Do_I_Find_My_Spoiler_Log_Again.3F|How do I find my spoiler log again?]]

<div style="font-size:larger;">'''Versions 1.0 - 3.0 and Standalone Download'''</div>
Open the spoiler log generated in the same folder that the randomized ROM is located in. It should be formatted as <code>OoT_SETTINGSTR_SEED_Spoiler.txt</code>.

Template:Info

2023-11-09T02:51:07Z

Flagrama: oh I'm just dumb

{{tag
|class=bg-info info text-info
|shorttext={{#if:{{{1|{{{mainpoint|}}}}}}|{{{1|{{{mainpoint|}}}}}}|}}
|description={{#if:{{{2|{{{details|}}}}}}|{{{2|{{{details|}}}}}}|}}
|smalltext={{#if:{{{3|{{{extra|}}}}}}|{{{3|{{{extra|}}}}}}|}}
}}<noinclude>{{Documentation}}[[Category:Header box templates]][[Category:Templates]]</noinclude>

Template:Info

2023-11-09T02:47:15Z

Flagrama: another fix attempt

{{tag
|class=bg-info info text-info
|shorttext={{#if:{{{1|{{{mainpoint|}}}}}}|<b>{{{1|{{{mainpoint|}}}}}}</b>|}}
|description={{#if:{{{2|{{{details|}}}}}}|{{{2|{{{details|}}}}}}|}}
|smalltext={{#if:{{{3|{{{extra|}}}}}}|{{{3|{{{extra|}}}}}}|}}
}}<noinclude>{{Documentation}}[[Category:Header box templates]][[Category:Templates]]</noinclude>

Template:Info

2023-11-09T02:42:16Z

Flagrama: add defaults

{{tag
|class=bg-info info text-info
|shorttext={{#if:{{{1|{{{mainpoint|}}}}}}|'''{{{1|{{{mainpoint|}}}}}}'''|This is the main point of the information.}}
|description={{#if:{{{2|{{{details|}}}}}}|{{{2|{{{details|}}}}}}|These are details of the information.}}
|smalltext={{#if:{{{3|{{{extra|}}}}}}|{{{3|{{{extra|}}}}}}|These are extra details of the information that aren't as important.}}
}}<noinclude>{{Documentation}}[[Category:Header box templates]][[Category:Templates]]</noinclude>

Template:Info

2023-11-09T02:40:20Z

Flagrama: try fix again

{{tag
|class=bg-info info text-info
|shorttext={{#if:{{{1|{{{mainpoint|}}}}}}| '''{{{1|{{{mainpoint|}}}}}}''' |}}
|description={{#if:{{{2|{{{details|}}}}}}|{{{2|{{{details|}}}}}}|}}
|smalltext={{#if:{{{3|{{{extra|}}}}}}|{{{3|{{{extra|}}}}}}|}}
}}<noinclude>{{Documentation}}[[Category:Header box templates]][[Category:Templates]]</noinclude>

Template:Info

2023-11-09T02:37:24Z

Flagrama: try fix

{{tag
|class=bg-info info text-info
|shorttext={{#if:{{{1|{{{mainpoint|}}}}}}|''' {{{1|{{{mainpoint|}}}}}} '''|}}
|description={{#if:{{{2|{{{details|}}}}}}|{{{2|{{{details|}}}}}}|}}
|smalltext={{#if:{{{3|{{{extra|}}}}}}|{{{3|{{{extra|}}}}}}|}}
}}<noinclude>{{Documentation}}[[Category:Header box templates]][[Category:Templates]]</noinclude>

Template:Info

2023-11-09T02:34:28Z

Flagrama: fix

{{tag
|class=bg-info info text-info
|shorttext={{#if:{{{1|{{{mainpoint|}}}}}}|'''{{{1|{{{mainpoint|}}}}}}'''|}}
|description={{#if:{{{2|{{{details|}}}}}}|'''{{{2|{{{details|}}}}}}'''|}}
|smalltext={{#if:{{{3|{{{extra|}}}}}}|{{{3|{{{extra|}}}}}}|}}
}}<noinclude>{{Documentation}}[[Category:Header box templates]][[Category:Templates]]</noinclude>

Template:Info

2023-11-09T02:28:00Z

Flagrama: Created page with "{{tag |class=bg-info info text-info |shorttext={{#if:{{{1|{{{mainpoint|}}}}}}|'''{{{1|{{{reason|}}}}}}'''|}} |description={{#if:{{{2|{{{details|}}}}}}|'''{{{2|{{{details|}}}}}..."

{{tag
|class=bg-info info text-info
|shorttext={{#if:{{{1|{{{mainpoint|}}}}}}|'''{{{1|{{{reason|}}}}}}'''|}}
|description={{#if:{{{2|{{{details|}}}}}}|'''{{{2|{{{details|}}}}}}'''|}}
|smalltext={{#if:{{{3|{{{extra|}}}}}}|{{{3|{{{extra|}}}}}}|}}
}}<noinclude>{{Documentation}}[[Category:Header box templates]][[Category:Templates]]</noinclude>

Template:Rule embed

2023-10-28T18:24:15Z

Flagrama: add ul around li

<div class="mw-collapsible {{#if:{{{expand|}}}||mw-collapsed}}">
<ul><li class="mw-collapsible-header">{{{1|Text}}}</li></ul>
<div class="mw-collapsible-content" style="{{{liststyle|text-align:left;padding:0}}}">{{#if:{{{2|<youtube>v=zqCgYBYziJU</youtube>}}} |{{-}}{{{2|<youtube>v=zqCgYBYziJU</youtube>}}} }}</div>
</div></div>

Standard

2023-10-28T18:20:50Z

Flagrama: using new rule embed template format

Here will be listed what is allowed or banned in the Standard racing ruleset, along with examples, an explanation, or a justification where necessary. This ruleset is subject to change based on the community feedback and the wisdom of the Race Mod team. This ruleset is typically raced with [[Logic|glitchless]] logic. [[Rules|Other rulesets are also available.]]

*''Please keep in mind that the [[Rules#Universal_Rules|Universal Rules]] apply to all OoTR races, including Standard Ruleset races.''

=== Basic Techniques ===

*Basic in-game mechanics and movement that are helpful and sometimes expected in default logic depending on settings include:
**Jumpslashing while mid-air for more distance
**Jumpslashing against a wall to recoil
**Save+Quitting, dying, and voiding to reset Link’s position
**Getting grabbed or thrown by an enemy into a collectible such as a Silver Rupee or a Gold Skulltula Token
**Power Crouch Stab
**Recoil Jump (Shielding damage midair to reset Link’s animation)
**Twisted sidehops and twisted backflips
**Gainers
***Using forward momentum movement from hover boots to forward flip over obstacles
***Also targeting a wall to redirect a sidehop or backflip’s momentum
*Any accidental glitch which does not grant the player an advantage is okay
**EG: Accidental ISG if dispelled and not used
*Any technique that is potentially required by the randomizer settings of your given race is allowed
**NB: This includes logical tricks

=== Allowed Glitchless Techniques ===

*Momentary Antigravity (1 frame)
*Schrodinger’s Chain, a.k.a Castle before Night or Cat Chain
*Hookshot and Bow Extension
{{rule embed|Obtaining and using a broken Deku Stick|<youtube>v=zqCgYBYziJU</youtube>}}
*Taking damage to abuse invincibility frames is allowed. This includes
**Damage buffering
**Opening flaming chests
**Passing through flame walls
*Solving puzzles in unintended ways, including skipping item requirements is allowed unless explicitly banned. Allowed techniques include
**Crossing the Haunted Wasteland without Longshot, Hover Boots, Magic or Lens
**Rolling from blue switches to quickly open doors
**Using a cucco (child) or Hover Boots to get behind the water in Zora’s River
**Backflipping over Mido in the Lost Woods as adult
**Hookshotless Gerudo Training Ground
**Entering Water Temple with the Gold Scale and no Iron Boots
**Jumping over the gate next to King Zora to access adult Zora’s Fountain
**Completing Diving in the Lab with Iron Boots and Hookshot
*Using cutscene items whilst falling through air such as Farore’s Wind in Fire or Din’s Fire in Deku Tree
*Interacting with actors on the other side of collision as long as Link’s actor does not pass through them is allowed. This includes
**Attacking to collect an object or hit a switch on the other side of collision
**Damaging Volvagia’s second hitbox
**Killing and collecting Gold Skulltulas inside red boulders
*Passing through the backside of one-sided collisions is allowed. Some examples of this include
**The bottom of the Kokiri Forest Bridge
**The door to Darunia’s room in Goron City
**The Song of Time block in the lobby of Forest Temple
**The gate towards Death Mountain Trail in Kakariko Village

=== Allowed Glitch Techniques ===
*Swimming with Iron Boots
*Opening underwater chests with Iron Boots
*A small, curated list of glitches that make the format more accessible and increase routing options are allowed. This list is
**Storing a Ground Jump via Grab A
**Using a stored Ground Jump to cancel a backflip or sidehop off solid ground
**Flame Storage
**Using a backflip to clip through the spike crushers in the spike crusher room of Shadow Temple

=== Banned Routing Sequence Breaks ===
*There are some techniques that can skip item requirements from default logic that are banned. This list is
**Entering Shadow Temple without Din’s Fire (unless randomizer settings of your race require it)
**Crossing over the broken Gerudo Valley Bridge using any method other than the Longshot or Epona
**Accessing the Spirit Temple boss door without using Hookshot or Longshot
**Accessing the wind tunnel room of Shadow Temple from the invisible spikes room without using Hookshot or Longshot
**Performing the Cucco Jump to cross the Gerudo Valley bridge as child
**“Crazy Dance” or other variants to access the adult side of Spirit Temple as child
**Wallwalking (previously known as seam walks)
**Crossing the broken bridge gap in Death Mountain Crater without using Hookshot, Longshot, Hover Boots, or floating on a Magic Bean.

=== Banned Glitches/Techniques ===
*Any platform exclusive tricks are banned
*Infinite Sword Glitch (ISG)
*Explosion/Damage based glitches/techniques such as:
**Megaflipping
**Megasidehopping
**Weirdshotting
**All forms of Superslide (SS, ESS, HESS, etc)
**Ground Jumping while mid-air (such as while floating with the Hover Boots)
**Recoil Jumping while mid-air (such as while floating with the Hover Boots)
**Using any form of damage or recoil to conserve speed or cross an otherwise uncrossable gap is banned. This includes
***Damage boosting
***Hoverboosting (equipping Hover Boots on a specific frame after taking damage)
***Megajumping (equipping Hover Boots on a specific frame of a jump)
***Recoil boosting (equipping Hover Boots on a specific frame after recoiling)
*Anything except Sword on B (excluding normal circumstances like riding Epona or playing minigames)
*Equip Swap
*Action Swap
**NB: Including using the explosion limit to Ground Jump
*Ocarina Items
*Duplicating any item checks or items in the inventory (such as Bottles and heart pieces)
*Retaining the Master Sword in Phase 1 of the Ganon fight by any means
*Using Temp B to alter the B button to an unnatural state
**NB: This can happen by accident and can be fixed by equipping a sword. If you are a child and do not have a sword, you cannot use the item on B.
*Using restricted items such as Farore’s Wind in the overworld or Ocarina in a boss room
*All forms of clipping are banned unless explicitly allowed in the previous section. For definitions of clipping for both polygonal and non-polygonal collision, please click the relevant links. Things that fall into the category of banned clipping are
**Passing through collision from the front
**Squeezing past boulders
**Hookshotting/Longshotting through boulders
*Touching misplaced or accidentally exposed loading zones is banned. This includes
**Entering Jabu Jabu without a bottled fish
**Trials skip
**Entering the Market or Kakariko shops that are normally closed at night
*Unloading or passing through actors which should be loaded is banned. This includes
**King Zora’s red ice (even as it melts)
**Graveyard graves
**Gold Gauntlet monoliths
*Abusing actors which have not updated, i.e.
**Deku Tree basement web
**Bombing (0, 0, 0) to kill unloaded actors
**Bongo Bongo quick kill
*Abusing boulders’ distance-based collision to shoot projectiles through
*Hookshot Jump/Doom Jump
*Down A, Return A, Blank A
*Wrong Warp
*Void Warp
*Entrance Point Glitch
*Actor Glitch
*Z-Slide and A-Slide
**This includes super swimming
*Extended Antigravity
*Low Gravity Glitch
*Quick Put Away (QPA)
*Using the Glitch Damage Value for Power Crouch Stab
*Walking while talking
*Dying to achieve anything other than a deathwarp or a health refill such as the Jabu Parasitic Tentacles skip (“slimy thing”)
*Causing a switch to remain pressed longer than it should
*Cutscene diving to sink into water is banned. This includes Navi, cuccos, and items.
*Being out of bounds or an unloaded area. This is defined to be any area which is beyond the boundary walls of the map or any area which is exposed to the lowest void plane on the map
*Collection Delay
*Stale Reference Manipulation (SRM)
*Arbitrary Code Execution (ACE)
*Item Manipulation
**Bottle Adventure (BA)
**Reverse Bottle Adventure (RBA)
**Get Item Manipulation (GIM)

<br />Any new technique or glitch not mentioned will be ALLOWED but subject to a decision by the race mods for legality.

[[Category:Racing Rules]]

Template:Rule embed

2023-10-28T18:12:49Z

Flagrama: test with html and not using collapsible list

<div class="mw-collapsible {{#if:{{{expand|}}}||mw-collapsed}}">
<li class="mw-collapsible-header">{{{1|Text}}}</li>
<div class="mw-collapsible-content" style="{{{liststyle|text-align:left;padding:0}}}">{{#if:{{{2|<youtube>v=zqCgYBYziJU</youtube>}}} |{{-}}{{{2|<youtube>v=zqCgYBYziJU</youtube>}}} }}</div>
</div></div>

Template:Rule embed

2023-10-28T17:43:42Z

Flagrama: place in div

<div>{{collapsible list|{{{1|}}}
|title=
|framestyle=overflow:auto;
|titlestyle=line-height:1.6;
}}</div>

Template:Rule embed

2023-10-28T17:35:34Z

Flagrama:

{{collapsible list|{{{1|}}}
|title=
|framestyle=overflow:auto;
|titlestyle=line-height:1.6;
}}

Template:Rule embed

2023-10-28T17:35:21Z

Flagrama:

{{collapsible list|{{{1|<youtube>v=-xNjTtcA4Es</youtube>}}}
|title=
|framestyle=overflow:auto;
|titlestyle=line-height:1.6;
}}

Template:Rule embed

2023-10-28T17:05:27Z

Flagrama:

{{collapsible list|<youtube>{{{1|v=-xNjTtcA4Es}}}</youtube>
|title=
|framestyle=overflow:auto;
|titlestyle=line-height:1.6;
}}

Template:Rule embed

2023-10-28T17:04:47Z

Flagrama: Created page with "{{collapsible list|<youtube>{{{2|v=-xNjTtcA4Es}}}</youtube> |title= |framestyle=overflow:auto; |titlestyle=line-height:1.6; }}"

{{collapsible list|<youtube>{{{2|v=-xNjTtcA4Es}}}</youtube>
|title=
|framestyle=overflow:auto;
|titlestyle=line-height:1.6;
}}

Setup

2023-10-09T18:45:18Z

Flagrama: /* Install Node.js */ remove incorrect version info

It is usually recommended to use the online generator on the website instead of the download or source code versions of the randomizer. The [[#Video Tutorial|video tutorial]] is also available as a walk through for the website. The [[Readme]] explains what the different options do. You can also check out the [[Changelog]] to see what changes have happened between randomizer versions. Recent [https://ootrandomizer.com/generatorDev Dev] and [https://ootrandomizer.com/generatorDev?version=devR_ Dev-R] versions are also available on the website.

Ocarina of Time Randomizer is compatible with emulators, Wii Virtual Console, and original Nintendo 64 hardware. Learn more about these options in the [[#Playing the Randomizer|Playing the Randomizer]] section.

Base files (ROMs, Wii common key, etc.) that are needed to play Ocarina of Time Randomizer are copyrighted and will not be provided by the community nor staff.

''If you want to run the [https://ootrandomizer.com/downloads standalone download] version of the randomizer, you should skip to [[#Install Python|installing Python]].''

''If you want to run the [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/master release source code] or [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/Dev Dev source code] version of randomizer, you should skip to [[#Install Node.js|installing Node.js]].''

''We have compiled [https://wiki.ootrandomizer.com/index.php?title=Common_Softlocks_And_Crashes a list of known softlocks and crashes]. It is recommended to read it through to potentially save you from frustration later.''

{{TOClimit|3}}

== Online Generator ==

This section contains information similar to what is presented in the video by TreZc0, but does not go into as much detail regarding randomization options or emulator setup. The [[Readme]] and [[https://wiki.ootrandomizer.com/index.php?title=Setup#Emulators emulator]] pages available to help with those details. The video is highly recommended, especially since it will provide visuals to aid in setup.

=== Video Tutorial ===
<youtube dimensions="480x270">https://www.youtube.com/watch?v=-xNjTtcA4Es</youtube>

Once you have viewed the video, generated a seed, and patched a randomizer ROM file, head to [[#Playing the Randomizer|Playing the Randomizer]].

=== Generating a Seed ===
The online randomizer does not require any downloads except for the final randomized rom, however you will be required to have one or more base files to create the randomized rom. Some of these are copyrighted files that you will need to have prior to receiving any help with setup in the {{discord|text=randomizer discord}}. Please read all rules of the discord and peruse the resources channel before requesting assistance there.
* '''Always Required'''
** OoT v1.0 NTSC-U/NTSC-J ROM - Copyrighted file
** A device with a multicore CPU & at least 2GB of available ram
*** Even most modern mobile devices (i.e. 2019 or newer) meet these requirements
** A modern browser (2020 or later): Chrome, Firefox, Edge, Safari, or Opera
** A method to play the game, which is covered later in the [[#Playing the Randomizer|Playing the Randomizer]] section.
* '''Only Required for WiiVC/vWii/Dolphin'''
** OoT v1.2 NTSC WAD - Copyrighted file
** Wii Common Key - Copyrighted file

Once prepared, go to https://ootrandomizer.com and click on the <samp><kbd>Play Now</kbd></samp> button for the latest stable version.
[[File:Setup-Website-PlayNow.jpeg|none|thumb|Click the <samp>Play Now</samp> button on the website to open the online generator.]]

Just below the "Ocarina of Time Item Randomizer v6.2" title is the button <samp><kbd>INSTRUCTIONS/HELP</kbd></samp> which effectively repeats the information available here and in the video at a quick glance.

Detailed explanations of the settings can be found on the [[Readme]] page and quick tooltips can be seen by hovering over any setting in the generator.

'''For a first seed, we recommend using either the Default/Beginner or Easy presets available on the "ROM Options" tab of the generator.''' The Default/Beginner preset is aimed at those familiar with vanilla who desire a similar progression. It uses base glitchless logic with no added tricks and no additional timesavers enabled (see the tab "Other" in the GUI). The world begins closed. Expect a long playthrough. The Easy Preset is aimed at those who have perhaps seen a few Randomizer runs previously and/or wish to dive right in. It uses base glitchless logic with no added tricks, but it does use additional timesavers (see the tab "Other" in the GUI). The world is more open after leaving Kokiri Forest.

Once a preset is selected from the dropdown, click <samp><kbd>LOAD</kbd></samp> and all settings shown in the generator, except Cosmetics and SFX, will change to match the preset. Feel free to look at the other tabs to see which settings are enabled by each preset before deciding which to use.

[[File:Presets.png|none|thumb|Presets location on the ROM Options tab of the generator.]]

If you're feeling a little more bold, settings may still be changed from those loaded by the preset to any you desire. '''However''', on the first tab of the randomizer, ROM Options, please never disable "'''Create Spoiler Log'''." The Spoiler Log is a file containing all the item locations, settings, and entrances when applicable of the randomized seed. Though you may never look at it, it is vital for those helping in the randomizer discord to be able to check this log if you require help at any point in the seed.

Once the settings are prepared, there are two options to generate the seed, <samp><kbd>GENERATE SEED!</kbd></samp> and <samp><kbd>GENERATE RACE SEED!</kbd></samp>. For most purposes, '''we highly recommend to only use the first option'''. Race seeds are encrypted and lock away the spoiler log even if it is generated. These locked logs will not be unlocked except for community races organized by the race mods.

Seed generation takes, on average, 15 seconds but may be longer depending on the current workload of the website. Now you will be on the seed page. The URL follows the naming convention of "https://ootrandomizer.com/seed/get?id=680574" where the 6 digit ID at the end is unique to your seed. This is particularly useful for sharing seeds with friends or sharing the spoiler log when asking for help. (Note that the seed ID at the end of the URL is also present in the default file name of randomized roms. We recommend not changing rom names to keep this piece of information always with the seed.)

Now it is time to direct the website to your base rom (OoT v1.0 NTSC-U/NTSC-J). The version is important, Rev A/B and MQ roms will not work. However, you can convert those ROMs to the proper one with the [https://oot.flagrama.com Ocarina of Time Downgrader and Converter]. For a normal N64 seed for use on everdrive or most emulators, leave the Output type toggle on <samp>.z64 (N64/Emulator)</samp> and browse to your rom file. For WiiVC/vWii/Dolphin, swap to <samp>WAD (WiiVC)</samp> and in addition to the Base Rom, also browse to your 1.2 WAD and Wii Common Key files. You can only patch a randomizer seed if you have the correct files given, so this is very important.

This page also offers the option to change the cosmetics and SFX from those generated with the seed. Please be aware that if you set your desired cosmetics and SFX previously, the option "Override Original Cosmetics" should be disabled before patching the rom as it is enabled by default.

[[File:Override_Cosmetics.PNG|none|thumb|Disable if cosmetics were previously set, enable if cosmetics are set on this page.]]

Once everything is set, simply click <samp>PATCH ROM!</samp> The patching process uses your device's CPU, so how long this takes is dependent on your hardware. Once the process is complete, a download will begin. Save this new rom file separately from the original rom, and now it's time to proceed to the [[#Playing the Randomizer|Playing the Randomizer]] section.

== Windows Setup ==
If you desire for any reason to use the offline randomizer program instead, you will need one or two other programs first. The randomizer itself will work on Windows, macOS, and Linux. The ROM will work on any device that has a Nintendo 64 emulator available. However, the following setup steps focus on getting the randomizer working on the Windows operating system.

=== Install Node.js ===
As of version 4.14 of the randomizer, the source code versions of the randomizer require [https://nodejs.org/en/ Node.js] to be installed. (Please skip this step for the executable version of the randomizer found on [https://ootrandomizer.com/downloads the website's download page].)

Open the [https://nodejs.org/en/ Node.js website] and click on the <samp><kbd>LTS</kbd></samp> button on their home page.<sup>1</sup> Save the <samp>msi</samp> installer file then, locate it in your <samp>Downloads</samp> folder, or wherever you saved it. Launch the installer by double-clicking it. Click <samp><kbd>Next</kbd></samp> until you get to the <samp>Tools for Native Modules</samp> screen. Make sure the <samp>Automatically install the necessary tools. [...]</samp> checkbox is '''not''' checked.<sup>2</sup> Click <samp><kbd>Next</kbd></samp> once you have made sure of this. Next click the <samp><kbd>Install</kbd></samp> button, then once that is completed, click the <samp><kbd>Finish</kbd></samp> button.

<gallery>
File:Setup-NodeJs-LTSButton.jpeg|1. Choose the <samp>LTS</samp> version which was <samp>12.16.2</samp> here, but may be different for you.
File:Setup-NodeJs-NativeModulesUnchecked.jpeg|2. Make sure the checkbox is unchecked before clicking <samp>Next</samp>.
</gallery>

=== Install Python ===
{{TemporaryNotice|Currently the latest release Python 12.0 does not work with the randomizer for Windows users. This will be fixed in Python 12.1 in December.}}
To run the randomizer on your computer you will need to install [https://www.python.org Python]. This is not needed when using the [https://ootrandomizer.com online generator] but in all other cases you '''must''' have Python installed. The randomizer requires at least <samp>Python 3.8.0</samp> installed, however we recommend installing the latest stable version of Python available when you install it.

Go to the [https://www.python.org Python website] and hover your mouse over the <samp>Downloads</samp> tab. A little dialog will appear and should have a <samp>Download for Windows</samp> section displayed. Click on the button labeled <samp>Python</samp> with a version number next to it.<sup>1</sup> Save the <samp>exe</samp> installer file, then locate it in your <samp>Downloads</samp> folder, or wherever you saved it. Launch the installer by double-clicking it. Click <samp><kbd>Install Now</kbd></samp> on the installer.<sup>2</sup>

<gallery>
File:Setup-Python-DownloadPythonButton.jpeg|1. Click this button. In this case the latest version was <samp>3.8.2</samp> but the version displayed for you is the one you want.
File:Setup-Python-InstallNow.jpeg|2. Choose to <samp>Install Now</samp>.
</gallery>

== Downloading the Randomizer ==
Please ensure Node and/or Python are properly installed per the instructions above before downloading the randomizer. Once your computer is prepared, you can follow the instructions for the [[#Standalone Download|standalone download]] version or the [[#Source Code|source code and Dev]] version of the randomizer.

=== Standalone Download ===
Download the current standalone download version of the randomzier by going to the [https://ootrandomizer.com/downloads downloads page on the website] and select the appropriate download for your operating system. The provided installers should install the randomizer to the appropriate place for your operating system and you should be able to launch the randomizer from your operating system's application launcher—Start Menu in Windows, Applications folder in macOS, and whichever application launcher you prefer for Linux. ''You must have [[#Install Python|Python 3.8 or higher]] installed for the standalone download randomizer to work''.

Once you have generated a randomizer ROM file, head to [[#Playing the Randomizer|playing the randomizer]].

==== Windows Troubleshooting ====
[[File:Setup-Standalone-WindowsSmartScreen.jpeg|none|thumb|Click <samp>More info</samp> then <samp>Run anyway</samp> to run the installer.]]

Often when a new version of the randomizer is released the standalone download is not trusted by the Windows operating system. When you try to run the installer it will pop up a Windows Smartscreen window. All you have to do is click <samp><kbd>More info</kbd></samp> and then the <samp><kbd>Run anyway</kbd></samp> button. The installer will then launch and install the randomizer.

=== Source Code ===
You can download either the release source code, or the development (Dev) branch source code to run the randomizer. Most users will want to use the [[#Standalone Download|standalone download]] for the release version, so this section will focus on running the latest development version from source code. ''You must have the latest [[#Install Node.js|Node.js LTS version]] and [[#Install Python|Python 3.8 or higher]] installed for the source code version of the randomizer to work''.

Head to the [https://ootrandomizer.com website] and in the navigation bar at the top, click on <samp><kbd>Resources</kbd></samp> and then choose the <samp><kbd>Dev Github</kbd></samp> option.<sup>1</sup> Next click on the <samp><kbd>releases</kbd></samp> button to reach the page with all of the randomizer releases.<sup>2</sup> Click on the <samp><kbd>zip</kbd></samp> button for the latest development version of the randomizer to download it.<sup>3</sup> ''The Dev branch of the randomizer is known to be unstable. The latest version may not work properly. If you run into issues you may want to join the {{discord|text=Discord server}} and ask which Dev version of the randomizer you should download''.

Locate the <samp>zip</samp> file you just downloaded in your <samp>Downloads</samp> folder, or wherever you saved it. <kbd>Right-click</kbd> the file and click <samp><kbd>Extract All...</kbd></samp> and extract the files from the zip archive.<sup>4</sup> A new folder should appear which may contain another folder inside. Open the folders until you see a folder with many folders and files inside. Locate the <samp>Gui.py</samp> file inside and <kbd>Double-click</kbd> it to launch the randomizer.<sup>5</sup> The first time you run the randomizer many files need to be downloaded from the internet. Wait patiently as they download.<sup>6</sup> ''This process will be faster every time you run the randomizer after this since it will only have to download the files once. Even if you download a new version it will be slightly faster as most of the files will be located in the Node.js cache and most will simply be used from there''.

The randomizer will launch once the initial installation has finished. Once you have generated a randomizer ROM file, head to [[#Playing the Randomizer|playing the randomizer]].

<gallery>
File:Setup-SourceCode-GitHubLink.jpeg|1. Open the <samp>Dev Github</samp> link to open the GitHub page for the main fork of the randomizer.
File:Setup-SourceCode-GitHubReleases.jpeg|2. The <samp>releases</samp> button will display all of the different randomizer versions.
File:Setup-SourceCode-GitHubZip.jpeg|3. A <samp>zip</samp> button should appear on the top release that you can click on.
File:Setup-SourceCode-WindowsExtract.jpeg|4. On Windows, choose to <samp>Extract All...</samp> from the zip file.
File:Setup-SourceCode-Gui-py.jpeg|5. Run the <samp>Gui.py</samp> Python script.
File:Setup-SourceCode-InitialInstall.jpeg|6. Wait patiently as Node.js downloads the randomizer's dependencies.
</gallery>

==== Alternative Source Code Download Method ====
You can alternatively use [https://git-scm.com/ Git] to download the source code. This is the easiest way to keep up to date with the latest changes. We have a guide on using [[GitKraken]], a GUI for git that many of the developers use if you want to try to download the source code this way. You still need to install [[#Source Code|the other software mentioned above]].

== Playing the Randomizer ==
===Emulators===
The Ocarina of Time Randomizer can be played on PC via an emulator. Given the emulation quality difference between emulators, not every emulator can be recommended.

The emulators we support are available for free and have been extensively tested to work well with OoTR, assuming proper setup.

[https://wiki.ootrandomizer.com/index.php?title=Project64 Project64 v3.0+] (Windows) is the least resource-intensive emulator and the easiest to setup. However, it is important that versions 3.0+ are used since these are currently the only ones that provide a stable game experience. Furthermore, '''<span style="color:red">please keep in mind that using Project64 v2.x for racing is against our community's racing rules</span>'''.

[[Bizhawk]] (Windows) is the most resource-intensive, but easier to setup than RetroArch. Bizhawk is also the only race-legal emulator to support [[Multiworld]] currently.

[https://wiki.ootrandomizer.com/index.php?title=Retroarch RetroArch] (Windows, macOS, Linux, and more) isn't as resource-intensive as Bizhawk. However, setting up RetroArch can be a frustrating experience, and especially so for certain controllers.

[[Dolphin]] (Windows, macOS, and possibly Linux and Android) is capable of running OoTR through emulating Wii Virtual Console. As a result, it also has the Wii VC advantage of having less lag when opening the item menu. Other advantages include being lightweight and being easy to set up, especially with Gamecube controllers and either the official Nintendo or the Mayflash adapter. Downsides include random Wii VC crashes, having to inject the OoTR ROM into a WAD for every seed and additional lag in some areas (e.g. Market) due to shortcomings in how Wii VC is emulated.

=== Wii Virtual Console ===

The Ocarina of Time Randomizer can be played on a [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console Wii] (or [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Playing_On_The_Wii_U.27s_Virtual_Wii Wii U]). The advantages are fast load times, less lag and improved graphics compared to the other options available. Some also prefer the stick sensitivity and deadzone settings of the Wii VC over that of pc emulators. The downsides are random (but extremely rare) crashes, installing new seeds is a longer process than on pc emulators, and potentially additional costs if you don't already own a Wii and/or compatible controllers or if you wish to stream your gameplay.

=== EverDrive ===

The Ocarina of Time Randomizer can be played on a N64 by using the [https://wiki.ootrandomizer.com/index.php?title=Everdrive EverDrive]. Keep in mind that EverDrives are expensive and that the N64 is very laggy. The randomizer also requires the memory pak, even though base Ocarina of Time does not.

== Patch Files ==
If someone shares a ZPF or ZPFZ file with you, these are [[Patch Files]]. They are a copyright-free method to share randomizer seeds with people. The [[Patch Files|patch files]] page will explain what to do with them.

Setup

2023-10-09T16:25:56Z

Flagrama: /* Generating a Seed */ mention downgrade site

It is usually recommended to use the online generator on the website instead of the download or source code versions of the randomizer. The [[#Video Tutorial|video tutorial]] is also available as a walk through for the website. The [[Readme]] explains what the different options do. You can also check out the [[Changelog]] to see what changes have happened between randomizer versions. Recent [https://ootrandomizer.com/generatorDev Dev] and [https://ootrandomizer.com/generatorDev?version=devR_ Dev-R] versions are also available on the website.

Ocarina of Time Randomizer is compatible with emulators, Wii Virtual Console, and original Nintendo 64 hardware. Learn more about these options in the [[#Playing the Randomizer|Playing the Randomizer]] section.

Base files (ROMs, Wii common key, etc.) that are needed to play Ocarina of Time Randomizer are copyrighted and will not be provided by the community nor staff.

''If you want to run the [https://ootrandomizer.com/downloads standalone download] version of the randomizer, you should skip to [[#Install Python|installing Python]].''

''If you want to run the [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/master release source code] or [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/Dev Dev source code] version of randomizer, you should skip to [[#Install Node.js|installing Node.js]].''

''We have compiled [https://wiki.ootrandomizer.com/index.php?title=Common_Softlocks_And_Crashes a list of known softlocks and crashes]. It is recommended to read it through to potentially save you from frustration later.''

{{TOClimit|3}}

== Online Generator ==

This section contains information similar to what is presented in the video by TreZc0, but does not go into as much detail regarding randomization options or emulator setup. The [[Readme]] and [[https://wiki.ootrandomizer.com/index.php?title=Setup#Emulators emulator]] pages available to help with those details. The video is highly recommended, especially since it will provide visuals to aid in setup.

=== Video Tutorial ===
<youtube dimensions="480x270">https://www.youtube.com/watch?v=-xNjTtcA4Es</youtube>

Once you have viewed the video, generated a seed, and patched a randomizer ROM file, head to [[#Playing the Randomizer|Playing the Randomizer]].

=== Generating a Seed ===
The online randomizer does not require any downloads except for the final randomized rom, however you will be required to have one or more base files to create the randomized rom. Some of these are copyrighted files that you will need to have prior to receiving any help with setup in the {{discord|text=randomizer discord}}. Please read all rules of the discord and peruse the resources channel before requesting assistance there.
* '''Always Required'''
** OoT v1.0 NTSC-U/NTSC-J ROM - Copyrighted file
** A device with a multicore CPU & at least 2GB of available ram
*** Even most modern mobile devices (i.e. 2019 or newer) meet these requirements
** A modern browser (2020 or later): Chrome, Firefox, Edge, Safari, or Opera
** A method to play the game, which is covered later in the [[#Playing the Randomizer|Playing the Randomizer]] section.
* '''Only Required for WiiVC/vWii/Dolphin'''
** OoT v1.2 NTSC WAD - Copyrighted file
** Wii Common Key - Copyrighted file

Once prepared, go to https://ootrandomizer.com and click on the <samp><kbd>Play Now</kbd></samp> button for the latest stable version.
[[File:Setup-Website-PlayNow.jpeg|none|thumb|Click the <samp>Play Now</samp> button on the website to open the online generator.]]

Just below the "Ocarina of Time Item Randomizer v6.2" title is the button <samp><kbd>INSTRUCTIONS/HELP</kbd></samp> which effectively repeats the information available here and in the video at a quick glance.

Detailed explanations of the settings can be found on the [[Readme]] page and quick tooltips can be seen by hovering over any setting in the generator.

'''For a first seed, we recommend using either the Default/Beginner or Easy presets available on the "ROM Options" tab of the generator.''' The Default/Beginner preset is aimed at those familiar with vanilla who desire a similar progression. It uses base glitchless logic with no added tricks and no additional timesavers enabled (see the tab "Other" in the GUI). The world begins closed. Expect a long playthrough. The Easy Preset is aimed at those who have perhaps seen a few Randomizer runs previously and/or wish to dive right in. It uses base glitchless logic with no added tricks, but it does use additional timesavers (see the tab "Other" in the GUI). The world is more open after leaving Kokiri Forest.

Once a preset is selected from the dropdown, click <samp><kbd>LOAD</kbd></samp> and all settings shown in the generator, except Cosmetics and SFX, will change to match the preset. Feel free to look at the other tabs to see which settings are enabled by each preset before deciding which to use.

[[File:Presets.png|none|thumb|Presets location on the ROM Options tab of the generator.]]

If you're feeling a little more bold, settings may still be changed from those loaded by the preset to any you desire. '''However''', on the first tab of the randomizer, ROM Options, please never disable "'''Create Spoiler Log'''." The Spoiler Log is a file containing all the item locations, settings, and entrances when applicable of the randomized seed. Though you may never look at it, it is vital for those helping in the randomizer discord to be able to check this log if you require help at any point in the seed.

Once the settings are prepared, there are two options to generate the seed, <samp><kbd>GENERATE SEED!</kbd></samp> and <samp><kbd>GENERATE RACE SEED!</kbd></samp>. For most purposes, '''we highly recommend to only use the first option'''. Race seeds are encrypted and lock away the spoiler log even if it is generated. These locked logs will not be unlocked except for community races organized by the race mods.

Seed generation takes, on average, 15 seconds but may be longer depending on the current workload of the website. Now you will be on the seed page. The URL follows the naming convention of "https://ootrandomizer.com/seed/get?id=680574" where the 6 digit ID at the end is unique to your seed. This is particularly useful for sharing seeds with friends or sharing the spoiler log when asking for help. (Note that the seed ID at the end of the URL is also present in the default file name of randomized roms. We recommend not changing rom names to keep this piece of information always with the seed.)

Now it is time to direct the website to your base rom (OoT v1.0 NTSC-U/NTSC-J). The version is important, Rev A/B and MQ roms will not work. However, you can convert those ROMs to the proper one with the [https://oot.flagrama.com Ocarina of Time Downgrader and Converter]. For a normal N64 seed for use on everdrive or most emulators, leave the Output type toggle on <samp>.z64 (N64/Emulator)</samp> and browse to your rom file. For WiiVC/vWii/Dolphin, swap to <samp>WAD (WiiVC)</samp> and in addition to the Base Rom, also browse to your 1.2 WAD and Wii Common Key files. You can only patch a randomizer seed if you have the correct files given, so this is very important.

This page also offers the option to change the cosmetics and SFX from those generated with the seed. Please be aware that if you set your desired cosmetics and SFX previously, the option "Override Original Cosmetics" should be disabled before patching the rom as it is enabled by default.

[[File:Override_Cosmetics.PNG|none|thumb|Disable if cosmetics were previously set, enable if cosmetics are set on this page.]]

Once everything is set, simply click <samp>PATCH ROM!</samp> The patching process uses your device's CPU, so how long this takes is dependent on your hardware. Once the process is complete, a download will begin. Save this new rom file separately from the original rom, and now it's time to proceed to the [[#Playing the Randomizer|Playing the Randomizer]] section.

== Windows Setup ==
If you desire for any reason to use the offline randomizer program instead, you will need one or two other programs first. The randomizer itself will work on Windows, macOS, and Linux. The ROM will work on any device that has a Nintendo 64 emulator available. However, the following setup steps focus on getting the randomizer working on the Windows operating system.

=== Install Node.js ===
As of version 4.14 of the randomizer, the source code versions of the randomizer require [https://nodejs.org/en/ Node.js] to be installed. (Please skip this step for the executable version of the randomizer found on [https://ootrandomizer.com/downloads the website's download page].)

Open the [https://nodejs.org/en/ Node.js website] and click on the <samp><kbd>LTS</kbd></samp> button on their home page.<sup>1</sup> Save the <samp>msi</samp> installer file then, locate it in your <samp>Downloads</samp> folder, or wherever you saved it. Launch the installer by double-clicking it. Click <samp><kbd>Next</kbd></samp> until you get to the <samp>Tools for Native Modules</samp> screen. Make sure the <samp>Automatically install the necessary tools. [...]</samp> checkbox is '''not''' checked.<sup>2</sup> Click <samp><kbd>Next</kbd></samp> once you have made sure of this. Next click the <samp><kbd>Install</kbd></samp> button, then once that is completed, click the <samp><kbd>Finish</kbd></samp> button.

<gallery>
File:Setup-NodeJs-LTSButton.jpeg|1. Choose the <samp>LTS</samp> version which was <samp>12.16.2</samp> here, but may be different for you. So long as it is v14.x or lower it will be compatible with OoTR. Do '''not''' click the <samp>Current version</samp> button, as that version isn't currently compatible.
File:Setup-NodeJs-NativeModulesUnchecked.jpeg|2. Make sure the checkbox is unchecked before clicking <samp>Next</samp>.
</gallery>

=== Install Python ===
{{TemporaryNotice|Currently the latest release Python 12.0 does not work with the randomizer for Windows users. This will be fixed in Python 12.1 in December.}}
To run the randomizer on your computer you will need to install [https://www.python.org Python]. This is not needed when using the [https://ootrandomizer.com online generator] but in all other cases you '''must''' have Python installed. The randomizer requires at least <samp>Python 3.8.0</samp> installed, however we recommend installing the latest stable version of Python available when you install it.

Go to the [https://www.python.org Python website] and hover your mouse over the <samp>Downloads</samp> tab. A little dialog will appear and should have a <samp>Download for Windows</samp> section displayed. Click on the button labeled <samp>Python</samp> with a version number next to it.<sup>1</sup> Save the <samp>exe</samp> installer file, then locate it in your <samp>Downloads</samp> folder, or wherever you saved it. Launch the installer by double-clicking it. Click <samp><kbd>Install Now</kbd></samp> on the installer.<sup>2</sup>

<gallery>
File:Setup-Python-DownloadPythonButton.jpeg|1. Click this button. In this case the latest version was <samp>3.8.2</samp> but the version displayed for you is the one you want.
File:Setup-Python-InstallNow.jpeg|2. Choose to <samp>Install Now</samp>.
</gallery>

== Downloading the Randomizer ==
Please ensure Node and/or Python are properly installed per the instructions above before downloading the randomizer. Once your computer is prepared, you can follow the instructions for the [[#Standalone Download|standalone download]] version or the [[#Source Code|source code and Dev]] version of the randomizer.

=== Standalone Download ===
Download the current standalone download version of the randomzier by going to the [https://ootrandomizer.com/downloads downloads page on the website] and select the appropriate download for your operating system. The provided installers should install the randomizer to the appropriate place for your operating system and you should be able to launch the randomizer from your operating system's application launcher—Start Menu in Windows, Applications folder in macOS, and whichever application launcher you prefer for Linux. ''You must have [[#Install Python|Python 3.8 or higher]] installed for the standalone download randomizer to work''.

Once you have generated a randomizer ROM file, head to [[#Playing the Randomizer|playing the randomizer]].

==== Windows Troubleshooting ====
[[File:Setup-Standalone-WindowsSmartScreen.jpeg|none|thumb|Click <samp>More info</samp> then <samp>Run anyway</samp> to run the installer.]]

Often when a new version of the randomizer is released the standalone download is not trusted by the Windows operating system. When you try to run the installer it will pop up a Windows Smartscreen window. All you have to do is click <samp><kbd>More info</kbd></samp> and then the <samp><kbd>Run anyway</kbd></samp> button. The installer will then launch and install the randomizer.

=== Source Code ===
You can download either the release source code, or the development (Dev) branch source code to run the randomizer. Most users will want to use the [[#Standalone Download|standalone download]] for the release version, so this section will focus on running the latest development version from source code. ''You must have the latest [[#Install Node.js|Node.js LTS version]] and [[#Install Python|Python 3.8 or higher]] installed for the source code version of the randomizer to work''.

Head to the [https://ootrandomizer.com website] and in the navigation bar at the top, click on <samp><kbd>Resources</kbd></samp> and then choose the <samp><kbd>Dev Github</kbd></samp> option.<sup>1</sup> Next click on the <samp><kbd>releases</kbd></samp> button to reach the page with all of the randomizer releases.<sup>2</sup> Click on the <samp><kbd>zip</kbd></samp> button for the latest development version of the randomizer to download it.<sup>3</sup> ''The Dev branch of the randomizer is known to be unstable. The latest version may not work properly. If you run into issues you may want to join the {{discord|text=Discord server}} and ask which Dev version of the randomizer you should download''.

Locate the <samp>zip</samp> file you just downloaded in your <samp>Downloads</samp> folder, or wherever you saved it. <kbd>Right-click</kbd> the file and click <samp><kbd>Extract All...</kbd></samp> and extract the files from the zip archive.<sup>4</sup> A new folder should appear which may contain another folder inside. Open the folders until you see a folder with many folders and files inside. Locate the <samp>Gui.py</samp> file inside and <kbd>Double-click</kbd> it to launch the randomizer.<sup>5</sup> The first time you run the randomizer many files need to be downloaded from the internet. Wait patiently as they download.<sup>6</sup> ''This process will be faster every time you run the randomizer after this since it will only have to download the files once. Even if you download a new version it will be slightly faster as most of the files will be located in the Node.js cache and most will simply be used from there''.

The randomizer will launch once the initial installation has finished. Once you have generated a randomizer ROM file, head to [[#Playing the Randomizer|playing the randomizer]].

<gallery>
File:Setup-SourceCode-GitHubLink.jpeg|1. Open the <samp>Dev Github</samp> link to open the GitHub page for the main fork of the randomizer.
File:Setup-SourceCode-GitHubReleases.jpeg|2. The <samp>releases</samp> button will display all of the different randomizer versions.
File:Setup-SourceCode-GitHubZip.jpeg|3. A <samp>zip</samp> button should appear on the top release that you can click on.
File:Setup-SourceCode-WindowsExtract.jpeg|4. On Windows, choose to <samp>Extract All...</samp> from the zip file.
File:Setup-SourceCode-Gui-py.jpeg|5. Run the <samp>Gui.py</samp> Python script.
File:Setup-SourceCode-InitialInstall.jpeg|6. Wait patiently as Node.js downloads the randomizer's dependencies.
</gallery>

==== Alternative Source Code Download Method ====
You can alternatively use [https://git-scm.com/ Git] to download the source code. This is the easiest way to keep up to date with the latest changes. We have a guide on using [[GitKraken]], a GUI for git that many of the developers use if you want to try to download the source code this way. You still need to install [[#Source Code|the other software mentioned above]].

== Playing the Randomizer ==
===Emulators===
The Ocarina of Time Randomizer can be played on PC via an emulator. Given the emulation quality difference between emulators, not every emulator can be recommended.

The emulators we support are available for free and have been extensively tested to work well with OoTR, assuming proper setup.

[https://wiki.ootrandomizer.com/index.php?title=Project64 Project64 v3.0+] (Windows) is the least resource-intensive emulator and the easiest to setup. However, it is important that versions 3.0+ are used since these are currently the only ones that provide a stable game experience. Furthermore, '''<span style="color:red">please keep in mind that using Project64 v2.x for racing is against our community's racing rules</span>'''.

[[Bizhawk]] (Windows) is the most resource-intensive, but easier to setup than RetroArch. Bizhawk is also the only race-legal emulator to support [[Multiworld]] currently.

[https://wiki.ootrandomizer.com/index.php?title=Retroarch RetroArch] (Windows, macOS, Linux, and more) isn't as resource-intensive as Bizhawk. However, setting up RetroArch can be a frustrating experience, and especially so for certain controllers.

[[Dolphin]] (Windows, macOS, and possibly Linux and Android) is capable of running OoTR through emulating Wii Virtual Console. As a result, it also has the Wii VC advantage of having less lag when opening the item menu. Other advantages include being lightweight and being easy to set up, especially with Gamecube controllers and either the official Nintendo or the Mayflash adapter. Downsides include random Wii VC crashes, having to inject the OoTR ROM into a WAD for every seed and additional lag in some areas (e.g. Market) due to shortcomings in how Wii VC is emulated.

=== Wii Virtual Console ===

The Ocarina of Time Randomizer can be played on a [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console Wii] (or [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Playing_On_The_Wii_U.27s_Virtual_Wii Wii U]). The advantages are fast load times, less lag and improved graphics compared to the other options available. Some also prefer the stick sensitivity and deadzone settings of the Wii VC over that of pc emulators. The downsides are random (but extremely rare) crashes, installing new seeds is a longer process than on pc emulators, and potentially additional costs if you don't already own a Wii and/or compatible controllers or if you wish to stream your gameplay.

=== EverDrive ===

The Ocarina of Time Randomizer can be played on a N64 by using the [https://wiki.ootrandomizer.com/index.php?title=Everdrive EverDrive]. Keep in mind that EverDrives are expensive and that the N64 is very laggy. The randomizer also requires the memory pak, even though base Ocarina of Time does not.

== Patch Files ==
If someone shares a ZPF or ZPFZ file with you, these are [[Patch Files]]. They are a copyright-free method to share randomizer seeds with people. The [[Patch Files|patch files]] page will explain what to do with them.

Setup

2023-10-09T16:22:36Z

Flagrama: unnecessary, it's a wiki, everything is WIP

It is usually recommended to use the online generator on the website instead of the download or source code versions of the randomizer. The [[#Video Tutorial|video tutorial]] is also available as a walk through for the website. The [[Readme]] explains what the different options do. You can also check out the [[Changelog]] to see what changes have happened between randomizer versions. Recent [https://ootrandomizer.com/generatorDev Dev] and [https://ootrandomizer.com/generatorDev?version=devR_ Dev-R] versions are also available on the website.

Ocarina of Time Randomizer is compatible with emulators, Wii Virtual Console, and original Nintendo 64 hardware. Learn more about these options in the [[#Playing the Randomizer|Playing the Randomizer]] section.

Base files (ROMs, Wii common key, etc.) that are needed to play Ocarina of Time Randomizer are copyrighted and will not be provided by the community nor staff.

''If you want to run the [https://ootrandomizer.com/downloads standalone download] version of the randomizer, you should skip to [[#Install Python|installing Python]].''

''If you want to run the [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/master release source code] or [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/Dev Dev source code] version of randomizer, you should skip to [[#Install Node.js|installing Node.js]].''

''We have compiled [https://wiki.ootrandomizer.com/index.php?title=Common_Softlocks_And_Crashes a list of known softlocks and crashes]. It is recommended to read it through to potentially save you from frustration later.''

{{TOClimit|3}}

== Online Generator ==

This section contains information similar to what is presented in the video by TreZc0, but does not go into as much detail regarding randomization options or emulator setup. The [[Readme]] and [[https://wiki.ootrandomizer.com/index.php?title=Setup#Emulators emulator]] pages available to help with those details. The video is highly recommended, especially since it will provide visuals to aid in setup.

=== Video Tutorial ===
<youtube dimensions="480x270">https://www.youtube.com/watch?v=-xNjTtcA4Es</youtube>

Once you have viewed the video, generated a seed, and patched a randomizer ROM file, head to [[#Playing the Randomizer|Playing the Randomizer]].

=== Generating a Seed ===
The online randomizer does not require any downloads except for the final randomized rom, however you will be required to have one or more base files to create the randomized rom. Some of these are copyrighted files that you will need to have prior to receiving any help with setup in the {{discord|text=randomizer discord}}. Please read all rules of the discord and peruse the resources channel before requesting assistance there.
* '''Always Required'''
** OoT v1.0 NTSC-U/NTSC-J rom - Copyrighted file
** A device with a multicore CPU & at least 2GB of available ram
*** Even most modern mobile devices (i.e. 2019 or newer) meet these requirements
** A modern browser (2020 or later): Chrome, Firefox, Edge, Safari, or Opera
** A method to play the game, which is covered later in the [[#Playing the Randomizer|Playing the Randomizer]] section.
* '''Only Required for WiiVC/vWii/Dolphin'''
** OoT v1.2 NTSC WAD - Copyrighted file
** Wii Common Key - Copyrighted file

Once prepared, go to https://ootrandomizer.com and click on the <samp><kbd>Play Now</kbd></samp> button for the latest stable version.
[[File:Setup-Website-PlayNow.jpeg|none|thumb|Click the <samp>Play Now</samp> button on the website to open the online generator.]]

Just below the "Ocarina of Time Item Randomizer v6.2" title is the button <samp><kbd>INSTRUCTIONS/HELP</kbd></samp> which effectively repeats the information available here and in the video at a quick glance.

Detailed explanations of the settings can be found on the [[Readme]] page and quick tooltips can be seen by hovering over any setting in the generator.

'''For a first seed, we recommend using either the Default/Beginner or Easy presets available on the "ROM Options" tab of the generator.''' The Default/Beginner preset is aimed at those familiar with vanilla who desire a similar progression. It uses base glitchless logic with no added tricks and no additional timesavers enabled (see the tab "Other" in the GUI). The world begins closed. Expect a long playthrough. The Easy Preset is aimed at those who have perhaps seen a few Randomizer runs previously and/or wish to dive right in. It uses base glitchless logic with no added tricks, but it does use additional timesavers (see the tab "Other" in the GUI). The world is more open after leaving Kokiri Forest.

Once a preset is selected from the dropdown, click <samp><kbd>LOAD</kbd></samp> and all settings shown in the generator, except Cosmetics and SFX, will change to match the preset. Feel free to look at the other tabs to see which settings are enabled by each preset before deciding which to use.

[[File:Presets.png|none|thumb|Presets location on the ROM Options tab of the generator.]]

If you're feeling a little more bold, settings may still be changed from those loaded by the preset to any you desire. '''However''', on the first tab of the randomizer, ROM Options, please never disable "'''Create Spoiler Log'''." The Spoiler Log is a file containing all the item locations, settings, and entrances when applicable of the randomized seed. Though you may never look at it, it is vital for those helping in the randomizer discord to be able to check this log if you require help at any point in the seed.

Once the settings are prepared, there are two options to generate the seed, <samp><kbd>GENERATE SEED!</kbd></samp> and <samp><kbd>GENERATE RACE SEED!</kbd></samp>. For most purposes, '''we highly recommend to only use the first option'''. Race seeds are encrypted and lock away the spoiler log even if it is generated. These locked logs will not be unlocked except for community races organized by the race mods.

Seed generation takes, on average, 15 seconds but may be longer depending on the current workload of the website. Now you will be on the seed page. The URL follows the naming convention of "https://ootrandomizer.com/seed/get?id=680574" where the 6 digit ID at the end is unique to your seed. This is particularly useful for sharing seeds with friends or sharing the spoiler log when asking for help. (Note that the seed ID at the end of the URL is also present in the default file name of randomized roms. We recommend not changing rom names to keep this piece of information always with the seed.)

Now it is time to direct the website to your base rom (OoT v1.0 NTSC-U/NTSC-J). The version is important, Rev A/B and MQ roms will not work. For a normal N64 seed for use on everdrive or most emulators, leave the Output type toggle on <samp>.z64 (N64/Emulator)</samp> and browse to your rom file. For WiiVC/vWii/Dolphin, swap to <samp>WAD (WiiVC)</samp> and in addition to the Base Rom, also browse to your 1.2 WAD and Wii Common Key files. You can only patch a randomizer seed if you have the correct files given, so this is very important.

This page also offers the option to change the cosmetics and SFX from those generated with the seed. Please be aware that if you set your desired cosmetics and SFX previously, the option "Override Original Cosmetics" should be disabled before patching the rom as it is enabled by default.

[[File:Override_Cosmetics.PNG|none|thumb|Disable if cosmetics were previously set, enable if cosmetics are set on this page.]]

Once everything is set, simply click <samp>PATCH ROM!</samp> The patching process uses your device's CPU, so how long this takes is dependent on your hardware. Once the process is complete, a download will begin. Save this new rom file separately from the original rom, and now it's time to proceed to the [[#Playing the Randomizer|Playing the Randomizer]] section.

== Windows Setup ==
If you desire for any reason to use the offline randomizer program instead, you will need one or two other programs first. The randomizer itself will work on Windows, macOS, and Linux. The ROM will work on any device that has a Nintendo 64 emulator available. However, the following setup steps focus on getting the randomizer working on the Windows operating system.

=== Install Node.js ===
As of version 4.14 of the randomizer, the source code versions of the randomizer require [https://nodejs.org/en/ Node.js] to be installed. (Please skip this step for the executable version of the randomizer found on [https://ootrandomizer.com/downloads the website's download page].)

Open the [https://nodejs.org/en/ Node.js website] and click on the <samp><kbd>LTS</kbd></samp> button on their home page.<sup>1</sup> Save the <samp>msi</samp> installer file then, locate it in your <samp>Downloads</samp> folder, or wherever you saved it. Launch the installer by double-clicking it. Click <samp><kbd>Next</kbd></samp> until you get to the <samp>Tools for Native Modules</samp> screen. Make sure the <samp>Automatically install the necessary tools. [...]</samp> checkbox is '''not''' checked.<sup>2</sup> Click <samp><kbd>Next</kbd></samp> once you have made sure of this. Next click the <samp><kbd>Install</kbd></samp> button, then once that is completed, click the <samp><kbd>Finish</kbd></samp> button.

<gallery>
File:Setup-NodeJs-LTSButton.jpeg|1. Choose the <samp>LTS</samp> version which was <samp>12.16.2</samp> here, but may be different for you. So long as it is v14.x or lower it will be compatible with OoTR. Do '''not''' click the <samp>Current version</samp> button, as that version isn't currently compatible.
File:Setup-NodeJs-NativeModulesUnchecked.jpeg|2. Make sure the checkbox is unchecked before clicking <samp>Next</samp>.
</gallery>

=== Install Python ===
{{TemporaryNotice|Currently the latest release Python 12.0 does not work with the randomizer for Windows users. This will be fixed in Python 12.1 in December.}}
To run the randomizer on your computer you will need to install [https://www.python.org Python]. This is not needed when using the [https://ootrandomizer.com online generator] but in all other cases you '''must''' have Python installed. The randomizer requires at least <samp>Python 3.8.0</samp> installed, however we recommend installing the latest stable version of Python available when you install it.

Go to the [https://www.python.org Python website] and hover your mouse over the <samp>Downloads</samp> tab. A little dialog will appear and should have a <samp>Download for Windows</samp> section displayed. Click on the button labeled <samp>Python</samp> with a version number next to it.<sup>1</sup> Save the <samp>exe</samp> installer file, then locate it in your <samp>Downloads</samp> folder, or wherever you saved it. Launch the installer by double-clicking it. Click <samp><kbd>Install Now</kbd></samp> on the installer.<sup>2</sup>

<gallery>
File:Setup-Python-DownloadPythonButton.jpeg|1. Click this button. In this case the latest version was <samp>3.8.2</samp> but the version displayed for you is the one you want.
File:Setup-Python-InstallNow.jpeg|2. Choose to <samp>Install Now</samp>.
</gallery>

== Downloading the Randomizer ==
Please ensure Node and/or Python are properly installed per the instructions above before downloading the randomizer. Once your computer is prepared, you can follow the instructions for the [[#Standalone Download|standalone download]] version or the [[#Source Code|source code and Dev]] version of the randomizer.

=== Standalone Download ===
Download the current standalone download version of the randomzier by going to the [https://ootrandomizer.com/downloads downloads page on the website] and select the appropriate download for your operating system. The provided installers should install the randomizer to the appropriate place for your operating system and you should be able to launch the randomizer from your operating system's application launcher—Start Menu in Windows, Applications folder in macOS, and whichever application launcher you prefer for Linux. ''You must have [[#Install Python|Python 3.8 or higher]] installed for the standalone download randomizer to work''.

Once you have generated a randomizer ROM file, head to [[#Playing the Randomizer|playing the randomizer]].

==== Windows Troubleshooting ====
[[File:Setup-Standalone-WindowsSmartScreen.jpeg|none|thumb|Click <samp>More info</samp> then <samp>Run anyway</samp> to run the installer.]]

Often when a new version of the randomizer is released the standalone download is not trusted by the Windows operating system. When you try to run the installer it will pop up a Windows Smartscreen window. All you have to do is click <samp><kbd>More info</kbd></samp> and then the <samp><kbd>Run anyway</kbd></samp> button. The installer will then launch and install the randomizer.

=== Source Code ===
You can download either the release source code, or the development (Dev) branch source code to run the randomizer. Most users will want to use the [[#Standalone Download|standalone download]] for the release version, so this section will focus on running the latest development version from source code. ''You must have the latest [[#Install Node.js|Node.js LTS version]] and [[#Install Python|Python 3.8 or higher]] installed for the source code version of the randomizer to work''.

Head to the [https://ootrandomizer.com website] and in the navigation bar at the top, click on <samp><kbd>Resources</kbd></samp> and then choose the <samp><kbd>Dev Github</kbd></samp> option.<sup>1</sup> Next click on the <samp><kbd>releases</kbd></samp> button to reach the page with all of the randomizer releases.<sup>2</sup> Click on the <samp><kbd>zip</kbd></samp> button for the latest development version of the randomizer to download it.<sup>3</sup> ''The Dev branch of the randomizer is known to be unstable. The latest version may not work properly. If you run into issues you may want to join the {{discord|text=Discord server}} and ask which Dev version of the randomizer you should download''.

Locate the <samp>zip</samp> file you just downloaded in your <samp>Downloads</samp> folder, or wherever you saved it. <kbd>Right-click</kbd> the file and click <samp><kbd>Extract All...</kbd></samp> and extract the files from the zip archive.<sup>4</sup> A new folder should appear which may contain another folder inside. Open the folders until you see a folder with many folders and files inside. Locate the <samp>Gui.py</samp> file inside and <kbd>Double-click</kbd> it to launch the randomizer.<sup>5</sup> The first time you run the randomizer many files need to be downloaded from the internet. Wait patiently as they download.<sup>6</sup> ''This process will be faster every time you run the randomizer after this since it will only have to download the files once. Even if you download a new version it will be slightly faster as most of the files will be located in the Node.js cache and most will simply be used from there''.

The randomizer will launch once the initial installation has finished. Once you have generated a randomizer ROM file, head to [[#Playing the Randomizer|playing the randomizer]].

<gallery>
File:Setup-SourceCode-GitHubLink.jpeg|1. Open the <samp>Dev Github</samp> link to open the GitHub page for the main fork of the randomizer.
File:Setup-SourceCode-GitHubReleases.jpeg|2. The <samp>releases</samp> button will display all of the different randomizer versions.
File:Setup-SourceCode-GitHubZip.jpeg|3. A <samp>zip</samp> button should appear on the top release that you can click on.
File:Setup-SourceCode-WindowsExtract.jpeg|4. On Windows, choose to <samp>Extract All...</samp> from the zip file.
File:Setup-SourceCode-Gui-py.jpeg|5. Run the <samp>Gui.py</samp> Python script.
File:Setup-SourceCode-InitialInstall.jpeg|6. Wait patiently as Node.js downloads the randomizer's dependencies.
</gallery>

==== Alternative Source Code Download Method ====
You can alternatively use [https://git-scm.com/ Git] to download the source code. This is the easiest way to keep up to date with the latest changes. We have a guide on using [[GitKraken]], a GUI for git that many of the developers use if you want to try to download the source code this way. You still need to install [[#Source Code|the other software mentioned above]].

== Playing the Randomizer ==
===Emulators===
The Ocarina of Time Randomizer can be played on PC via an emulator. Given the emulation quality difference between emulators, not every emulator can be recommended.

The emulators we support are available for free and have been extensively tested to work well with OoTR, assuming proper setup.

[https://wiki.ootrandomizer.com/index.php?title=Project64 Project64 v3.0+] (Windows) is the least resource-intensive emulator and the easiest to setup. However, it is important that versions 3.0+ are used since these are currently the only ones that provide a stable game experience. Furthermore, '''<span style="color:red">please keep in mind that using Project64 v2.x for racing is against our community's racing rules</span>'''.

[[Bizhawk]] (Windows) is the most resource-intensive, but easier to setup than RetroArch. Bizhawk is also the only race-legal emulator to support [[Multiworld]] currently.

[https://wiki.ootrandomizer.com/index.php?title=Retroarch RetroArch] (Windows, macOS, Linux, and more) isn't as resource-intensive as Bizhawk. However, setting up RetroArch can be a frustrating experience, and especially so for certain controllers.

[[Dolphin]] (Windows, macOS, and possibly Linux and Android) is capable of running OoTR through emulating Wii Virtual Console. As a result, it also has the Wii VC advantage of having less lag when opening the item menu. Other advantages include being lightweight and being easy to set up, especially with Gamecube controllers and either the official Nintendo or the Mayflash adapter. Downsides include random Wii VC crashes, having to inject the OoTR ROM into a WAD for every seed and additional lag in some areas (e.g. Market) due to shortcomings in how Wii VC is emulated.

=== Wii Virtual Console ===

The Ocarina of Time Randomizer can be played on a [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console Wii] (or [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Playing_On_The_Wii_U.27s_Virtual_Wii Wii U]). The advantages are fast load times, less lag and improved graphics compared to the other options available. Some also prefer the stick sensitivity and deadzone settings of the Wii VC over that of pc emulators. The downsides are random (but extremely rare) crashes, installing new seeds is a longer process than on pc emulators, and potentially additional costs if you don't already own a Wii and/or compatible controllers or if you wish to stream your gameplay.

=== EverDrive ===

The Ocarina of Time Randomizer can be played on a N64 by using the [https://wiki.ootrandomizer.com/index.php?title=Everdrive EverDrive]. Keep in mind that EverDrives are expensive and that the N64 is very laggy. The randomizer also requires the memory pak, even though base Ocarina of Time does not.

== Patch Files ==
If someone shares a ZPF or ZPFZ file with you, these are [[Patch Files]]. They are a copyright-free method to share randomizer seeds with people. The [[Patch Files|patch files]] page will explain what to do with them.

Setup

2023-10-09T14:05:23Z

Flagrama: /* Install Python */ temporary notice about python version 12

It is usually recommended to use the online generator on the website instead of the download or source code versions of the randomizer. The [[#Video Tutorial|video tutorial]] is also available as a walk through for the website. The [[Readme]] explains what the different options do. You can also check out the [[Changelog]] to see what changes have happened between randomizer versions. Recent [https://ootrandomizer.com/generatorDev Dev] and [https://ootrandomizer.com/generatorDev?version=devR_ Dev-R] versions are also available on the website.

Ocarina of Time Randomizer is compatible with emulators, Wii Virtual Console, and original Nintendo 64 hardware. Learn more about these options in the [[#Playing the Randomizer|Playing the Randomizer]] section.

Base files (ROMs, Wii common key, etc.) that are needed to play Ocarina of Time Randomizer are copyrighted and will not be provided by the community nor staff.

''If you want to run the [https://ootrandomizer.com/downloads standalone download] version of the randomizer, you should skip to [[#Install Python|installing Python]].''

''If you want to run the [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/master release source code] or [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/Dev Dev source code] version of randomizer, you should skip to [[#Install Node.js|installing Node.js]].''

''We have compiled [https://wiki.ootrandomizer.com/index.php?title=Common_Softlocks_And_Crashes a list of known softlocks and crashes] (WIP). It is recommended to read it through to potentially save you from frustration later.''

{{TOClimit|3}}

== Online Generator ==

This section contains information similar to what is presented in the video by TreZc0, but does not go into as much detail regarding randomization options or emulator setup. The [[Readme]] and [[https://wiki.ootrandomizer.com/index.php?title=Setup#Emulators emulator]] pages available to help with those details. The video is highly recommended, especially since it will provide visuals to aid in setup.

=== Video Tutorial ===
<youtube dimensions="480x270">https://www.youtube.com/watch?v=-xNjTtcA4Es</youtube>

Once you have viewed the video, generated a seed, and patched a randomizer ROM file, head to [[#Playing the Randomizer|Playing the Randomizer]].

=== Generating a Seed ===
The online randomizer does not require any downloads except for the final randomized rom, however you will be required to have one or more base files to create the randomized rom. Some of these are copyrighted files that you will need to have prior to receiving any help with setup in the {{discord|text=randomizer discord}}. Please read all rules of the discord and peruse the resources channel before requesting assistance there.
* '''Always Required'''
** OoT v1.0 NTSC-U/NTSC-J rom - Copyrighted file
** A device with a multicore CPU & at least 2GB of available ram
*** Even most modern mobile devices (i.e. 2019 or newer) meet these requirements
** A modern browser (2020 or later): Chrome, Firefox, Edge, Safari, or Opera
** A method to play the game, which is covered later in the [[#Playing the Randomizer|Playing the Randomizer]] section.
* '''Only Required for WiiVC/vWii/Dolphin'''
** OoT v1.2 NTSC WAD - Copyrighted file
** Wii Common Key - Copyrighted file

Once prepared, go to https://ootrandomizer.com and click on the <samp><kbd>Play Now</kbd></samp> button for the latest stable version.
[[File:Setup-Website-PlayNow.jpeg|none|thumb|Click the <samp>Play Now</samp> button on the website to open the online generator.]]

Just below the "Ocarina of Time Item Randomizer v6.2" title is the button <samp><kbd>INSTRUCTIONS/HELP</kbd></samp> which effectively repeats the information available here and in the video at a quick glance.

Detailed explanations of the settings can be found on the [[Readme]] page and quick tooltips can be seen by hovering over any setting in the generator.

'''For a first seed, we recommend using either the Default/Beginner or Easy presets available on the "ROM Options" tab of the generator.''' The Default/Beginner preset is aimed at those familiar with vanilla who desire a similar progression. It uses base glitchless logic with no added tricks and no additional timesavers enabled (see the tab "Other" in the GUI). The world begins closed. Expect a long playthrough. The Easy Preset is aimed at those who have perhaps seen a few Randomizer runs previously and/or wish to dive right in. It uses base glitchless logic with no added tricks, but it does use additional timesavers (see the tab "Other" in the GUI). The world is more open after leaving Kokiri Forest.

Once a preset is selected from the dropdown, click <samp><kbd>LOAD</kbd></samp> and all settings shown in the generator, except Cosmetics and SFX, will change to match the preset. Feel free to look at the other tabs to see which settings are enabled by each preset before deciding which to use.

[[File:Presets.png|none|thumb|Presets location on the ROM Options tab of the generator.]]

If you're feeling a little more bold, settings may still be changed from those loaded by the preset to any you desire. '''However''', on the first tab of the randomizer, ROM Options, please never disable "'''Create Spoiler Log'''." The Spoiler Log is a file containing all the item locations, settings, and entrances when applicable of the randomized seed. Though you may never look at it, it is vital for those helping in the randomizer discord to be able to check this log if you require help at any point in the seed.

Once the settings are prepared, there are two options to generate the seed, <samp><kbd>GENERATE SEED!</kbd></samp> and <samp><kbd>GENERATE RACE SEED!</kbd></samp>. For most purposes, '''we highly recommend to only use the first option'''. Race seeds are encrypted and lock away the spoiler log even if it is generated. These locked logs will not be unlocked except for community races organized by the race mods.

Seed generation takes, on average, 15 seconds but may be longer depending on the current workload of the website. Now you will be on the seed page. The URL follows the naming convention of "https://ootrandomizer.com/seed/get?id=680574" where the 6 digit ID at the end is unique to your seed. This is particularly useful for sharing seeds with friends or sharing the spoiler log when asking for help. (Note that the seed ID at the end of the URL is also present in the default file name of randomized roms. We recommend not changing rom names to keep this piece of information always with the seed.)

Now it is time to direct the website to your base rom (OoT v1.0 NTSC-U/NTSC-J). The version is important, Rev A/B and MQ roms will not work. For a normal N64 seed for use on everdrive or most emulators, leave the Output type toggle on <samp>.z64 (N64/Emulator)</samp> and browse to your rom file. For WiiVC/vWii/Dolphin, swap to <samp>WAD (WiiVC)</samp> and in addition to the Base Rom, also browse to your 1.2 WAD and Wii Common Key files. You can only patch a randomizer seed if you have the correct files given, so this is very important.

This page also offers the option to change the cosmetics and SFX from those generated with the seed. Please be aware that if you set your desired cosmetics and SFX previously, the option "Override Original Cosmetics" should be disabled before patching the rom as it is enabled by default.

[[File:Override_Cosmetics.PNG|none|thumb|Disable if cosmetics were previously set, enable if cosmetics are set on this page.]]

Once everything is set, simply click <samp>PATCH ROM!</samp> The patching process uses your device's CPU, so how long this takes is dependent on your hardware. Once the process is complete, a download will begin. Save this new rom file separately from the original rom, and now it's time to proceed to the [[#Playing the Randomizer|Playing the Randomizer]] section.

== Windows Setup ==
If you desire for any reason to use the offline randomizer program instead, you will need one or two other programs first. The randomizer itself will work on Windows, macOS, and Linux. The ROM will work on any device that has a Nintendo 64 emulator available. However, the following setup steps focus on getting the randomizer working on the Windows operating system.

=== Install Node.js ===
As of version 4.14 of the randomizer, the source code versions of the randomizer require [https://nodejs.org/en/ Node.js] to be installed. (Please skip this step for the executable version of the randomizer found on [https://ootrandomizer.com/downloads the website's download page].)

Open the [https://nodejs.org/en/ Node.js website] and click on the <samp><kbd>LTS</kbd></samp> button on their home page.<sup>1</sup> Save the <samp>msi</samp> installer file then, locate it in your <samp>Downloads</samp> folder, or wherever you saved it. Launch the installer by double-clicking it. Click <samp><kbd>Next</kbd></samp> until you get to the <samp>Tools for Native Modules</samp> screen. Make sure the <samp>Automatically install the necessary tools. [...]</samp> checkbox is '''not''' checked.<sup>2</sup> Click <samp><kbd>Next</kbd></samp> once you have made sure of this. Next click the <samp><kbd>Install</kbd></samp> button, then once that is completed, click the <samp><kbd>Finish</kbd></samp> button.

<gallery>
File:Setup-NodeJs-LTSButton.jpeg|1. Choose the <samp>LTS</samp> version which was <samp>12.16.2</samp> here, but may be different for you. So long as it is v14.x or lower it will be compatible with OoTR. Do '''not''' click the <samp>Current version</samp> button, as that version isn't currently compatible.
File:Setup-NodeJs-NativeModulesUnchecked.jpeg|2. Make sure the checkbox is unchecked before clicking <samp>Next</samp>.
</gallery>

=== Install Python ===
{{TemporaryNotice|Currently the latest release Python 12.0 does not work with the randomizer for Windows users. This will be fixed in Python 12.1 in December.}}
To run the randomizer on your computer you will need to install [https://www.python.org Python]. This is not needed when using the [https://ootrandomizer.com online generator] but in all other cases you '''must''' have Python installed. The randomizer requires at least <samp>Python 3.8.0</samp> installed, however we recommend installing the latest stable version of Python available when you install it.

Go to the [https://www.python.org Python website] and hover your mouse over the <samp>Downloads</samp> tab. A little dialog will appear and should have a <samp>Download for Windows</samp> section displayed. Click on the button labeled <samp>Python</samp> with a version number next to it.<sup>1</sup> Save the <samp>exe</samp> installer file, then locate it in your <samp>Downloads</samp> folder, or wherever you saved it. Launch the installer by double-clicking it. Click <samp><kbd>Install Now</kbd></samp> on the installer.<sup>2</sup>

<gallery>
File:Setup-Python-DownloadPythonButton.jpeg|1. Click this button. In this case the latest version was <samp>3.8.2</samp> but the version displayed for you is the one you want.
File:Setup-Python-InstallNow.jpeg|2. Choose to <samp>Install Now</samp>.
</gallery>

== Downloading the Randomizer ==
Please ensure Node and/or Python are properly installed per the instructions above before downloading the randomizer. Once your computer is prepared, you can follow the instructions for the [[#Standalone Download|standalone download]] version or the [[#Source Code|source code and Dev]] version of the randomizer.

=== Standalone Download ===
Download the current standalone download version of the randomzier by going to the [https://ootrandomizer.com/downloads downloads page on the website] and select the appropriate download for your operating system. The provided installers should install the randomizer to the appropriate place for your operating system and you should be able to launch the randomizer from your operating system's application launcher—Start Menu in Windows, Applications folder in macOS, and whichever application launcher you prefer for Linux. ''You must have [[#Install Python|Python 3.8 or higher]] installed for the standalone download randomizer to work''.

Once you have generated a randomizer ROM file, head to [[#Playing the Randomizer|playing the randomizer]].

==== Windows Troubleshooting ====
[[File:Setup-Standalone-WindowsSmartScreen.jpeg|none|thumb|Click <samp>More info</samp> then <samp>Run anyway</samp> to run the installer.]]

Often when a new version of the randomizer is released the standalone download is not trusted by the Windows operating system. When you try to run the installer it will pop up a Windows Smartscreen window. All you have to do is click <samp><kbd>More info</kbd></samp> and then the <samp><kbd>Run anyway</kbd></samp> button. The installer will then launch and install the randomizer.

=== Source Code ===
You can download either the release source code, or the development (Dev) branch source code to run the randomizer. Most users will want to use the [[#Standalone Download|standalone download]] for the release version, so this section will focus on running the latest development version from source code. ''You must have the latest [[#Install Node.js|Node.js LTS version]] and [[#Install Python|Python 3.8 or higher]] installed for the source code version of the randomizer to work''.

Head to the [https://ootrandomizer.com website] and in the navigation bar at the top, click on <samp><kbd>Resources</kbd></samp> and then choose the <samp><kbd>Dev Github</kbd></samp> option.<sup>1</sup> Next click on the <samp><kbd>releases</kbd></samp> button to reach the page with all of the randomizer releases.<sup>2</sup> Click on the <samp><kbd>zip</kbd></samp> button for the latest development version of the randomizer to download it.<sup>3</sup> ''The Dev branch of the randomizer is known to be unstable. The latest version may not work properly. If you run into issues you may want to join the {{discord|text=Discord server}} and ask which Dev version of the randomizer you should download''.

Locate the <samp>zip</samp> file you just downloaded in your <samp>Downloads</samp> folder, or wherever you saved it. <kbd>Right-click</kbd> the file and click <samp><kbd>Extract All...</kbd></samp> and extract the files from the zip archive.<sup>4</sup> A new folder should appear which may contain another folder inside. Open the folders until you see a folder with many folders and files inside. Locate the <samp>Gui.py</samp> file inside and <kbd>Double-click</kbd> it to launch the randomizer.<sup>5</sup> The first time you run the randomizer many files need to be downloaded from the internet. Wait patiently as they download.<sup>6</sup> ''This process will be faster every time you run the randomizer after this since it will only have to download the files once. Even if you download a new version it will be slightly faster as most of the files will be located in the Node.js cache and most will simply be used from there''.

The randomizer will launch once the initial installation has finished. Once you have generated a randomizer ROM file, head to [[#Playing the Randomizer|playing the randomizer]].

<gallery>
File:Setup-SourceCode-GitHubLink.jpeg|1. Open the <samp>Dev Github</samp> link to open the GitHub page for the main fork of the randomizer.
File:Setup-SourceCode-GitHubReleases.jpeg|2. The <samp>releases</samp> button will display all of the different randomizer versions.
File:Setup-SourceCode-GitHubZip.jpeg|3. A <samp>zip</samp> button should appear on the top release that you can click on.
File:Setup-SourceCode-WindowsExtract.jpeg|4. On Windows, choose to <samp>Extract All...</samp> from the zip file.
File:Setup-SourceCode-Gui-py.jpeg|5. Run the <samp>Gui.py</samp> Python script.
File:Setup-SourceCode-InitialInstall.jpeg|6. Wait patiently as Node.js downloads the randomizer's dependencies.
</gallery>

==== Alternative Source Code Download Method ====
You can alternatively use [https://git-scm.com/ Git] to download the source code. This is the easiest way to keep up to date with the latest changes. We have a guide on using [[GitKraken]], a GUI for git that many of the developers use if you want to try to download the source code this way. You still need to install [[#Source Code|the other software mentioned above]].

== Playing the Randomizer ==
===Emulators===
The Ocarina of Time Randomizer can be played on PC via an emulator. Given the emulation quality difference between emulators, not every emulator can be recommended.

The emulators we support are available for free and have been extensively tested to work well with OoTR, assuming proper setup.

[https://wiki.ootrandomizer.com/index.php?title=Project64 Project64 v3.0+] (Windows) is the least resource-intensive emulator and the easiest to setup. However, it is important that versions 3.0+ are used since these are currently the only ones that provide a stable game experience. Furthermore, '''<span style="color:red">please keep in mind that using Project64 v2.x for racing is against our community's racing rules</span>'''.

[[Bizhawk]] (Windows) is the most resource-intensive, but easier to setup than RetroArch. Bizhawk is also the only race-legal emulator to support [[Multiworld]] currently.

[https://wiki.ootrandomizer.com/index.php?title=Retroarch RetroArch] (Windows, macOS, Linux, and more) isn't as resource-intensive as Bizhawk. However, setting up RetroArch can be a frustrating experience, and especially so for certain controllers.

[[Dolphin]] (Windows, macOS, and possibly Linux and Android) is capable of running OoTR through emulating Wii Virtual Console. As a result, it also has the Wii VC advantage of having less lag when opening the item menu. Other advantages include being lightweight and being easy to set up, especially with Gamecube controllers and either the official Nintendo or the Mayflash adapter. Downsides include random Wii VC crashes, having to inject the OoTR ROM into a WAD for every seed and additional lag in some areas (e.g. Market) due to shortcomings in how Wii VC is emulated.

=== Wii Virtual Console ===

The Ocarina of Time Randomizer can be played on a [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console Wii] (or [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Playing_On_The_Wii_U.27s_Virtual_Wii Wii U]). The advantages are fast load times, less lag and improved graphics compared to the other options available. Some also prefer the stick sensitivity and deadzone settings of the Wii VC over that of pc emulators. The downsides are random (but extremely rare) crashes, installing new seeds is a longer process than on pc emulators, and potentially additional costs if you don't already own a Wii and/or compatible controllers or if you wish to stream your gameplay.

=== EverDrive ===

The Ocarina of Time Randomizer can be played on a N64 by using the [https://wiki.ootrandomizer.com/index.php?title=Everdrive EverDrive]. Keep in mind that EverDrives are expensive and that the N64 is very laggy. The randomizer also requires the memory pak, even though base Ocarina of Time does not.

== Patch Files ==
If someone shares a ZPF or ZPFZ file with you, these are [[Patch Files]]. They are a copyright-free method to share randomizer seeds with people. The [[Patch Files|patch files]] page will explain what to do with them.

Template:TemporaryNotice

2023-10-09T14:02:32Z

Flagrama: Created page with "{{tag |class=bg-warning archival text-warning |shorttext=This is a temporary notice! |smalltext={{#if:{{{1|{{{reason|}}}}}}|'''Reason''': {{{1|{{{reason|}}}}}}|No reason has b..."

{{tag
|class=bg-warning archival text-warning
|shorttext=This is a temporary notice!
|smalltext={{#if:{{{1|{{{reason|}}}}}}|'''Reason''': {{{1|{{{reason|}}}}}}|No reason has been specified. If you know it, please add it using the ''first'' parameter for the {{t|TemporaryNotice}} template on this page.}}
}}<noinclude>
[[Category:Header box templates]][[Category:Templates]]</noinclude>

Setup

2023-10-09T13:56:03Z

Flagrama: update python version, link to previous sections in Source Code and Standalone sections

It is usually recommended to use the online generator on the website instead of the download or source code versions of the randomizer. The [[#Video Tutorial|video tutorial]] is also available as a walk through for the website. The [[Readme]] explains what the different options do. You can also check out the [[Changelog]] to see what changes have happened between randomizer versions. Recent [https://ootrandomizer.com/generatorDev Dev] and [https://ootrandomizer.com/generatorDev?version=devR_ Dev-R] versions are also available on the website.

Ocarina of Time Randomizer is compatible with emulators, Wii Virtual Console, and original Nintendo 64 hardware. Learn more about these options in the [[#Playing the Randomizer|Playing the Randomizer]] section.

Base files (ROMs, Wii common key, etc.) that are needed to play Ocarina of Time Randomizer are copyrighted and will not be provided by the community nor staff.

''If you want to run the [https://ootrandomizer.com/downloads standalone download] version of the randomizer, you should skip to [[#Install Python|installing Python]].''

''If you want to run the [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/master release source code] or [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/Dev Dev source code] version of randomizer, you should skip to [[#Install Node.js|installing Node.js]].''

''We have compiled [https://wiki.ootrandomizer.com/index.php?title=Common_Softlocks_And_Crashes a list of known softlocks and crashes] (WIP). It is recommended to read it through to potentially save you from frustration later.''

{{TOClimit|3}}

== Online Generator ==

This section contains information similar to what is presented in the video by TreZc0, but does not go into as much detail regarding randomization options or emulator setup. The [[Readme]] and [[https://wiki.ootrandomizer.com/index.php?title=Setup#Emulators emulator]] pages available to help with those details. The video is highly recommended, especially since it will provide visuals to aid in setup.

=== Video Tutorial ===
<youtube dimensions="480x270">https://www.youtube.com/watch?v=-xNjTtcA4Es</youtube>

Once you have viewed the video, generated a seed, and patched a randomizer ROM file, head to [[#Playing the Randomizer|Playing the Randomizer]].

=== Generating a Seed ===
The online randomizer does not require any downloads except for the final randomized rom, however you will be required to have one or more base files to create the randomized rom. Some of these are copyrighted files that you will need to have prior to receiving any help with setup in the {{discord|text=randomizer discord}}. Please read all rules of the discord and peruse the resources channel before requesting assistance there.
* '''Always Required'''
** OoT v1.0 NTSC-U/NTSC-J rom - Copyrighted file
** A device with a multicore CPU & at least 2GB of available ram
*** Even most modern mobile devices (i.e. 2019 or newer) meet these requirements
** A modern browser (2020 or later): Chrome, Firefox, Edge, Safari, or Opera
** A method to play the game, which is covered later in the [[#Playing the Randomizer|Playing the Randomizer]] section.
* '''Only Required for WiiVC/vWii/Dolphin'''
** OoT v1.2 NTSC WAD - Copyrighted file
** Wii Common Key - Copyrighted file

Once prepared, go to https://ootrandomizer.com and click on the <samp><kbd>Play Now</kbd></samp> button for the latest stable version.
[[File:Setup-Website-PlayNow.jpeg|none|thumb|Click the <samp>Play Now</samp> button on the website to open the online generator.]]

Just below the "Ocarina of Time Item Randomizer v6.2" title is the button <samp><kbd>INSTRUCTIONS/HELP</kbd></samp> which effectively repeats the information available here and in the video at a quick glance.

Detailed explanations of the settings can be found on the [[Readme]] page and quick tooltips can be seen by hovering over any setting in the generator.

'''For a first seed, we recommend using either the Default/Beginner or Easy presets available on the "ROM Options" tab of the generator.''' The Default/Beginner preset is aimed at those familiar with vanilla who desire a similar progression. It uses base glitchless logic with no added tricks and no additional timesavers enabled (see the tab "Other" in the GUI). The world begins closed. Expect a long playthrough. The Easy Preset is aimed at those who have perhaps seen a few Randomizer runs previously and/or wish to dive right in. It uses base glitchless logic with no added tricks, but it does use additional timesavers (see the tab "Other" in the GUI). The world is more open after leaving Kokiri Forest.

Once a preset is selected from the dropdown, click <samp><kbd>LOAD</kbd></samp> and all settings shown in the generator, except Cosmetics and SFX, will change to match the preset. Feel free to look at the other tabs to see which settings are enabled by each preset before deciding which to use.

[[File:Presets.png|none|thumb|Presets location on the ROM Options tab of the generator.]]

If you're feeling a little more bold, settings may still be changed from those loaded by the preset to any you desire. '''However''', on the first tab of the randomizer, ROM Options, please never disable "'''Create Spoiler Log'''." The Spoiler Log is a file containing all the item locations, settings, and entrances when applicable of the randomized seed. Though you may never look at it, it is vital for those helping in the randomizer discord to be able to check this log if you require help at any point in the seed.

Once the settings are prepared, there are two options to generate the seed, <samp><kbd>GENERATE SEED!</kbd></samp> and <samp><kbd>GENERATE RACE SEED!</kbd></samp>. For most purposes, '''we highly recommend to only use the first option'''. Race seeds are encrypted and lock away the spoiler log even if it is generated. These locked logs will not be unlocked except for community races organized by the race mods.

Seed generation takes, on average, 15 seconds but may be longer depending on the current workload of the website. Now you will be on the seed page. The URL follows the naming convention of "https://ootrandomizer.com/seed/get?id=680574" where the 6 digit ID at the end is unique to your seed. This is particularly useful for sharing seeds with friends or sharing the spoiler log when asking for help. (Note that the seed ID at the end of the URL is also present in the default file name of randomized roms. We recommend not changing rom names to keep this piece of information always with the seed.)

Now it is time to direct the website to your base rom (OoT v1.0 NTSC-U/NTSC-J). The version is important, Rev A/B and MQ roms will not work. For a normal N64 seed for use on everdrive or most emulators, leave the Output type toggle on <samp>.z64 (N64/Emulator)</samp> and browse to your rom file. For WiiVC/vWii/Dolphin, swap to <samp>WAD (WiiVC)</samp> and in addition to the Base Rom, also browse to your 1.2 WAD and Wii Common Key files. You can only patch a randomizer seed if you have the correct files given, so this is very important.

This page also offers the option to change the cosmetics and SFX from those generated with the seed. Please be aware that if you set your desired cosmetics and SFX previously, the option "Override Original Cosmetics" should be disabled before patching the rom as it is enabled by default.

[[File:Override_Cosmetics.PNG|none|thumb|Disable if cosmetics were previously set, enable if cosmetics are set on this page.]]

Once everything is set, simply click <samp>PATCH ROM!</samp> The patching process uses your device's CPU, so how long this takes is dependent on your hardware. Once the process is complete, a download will begin. Save this new rom file separately from the original rom, and now it's time to proceed to the [[#Playing the Randomizer|Playing the Randomizer]] section.

== Windows Setup ==
If you desire for any reason to use the offline randomizer program instead, you will need one or two other programs first. The randomizer itself will work on Windows, macOS, and Linux. The ROM will work on any device that has a Nintendo 64 emulator available. However, the following setup steps focus on getting the randomizer working on the Windows operating system.

=== Install Node.js ===
As of version 4.14 of the randomizer, the source code versions of the randomizer require [https://nodejs.org/en/ Node.js] to be installed. (Please skip this step for the executable version of the randomizer found on [https://ootrandomizer.com/downloads the website's download page].)

Open the [https://nodejs.org/en/ Node.js website] and click on the <samp><kbd>LTS</kbd></samp> button on their home page.<sup>1</sup> Save the <samp>msi</samp> installer file then, locate it in your <samp>Downloads</samp> folder, or wherever you saved it. Launch the installer by double-clicking it. Click <samp><kbd>Next</kbd></samp> until you get to the <samp>Tools for Native Modules</samp> screen. Make sure the <samp>Automatically install the necessary tools. [...]</samp> checkbox is '''not''' checked.<sup>2</sup> Click <samp><kbd>Next</kbd></samp> once you have made sure of this. Next click the <samp><kbd>Install</kbd></samp> button, then once that is completed, click the <samp><kbd>Finish</kbd></samp> button.

<gallery>
File:Setup-NodeJs-LTSButton.jpeg|1. Choose the <samp>LTS</samp> version which was <samp>12.16.2</samp> here, but may be different for you. So long as it is v14.x or lower it will be compatible with OoTR. Do '''not''' click the <samp>Current version</samp> button, as that version isn't currently compatible.
File:Setup-NodeJs-NativeModulesUnchecked.jpeg|2. Make sure the checkbox is unchecked before clicking <samp>Next</samp>.
</gallery>

=== Install Python ===
To run the randomizer on your computer you will need to install [https://www.python.org Python]. This is not needed when using the [https://ootrandomizer.com online generator] but in all other cases you '''must''' have Python installed. The randomizer requires at least <samp>Python 3.8.0</samp> installed, however we recommend installing the latest stable version of Python available when you install it.

Go to the [https://www.python.org Python website] and hover your mouse over the <samp>Downloads</samp> tab. A little dialog will appear and should have a <samp>Download for Windows</samp> section displayed. Click on the button labeled <samp>Python</samp> with a version number next to it.<sup>1</sup> Save the <samp>exe</samp> installer file, then locate it in your <samp>Downloads</samp> folder, or wherever you saved it. Launch the installer by double-clicking it. Click <samp><kbd>Install Now</kbd></samp> on the installer.<sup>2</sup>

<gallery>
File:Setup-Python-DownloadPythonButton.jpeg|1. Click this button. In this case the latest version was <samp>3.8.2</samp> but the version displayed for you is the one you want.
File:Setup-Python-InstallNow.jpeg|2. Choose to <samp>Install Now</samp>.
</gallery>

== Downloading the Randomizer ==
Please ensure Node and/or Python are properly installed per the instructions above before downloading the randomizer. Once your computer is prepared, you can follow the instructions for the [[#Standalone Download|standalone download]] version or the [[#Source Code|source code and Dev]] version of the randomizer.

=== Standalone Download ===
Download the current standalone download version of the randomzier by going to the [https://ootrandomizer.com/downloads downloads page on the website] and select the appropriate download for your operating system. The provided installers should install the randomizer to the appropriate place for your operating system and you should be able to launch the randomizer from your operating system's application launcher—Start Menu in Windows, Applications folder in macOS, and whichever application launcher you prefer for Linux. ''You must have [[#Install Python|Python 3.8 or higher]] installed for the standalone download randomizer to work''.

Once you have generated a randomizer ROM file, head to [[#Playing the Randomizer|playing the randomizer]].

==== Windows Troubleshooting ====
[[File:Setup-Standalone-WindowsSmartScreen.jpeg|none|thumb|Click <samp>More info</samp> then <samp>Run anyway</samp> to run the installer.]]

Often when a new version of the randomizer is released the standalone download is not trusted by the Windows operating system. When you try to run the installer it will pop up a Windows Smartscreen window. All you have to do is click <samp><kbd>More info</kbd></samp> and then the <samp><kbd>Run anyway</kbd></samp> button. The installer will then launch and install the randomizer.

=== Source Code ===
You can download either the release source code, or the development (Dev) branch source code to run the randomizer. Most users will want to use the [[#Standalone Download|standalone download]] for the release version, so this section will focus on running the latest development version from source code. ''You must have the latest [[#Install Node.js|Node.js LTS version]] and [[#Install Python|Python 3.8 or higher]] installed for the source code version of the randomizer to work''.

Head to the [https://ootrandomizer.com website] and in the navigation bar at the top, click on <samp><kbd>Resources</kbd></samp> and then choose the <samp><kbd>Dev Github</kbd></samp> option.<sup>1</sup> Next click on the <samp><kbd>releases</kbd></samp> button to reach the page with all of the randomizer releases.<sup>2</sup> Click on the <samp><kbd>zip</kbd></samp> button for the latest development version of the randomizer to download it.<sup>3</sup> ''The Dev branch of the randomizer is known to be unstable. The latest version may not work properly. If you run into issues you may want to join the {{discord|text=Discord server}} and ask which Dev version of the randomizer you should download''.

Locate the <samp>zip</samp> file you just downloaded in your <samp>Downloads</samp> folder, or wherever you saved it. <kbd>Right-click</kbd> the file and click <samp><kbd>Extract All...</kbd></samp> and extract the files from the zip archive.<sup>4</sup> A new folder should appear which may contain another folder inside. Open the folders until you see a folder with many folders and files inside. Locate the <samp>Gui.py</samp> file inside and <kbd>Double-click</kbd> it to launch the randomizer.<sup>5</sup> The first time you run the randomizer many files need to be downloaded from the internet. Wait patiently as they download.<sup>6</sup> ''This process will be faster every time you run the randomizer after this since it will only have to download the files once. Even if you download a new version it will be slightly faster as most of the files will be located in the Node.js cache and most will simply be used from there''.

The randomizer will launch once the initial installation has finished. Once you have generated a randomizer ROM file, head to [[#Playing the Randomizer|playing the randomizer]].

<gallery>
File:Setup-SourceCode-GitHubLink.jpeg|1. Open the <samp>Dev Github</samp> link to open the GitHub page for the main fork of the randomizer.
File:Setup-SourceCode-GitHubReleases.jpeg|2. The <samp>releases</samp> button will display all of the different randomizer versions.
File:Setup-SourceCode-GitHubZip.jpeg|3. A <samp>zip</samp> button should appear on the top release that you can click on.
File:Setup-SourceCode-WindowsExtract.jpeg|4. On Windows, choose to <samp>Extract All...</samp> from the zip file.
File:Setup-SourceCode-Gui-py.jpeg|5. Run the <samp>Gui.py</samp> Python script.
File:Setup-SourceCode-InitialInstall.jpeg|6. Wait patiently as Node.js downloads the randomizer's dependencies.
</gallery>

==== Alternative Source Code Download Method ====
You can alternatively use [https://git-scm.com/ Git] to download the source code. This is the easiest way to keep up to date with the latest changes. We have a guide on using [[GitKraken]], a GUI for git that many of the developers use if you want to try to download the source code this way. You still need to install [[#Source Code|the other software mentioned above]].

== Playing the Randomizer ==
===Emulators===
The Ocarina of Time Randomizer can be played on PC via an emulator. Given the emulation quality difference between emulators, not every emulator can be recommended.

The emulators we support are available for free and have been extensively tested to work well with OoTR, assuming proper setup.

[https://wiki.ootrandomizer.com/index.php?title=Project64 Project64 v3.0+] (Windows) is the least resource-intensive emulator and the easiest to setup. However, it is important that versions 3.0+ are used since these are currently the only ones that provide a stable game experience. Furthermore, '''<span style="color:red">please keep in mind that using Project64 v2.x for racing is against our community's racing rules</span>'''.

[[Bizhawk]] (Windows) is the most resource-intensive, but easier to setup than RetroArch. Bizhawk is also the only race-legal emulator to support [[Multiworld]] currently.

[https://wiki.ootrandomizer.com/index.php?title=Retroarch RetroArch] (Windows, macOS, Linux, and more) isn't as resource-intensive as Bizhawk. However, setting up RetroArch can be a frustrating experience, and especially so for certain controllers.

[[Dolphin]] (Windows, macOS, and possibly Linux and Android) is capable of running OoTR through emulating Wii Virtual Console. As a result, it also has the Wii VC advantage of having less lag when opening the item menu. Other advantages include being lightweight and being easy to set up, especially with Gamecube controllers and either the official Nintendo or the Mayflash adapter. Downsides include random Wii VC crashes, having to inject the OoTR ROM into a WAD for every seed and additional lag in some areas (e.g. Market) due to shortcomings in how Wii VC is emulated.

=== Wii Virtual Console ===

The Ocarina of Time Randomizer can be played on a [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console Wii] (or [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Playing_On_The_Wii_U.27s_Virtual_Wii Wii U]). The advantages are fast load times, less lag and improved graphics compared to the other options available. Some also prefer the stick sensitivity and deadzone settings of the Wii VC over that of pc emulators. The downsides are random (but extremely rare) crashes, installing new seeds is a longer process than on pc emulators, and potentially additional costs if you don't already own a Wii and/or compatible controllers or if you wish to stream your gameplay.

=== EverDrive ===

The Ocarina of Time Randomizer can be played on a N64 by using the [https://wiki.ootrandomizer.com/index.php?title=Everdrive EverDrive]. Keep in mind that EverDrives are expensive and that the N64 is very laggy. The randomizer also requires the memory pak, even though base Ocarina of Time does not.

== Patch Files ==
If someone shares a ZPF or ZPFZ file with you, these are [[Patch Files]]. They are a copyright-free method to share randomizer seeds with people. The [[Patch Files|patch files]] page will explain what to do with them.

GitKraken

2023-10-06T21:56:26Z

Flagrama: /* Forking the code */ add managing other forks section afterwards

So, you want to start contributing to Ocarina of Time Item Randomizer. Maybe you know how to code in [https://www.python.org/ Python] and want to improve something in the backend code or add a simple hack. Or perhaps you know some Assembly and want to contribute a whole new feature to add to the game. Even just a quick bug fix is always appreciated.

In order to contribute you will need to get familiar with [https://git-scm.com/ Git], the version control system that the randomizer uses to organize and share its code. Git is normally a command line tool, but many GUIs also exist as a frontend that is more user-friendly, if a bit more limited than the actual Git tool. [https://www.gitkraken.com/ GitKraken] is the GUI that many of the OoTR developers use and are familiar with so is the one you are most likely to get support for if you run into issues.

* [https://www.gitkraken.com/ Click the Free Download button to download the GitKraken installer]

Run <code>GitKrakenSetup.exe</code> and it will automatically install itself and launch for the first time.

== Sign in to GitKraken ==

GitKraken requires you register an account to use their software. Since you will be using [https://github.com GitHub] to contribute to the randomizer anyway so sign up over there first then choose <code>Sign in with GitHub</code>. Doing so will launch a web browser with a page asking you to authorize GitKraken to access GitHub. Choose <code>Continue authorization</code>. Now sign in with your GitHub account if you are not already. You will then be brought to a page asking you if you want to authorize GitKraken to access your GitHub account on GitHub. Click `Allow` and GitKraken will now bring up the "Set Up Your Profile" screen.

[[File:GitKraken_setupprofile.png|thumb|Profile setup screen]]

== Set up ==

There are a couple of things that need to be set up from here that you only need to do once. First, set up the GitKraken profile.

Here you select an avatar which only you will see, but will pull from [https://gravatar.com Gravatar] if you use an email address associated with an account which GitHub will also do. Ignore the "Profile Name" box, "Default Profile" is fine. Under "Name" it is traditional to use your full first and last name, but if you are not comfortable with that you can enter a nick name. The most important text box here is "Email" and it should be set to the same email address as your GitHub account. Now, click <code>Save Changes</code> and GitKraken will open proper.

=== Clone the main repository ===

With GitKraken set up go to <code>File > Clone Repo</code> and make sure "Clone with URL" is selected. Click on the ''Browse'' button next to the "Where to clone to" text box. By default GitKraken should choose the "Documents" folder. This is fine, you can click ''Select Folder'' to use it. '''If you are using Windows 7 you will get an error saying "You've selected a library. Please choose a folder instead." Click on the arrow next to the "Documents" library and choose "My Documents" then click ''Select Folder'''''. In the URL box put the GitHub URL to the current main repository. At the time of writing the current main repo is <code><nowiki>https://github.com/TestRunnerSRL/OoT-Randomizer</nowiki></code>. Filling in the box will reveal a new "Full Path" text box. Leave this alone and click <code>Clone the repo!</code>.

[[File:GitKraken_successclone.png|800px|center|none]]

GitKraken will now show a bar near the top of the window telling you that you cloned the repo. Click the <code>Open Now</code> button to open the repository in a tab. Congratulations, you now have a local copy of the randomizer code on your computer.

=== Forking the code ===

[[File:GitKraken_mainscreen.png|thumb|GitKraken with Ocarina of Time Item Randomizer open]]

While you now have a copy of the code on your computer, you do not have permission to push code changes directly on to the existing repository. To actually make changes and upload them you need to create a copy of the main repository, called a ''Fork''. Go to the main repository on GitHub and at the top right of the page you should see the ''Fork'' button. This will create a copy of the repository on your account which you have permission to modify.

Now, go back to GitKraken and hover over the ''REMOTE'' header on the left side of the screen. A "+" button should appear. Click that then in the new box that appears choose the "URL" option. Under "Name" put your username so that you can tell that it is your repository. Under "Pull URL" put the link to your repository. It will be similar to the following: <code><nowiki>https://github.com/username/OoT-Randomizer.git</nowiki></code>. Ensure you change <code>username</code> to your GitHub username. Click <code>Add Remote</code> to add your copy of the repository to GitKraken.

Congratulations, you are now prepared to submit contributions to the randomizer. You can follow [[#Clone the main repository|these steps]] for any other Git or GitHub repositories you want to contribute to as well.

=== Managing Other Forks ===

Sometimes you will want to work off of branches on other forks of the Randomizer. You don't need a separate copy of the repository to do this. Git makes it very simple to switch between branches and tags of any other copy of the repository. Doesn't matter if it is on GitHub, some other website, or on a network share on another computer in your house. This section focuses on other forks on GitHub though, as that is where you'll find all of the OoT-Randomizer forks.

You follow the same directions from the previous [[#Forking the code|forking the code]] section, but instead of your GitHub username in the "Name" and in the "Pull URL" using the same <code><nowiki>https://github.com/username/OoT-Randomizer.git</nowiki></code> URL you will change <code>username</code> to the GitHub username of the person who made the fork. You can then click <code>Add Remote</code> so that GitKraken will now know to look for more branches there. You can then use it much like the main repository is used in the following steps.

== Contributing ==

Now that you have your own copy of the repository you can start changing code and submitting it to the main repo. The following steps go through the usual Git on GitHub workflow for contributions.

=== Create a local branch ===

Since repository maintainers will often change commits after they are submitted, usually to make the Git log history cleaner looking, you do not want to make changes directly on the main branch. You want to create a branch off of the main branch which will give you a clean workspace that you won't have to worry about figuring out how to update it when new changes are added to the main repository and you need to pull them down.

The main development branch for the randomizer is called <code>Dev</code>. Other repositories may use branches called develop or development as well, and some just use master as their main branch. When you start to add code you want to make a branch off of this main branch first. You should already have "Dev" selected under the "LOCAL" heading on the left side of the GitKraken screen. If it is not currently selected double-click it to select it. Now at the top of the screen is a button with a "Branch" label. Click this button then type a short description for what you intend your changes to be and press <code>Enter</code>. This will create a new branch and automatically check it out for you. Now under the "LOCAL" header you should see your new branch selected.

You may now make any changes to the code that you want. Code files are just normal text files, in this case using the .py, .c, and other file extensions instead of the .txt extension. They can be opened in any text editor that will open .txt files. Even Notepad, TextEdit, and gedit can open these files. The extension is only to help let you know that text within is expected to look a certain way. [https://visualstudio.microsoft.com/ Visual Studio Code] is such a text editor, and as it is cross-platform and used by many people in the community it is the one we recommend you use.

=== Commit and push your changes ===

Once you have made your changes, or are at a logical stopping point for part of them, you will want to commit your changes. If you go back to GitKraken you should now see a new entry at the very top of the Git log. It will have the text "// WIP" and next to it will be some icons. A "+" or "-" if you have added or removed any files, a pen if you have edited some, or a file icon if you have renamed one. Clicking on this entry should update the right side panel of GitKraken.

Under the "Unstaged Files" section you will see each file that you have modified in some way. You will want to ensure all of these are the changes you want to submit. If they are, simply click the "Stage all changes" button to move them to the "Staged Files" section. If there are some you don't want to submit, you can individually stage files with buttons that appear to the right when you hover over them with the mouse, or you can stage all the changes and remove individual ones the same way in the "Staged Files" area.

Once you have staged your changes move down to the "Commit Message" box. Put a short description of your changes in the "Summary" field. You shouldn't use more than 50-80 characters here. If you need to explain some things more clearly do so in the "Description" field below. Once you have entered a commit message you can click the <code>Commit changes to {n} files</code> button to commit your changes to your local branch.

With your changes committed locally you should now push them to your fork on GitHub. Click the "Push" button at the top of the screen and GitKraken will ask you to choose the remote branch you want to push to. Since this is a new branch you will want to create a new branch so just make sure your repository is highlighted in the dropdown box, then in the box next to it the name of your local branch should already be pre-filled. Click the <code>Submit</code> button and your changes should now be viewable on your GitHub repository page.

=== Making a pull request ===

You've now made your changes and pushed them to your fork. Next you need to make a pull request to the main repository to have your changes merged into the randomizer proper. Go to your OoT-Randomizer repository on GitHub. Near the middle left of the screen you should see a dropdown box with a "Branch: Dev" or "Branch: master" label. Click this then select the new branch you pushed with your changes. After the page reloads, right next to the dropdown box you will see a button labeled "New pull request." Click this button and a new page will load. The left side should already be pre-filled with the TestRunner repository and Dev branch, and the right side should already be pre-filled with your repository and the branch with your changes. If not, fix it now.

The pull request title will also be pre-filled with your "Summary" from your Git commit message, and the "Leave a comment" box will have your "Description" already filled in if you wrote one. You might want to change this to make it a bit clearer to people looking at the pull request page and the repository maintainer what your changes do. Once you are happy with what is here, click on the "Create pull request" button. If this is a larger change and you're still working on it but want feedback, you can also click the arrow next to this button and choose "Create draft pull request" instead.

Your pull request should now be created. You'll likely get comments from the developers and community members curious about different aspects of your changes, and you may get a request to change how something functions. To make changes to the pull request, just commit them to your existing local branch and push it to your fork branch again. This will automatically update the pull request.

Once your changes have been approved they will be merged into the main branch. At this point you can now delete your branch. For each new pull request you intend to make you should create a new branch based off the [[#Staying up-to-date|latest version]] of the main branch, and do [[#Contributing|these steps]] again.

== Staying up-to-date ==

This is the easiest method to keep the Dev branch up-to-date. Ensure that "Dev" is selected under the "LOCAL" header. If it is not double-click the branch to check it out. Now click on the "Pull" button at the top of the screen. Yes, that is it.

Project64

2023-10-05T23:28:20Z

Flagrama: fix mention of Project64 as PJ64. PJ64 should only be used where it is displayed literally (n-rage for pj64).

Project64 is no doubt the most popular N64 emulator available. Randomizer staff will support Project 64 '''3.0.0 or newer''' which was released on May 26, 2021. We will not directly support any previous version.

{{race rule|Only Project64 3.0 and newer are allowed and supported for racing. Version 2.0 - 2.3 are not allowed for racing. }}
Project64 v3.0.0 or newer as well as [[Bizhawk]] and [[Retroarch]] are the recommended emulators for racing.

[https://www.pj64-emu.com/public-releases Download Project64] '''v3.0.0 or newer'''

Please note that certain ads on the Project64 download page might lead you to download adware. Only wait for the download to start automatically or click ''Try again'' to start it.

Version 3.0.1 changed the wording in many places. One of the major ones is changing <samp>Settings...</samp> in the <samp>Options</samp> menu, so when using 3.0 anywhere you see <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> look for <kbd><samp>Options</samp> ⇒ <samp>Settings...</samp></kbd> instead.

== Configure Controller ==
First, read the [[Controller Setup]] guide. Ensure the controller is calibrated, and if you are using one of the controllers with additional setups steps in that guide make sure you follow them.

When using an Xbox controller, or any controller that is an XInput device, you must first go to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp> ⇒ <samp>Plugins</samp></kbd> and change the <kbd><samp>Input (controller) plugin</samp></kbd> from <kbd><samp>Project64 Input Plugin</samp></kbd> to <kbd><samp>N-Rage for PJ64</samp></kbd>. Then navigate to <kbd><samp>Options</samp> ⇒ <samp>Configure controller plugin...</samp></kbd> and check <kbd><samp>XInput</samp></kbd> at the top. This will change the bind menu to be more appropriate for your device.<sup>2</sup> The <samp>XControl</samp> column is the button on your controller, and the <samp>N64</samp> column is the button on the N64 controller you want it to use.

For other controllers and keyboard users, use the default <kbd><samp>Project64 Input Plugin</samp></kbd> or if N-Rage works better for you ensure that <samp>XInput</samp> does not have a check by it. Click on the button for the control you want to bind a button to and the menu will wait for you to press a button on the controller or a key on your keyboard to use for the button. ''You may need to change these again if you switch controllers''.

===GameCube Controllers===
There is a common issue with GameCube controllers that happens if you are using Project64 Input Plugin and using its options that lets you bind all of the controls. Whenever you bind one of the triggers, if you press it all the way down until it clicks it will bind two controls in rapid succession. The GameCube controller works differently than modern controllers. L and R are both analog triggers and digital buttons. Since these are two distinct controls on the same physical button the input plugin accepts both. It is recommended you push these buttons only far enough that it registers instead of until it clicks.

===Keyboard===
If you use a keyboard, you will also want to increase the <kbd><samp>Analog Stick</samp> ⇒ <samp>Range</samp></kbd> to <kbd>100%</kbd>.

[[File:Project64KeyboardControls.jpg|560x315px]][[File:PJ64 10.png|560x315px]]

== Recommended Settings ==

=== Video (Graphics) Plugin ===

The GlideN64 Plugin is recommended. To do this, launch Project64 and navigate to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> or press <kbd><samp>Ctrl+T</samp></kbd> to open the Settings menu.

In the Settings menu, go to the <samp>Plugins</samp> section and change your <samp>Video (Graphics) Plugin</samp> to <samp>GlideN64</samp>. Click <samp>Apply</samp>.

If your PC doesn't support this, you'll have to use the <samp>Project64 Video Plugin</samp> instead.

<samp>Jabo's Direct3D8 Plugin</samp> is not recommended.

== Optional Settings ==

=== Enable Save States ===

{{race rule|Save states are not allowed to be loaded while racing. Please ensure you do not set up keybinds you may hit on accident during a race.}}
To enable save states, launch Project64 and navigate to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> or press <kbd><samp>Ctrl+T</samp></kbd> to open the Settings menu.

In the Settings menu, click <samp>Options</samp> and untick <samp>Hide advanced settings</samp>. Click <samp>Apply</samp>.

You should now be able to utilize save states while running the game by navigating to <kbd><samp>System</samp></kbd>.

=== Pause/Unpause Emulation when Window is not Active ===

In the Settings menu, expand the {{menuItem|Options/Configuration}} list on the left-hand side and tick the box for {{menuItem|Pause emulation when window is not active}} section to have the emulation pause completely when the window is not active. This prevents the game from even running and communication with the game from outside applications when the window is not active, so you may not want it to be on. If that is a problem you will want to ensure you untick {{menuItem|Pause emulation when window is not active}}.

{{kbd|Click Apply}} to save the setting. If you were running a game when you changed this setting you will need to go to the {{menuItem|System}} menu and {{kbd|Click Resume}} to continue playing.

=== Remove the FPS Cap ===

{{race rule|Unlimited FPS is not allowed for racing. Please ensure you do not set up keybinds you may hit on accident during a race.}}
To remove the FPS cap, launch Project64 and navigate to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> or press <kbd><samp>Ctrl+T</samp></kbd> to open the Settings menu.

In the Settings menu, click <samp>Options</samp> and untick <samp>Hide advanced settings</samp>. Click <samp>Apply</samp>.

You should now be able to remove the FPS Cap by loading a ROM, navigating to <kbd><samp>System</samp></kbd> and clicking on <samp>Limit FPS</samp>. Alternatively, you can just press F4 on your keyboard.

=== Resize Emulator Window ===

Go to <kbd><samp>Options</samp> ⇒ <samp>Configure Graphics Plugin</samp></kbd> and change the <samp>Windowed Resolution</samp> to whatever you prefer.

=== Show ROMs in ROM List ===

Right-click anywhere on the white screen and click on <kbd><samp>Choose ROM Directory...</kbd></samp> Select the respective folder that your ROMs are in.

=== Texture Packs ===

{{race rule|Texture packs are not allowed for races. Disable them before participating.}}
The following link will let you set up texture packs for [https://wiki.ootrandomizer.com/index.php?title=HiRes_Texture_Packs Project64 v3.0.0 or newer]

=== Required Settings for Racing ===

If you wish to partake in our community's races, then don't forgot to also configure the settings mentioned [[Racing#Project64|here]].

== Troubleshooting ==

=== Alt+Tabbing Crashes in Full-Screen Mode ===

Use the [[#Video_(Graphics)_Plugin|GlideN64 Video Plugin]]. If your PC doesn't support that plugin, you'll have to be aware to hit the "Escape" key on your keyboard before Alt+Tabbing.

Alternatively, you could also play in Windowed Mode. Navigate to <kbd><samp>Options</samp> ⇒ <samp>Configure Graphics Plugin...</samp></kbd> and adjust the Windowed Resolution accordingly. Click <samp>Save and Close</samp>.

=== Screen Flicker when Streaming ===

If using the [[#Video_(Graphics)_Plugin|GlideN64 Video Plugin]], go to <kbd><samp>Options</samp> ⇒ <samp>Configure Graphics Plugin...</samp></kbd>. In the "Video" tab, check the "Overscan" box. Click <samp>Save and Close</samp>.

=== Error: uCode crc not found in INI, using currently selected uCode ===

This error is caused by Project64 using Project64-video not being able to find the <samp>Video.rdb</samp> file that should be in the <samp>Config</samp> directory in the Project64 folder. Double check that this file is in the right location. Also ensure you are not running Project64 from the zip file as it cannot see any of its required files and will throw strange errors like this one when it can't find them.

If you still get the error, make sure you're using [https://www.pj64-emu.com/public-releases Project64 v3.0.0 or newer]. If your current <samp>Video (Graphics) Plugin</samp> is not already <samp>GlideN64</samp>, then change to that one. [[#Video_(Graphics)_Plugin|You can read here how to swap plugins]]. If that doesn't work, try the <samp>Project64 Video Plugin</samp>. If even this doesn't fix the issue, you can try <samp>Jabo's Direct3D8 Plugin</samp> as a last resort.

Project64

2023-10-05T23:23:57Z

Flagrama: /* Configure Controller */ mention common gamecube double bind problem

Project64 is no doubt the most popular N64 emulator available. Randomizer staff will support Project 64 '''3.0.0 or newer''' which was released on May 26, 2021. We will not directly support any previous version.

{{race rule|Only Project64 3.0 and newer are allowed and supported for racing. Version 2.0 - 2.3 are not allowed for racing. }}
Project64 v3.0.0 or newer as well as [[Bizhawk]] and [[Retroarch]] are the recommended emulators for racing.

[https://www.pj64-emu.com/public-releases Download Project64] '''v3.0.0 or newer'''

Please note that certain ads on the PJ64 download page might lead you to download adware. Only wait for the download to start automatically or click ''Try again'' to start it.

Version 3.0.1 changed the wording in many places. One of the major ones is changing <samp>Settings...</samp> in the <samp>Options</samp> menu, so when using 3.0 anywhere you see <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> look for <kbd><samp>Options</samp> ⇒ <samp>Settings...</samp></kbd> instead.

== Configure Controller ==
First, read the [[Controller Setup]] guide. Ensure the controller is calibrated, and if you are using one of the controllers with additional setups steps in that guide make sure you follow them.

When using an Xbox controller, or any controller that is an XInput device, you must first go to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp> ⇒ <samp>Plugins</samp></kbd> and change the <kbd><samp>Input (controller) plugin</samp></kbd> from <kbd><samp>Project64 Input Plugin</samp></kbd> to <kbd><samp>N-Rage for PJ64</samp></kbd>. Then navigate to <kbd><samp>Options</samp> ⇒ <samp>Configure controller plugin...</samp></kbd> and check <kbd><samp>XInput</samp></kbd> at the top. This will change the bind menu to be more appropriate for your device.<sup>2</sup> The <samp>XControl</samp> column is the button on your controller, and the <samp>N64</samp> column is the button on the N64 controller you want it to use.

For other controllers and keyboard users, use the default <kbd><samp>Project64 Input Plugin</samp></kbd> or if N-Rage works better for you ensure that <samp>XInput</samp> does not have a check by it. Click on the button for the control you want to bind a button to and the menu will wait for you to press a button on the controller or a key on your keyboard to use for the button. ''You may need to change these again if you switch controllers''.

===GameCube Controllers===
There is a common issue with GameCube controllers that happens if you are using Project64 Input Plugin and using its options that lets you bind all of the controls. Whenever you bind one of the triggers, if you press it all the way down until it clicks it will bind two controls in rapid succession. The GameCube controller works differently than modern controllers. L and R are both analog triggers and digital buttons. Since these are two distinct controls on the same physical button the input plugin accepts both. It is recommended you push these buttons only far enough that it registers instead of until it clicks.

===Keyboard===
If you use a keyboard, you will also want to increase the <kbd><samp>Analog Stick</samp> ⇒ <samp>Range</samp></kbd> to <kbd>100%</kbd>.

[[File:Project64KeyboardControls.jpg|560x315px]][[File:PJ64 10.png|560x315px]]

== Recommended Settings ==

=== Video (Graphics) Plugin ===

The GlideN64 Plugin is recommended. To do this, launch Project64 and navigate to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> or press <kbd><samp>Ctrl+T</samp></kbd> to open the Settings menu.

In the Settings menu, go to the <samp>Plugins</samp> section and change your <samp>Video (Graphics) Plugin</samp> to <samp>GlideN64</samp>. Click <samp>Apply</samp>.

If your PC doesn't support this, you'll have to use the <samp>Project64 Video Plugin</samp> instead.

<samp>Jabo's Direct3D8 Plugin</samp> is not recommended.

== Optional Settings ==

=== Enable Save States ===

{{race rule|Save states are not allowed to be loaded while racing. Please ensure you do not set up keybinds you may hit on accident during a race.}}
To enable save states, launch Project64 and navigate to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> or press <kbd><samp>Ctrl+T</samp></kbd> to open the Settings menu.

In the Settings menu, click <samp>Options</samp> and untick <samp>Hide advanced settings</samp>. Click <samp>Apply</samp>.

You should now be able to utilize save states while running the game by navigating to <kbd><samp>System</samp></kbd>.

=== Pause/Unpause Emulation when Window is not Active ===

In the Settings menu, expand the {{menuItem|Options/Configuration}} list on the left-hand side and tick the box for {{menuItem|Pause emulation when window is not active}} section to have the emulation pause completely when the window is not active. This prevents the game from even running and communication with the game from outside applications when the window is not active, so you may not want it to be on. If that is a problem you will want to ensure you untick {{menuItem|Pause emulation when window is not active}}.

{{kbd|Click Apply}} to save the setting. If you were running a game when you changed this setting you will need to go to the {{menuItem|System}} menu and {{kbd|Click Resume}} to continue playing.

=== Remove the FPS Cap ===

{{race rule|Unlimited FPS is not allowed for racing. Please ensure you do not set up keybinds you may hit on accident during a race.}}
To remove the FPS cap, launch Project64 and navigate to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> or press <kbd><samp>Ctrl+T</samp></kbd> to open the Settings menu.

In the Settings menu, click <samp>Options</samp> and untick <samp>Hide advanced settings</samp>. Click <samp>Apply</samp>.

You should now be able to remove the FPS Cap by loading a ROM, navigating to <kbd><samp>System</samp></kbd> and clicking on <samp>Limit FPS</samp>. Alternatively, you can just press F4 on your keyboard.

=== Resize Emulator Window ===

Go to <kbd><samp>Options</samp> ⇒ <samp>Configure Graphics Plugin</samp></kbd> and change the <samp>Windowed Resolution</samp> to whatever you prefer.

=== Show ROMs in ROM List ===

Right-click anywhere on the white screen and click on <kbd><samp>Choose ROM Directory...</kbd></samp> Select the respective folder that your ROMs are in.

=== Texture Packs ===

{{race rule|Texture packs are not allowed for races. Disable them before participating.}}
The following link will let you set up texture packs for [https://wiki.ootrandomizer.com/index.php?title=HiRes_Texture_Packs Project64 v3.0.0 or newer]

=== Required Settings for Racing ===

If you wish to partake in our community's races, then don't forgot to also configure the settings mentioned [[Racing#Project64|here]].

== Troubleshooting ==

=== Alt+Tabbing Crashes in Full-Screen Mode ===

Use the [[#Video_(Graphics)_Plugin|GlideN64 Video Plugin]]. If your PC doesn't support that plugin, you'll have to be aware to hit the "Escape" key on your keyboard before Alt+Tabbing.

Alternatively, you could also play in Windowed Mode. Navigate to <kbd><samp>Options</samp> ⇒ <samp>Configure Graphics Plugin...</samp></kbd> and adjust the Windowed Resolution accordingly. Click <samp>Save and Close</samp>.

=== Screen Flicker when Streaming ===

If using the [[#Video_(Graphics)_Plugin|GlideN64 Video Plugin]], go to <kbd><samp>Options</samp> ⇒ <samp>Configure Graphics Plugin...</samp></kbd>. In the "Video" tab, check the "Overscan" box. Click <samp>Save and Close</samp>.

=== Error: uCode crc not found in INI, using currently selected uCode ===

This error is caused by Project64 using Project64-video not being able to find the <samp>Video.rdb</samp> file that should be in the <samp>Config</samp> directory in the Project64 folder. Double check that this file is in the right location. Also ensure you are not running Project64 from the zip file as it cannot see any of its required files and will throw strange errors like this one when it can't find them.

If you still get the error, make sure you're using [https://www.pj64-emu.com/public-releases Project64 v3.0.0 or newer]. If your current <samp>Video (Graphics) Plugin</samp> is not already <samp>GlideN64</samp>, then change to that one. [[#Video_(Graphics)_Plugin|You can read here how to swap plugins]]. If that doesn't work, try the <samp>Project64 Video Plugin</samp>. If even this doesn't fix the issue, you can try <samp>Jabo's Direct3D8 Plugin</samp> as a last resort.

Logic

2023-10-02T23:22:07Z

Flagrama: /* Haunted Wasteland */ clarify bombchu salesman

'''“My Seed Is Broken!” (Glitchless Logic)''' - Solutions to completing randomized runs of ''Ocarina of Time'' can sometimes be unintuitive. While your seed may appear to be unbeatable, this isn’t often the case. Thanks to the diligent efforts of the developers, OoTR’s logic is incredibly robust. Listed below are some common sources of confusion, grouped by location. If you don’t mind spoiling the rest of the playthrough, instructions to finding your next step will be listed [[#Knowing_the_Way_with_the_Spoiler_Log|here]].

If you follow these steps and still need help, you’re welcome to ask for support in the {{discord|gameplay-and-tricks}} channel of the {{discord}}. Please provide the seed and setting string along with any important details about the issue. If it turns out there is indeed a logical flaw, kind members of our team will report issues from there.

{{TOClimit|1}}

= Other Logic Pages =
This page of the Wiki is for Glitchless Logic; for more information on Glitched and Entrance Randomizer Logic, please view the [[Glitched_Logic|Glitched]] and [[Entrance_Randomizer|Entrance Randomizer]] pages of the Wiki.

The logical item requirements for each dungeon are also available on the [[Vanilla_Dungeon_Requirements | Vanilla]] and [[Master_Quest_Dungeon_Requirements | Master Quest]] dungeon requirements pages.

It is also to document unusual logic that is '''absolutely required''' know in a seed to finish most randomizer seeds. Anyone who wish to contribute to the randomizer by adding features with logical requirements will likely need to be familiar with the logic on a deeper level. The [[Advanced Logic]] page will provide a better explanation of some of the more difficult to comprehend, but unnecessary to know by heart, logic quirks.

= Vanilla Help =
For a quick refresher regarding the most basic aspects of Ocarina of Time, see these [https://strategywiki.org/wiki/The_Legend_of_Zelda:_Ocarina_of_Time/Getting_Started getting Started pages for Ocarina of Time].

For players who have not played randomizer before, it is strongly recommended to play the original game (i.e. vanilla) before attempting a randomizer seed. Strategy guides such as those from [https://strategywiki.org/wiki/The_Legend_of_Zelda:_Ocarina_of_Time/Table_of_Contents StrategyWiki] and [https://www.zeldadungeon.net/ocarina-of-time-walkthrough/ Zelda Dungeon] can be very helpful. Video guides are also available, the user [https://www.youtube.com/user/ScarecrowScythe Krow's Graveyard] has a playlist for [https://www.youtube.com/playlist?list=PLC4ADFACDF4946595 Vanilla Ocarina of Time] and [https://www.youtube.com/playlist?list=PLDgypNs3MY2Rd1jlYqNTWIfeLW7AiuoOK Master Quest Ocarina of Time]. Understanding how to beat vanilla is '''vital''' to beating a randomized seed.

For those who would prefer a quicker experience, [https://ootrandomizer.com/seed/vanilla Vanilla] and [https://ootrandomizer.com/seed/MQvanilla Master Quest] are available as randomizer seeds with all the QoL changes inherent to randomizer.



<div style="font-size:larger;">'''Spinning Pottery'''</div>
The spinning Goron Pot is activated by lighting the torches surrounding it. This can be accomplished by lighting sticks from Darunia's chamber OR by casting Din's Fire.
The Spinning Pot has 3 faces - Happy, Neutral, and Mad. The Happy face will always give a randomized reward. If freestanding Rupees & hearts are also shuffled, then each face will give 3 randomized rewards.

<div style="font-size:larger;">'''Scarecrow’s Song'''</div>
Link must teach it to Bonooru (the scarecrow nearer the lake) as a child and then remind him again as an adult. The song cannot be all the same note; many alternate between two notes for simplicity.

<div style="font-size:larger;">'''Save Quits'''</div>
Saving and quitting, then reloading the game, inside dungeons will send you back to the beginning of the dungeon. If you get stuck somewhere without a warp song, you can save and quit outside the dungeon. Even if you have a warp song, certain locations like Dampe's Grave and Windmill don't let you warp and require you to save and quit if you get stuck. Reloading the game will return Link to the Temple of Time (if adult) or Link's house (if child).

<div style="font-size:larger;">'''Opening Grottos without Bombs'''</div>
Any grotto which can be opened with Bombs can also be opened with Hammer. However some grottos open when the Song of Storms is played and not with explosives.

= Misunderstood Vanilla Mechanics =
A lot of randomizer uses the vanilla requirements to do certain things. It just so happens that vanilla takes logic shortcuts in some locations because it's impossible to do some events before others. Meanwhile other events have requirements which do not come up in ordinary play. These are the most common issues people have starting randomizer after vanilla.

<div style="font-size:larger;">'''Open the Door of Time'''</div>
Play the Song of Time while standing in front of the pedestal. The only requirements are a '''Fairy Ocarina''' and the '''Song of Time'''. The Spiritual Stones are '''not''' required, and the Ocarina of Time is also '''not''' required.

<div style="font-size:larger;">'''Skull Kid Ignores the Skull Mask'''</div>
Skull Kid must be befriended with Saria's Song before he will buy the Skull Mask. This is '''not''' required for the Skull Mask check- that is done by showing the Skull Mask to the Deku Scrubs inside the Lost Woods Theater.

<div style="font-size:larger;">'''Saria Missing from Sacred Forest Meadow'''</div>
Link must have Zelda's Letter or later in the child trade sequence before Saria arrives to teach her song. This means finding the Weird Egg, waking Talon, and visiting Zelda first.

<div style="font-size:larger;">'''Ocarina of Time and Song of Time Cutscenes'''</div>
This is the Zelda & Impa's escape cutscene initiated by approaching the Castle Town draw bridge as a child. Link must have all 3 Spiritual Stones before approaching the draw bridge, Zora's Sapphire alone is not enough.

<div style="font-size:larger;">'''Can't Find the Running Man'''</div>
Link must possess all 3 Spiritual Stones before the Running Man appears in Hyrule Field. Zora's Sapphire alone is not enough.

<div style="font-size:larger;">'''Big Poe Hunt'''</div>
Without Epona, there is a 2/5 (40%) chance of a Big Poe spawning while passing their spawn areas. While on Epona, there is a 100% chance that the poe that spawns will be a Big Poe. Due to this, default logic does '''not''' expect hunting Big Poes without Epona. However, logic may expect them to be found as the random contents of bottles if the Big Poe Count setting is low enough.

<div style="font-size:larger;">'''Burning Village/Nocturne of Shadow Cutscene'''</div>
Link must have the <span style="color: green">Forest</span>, <span style="color: crimson">Fire</span>, and <span style="color: blue">Water</span> Medallions and then enter Kakariko Village as Adult. In vanilla Ocarina of Time you must enter from Hyrule Field, but in the randomizer it has been changed to entering from any entrance.

<div style="font-size:larger;">'''Castle Town Shooting Gallery'''</div>
Even though the Kakariko Shooting Gallery requires the bow for the special prize, you do not need to have the slingshot for the Castle Town Shooting Gallery's special prize.

<div style="font-size:larger;">'''Kakariko Shooting Gallery Gives 50 Rupees'''</div>
The Fairy Bow/Quiver is required to win the special prize, otherwise you will receive 50 rupees.

<div style="font-size:larger;">'''Requiem of Spirit'''</div>
The song typically acquired by leaving Spirit Temple as an adult can be collected as a child too. Exiting Spirit Temple is the vanilla requirement, since outside sequence breaks child would never reach the Colossus before adult.

In Entrance Randomizer, exit whichever dungeon is placed at Desert Colossus.

<div style="font-size:larger;">'''Zelda Light Arrow Cutscene'''</div>
Enter the Temple of Time as adult with the Shadow and Spirit medallions to receive this item check. Make sure you don't save and reset after entering the Temple of Time and before obtaining the item, [https://wiki.ootrandomizer.com/index.php?title=Common_Softlocks_And_Crashes or you could get locked out of it entirely].

= Vanilla Mechanics Changed by Randomizer =
Randomizer has also changed some vanilla mechanics in an attempt to make randomization of certain elements more valuable. Those ''very'' familiar with Ocarina of Time may want to take note of the following differences.

<div style="font-size:larger;">'''Ocarina Memory Game'''</div>
Randomizer changed this mini-game to only require completing the 5 note version of the game to obtain the item. The mini-game does not need to be done a second time.

<div style="font-size:larger;">'''Malon or Talon Missing from Ranch'''</div>
Malon and Talon normally appear in Lon Lon Ranch after speaking to Zelda and receiving Zelda's Letter. Due to Weird Egg being able to be shuffled some changes have had to be made to this to avoid softlocks. Waking Talon up at Hyrule Castle with the Cucco from the Weird Egg and obtaining Zelda's Letter will have him appear at the ranch. If the Weird Egg is not shuffled, Malon will also appear at the ranch after this. If Weird Egg is shuffled, she will not appear at the ranch until Link speaks to her at Hyrule Castle and receives an item from her.

<div style="font-size:larger;">'''Dampe's Heart-Pounding Gravedigging Tour'''</div>
Dampe no longer requires a random number of attempts and will instead dig up the Heart Piece on the first attempt. He doesn't even need to be over a dirt patch.

There is a bug in vanilla where if Link leaves the area before picking up the Heart Piece it is lost forever. The randomizer has ''mostly'' resolved this issue. Don't die before picking up the Heart Piece because this seems to do the same thing the vanilla bug does and isn't handled properly by the randomizer yet.

<div style="font-size:larger;">'''Sheik at Temple'''</div>
The Sheik cutscene at the Master Sword pedestal to obtain Prelude of Light has been changed from beating Forest Temple to obtaining the Forest Medallion. Once Link has the Forest Medallion, approaching the pedestal as adult either from the door of time, or from pulling the sword out as child will give you the reward.

<div style="font-size:larger;">'''Sheik in Ice Cavern'''</div>
The Sheik cutscene in Ice cavern to obtain Serenade of Water can be triggered as either age in OoTR instead of as adult only.

<div style="font-size:larger;">'''Fishing Pond'''</div>
The fishing reward minimums were lowered so an 8 pound fish is required as Child and a 10 pound fish is required as Adult. However, the lure must still be in deep enough water to cause the fish to bite.

<div style="font-size:larger;">'''Biggoron's Claim Check'''</div>
Biggoron no longer requires three days between giving him the eyedrops and claim check. The claim check can now be immediately returned to Biggoron for a randomized item.

<div style="font-size:larger;">'''Bombchu Bowling'''</div>
Randomizer changed this mini-game so that the two randomized prizes are always the first two prizes offered by the lady- if you lose the game, leave and re-enter to reset the prize order. The requirements for unlocking this check have also been changed- if bombchus are in logic, then finding a bombchu pack is required, otherwise a bomb bag is required if bombchus are not in logic.

== Forest ==
This section covers the following areas '''Kokiri Forest''', '''The Lost Woods''', and '''The Sacred Forest Meadow'''.

<div style="font-size:largest;">'''Closed Forest'''</div>
When the "Closed Forest" setting is active, Link is expected to stay in the aforementioned areas until beating Gohma in the Great Deku Tree. Do not leave these areas, even if there is a bomb bag, silver scale, or ocarina and a warp song. The Kokiri Sword will be in one of these forest areas and the shop will have a repeatably purchasable Deku Shield, even with Shopsanity active.

<div style="font-size:larger;">'''Slingshot'''</div>
If Closed Forest is enabled a Slingshot will always be found somewhere in '''Kokiri Forest''', '''The Lost Woods''', '''The Sacred Forest Meadow''' or '''[[#Inside the Deku Tree|The Great Deku Tree]]'''.

<div style="font-size:larger;">'''Hidden Grottos'''</div>
Hidden grottos in these areas can be required, especially with the Closed Forest setting enabled. The Stone of Agony must be found before logic can expect these locations, provided the trick that removes the SoA requirement is not enabled.

<div style="font-size:larger;">'''Tokensanity'''</div>
With Tokensanity enabled the three dirt patch Skulltulas can be required, especially if the Closed Forest setting is enabled. In the Lost Woods, jump slashing the bushes outside of the Goron City warp with a stick will release bugs which can be caught in a bottle and used on the dirt patches. Since the sword could be in a dirt patch, keep this in mind.

== Kakariko Village ==

<div style="font-size:larger;">'''Rear Entrance to Impa's House as Child'''</div>
Take a cucco to the incomplete building. Toss it onto the top of the pile of bricks and climb up after it. Once on top of the pile of bricks with the cucco, pick it up and fly across to the Scaffolding. From here follow behind the carpenter to reach a good position to jump towards the entrance above the chicken coop.

<div style="font-size:larger;">'''Reach Rooftops without Longshot'''</div>
It's possible to get on the important rooftops with only Hookshot. Get a little closer and try again.

<div style="font-size:larger;">'''Draining Kakariko Well'''</div>
Play the Song of Storms to the Windmill Operator as a child.

*Project 64 will have this issue if not configured correctly. Be sure you have followed the instructions in [[Project64]] if you run into it: ''Draining the well at night can crash the game; attempting it during the day is less likely to cause this crash.''

<div style="font-size:larger;">'''Freestanding PoH in Windmill'''</div>
The freestanding heart piece in the windmill doesn't always expect an ocarina or the Song of Time. Use the boomerang to grab the item here or, if the trick is enabled, [https://www.youtube.com/watch?v=vDl7lr4Ecv8| reach it as adult with no other items required].

== Death Mountain Trail ==

<div style="font-size:larger;">'''Freestanding Piece of Heart above Dodongo's Cavern'''</div>
If you're a child and you don't have the Goron's Bracelet, you can still backflip onto the ledge from where the bomb flower is by angling it correctly and backflipping from outside the grab range. Using C-Up will help. If you're an adult, the bomb flower isn't there.

== Goron City ==

<div style="font-size:larger;">'''Reach Goron City from Lost Woods without Bombs'''</div>
Ignite the Bomb Flowers behind the boulders using Din’s Fire. Alternatively, if Adult Link destroys the boulders with Hammer, Strength, or Bow they'll be destroyed in the past so Child Link can enter.

<div style="font-size:larger;">'''Get Large Rolling Goron to Relinquish Goods'''</div>
Bomb the Goron in the dark tunnel near the sign (Bomb/Bombchu).

''In version 4.0 and older the Large Rolling Goron also requires Link to have a Bomb Bag''

<div style="font-size:larger;">'''Boulder Maze without Bombs or Hammer'''</div>
Silver Guantlets are effective at clearing a path to each of the chests in the room. This will take some time, however.

<div style="font-size:larger;">'''Reaching the Grotto'''</div>
This grotto is adult only, and contains three business scrubs. Requirements to reach this grotto are as follows: Goron Tunic + Hookshot, or Ocarina + Song of Time, or Nayru's Love + Hookshot. If one-hit KO or 4x damage is on, then the glitchless logical requirements are either Ocarina + Song of Time + Goron Tunic/Longshot/Nayru's Love, or Nayru's Love + Hookshot. Further explanation [[Grottos#Goron_City:_1_Grotto|here]].

== Death Mountain Crater ==

<div style="font-size:larger;">'''Reach the lower Exit'''</div>
From the top of the tall ladder, use the Hover Boots to hover over the boulder blocking the shortcut to Goron City (lower exit). Hover Boots can also be used at the bottom of the ladder to bypass the Boulder.

<div style="font-size:larger;">'''Reach the Bottom Area for Bolero of Fire and Access to Fire Temple'''</div>
Use Hover Boots to cross the dilapidated bridge to reach the Warp Platform & Fire Temple.

Alternatively, reach this bottom area with the Longshot by jumping from the upper area onto the lava platforms below and shooting a wooden plank to pull Link across the pool of lava.

== Zora’s Domain ==

<div style="font-size:larger;">'''Access with Silver Scale'''</div>
Silver Scale allows access to Zora's Domain as child from Lake Hylia.

<div style="font-size:larger;">'''Need Blue Fire to Unfreeze King Zora/Zora Shop'''</div>
In Ganon’s Castle, Blue Fire can be found in Water Trial. Blue Fire may also be a purchasable item for 300 rupees in shops.

== Lake Hylia ==

<div style="font-size:larger;">'''Go fishing'''</div>
The fishing man rewards an 8 pound fish as a Child and a 10 pound fish as an Adult. Make sure to toss the lure in deep enough water to entice fish to bite. There's a minimum depth required for the mini-game to work. Tossing the Lure in very shallow water may cause the fish may swim around the Lure but never bite.

<div style="font-size:larger;">'''Lake Hylia - Shooting the Sun with an Arrow'''</div>
The tall rectangle island can be reached without filling the lake by using Scarecrow's Song and Longshot. You may not need to complete the Water Temple and raise the water level at Lake Hylia to acquire the item. The arrow must be fired at the sun during the early morning as per the written instructions on the stone platform.

== Gerudo Fortress/Gerudo Valley ==

<div style="font-size:larger;">'''Traversing the Gerudo Valley Broken Bridge'''</div>
Cross the Broken Bridge as an Adult by using either Epona to jump it or using the Longshot on the sign above the gate on the other side.

<div style="font-size:larger;">'''Entering Gerudo Training Grounds without Being Captured'''</div>
Link must have the Gerudo Membership Card and also rescue all of the Carpenters that have been captured. If the Gerudo Membership Card is shuffled, then only the card is needed and the Carpenters do not need to be rescued to access the area.

<div style="font-size:larger;">'''Getting Caught without a Hookshot'''</div>
If caught by a Gerudo Guard, either inside during combat or outside by being seen, without a Hookshot, Link will be thrown into the valley outside the tent, rather than into the jail cell from which Link could not escape.

<div style="font-size:larger;">'''Horse Archery NPC is Missing or Won't Initiate the Mini-game'''</div>
This mini-game requires the Fairy Bow, Epona, and the Gerudo Membership Card. It must also be day time.

<div style="font-size:larger;">'''Fortress Rooftop Chest without Longshot'''</div>
The chest can be reached from the top with the Hover Boots or by spawning a scarecrow and using the Hookshot. You'll have to stand close to the edge of the top level for the Hookshot to reach. Note that you won't see the Hookshot's red dot on the scarecrow.

== Haunted Wasteland ==

<div style="font-size:larger;">'''Bombchu Salesman'''</div>
As an adult, jump off the edge and use a jump-slash to land on the carpet. If the trick "Reverse Haunted Wasteland" or "Wasteland Crossing" is activated you may also have to do this as child. Either a Deku Stick or sword will work.

== Inside the Deku Tree ==

<div style="font-size:larger;">'''Access F3 without Slingshot'''</div>
The slingshot is not required to get to the top floor of the Deku Tree. In fact, in Master Quest Link doesn't get the slingshot until climbing all the way up the tree in the first place. Skulltulas don't rush Link when he is not moving. Sneak past them while they are looking away.

<div style="font-size:larger;">'''Two Chests in Slingshot Room'''</div>
In vanilla Deku Tree there are two chests in the Slingshot room. The first is the obvious one that has the slingshot, but there are climbable vines on the wall to the left of it which lead to a second chest.

== Dodongo's Cavern ==

<div style="font-size:larger;">'''Gold Skulltula on top of the Sinking Staircase'''</div>
Progress through the right side of the dungeon and hit the switch that makes the platforms in the entrance room rise higher, then leave the dungeon and re-enter it, progress through the dungeon backwards by taking the right platform in the entrance room to the top floor and going through the door on the upper level. This will grant you access to vines on the side of the stairs before the stairs have been lowered by the bomb blasts.

== Inside Jabu-Jabu's Belly ==

<div style="font-size:larger;">'''First Switch'''</div>
The switch on the ceiling in the first room of Jabu Jabu's Belly can be hit using explosives.

== Forest Temple ==

<div style="font-size:larger;">'''Get Outside without Song of Time or Bow'''</div>
With Hover Boots, float to the door connecting the large block-pushing room with the courtyard.

<div style="font-size:larger;">'''Cross to the Other Courtyard via Well'''</div>
With Gold Scale or Iron Boots, Link can cross from one courtyard to the other through the well.

<div style="font-size:larger;">'''Can’t Push Large Colored Blocks as Adult'''</div>
In the Forest Temple, the Goron’s Bracelet is required to push these blocks, even as adult. Link only put on gauntlets to keep his hands from drying out.

<div style="font-size:larger;">'''Triggering the Frozen Eye Switch without Bow'''</div>
Use Din's Fire from the platform below the frozen eye switch to activate it.

== MQ Forest Temple ==

<div style="font-size:larger;">'''Get Outside with just Hover Boots'''</div>
The western courtyard can be reached from the room with the block-push puzzle by hovering towards the crystal switch behind the transparent wall and then jump slashing to hit the switch from the other side. This will remove the transparent wall, allowing you to hover to this door leading to the courtyard. The ledge from which you'll want to hover is behind the first blocks, but if you lack strength then this ledge can also be hovered to from where you end up after climbing the second ladder. If you have trouble making these hovers, then try rolling for extra distance.

== Fire Temple ==

<div style="font-size:larger;">'''Can’t Push Large Colored Blocks as Adult'''</div>
In the Fire Temple, the Goron’s Bracelet is required to push these blocks, even as adult. Link only put on gauntlets to keep his hands from drying out.

<div style="font-size:larger;">'''Reach Volvagia without Hammer'''</div>
With Hover Boots equipped, it’s a simple matter of floating over to the boss door. That said, the Hammer is still required to defeat the boss.

<div style="font-size:larger;">'''Skip the Topmost Locked Door'''</div>
Similarly to Volvagia, skip the topmost locked door by using Hover boots to float over to the pillar. Then use the Hammer to open the door leading to the Highest Goron and Hammer Chest.

<div style="font-size:larger;">'''Extra Key'''</div>
When key-sanity is disabled (that is, keys are in their own dungeon), the lock in the basement behind the hammer blocks is removed. This results in a spare key for this dungeon.

== MQ Ice Cavern ==

<div style="font-size:larger;">'''Hitting the Crystal Switches'''</div>

The pot at the entrance of the Ice Cavern is the only thing required to hit the first crystal switch.

For the crystal switch hanging from the ceiling, the pot in the previous room is the only thing required.

== Water Temple ==

<div style="font-size:larger;">'''Entering without Iron Boots'''</div>
The entryway is in logic with just longshot and gold scale. However, nothing inside Water Temple is in default logic without Iron Boots, except for beating Morpha and part of the Dark Link loop (Longshot chest, whirlpool river chest and the Gold Skulltula in the falling platforms room). Therefore this is only logically relevant in Entrance Randomizer or various Boss/Small Key settings. Nevertheless, there are [https://www.youtube.com/watch?v=4_3GPW8xVuo strats for getting most of the checks in Water Temple without Iron Boots].

<div style="font-size:larger;">'''Boss Key Chest without Bombs or Goron’s Bracelet'''</div>
Use the Hover Boots to reach the chest.

<div style="font-size:larger;">'''Getting Past the Timed Gate without Longshot'''</div>
After shooting the eye switch, cross the gap with Hover Boots.

<div style="font-size:larger;">'''Center Room Gold Skulltula without Longshot'''</div>
Cast Farore’s Wind inside the center room. Raise the water to its highest level and cast Farore's Wind again to return to the warp point. Swim to the surface to reach the Gold Skulltula. '''In versions 6.0 and newer''', this is no longer in default logic.

<div style="font-size:larger;">'''Extra Key'''</div>
The door leading to the highest water level changer is never locked in rando. This results in a spare key for this dungeon.

<div style="font-size:larger;">'''Can’t Raise the Water Level'''</div>
''This is only relevant prior to version 4.0 of randomizer''

With the water level lowered, jump down to the second level of the central structure. This may require savewarping to the beginning of the dungeon to reach. Use the Hookshot to climb onto the top level. With a well-spaced rolling jump you should be able to reach the ledge where you can raise the water to its highest level. This isn't required but it's a handy time saver.

== Shadow Temple ==

<div style="font-size:larger;">'''Crossing the First Gap without Hookshot'''</div>
Hoverboots will reach the other side. If you fall short, start from the wall to build up speed before leaving the ledge.

<div style="font-size:larger;">'''First Silver Rupee Room without Hookshot'''</div>
Reach raised platform in the corner of the room by using the Hover Boots from the nearby low wall.

<div style="font-size:larger;">'''Spike floor room without Longshot'''</div>
Backflip onto the chest spawned in the middle of the room. From there, use the Hookshot to reach the upper ledge.

<div style="font-size:larger;">'''Reach the Boat without Goron’s Bracelet'''</div>
Bypass pushing the large block by shooting the top of the ladder with a Hookshot.

<div style="font-size:larger;">'''Reach Bongo Bongo without the Fairy Bow'''</div>
Play the Scarecrow’s Song to summon Pierre. Use Longshot to get to the other side.

<div style="font-size:larger;">'''Go through the Wind Tunnel without Iron Boots'''</div>
Timing is key. Move when the fans stop. Tip: You can stand between the fans in the final section. There are lines in the floor that mark the safe zones.

== MQ Shadow Temple ==

<div style="font-size:larger;">'''Spike floor room without Longshot'''</div>
Backflip onto the chest spawned in the middle of the room. From there, use the Hookshot to reach the upper ledge. The Silver Rupees can be collected with just the Hookshot (and Hover Boots) since the Hookshot targets on the ceiling are just low enough for the Hookshot to reach them.

== Gerudo Training Ground ==

<div style="font-size:larger;">'''Lava room without Longshot'''</div>
The torch at the end of this room is in reach using only the Hookshot.

<div style="font-size:larger;">'''Timed Boulder Room without Longshot'''</div>
The target on the ceiling is just within range of the Hookshot when standing almost directly under it. A wallmaster can also lift Link into the rupee if it’s the last to be collected.

== Spirit Temple ==

<div style="font-size:larger;">'''Child Side Enemy Room'''</div>
In order to kill the Armos in this room, you're expected to have at least one of the following item combinations: Deku Sticks (jumpslashes can hit), Kokiri Sword, or Deku Nuts + Slingshot.

<div style="font-size:larger;">'''Lower Metal Bridge on Child Side without Boomerang'''</div>
You can just barely hit the switch with a well-placed slingshot shot. Alternatively, hit the crystal switch with a well-timed Bombchu placement in the opposite direction.

<div style="font-size:larger;">'''Map chest without Din’s Fire or Magic'''</div>
Child Link is perfectly capable of lighting the torches using only a Deku Stick.

<div style="font-size:larger;">'''Collect Silver Rupees in the Boulder Room without Hover Boots'''</div>
Reach the floating rupee by jumping into the boulder with a jump slash, or even without hitting the boulder with a properly timed jump slash.

<div style="font-size:larger;">'''Silver Gauntlets Chest from Adult Side using Longshot'''</div>
With a Longshot, shoot the chest opposite from the Mirror Shield chest to gain access to its contents and the end of child-side.

<div style="font-size:larger;">'''Boss Key Chest'''</div>
The Eye Switch can be accessed by hitting the fake door with something to make it fall over. You do not necessarily need to destroy the fake door.

== Inside Ganon’s Castle ==

<div style="font-size:larger;">'''Spirit Trial without Fire Arrows'''</div>
A precise shot of an arrow through the torch will burn the web to reveal the light.

<div style="font-size:larger;">'''Water Trial Blue Fire'''</div>
With your bridge requirement set to Open, Blue Fire can be brought from the Water Trial to thaw King Zora or, if you have shopsanity active, to open the Zora Shop as adult if inaccessible as child.

<div style="font-size:larger;">'''Shadow Trial First Chest without Hookshot and Fire Arrows'''</div>
Playing the Song of Time will spawn Song of Time blocks leading to the first chest. Hover boots will also work.

<div style="font-size:larger;">'''Shadow Trial (Second Chest or Trial Completion) without Fire Arrows'''</div>
There are 2 scenarios possible here, either with Hover Boots or with Din's Fire. Obviously, Link may have both, in which case either method will work.<br/>
With Hover Boots, Longshot the torch to the right as you enter. From there, Link can reach the Like-Like with the Longshot. Once to the middle platform, equip the Hover Boots and roll across the gap to the platform where the chest spawns. From here open the chest and finish the trial.<br/>
With Din's Fire as a fire source, do the same thing as with Hover Boots, but instead of going to the Like-Like immediately, cast Din's Fire first. This will spawn the glass platform to the chest platform so Link can jump across.

== MQ Inside Ganon's Castle ==

<div style="font-size:larger;">'''MQ Forest Trial'''</div>

Getting to the room where the Forest Crystal is only requires the Song of Time. While on the ledge that has the door leading to the Forest Crystal room, go to the edge of the corner near where the Blue Switch is and play the Song of Time. You do not need to be on the platform where the Beamos is.

<div style="font-size:larger;">'''MQ Shadow Trial Bomb Flower Chest'''</div>

For the Bomb Flower Chest, logic expects you to either use the Bow, Explosives, Strength, or Din's Fire to blow up the bomb flower. To get to the platform where the chest spawns, either the Hookshot or Hover Boots are required.

= Knowing the Way with the Spoiler Log =

The spoiler log contains information about your personally randomized copy of the game and can be very helpful when looking for important items you've missed. Please be aware that the Playthrough presented is intended to prove the seed is beatable in logic. It does not represent the only way to logically beat the seed. It takes only a few steps to find:

= How do I find my Spoiler Log? =
*[[Frequently_Asked_Questions#How_Do_I_Find_My_Spoiler_Log_Again.3F|How do I find my spoiler log again?]]

<div style="font-size:larger;">'''Versions 1.0 - 3.0 and Standalone Download'''</div>
Open the spoiler log generated in the same folder that the randomized ROM is located in. It should be formatted as <code>OoT_SETTINGSTR_SEED_Spoiler.txt</code>.

Multiworld

2023-09-21T20:11:57Z

Flagrama: update modloader discord url

The aim of this page is to help the reader set up [[Bizhawk]] for Multiworld. Multiworld is a co-op mod for the OoT Randomizer. Players have their own inventory and their own world. Also, player-specific items are mixed between the worlds. For example, if you obtain an item in your world, it could either stay with you or get sent to another player. Everyone participating will be playing different intermingled seeds.

As an example, there could be a scenario where Player 1 can only advance in their own world based on something Player 2 does. Once Player 2 finds the Megaton Hammer belonging to Player 1, Player 1 will automatically receive it. Every world is linked together.

In order to link everyone's worlds together, players need to make use of "lua scripts". These are only compatible with Bizhawk, however the ModLoader64 devs have made a copy which is compatible with their emulator and the OoT Online pak, allowing players to play without a "host" and to see each other's character in the game. ([https://discord.gg/UFVY9DE For assistance with ModLoader64, please join their Discord].) Support for other emulators, as well as console support, is planned for future releases.

{{TOClimit|4}}

== Generating the Seeds ==

=== Using the Webpatcher ===

Start off by going to the [https://ootrandomizer.com/generator Webpatcher] and set up the settings you want for the seed. On the <code>Rom Options</code> tab change the <code>Player Count</code> to however many people will be playing. Once you're done, generate the seed.

[[File:mwromgen.png|560x315px]]

After you have generated the seed, share the URL with your partners and have everyone choose a different <code>Player ID</code>. Then continue patching the rom as you would normally (don't forget cosmetics and sfx). Each player should have their own Randomizer ROM, with the formula <code>OoT_SeedID_SettingsHash_W0P0</code> with the W0 and P0 being world count and player ID respectively.

[[File:mwromgen2.png|560x315px]]

=== Using the Offline Version ===

Generating a ROM using an offline build works a little differently. After choosing the settings you wish to play with, go to the <code>ROM Options</code> tab and set <code>Generate New Seed</code> (<code>Generate From Seed</code> in previous versions). Choose <code>Patch File</code> as your <code>Output Type</code> and change the <code>Player Count</code> to however many people will be playing. Then hit <code>Generate!</code>.

[[File:mwromgendev1.png|560x315px]]

Send the patch file (.zpfz) to your partners and have them set <code>Generate From File</code>. The <code>Output Type</code> should be <code>Compressed [Stable]</code> now, and everyone should choose a different <code>Player ID</code>. Select the patch file and hit <code>Generate!</code> (don't forget to set cosmetics and sfx). Each player should have their own Randomizer ROM, with the formula <code>OoT_SeedID_SettingsHash_W0P0</code> with the W0 and P0 being world count and player ID respectively.

[[File:mwromgendev3.png|560x315px]]

Note: if your partners don't have the offline build they can also patch the rom using the website. Make sure to set <code>Generate From File</code> and select your patch file (.zpfz).

There are several reasons why someone might want to generate a ROM using an offline build. For example, some builds might have features that are not available on the website build (yet), like [https://github.com/Roman971/OoT-Randomizer additional Entrance Randomizer settings]. Generating from an offline build also lets you play with your own custom patches.

== Installing Multiworld and Bizhawk ==

=== The Recommended Method ===

Press '''Windows+R''' to open the '''Run''' dialog box, and then type "'''powershell'''" in the text box. Once you have your PowerShell window open, copy-paste this in:

'''<pre>cd $env:userprofile\downloads;
Set-ExecutionPolicy Bypass -Scope Process -Force;
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072;
iex ((New-Object System.Net.WebClient).DownloadString('https://raw.githubusercontent.com/TestRunnerSRL/bizhawk-co-op/master/bizhawk-co-op.ps1'))</pre>'''

From here, the PowerShell is getting you 99% of the way done: it will create a new Bizhawk 2.7 install in your downloads folder and place everything for you. Say '''yes''' when PowerShell prompts you to install the <code>bizhawk_prereqs.exe</code> file. Once PowerShell is done, you can move the Bizhawk 2.7 folder somewhere else if you wish. Afterwards, open up the Bizhawk 2.7 folder it created and launch <code>EmuHawk.exe</code>.

=== The Alternate Method ===

==== Download the Custom Bizhawk Installer ====

First, you must download the Multiworld script from [https://github.com/TestRunnerSRL/bizhawk-co-op/archive/master.zip TestRunner's GitHub page]. When you download this, extract its contents to ''its own folder'' - it will be creating a new Bizhawk install for you to use, so you must keep it separate. ''Note: Whenever there is an update to the Multiworld script, everybody playing must update to the latest version.''

==== Running the Custom Bizhawk Installer ====

Once you have the contents extracted to its own folder, locate the <code>bizhawk-co-op.ps1</code> file. Right Click and select Run with PowerShell.

[[File:MWG1.png|610x149px|Run with PowerShell]]

If Powershell prompts you for permissions, say yes to all. From here, the Powershell is getting you 99% of the way done: it will create a new Bizhawk 2.7 install and place everything for you. Once Powershell is done, open up the Bizhawk 2.7 folder it created and launch <code>EmuHawk.exe</code>. ''Note: It is recommended you delete everything outside of the Bizhawk 2.7 folder that was created. These files are no longer needed and only add confusion.''

==== Powershell Permissions ====

You may need to enable executing Powershell scripts without requiring the script to be digitally signed. Open Powershell from the Start Menu by right clicking it and selecting "Run as Admin". Click the "Yes" button to allow Powershell to run as Administrator. Type <code>Set-ExecutionPolicy Unrestricted</code> and press <code>Enter</code> once, type <code>Y</code> then press <code>Enter</code> again. The Powershell script should now run.

== Configuring Bizhawk for Multiworld ==

=== Bizhawk Settings ===

There are a few things you need to do once you've got the emulator running. The very first thing is go to <code>Config -> Customize</code> and navigate to the Advanced tab. At the bottom, there is an option for Lua Core; select <code>Lua+LuaInterface</code> and hit OK. While on the Advanced tab, you should also check the box for <code>AutoSaveRAM</code> and set it to a reasonable time, such as 60-180 seconds (keep in mind that setting this too low could increase lag and decrease overall emulator performance). This will allow Bizhawk to write your in-game save to your drive. This is '''NOT''' a form of save state - it simply periodically creates/updates a file on your hard drive with your in-game save data, and is wonderful for mitigating the effects of crashes. '''<span style="color:red">In the event of a crash (or if you open TAStudio by accident) DO NOT RELOAD THE ROM! DO NOT RELOAD THE ROM!</span>''' Doing so will overwrite your backups, meaning that your save files will be gone. To recover your save file follow the instructions over [[Multiworld#Help! My emulator crashed!/I accidentally opened TAStudio and got a black screen!|here]].

[[File:bizhawkautosave.png|420x487px|Advanced Customization]]

In the General tab of the Customize menu, tick the boxes for "Accept background input" and "Run in background" – this will allow Bizhawk to keep accepting controller inputs when you tab over to your tracker or notes and prevent the emulation from pausing (which will disconnect you). Clear your hotkeys by going to Config -> Hotkeys, and at the bottom click Misc and Clear All.

=== Controller Settings ===

The next step is to set your controller up. Your controller configuration will vary based on what controller you are using; for Bizhawk to enable the Controller menu, you must have a ROM loaded. For a smooth controller experience, you must unbind the first 4 binds in Config -> Controller such that it looks like this:

[[File:MWG3.png|320x207px|Normal Controls]]

You'll then have to bind your analog stick in the Analog tab of your controller config and adjust your sensitivity and deadzones to your preference. ''Additional info on controller setup can be found in Step 6 of the [[Bizhawk|Bizhawk Guide]].''

=== Video Settings ===

You can fix how your game looks by going to Config -> Cores -> N64 Video Plugin Settings. In here, change your resolution so that it runs smooth. Multiworld will drop your performance, so keep that in mind. The recommended video plugin is GLideN64. ''(This is not the same plugin as Glide64!)''

== Starting the Multiworld Session ==

=== Opening the Lua Console ===

Once you have your emulator set up to run how you are comfortable with, its time to move to the Lua console. Go to Tools -> Lua Console, and a separate window will open up. ''This window must remain open at all times during a Multiworld.'' In the Lua Console, go to Settings and checkmark the Disable Scripts on loads.

[[File:MWG4.png|586x379px|Disable Scripts on Load]]

This is the last of the settings changes you have to do. If you want Bizhawk to retain these settings changes for the next time, go to Config -> Save Config. Once you have these steps done, '''you MUST close your emulator and reopen it for this change to take effect'''. Close out of Bizhawk, and then reopen it and the Lua Console. Sometimes this will not be enough and you will still get an error trying to load the Lua file. In that case reboot your entire computer.

'''If for some reason you do not have your Multiworld ROM open, you must do so now.'''

From here in the Lua Console, Open Script and locate the <code>bizhawk co-op.lua</code> file in the Bizhawk 2.7 folder. Once you have that done, a red square will appear in the console; double click it and a new window will open up.

[[File:MWG5 2.png|Bizhawk co-op]]

This window must ''also'' stay open at all times.

=== Rooms ===

The Lua Console Script is where you set up a room and join rooms.

If you are the Host: You must port forward. How you do this varies on what brand your router is. Instructions on how to do this can be found by Googling your brand/model of router. You'll want to use a port between 49152 and 65535. We highly recommend using the default port, 50000. You'll also want to ensure you're forwarding the TCP protocol as that is the protocol Multiworld uses. Most other games you have port forwarded in the past likely were using the UDP protocol.

Once that is done, in the Bizhawk Co-op window the Host must set their name, password, and the port that was forwarded, along with setting the game script to Ocarina of Time. Don't set the IP address. Hit Create Room and tell the people joining the Room Name (= your name), password, and port. ''(It is not recommended to use your own personal password here, as it is shared with the group. Use something that will prevent random people from joining your room, but not something that will compromise your own security.)''

If you are Joining and the Host has set up the room: hit Refresh in the Bizhawk Co-op window and select the Host's Room from the dropdown bar. When you input your username, keep in mind the game will use this to display who got what item for everyone playing. It will max out at 8 characters, even if you input more. Fill in the password and port number the Host gave you and select the Ocarina of Time Game Script and hit Join Room.

You can also select a player number when both hosting and joining a room. This is non-mandatory, and player numbers will be automatically selected if non are entered. This also does not need to match the world number chosen when patching your ROM file. If you do select a player number, and that number is already filled in that room, you will be unable to join.

=== Play Some Multiworld! ===

Go and have fun with new or old friends! If you are part of the {{discord}}, you can assign the Multiworld role to yourself by going to the {{discord|role-assignment}} channel and clicking the 3 emote - this will allow you to receive pings in the server where there are announcements from the Devs or folks are looking for players. You can also visit {{discord|multiworld-planning}} to look for additional players. It is ''highly'' recommended that you use one of the [[Trackers]] so that you don't accidentally leave those new friends out to dry if you miss a check. Map Trackers such as 2deep4real's Web Tracker or Hamsda's Map and Item Tracker package for EmoTracker are highly recommended.

== Troubleshooting ==

=== Installation Issues (Applies to both the Recommended and Alternate Methods) ===

==== Windows 7 ====

If you are running Windows 7 you will need to enable remote Powershell script execution, and make sure Powershell is updated.

First, go to the [https://docs.microsoft.com/en-us/powershell/scripting/install/installing-windows-powershell?view=powershell-6#upgrading-existing-windows-powershell|Microsoft Installing Powershell page] and navigate to the download page for the the latest Windows 7 SP1 Powershell version. At the time of writing it is WMF 5.1. The file on the download page you want to download is named similar to <code>Win7AndW2K8R2-KB3191566-x64.zip</code>. Run the <code>.msu</code> file inside of the zip file and it should update Powershell.

==== Anti-Virus ====

Another issue that can occur while running the Powershell script is your anti-virus deleting the files it downloads. The BizHawk Prerequisites often gets marked as suspicious due to it being an installer that runs more installers. We can't give a detailed guide on how to exclude a folder in every anti-virus software, but search Google with a query like <code>Exclude Folder <your_anti-virus_name></code> and you should find a guide on their official site explaining how to do so. Exclude the folder that has the Powershell script in it and now you should be able to run it without the downloaded files getting deleted.

=== Common Error Messages ===
These are the most common errors that pop up that have known solutions. If none of these solve the problem, try rebooting your computer again afterwards to ensure any new configurations are fully loaded.

==== NullHawk Does Not Implement Memory Domains ====
You must load the ROM before activating the Lua scripts.

If doing so does not fix the issue, open the Lua Console and look at <code>Settings -> Autoload</code>. This setting should be '''disabled'''. Save the settings and completely close out of Bizhawk. Reopen, load the rom, and only after the rom is loaded open the Lua Console.

==== Error 401 ====
This generally means that either the password entered was incorrect, or that the room name already exists. Also, avoid special characters like spaces in the room name. We recommend using letters (no accents) and numbers only.

==== This ROM is not compatible with this version of the co-op script. ====
[https://github.com/TestRunnerSRL/bizhawk-co-op/archive/master.zip Update your scripts].

==== Unable To Find Domain: CARTROM ====
You are using the A Link to the Past LUA script. Choose Ocarina of Time in the dropdown instead.

==== Dynamic Libraries Not Enabled ====
You did not set the Lua Core setting properly. Remember to restart Bizhawk after changing it.

==== Unprotected Error in Call to LUA API ====
This is a general error that pops up randomly. You need to ensure all copies of Bizhawk are closed properly. The easiest way to ensure this is by rebooting your computer.

If you consistently get it when trying to start up the script, make sure the script is located in the Bizhawk root folder. This error will come up if you run the script from any other folder.

==== Connection Failed: Timeout ====
There are several reasons this can happen, all of them being various methods of misconfiguration.

First, the host must have the [[#Rooms|port being used forwarded]] if not using Hamachi. Your private IP address that you forward the port to can change for various reasons. Always ensure that the router is pointing to the right computer with the port forwarding options. The host must also not have pings blocked in their router settings. This setting can be found under many names depending on the router.

Everyone playing must have the Bizhawk emulator allowed through their firewall.

The above [[#Configuring_Bizhawk_for_Multiworld|Bizhawk configuration options]] are not optional. If you do not configure the emulator properly you will be unable to stay connected to each other.

==== Invalid Arguments to Method Call ====
You'll get this error if files are in the wrong place. This can happen if you move any of the files manually, or if the Powershell script exits early.

The easiest way to fix this is to remove the Bizhawk folder and re-run the Powershell script. If your bizhawk-co-op.lua file is in the Lua folder, you can try moving it to the root folder where EmuHawk.exe is instead and see if that works too.

==== Attempt to concatenate local 'err' ====
This error occurs when some part that was downloaded was corrupt. The easiest way to fix this is to delete the Bizhawk folder the Powershell script downloaded and run it again.

=== Miscellaneous Issues ===

==== A Specific Item Failed to Transfer ====

Items can be retrieved by having the receiving player enter a line of code into the Lua console, though it is best to avoid this situation entirely if possible. This frequently occurs if a player continues while one or more other players are disconnected from the room. To prevent this, always ensure everyone is connected before collecting any item.

Go to [https://pidgezero.one/zootr/mwlua.html this website] (made by pidgezero_one) and select option 2. Locate the code for the missing item and follow the instructions there to retrieve the item. If the layout looks wrong, press ctrl+F5 to fix it.

==== Help! My emulator crashed!/I accidentally opened TAStudio and got a black screen! ====

First of all, '''<span style="color:red">DO NOT RELOAD THE ROM! DO NOT RELOAD THE ROM!</span>''' Doing so will overwrite your backups, meaning that your save files will be gone. To recover your save files follow these instructions.

# In your Bizhawk folder navigate to <code>\N64\SaveRAM</code>.
# Identify the <code>SaveRAM</code> and <code>AutoSaveRAM</code> files corresponding to your seed. Sorting by date may help. Note that the <code>AutoSaveRAM</code> files will only exist if you've [[Multiworld#Bizhawk Settings|enabled that]] beforehand.
# Optional: manually make a backup of these files somewhere on your pc.
# Delete the <code>SaveRAM</code> file and rename <code>AutoSaveRAM</code> to take the place of the <code>SaveRAM</code> file you've just deleted.
# Now you can safely load your seed again and continue playing.

==== A Player Forfeits without Finishing ====

If a player forfeits their world, the game can continue without them by entering code lines into the Lua console to retrieve the lost items for the remaining players. Upload the multiworld spoiler log on [https://pidgezero.one/zootr/mwlua.html this site] (made by pidgezero_one) and follow the instructions there. If the layout looks wrong, press ctrl+F5 to fix it.

==== LUA Console Window Too Small ====

If your window for the LUA connection console is too small and the elements are overlapping, you need to change your DPI settings. Right click EmuHawk -> Properties -> Compatability -> High DPI scaling override, change to "System (Enhanced)".

[[File:DPISettings.png|326x407px|EmuHawk High DPI Settings]]

== Multiworld Without Port-Forwarding or Bizhawk ==

=== Hamachi ===

If nobody in your multiworld group can port-forward for whatever reason, and you cannot get someone who can to join, then there is a program you can use: Hamachi. Let me preface this by saying that Hamachi basically 'tricks' your computers to believe that you are all connected via LAN.

To start, download Hamchi [[https://www.vpn.net/ here]] and install it. Create an account, and go to System > Preferences > Settings to make sure that 'Encryption' is enabled. Then, click on the power button to go online.

==== Hosting ====
If you're hosting, then click Network > Create a new network. Give it a unique name and password, making sure that nobody other than the people you're playing with find out this information. After this, you'll see it pop onscreen:

[[File:Guide.JPG|RTENOTITLE]]

To join an existing network, click Network > Join an existing network. Type in your friend's network ID and the network's password.

Once you're all connected in the network, you can start the multiworld.

Right click on the address above your nickname, and click 'Copy IPv4 address' and share it with the people joining you:

[[File:Guide2.JPG|RTENOTITLE]]

Then, start up the Bizhawk co-op lua script. Set 'Rooms' to '(Custom IP)', Set your Username and Password as usual, and the game script to Ocarina of Time.

==== Joining ====

Then, start up the Bizhawk co-op lua script. Set 'Rooms' to '(Custom IP)' and paste the IPv4 the host gave you into the 'Host IP' bar. Set your Username and Password as usual, and the game script to Ocarina of Time.

Now you should be ready to start. As usual, if you have any more problems, seek advice within the {{discord}}.

==== Security Awareness ====
'''Be careful with who you give permission to join your network to.''' Using Hamachi is like letting everyone using it with you use a computer on the same network as yours.

==== Hamachi Request Timed Out ====
[https://help.logmein.com/articles/en_US/FAQ/Resolving-Hamachi-Request-Timed-Out Follow these steps to ensure Hamachi is allowed through your firewall]. Both the Host and the clients connecting to the host should do this.

=== Playing over LAN ===

If you're playing over a LAN network, then all you need to do is set the 'room' to (Custom IP), type the LAN's Ipv4 into the 'host IP' field, and give yourself a username. Leave the password field blank.

=== Play Without Bizhawk ===

While Bizhawk is the officially supported emulator for multiworld, it is known to be a resource-intensive emulator in addition to being Windows only.

If port forwarding/using Hamachi is impossible for any reason, try [https://midos.house/mw Mido's House Multiworld]. It is compatible with Bizhawk and Project64 and can have players on different emulators at the same time. This method for multiworld was created by Fenhl and is the newest way to play multiworld. Issues with this can be brought up in the #setup-support channel of the OoTR discord, but it's unlikely anyone except Fenhl will be able to provide meaningful assistance so do not expect quick replies.

If using Bizhawk is impossible for any reason, try the emulator ModLoader64 (Windows and Linux compatible), as DemoXin has modified the multiworld script to work with it. This method does not require a host. Modloader64 is also the only way to play Ocarina of Time Online, which allows players to see each other in the world, and also supports other various features. As we do not officially support this emulator or any of their paks, we kindly refer you to [https://discord.gg/mWDztG their Discord] for all issues and support.

==== Feature comparison ====

{| class="wikitable"
|-
! Feature
! [https://github.com/TestRunnerSRL/bizhawk-co-op bizhawk-co-op]
! [https://midos.house/mw Mido's House Multiworld]
|-
| [[Project64]] support
|
| ✓
|-
| [[Bizhawk|BizHawk]] support
| 2.3–2.8 (no support for the current version)
| 2.9.1 only (no support for older versions)
|-
| no port forwarding or Hamachi required
|
| ✓
|-
| can be used via LAN without an internet connection
| ✓
| [https://github.com/midoshouse/ootr-multiworld/issues/3 planned]
|-
| async support: players don't need to be connected at the same time
|
| ✓
|-
| easier setup: player name and world number are read from the game
|
| ✓
|-
| prevents players from accidentally using the same world number
|
| ✓
|-
| support for some other games
| ✓
|
|-
| automatically updates itself
|
| ✓
|-
| send all remaining items from a world using a spoiler log
| using [https://pidgezero.one/zootr/mwlua.html an external service]
| built in
|-
| choose individual items to give to a player
| using [https://pidgezero.one/zootr/mwlua.html an external service]
|
|-
| rooms are automatically deleted after a period of inactivity
|
| ✓ (defaults to 7 days, configurable)
|}

Dungeon Door Requirement

2023-09-09T01:06:10Z

Flagrama: /* Tips and Advice */ improve link text

The Dungeon Door Requirement (DDR) ruleset is a glitched ruleset designed specifically with randomizer in mind. While the ruleset utilizes glitches, it is meant to be played using [[logic | glitchless logic]]; this means that racers of glitchless rulesets (e.g., [[Standard]] and [[GGJ]]) can immediately play and learn alongside DDR racers.

There are multiple motivations behind creating this ruleset:
*'''Provide an opportunity within the randomizer context for players to learn glitches.''' Because the ruleset is meant to be played with glitchless logic, racers can play with any level of glitch knowledge. It also provides opportunity for new racers to learn glitches off of more experiences players.
*'''Provide a set of quality-of-life glitches''' (e.g., various clips and speed strats), allowing for faster play and for one-use items (e.g., Ruto's Letter and Longshot) to no longer be required.
*'''Provide opportunities to bypass the logic without straying too far from it.''' If the racer has caught onto the logic of the seed, then the racer can utilize certain glitches to bypass certain checks (Example: bypassing finding Requiem in order to get an item in child Spirit Temple). This will also allow for high-risk, high-reward plays to recover from mistakes.

[[Rules | Other rulesets are also available.]]

*''Please keep in mind that the [[Rules#Universal_Rules|Universal Rules]] apply to all OoTR races, including DDR Ruleset races.''

== Banned Glitches ==
*Item Manipulation:
**Reverse Bottle Adventure (RBA)
**Bottle Adventure (BA)
**Get Item Manipulation (GIM)
*Wrong Warp
*Arbitrary Code Execution (ACE)
*Stale Reference Manipulation (SRM)
*Platform Exclusive Tricks (Bombchus Out of Bounds, Emulator Cheats, etc.)
*Duping Collectable Items, such as:
**Skull Duping
**Bottle Duping
**Repeating Item Checks (e.g., Duping Man on Roof HP)
*Hovering off the ground by using ISG in combination with a damage source (e.g., Bomb/Chu hovers, guay hover, biri hover, etc.)
*Anything other than sword on B (beyond normal cases, such as minigames)
*Collection Delay (e.g., Gold Skulltula hookshot jump to Fire Arrows)
*Equip Swapping (e.g., Hammer as Child, Boomerang as Adult)
*Action Swapping

== Dungeon Requirements ==
In the completion of each seed, two dungeon requirements must be met: the '''dungeon entrance requirement''' and the '''boss door requirement'''. For the purposes of this ruleset, a “dungeon” refers to locations containing a blue warp (Deku Tree, Dodongo's Cavern, Jabu-Jabu's Belly, Forest Temple, Fire Temple, Water Temple, Shadow Temple, and Spirit Temple) plus Ganon’s Castle. This means that Bottom of the Well, Ice Cavern, and Gerudo Training Grounds are not restricted by these requirements.

=== Dungeon Entrance Requirement ===
All dungeons must be opened their intended way (as defined below), so any glitch that allows the player to touch the loading zones for these dungeons prematurely is not allowed.

Below is a list of requirements that must be met in order to enter each dungeon:
*'''Deku Tree''' - Walk into the Deku Tree’s open mouth when the tree is in a fully loaded state (e.g. the hover boost to Deku Tree as adult is not allowed)
*'''Dodongo’s Cavern''' - To enter as child, the rock must be blown up before entering. As adult, the dungeon is already open and is free to enter.
*'''Jabu-Jabu's Belly''' - Jabu must be fully loaded into the scene and presented with a fish in order to activate the "Entering Jabu" cutscene. Any method to clip into Jabu as child is not allowed, nor is any method to enter Jabu as adult. However, methods to clip past King Zora in order to reach Zora's Fountain are permitted, so long as they are not within the banned glitch set listed above.
*'''Forest Temple''' - Use hookshot on the tree to reach the ledge. Bomb hovers cannot be used to enter the temple as they are globally banned in this ruleset.
*'''Fire Temple''' - Simply walk into the temple.
*'''Water Temple''' - The gate must be opened using hookshot or longshot before entering. The temple can then be entered by passing through the open gate using Iron Boots, Ocarina Dive, Gold Scale, etc. Glitches such as a ledge clip to enter Water Temple from behind the loading zone are not allowed, even if the gate has already been opened.
*'''Shadow Temple''' - The door to Shadow must be opened by lighting the torches outside (with Din’s, Fire Arrows, Quick Putaway, etc.). While a Hookshot Jump can still be used as a means to reach the Nocturne platform, sidehopping over the loading zone to prevent the Shadow Temple door from loading is not allowed.
*'''Spirit Temple''' - Simply walk into the main entrance, or into either of the entrances on the Colossus hands, as long as they can be accessed without violating the global ruleset (Spirit Hovers, for example, cannot be used to reach the Colossus hands as hovers are globally banned in this ruleset).
*'''Ganon’s Castle''' - Open the Rainbow bridge per the requirements used when generating the randomizer seed (Hovering to Ganon's Castle, for example, is not allowed as they are globally banned in this ruleset). If there are any Trials on, there is no requirement to complete any of them; that is, methods to skip the Trails that do not violate the global rules is permitted.

'''A note on entrance randomizer:''' The dungeon entrance requirements apply to the entrances themselves, not to the dungeon associated with them. Therefore, while these requirements must be met to pass through the associated loading zones, they are not required to complete the dungeon itself if the dungeon is easily accessible elsewhere. For example, if Shadow Temple is in Mido's House, racers do not need to light the torches in Graveyard before completing the dungeon. The racers do, however, still need to light the torches in order to access the loading zone behind the Shadow Temple door in Graveyard.

=== Boss Door Requirement ===
In order to touch a loading zone which would normally lead to a boss, the player must open the door which leads to the boss. Practically, this means that all boss key skips or any other methods to clip into boss rooms (including boss rooms found in child dungeons) are banned.

== Tips and Advice ==
*Savescumming is allowed and encouraged. Use savescumming to utilize keys more efficiently (e.g., as in Gerudo Training Grounds).
*The glitchless logic is not designed to be used with glitches, so there are a few places where using glitches can softlock the seed. The most notable example: in Shadow Temple, you can use a Gate Clip to clip past the strength block in the boat room. Depending on the key logic, using a key in this area to go to Bongo-Bongo or to the room with the Gibdos can potentailly keylock the dungeon. Be sure to save before opening those doors in the back.
*Just because an area is accessible with glitches does not mean you should go there. The glitches add movement options, but can also be a massive time loss.
*While the addition of glitches can speed up gameplay, being able to read the logic of the seed is still important. Use the logic to guide which glitches to use to finish the seed quickly and efficiently.
*If you are playing on VC (or some emulators) and are planning on doing weirdshots, it is highly recommended to use a non-randomized Kokiri Tunic color, as certain colors will crash should you get the "weird" type of weirdshot. It is not yet understood which colors cause crashes, but the vanilla color is confirmed to be safe. {{GhIssue|1698|There are more details starting with this GitHub issue}}. Note that it is irrelevant which tunic you have equipped while doing the weirdshot.

[[Category:Racing Rules]]

Template:GhIssue

2023-09-09T01:05:17Z

Flagrama: move text to after to see if it improves spacing

[[File:Github-mark.png|15px|link=https://github.com/OoTRandomizer/OoT-Randomizer/issues/{{{1}}}|alt=Github icon|View issue on GitHub]] {{#if:{{{2|}}}|[https://github.com/OoTRandomizer/OoT-Randomizer/issues/{{{1}}} {{{2}}}]}}

Template:GhIssue

2023-09-09T00:59:21Z

Flagrama: for got pipe

{{#if:{{{2|}}}|[https://github.com/OoTRandomizer/OoT-Randomizer/issues/{{{1}}} {{{2}}}] }}[[File:Github-mark.png|15px|link=https://github.com/OoTRandomizer/OoT-Randomizer/issues/{{{1}}}|alt=Github icon|View issue on GitHub]]

Template:GhIssue

2023-09-09T00:56:17Z

Flagrama: minor change to alt text, add optional second parameter to add additional text before icon

{{#if:{{{2|}}}[https://github.com/OoTRandomizer/OoT-Randomizer/issues/{{{1}}} {{{2|}}}] }}[[File:Github-mark.png|15px|link=https://github.com/OoTRandomizer/OoT-Randomizer/issues/{{{1}}}|alt=Github icon|View issue on GitHub]]

Project64

2023-09-08T23:31:56Z

Flagrama: /* Pause/Unpause Emulation when Window is not Active */

Project64 is no doubt the most popular N64 emulator available. Randomizer staff will support Project 64 '''3.0.0 or newer''' which was released on May 26, 2021. We will not directly support any previous version.

{{race rule|Only Project64 3.0 and newer are allowed and supported for racing. Version 2.0 - 2.3 are not allowed for racing. }}
Project64 v3.0.0 or newer as well as [[Bizhawk]] and [[Retroarch]] are the recommended emulators for racing.

[https://www.pj64-emu.com/public-releases Download Project64] '''v3.0.0 or newer'''

Please note that certain ads on the PJ64 download page might lead you to download adware. Only wait for the download to start automatically or click ''Try again'' to start it.

Version 3.0.1 changed the wording in many places. One of the major ones is changing <samp>Settings...</samp> in the <samp>Options</samp> menu, so when using 3.0 anywhere you see <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> look for <kbd><samp>Options</samp> ⇒ <samp>Settings...</samp></kbd> instead.

== Configure Controller ==
First, read the [[Controller Setup]] guide. Ensure the controller is calibrated, and if you are using one of the controllers with additional setups steps in that guide make sure you follow them.

When using an Xbox controller, or any controller that is an XInput device, you must first go to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp> ⇒ <samp>Plugins</samp></kbd> and change the <kbd><samp>Input (controller) plugin</samp></kbd> from <kbd><samp>Project64 Input Plugin</samp></kbd> to <kbd><samp>N-Rage for PJ64</samp></kbd>. Then navigate to <kbd><samp>Options</samp> ⇒ <samp>Configure controller plugin...</samp></kbd> and check <kbd><samp>XInput</samp></kbd> at the top. This will change the bind menu to be more appropriate for your device.<sup>2</sup> The <samp>XControl</samp> column is the button on your controller, and the <samp>N64</samp> column is the button on the N64 controller you want it to use.

For other controllers and keyboard users, use the default <kbd><samp>Project64 Input Plugin</samp></kbd> (or ensure that <samp>XInput</samp> does not have a check by it). Click on the button for the control you want to bind a button to and the menu will wait for you to press a button on the controller or a key on your keyboard to use for the button. ''You may need to change these again if you switch controllers''.

If you use a keyboard, you will also want to increase the <kbd><samp>Analog Stick</samp> ⇒ <samp>Range</samp></kbd> to <kbd>100%</kbd>.

[[File:Project64KeyboardControls.jpg|560x315px]][[File:PJ64 10.png|560x315px]]

== Recommended Settings ==

=== Video (Graphics) Plugin ===

The GlideN64 Plugin is recommended. To do this, launch Project64 and navigate to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> or press <kbd><samp>Ctrl+T</samp></kbd> to open the Settings menu.

In the Settings menu, go to the <samp>Plugins</samp> section and change your <samp>Video (Graphics) Plugin</samp> to <samp>GlideN64</samp>. Click <samp>Apply</samp>.

If your PC doesn't support this, you'll have to use the <samp>Project64 Video Plugin</samp> instead.

<samp>Jabo's Direct3D8 Plugin</samp> is not recommended.

== Optional Settings ==

=== Enable Save States ===

{{race rule|Save states are not allowed to be loaded while racing. Please ensure you do not set up keybinds you may hit on accident during a race.}}
To enable save states, launch Project64 and navigate to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> or press <kbd><samp>Ctrl+T</samp></kbd> to open the Settings menu.

In the Settings menu, click <samp>Options</samp> and untick <samp>Hide advanced settings</samp>. Click <samp>Apply</samp>.

You should now be able to utilize save states while running the game by navigating to <kbd><samp>System</samp></kbd>.

=== Pause/Unpause Emulation when Window is not Active ===

In the Settings menu, expand the {{menuItem|Options/Configuration}} list on the left-hand side and tick the box for {{menuItem|Pause emulation when window is not active}} section to have the emulation pause completely when the window is not active. This prevents the game from even running and communication with the game from outside applications when the window is not active, so you may not want it to be on. If that is a problem you will want to ensure you untick {{menuItem|Pause emulation when window is not active}}.

{{kbd|Click Apply}} to save the setting. If you were running a game when you changed this setting you will need to go to the {{menuItem|System}} menu and {{kbd|Click Resume}} to continue playing.

=== Remove the FPS Cap ===

{{race rule|Unlimited FPS is not allowed for racing. Please ensure you do not set up keybinds you may hit on accident during a race.}}
To remove the FPS cap, launch Project64 and navigate to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> or press <kbd><samp>Ctrl+T</samp></kbd> to open the Settings menu.

In the Settings menu, click <samp>Options</samp> and untick <samp>Hide advanced settings</samp>. Click <samp>Apply</samp>.

You should now be able to remove the FPS Cap by loading a ROM, navigating to <kbd><samp>System</samp></kbd> and clicking on <samp>Limit FPS</samp>. Alternatively, you can just press F4 on your keyboard.

=== Resize Emulator Window ===

Go to <kbd><samp>Options</samp> ⇒ <samp>Configure Graphics Plugin</samp></kbd> and change the <samp>Windowed Resolution</samp> to whatever you prefer.

=== Show ROMs in ROM List ===

Right-click anywhere on the white screen and click on <kbd><samp>Choose ROM Directory...</kbd></samp> Select the respective folder that your ROMs are in.

=== Texture Packs ===

{{race rule|Texture packs are not allowed for races. Disable them before participating.}}
The following link will let you set up texture packs for [https://wiki.ootrandomizer.com/index.php?title=HiRes_Texture_Packs Project64 v3.0.0 or newer]

=== Required Settings for Racing ===

If you wish to partake in our community's races, then don't forgot to also configure the settings mentioned [[Racing#Project64|here]].

== Troubleshooting ==

=== Alt+Tabbing Crashes in Full-Screen Mode ===

Use the [[#Video_(Graphics)_Plugin|GlideN64 Video Plugin]]. If your PC doesn't support that plugin, you'll have to be aware to hit the "Escape" key on your keyboard before Alt+Tabbing.

Alternatively, you could also play in Windowed Mode. Navigate to <kbd><samp>Options</samp> ⇒ <samp>Configure Graphics Plugin...</samp></kbd> and adjust the Windowed Resolution accordingly. Click <samp>Save and Close</samp>.

=== Screen Flicker when Streaming ===

If using the [[#Video_(Graphics)_Plugin|GlideN64 Video Plugin]], go to <kbd><samp>Options</samp> ⇒ <samp>Configure Graphics Plugin...</samp></kbd>. In the "Video" tab, check the "Overscan" box. Click <samp>Save and Close</samp>.

=== Error: uCode crc not found in INI, using currently selected uCode ===

This error is caused by Project64 using Project64-video not being able to find the <samp>Video.rdb</samp> file that should be in the <samp>Config</samp> directory in the Project64 folder. Double check that this file is in the right location. Also ensure you are not running Project64 from the zip file as it cannot see any of its required files and will throw strange errors like this one when it can't find them.

If you still get the error, make sure you're using [https://www.pj64-emu.com/public-releases Project64 v3.0.0 or newer]. If your current <samp>Video (Graphics) Plugin</samp> is not already <samp>GlideN64</samp>, then change to that one. [[#Video_(Graphics)_Plugin|You can read here how to swap plugins]]. If that doesn't work, try the <samp>Project64 Video Plugin</samp>. If even this doesn't fix the issue, you can try <samp>Jabo's Direct3D8 Plugin</samp> as a last resort.

Bizhawk

2023-05-10T21:55:54Z

Flagrama: use templates to produce more semantic HTML easier

[[File:Bizhawk_releases_page_download.png|thumb|250px|You want the first file located under the Assets heading for both downloads. It should have ".zip" at the end. Version numbers will vary, ask in {{discord|setup-support}} on the {{discord}} if you're not sure which versions you want.]]

BizHawk is a frontend for small number of emulators and is targeted at Tool-Assisted Speedrunners. The advantage of this is that it means the emulators you use on it are targeted towards accuracy so you are unlikely to run into too many bugs that aren't also found when running the games on hardware. A small disadvantage to this is that these emulators also have various debugging tools enabled, which generally means they run slightly slower than emulators without these features enabled. But this also allows further manipulation of the game via Lua scripts which is how [[Multiworld]] functions. This also means that as of right now, '''''BizHawk is the only emulator that can be used for playing Multiworld'''''. Please also read the Multiworld page while setting up Bizhawk for that purpose.

First, you must download BizHawk and the files it requires to have installed to even run.
* [https://github.com/TASVideos/BizHawk-Prereqs/releases/ Prerequisite Files Installer]
** You want version 2.1 of the pre-requisites if you are using Bizhawk 2.3.x and the newest version of the pre-requisites if you are using the newest version of BizHawk.
* [https://github.com/TASVideos/BizHawk/releases/ BizHawk Emulator]

== Installing ==
<span style="display:block;margin:20px;">[[File:Bizhawk 01.png|RTENOTITLE]]</span>

Once you have downloaded the files for installation, you have to extract them. Right-click the zip files and choose {{MenuChoice|Extract All...}} and click {{MenuChoice|Next}} a couple of time. Make sure you do this for both zip files you downloaded.

You should now have a folder with a name like ''bizhawk_prereqs_vX.X'' where <code>X.X</code> is the version of the prerequisites that you downloaded such as <code>2.1</code>. This version can be different than the BizHawk version. Open this folder.

Inside there should be a file called {{MenuChoice|bizhawk_prereqs.exe}}. Double-click this file and click {{MenuChoice|Next}} a couple of times, then wait for all of the files to install. Once the installer has completed you can continue.

== Emulator Setup ==
You can now start up BizHawk. Open the folder ''BizHawk-X.X.X'' where <code>X.X.X</code> is the BizHawk version you downloaded, such as <code>2.7.0</code>. This version can be different than the Prerequisites version. Inside this folder is a file called {{MenuChoice|EmuHawk.exe}}. Open this file.

You have to load a ROM before you can change N64 emulator-specific settings. Go to {{MenuItem|File}} {{To}} {{MenuItem|{{MenuChoice|Open ROM}}}} in the menu bar up top. Locate your ROM and open it.

<span style="display:block;margin:20px;">[[File:Rom.png|RTENOTITLE]]</span>

=== Enable RAM Expansion ===

Now that you have loaded a ROM a new menu entry {{MenuItem|N64}} will show up in the menu bar. Ensure {{MenuItem|N64}} {{To}} {{MenuItem|Use Expansion Slot}} has a check-mark beside it indicating it is enabled. If it does not click {{MenuChoice|Use Expansion Slot}} to enable it. Once you have enabled the setting you have to reboot the core for it to take effect. Navigate to {{MenuItem|Emulation}} {{To}} {{MenuItem|{{MenuChoice|Reboot Core}}}} to do so. You'll have to do this for every randomizer rom you create due to how Bizhawk works.

=== Enable Save Backup In Case of Crashes ===

Go to {{MenuItem|Config}} {{To}} {{MenuItem|{{MenuChoice|Customize}}}} and navigate to the {{MenuChoice|Advanced}} tab. You should check the box for {{MenuChoice|AutoSaveRAM}} and set it to a reasonable time, such as {{MenuChoice|30}}-{{MenuChoice|45}} seconds (keep in mind that setting this too low could increase lag and decrease overall emulator performance, while setting it too high can cause save data corruption if you crash mid-save). This will allow Bizhawk to write your in-game save to your drive. This is '''NOT''' a form of save state - it simply periodically creates/updates a file on your hard drive with your in-game save data, and is wonderful for mitigating the effects of crashes. '''<span style="color:red">In the event of a crash (or if you open TAStudio by accident) DO NOT RELOAD THE ROM! DO NOT RELOAD THE ROM!</span>''' Doing so will overwrite your backups, meaning that your save files will be gone. To recover your save file follow the instructions over [[Bizhawk#Help! My emulator crashed!/I accidentally opened TAStudio and got a black screen!|here]].

[[File:bizhawkautosave.png|420x487px|Advanced Customization]]

=== Hotkey Settings ===
<span style="display:block;margin:20px;">[[File:Bizhawk 04.png|RTENOTITLE]]</span>

It is strongly recommended to remove most, if not all, of the default hotkeys. Some are bound to your controller by default and can cause frustration while trying to play. Go to {{MenuItem|Config}} {{To}} {{MenuItem|{{MenuChoice|Hotkeys...}}}}, select a hotkey, and simply press the {{MenuChoice|Esc}} key on your keyboard to unbind it. You can also click {{MenuChoice|Misc}} and {{MenuChoice|Clear All}} to unbind all of the hotkeys at once.

=== Required Settings for Racing ===

{{Race rule|If you wish to partake in our community's races, then don't forgot to also configure the settings mentioned [[Racing#BizHawk|here]].}}

== Controls Setup ==
First, take a look at the [[Controller Setup]] guide. Ensure your controller is calibrated, and if you are using one of the controllers with additional setups steps in that guide make sure you follow them.

With the ROM still running, go to {{MenuItem|Config}} {{To}} {{MenuItem|{{MenuChoice|Controllers...}}}} and set up your controls by clicking on the textboxes and {{MenuChoice|pressing}} the button on your controller or keyboard you wish to have mapped to the displayed N64 control. If your controller isn't registering inputs you are missing the required drivers for your controller and must find them and install them.

=== XBOX Controller Troubleshooting ===
XBOX controllers can be a bit finicky with BizHawk.

==== XBOX One Analog Stick Doesn't Work As Background Input ====
In versions prior to 2.5, BizHawk does not reliably communicate with the XBOX One controller, and on Windows 10, Windows itself will take control over the controller's left analog stick when the window isn't focused. To fix this, update to BizHawk 2.5 or later.

==== Can Only Press 1 Trigger At A Time or Background Input Buttons Don't Work ====
[[File:Bizhawk 2.5 Customization Options XBOX.png]]

In versions prior to 2.5 BizHawk does not reliably communicate with XBOX controllers. To fix this, update to BizHawk 2.5 or newer. In these versions, you can go to {{MenuItem|Config}} {{To}} {{MenuItem|{{MenuChoice|Customize...}}}} and under the {{MenuChoice|General}} tab there is an {{MenuItem|Input Method (requires restart)}} option. Choose the radio button by {{MenuChoice|OpenTK}}. Click {{MenuChoice|OK}}, then close BizHawk. When you relaunch BizHawk you should rebind all of your controls again, including the analog sticks. You should no longer have issues with your controller.

=== Better Analog Stick Accuracy ===
''Provided by Retzioka''

<span style="display:block;margin:20px;">[[File:Bizhawk 03.png|RTENOTITLE]]</span>

Make sure the first '''4''' boxes under {{MenuChoice|Normal Controls}} are empty as displayed above. If they are not, click the box and hit {{MenuChoice|Esc}} to clear the bind. These settings will force your controller to always input the control stick at 100% rather than by how much you press the stick in a direction. This makes aiming in the game very difficult. You never want these set if you are using a controller with an analog stick which is why we unbind them.

Now go to the {{MenuChoice|Analog Controls}} tab and click the {{MenuChoice|Bind}} button.

'''X-Axis''' Move your stick Left to Right once.

'''Y-Axis''' Move your stick from Up to Down once.

Be sure to also adjust your sensitivity to make it easier to aim as well. The image above shows an example, but everyone has a different setting that "feels good" to them. Experiment with them, especially once you've found a Bow or Slingshot.

== Optional Settings ==

=== Better Graphics ===
<span style="display:block;margin:20px;">[[File:Bizhawk 05.png|RTENOTITLE]]</span>

Under {{MenuItem|Config}} {{To}} {{MenuItem|Cores}} {{To}} {{MenuItem|{{MenuChoice|N64 Video Plugin Settings}}}} you should see a dropdown box titled {{MenuItem|Video Resolution}}. The recommended resolution is {{MenuItem|{{MenuChoice|640x480}}}} and our maximum recommended resolution is {{MenuItem|{{MenuChoice|800x600}}}}. However, if you want to go higher than {{MenuItem|800x600}}, be '''warned''' that Bizhawk is a resource hog and the higher the resolution, the more likely your emulator's performance will be affected and will be a major cause of slowed and laggy gameplay.

If you computer has up-to-date OpenGL drivers (fairly modern Nvidia and AMD cards, and only very, very recent Intel graphics) you should change the {{MenuItem|Active Video Plugin}} to {{MenuItem|{{MenuChoice|GLideN64}}}} as it is the most accurate video plugin. If the game boots to a black screen while after activating this plugin try {{MenuItem|{{MenuChoice|Glide64 mk2}}}} instead. Use {{MenuItem|{{MenuChoice|Rice}}}} plugin only as a last resort as it is quite inaccurate.

=== Background Inputs ===
<span style="display:block;margin:20px;">[[File:Bizhawk 06.png|RTENOTITLE]]</span>

As a Streamer, you may have to click around often. This will make sure that whatever you do, the Emulator will register the inputs from your Controller. Go to {{MenuItem|Config}} {{To}} {{MenuItem|{{MenuChoice|Customize...}}}} and make sure {{MenuChoice|Run in background}} and {{MenuChoice|Accept background input}} are both checked. It is also recommended to uncheck the {{MenuChoice|Pause when menu activated}} box.

'''If you selected a high resolution in the previous step your FPS might go down if you click somewhere other than on the Emulator.'''

=== Save States ===
In order to use save states in OoTR you will need to go to {{MenuItem|N64}} {{To}} {{MenuItem|{{MenuChoice|Use Expansion Slot}}}} and enable it. Savestates made before this change will fail, but any made after will be fine.

Note that the {{MenuItem|N64}} dropdown bar will not appear until after you've loaded a rom.

=== Aspect Ratio ===
<span style="display:block;margin:20px;">[[File:Bizhawk 07.png|RTENOTITLE]]</span>

If you decide to make your emulator’s window fullscreen, your game will look stretched. This does not look very nice for either you or your viewers. This will ensure the game will stay in its original 4:3 Ratio. Go to {{MenuItem|Config}} {{To}} {{MenuItem|{{MenuChoice|Display}}}} and check the {{MenuChoice|Maintain aspect ratio (letterbox)}} box and select {{MenuChoice|Use 1:1 pixel size}}.

== Troubleshooting ==

=== My Save Files Are Suddenly Gone ===

If Bizhawk closes improperly (e.g. due to a crash), then it will clear your save files upon reloading the rom. To prevent this from happening, read the instructions in the next subsection. If you have already reloaded your seed, then there is unfortunately nothing that can be done to retrieve your save file.

There have also been reports of this happening even though Bizhawk didn't crash. We believe that this is still due to closing Bizhawk improperly. After you're done playing, save the game and wait for Bizhawk to create your backups. Then go to {{MenuItem|File}} {{To}} {{MenuItem|{{MenuChoice|Close ROM}}}}, and afterwards hit {{MenuItem|File}} {{To}} {{MenuItem|{{MenuChoice|Exit}}}}. This should be the safest way to close Bizhawk and preserve your saves.

=== Help! My emulator crashed!/I accidentally opened TAStudio and got a black screen! ===

First of all, '''<span style="color:red">DO NOT RELOAD THE ROM! DO NOT RELOAD THE ROM!</span>''' Doing so will overwrite your backups, meaning that your save files will be gone. To recover your save files follow these instructions.

# In your Bizhawk folder navigate to <samp>\N64\SaveRAM</samp>.
# Identify the <samp>SaveRAM</samp> and <samp>AutoSaveRAM</samp> files corresponding to your seed. Sorting by date may help. Note that the <samp>AutoSaveRAM</samp> files will only exist if you've [[Bizhawk#Enable Save Backup In Case of Crashes|enabled that]] beforehand.
# Optional: manually make a backup of these files somewhere on your pc.
# Delete the <samp>SaveRAM</samp> file and rename <samp>AutoSaveRAM</samp> to take the place of the <samp>SaveRAM</samp> file you've just deleted.
# Now you can safely load your seed again and continue playing.

=== I am getting (Random) Crashes ===
[[Bizhawk#Enable RAM Expansion|Ensure that you've enabled RAM expansion]]

=== Bizhawk is Laggy ===

The first thing to look at if Bizhawk is lagging is your graphics settings.

==== Ensure Proper GPU is Being Used ====
[https://www.howtogeek.com/351522/how-to-choose-which-gpu-a-game-uses-on-windows-10/ This HowToGeek article on choosing a GPU to use for an application] will help you to ensure Bizhawk is using your high performance GPU if you have one.

==== Reduce Resolution ====
Refer back to [[Bizhawk#Better_Graphics|Graphics Configuration]]. If this is set too high then that can cause lag. Even if your pc is very powerful we still recommend not going over {{MenuItem|800x600}}, because it will demand a lot of resources from your computer without increasing the graphics all that much (it's a 20 y/o game). If you're still experiencing lag then consider decreasing the resolution even further. Remember: Bizhawk is a very resource-intensive emulator.

==== Disable Fullscreen ====
Playing in full screen could also be a cause of lag.

=== Audio Issues ===
Audio issues can be just that, audio issues, but if you have a reasonably powerful graphics card in your computer audio issues can be a result of Bizhawk using the integrated GPU on your CPU instead of the actual powerful dedicated GPU.

==== Ensure Proper GPU is Being Used ====
[https://www.howtogeek.com/351522/how-to-choose-which-gpu-a-game-uses-on-windows-10/ This HowToGeek article on choosing a GPU to use for an application] will help you to ensure Bizhawk is using your high performance GPU if you have one.

==== Reduce Resolution ====
If your high performance GPU is being used, or you don't have one, then try reducing the output resolution. Refer back to the [[Bizhawk#Better_Graphics|Graphics Configuration]] part of the guide to help guide you.

==== Disable Fullscreen ====
Playing in full screen could also be a cause of lag.

==== Increase the Audio Buffer ====
<span style="display:block;margin:20px;">[[File:Bizhawk_audio.jpg|RTENOTITLE]]</span>

Sometimes the audio buffer BizHawk uses runs out and causes audio skipping, or crashes the emulator. To prevent this issue you should increase the audio buffer size. Go to {{MenuItem|Config}} {{To}} {{MenuItem|{{MenuChoice|Sound...}}}} and increase the {{MenuItem|Buffer Size}} from {{MenuItem|100}} milliseconds to at least {{MenuChoice|250}} milliseconds. This will slightly delay audio playback but should reduce how often the emulator crashes.

==== Change the Output Method ====
If you are still having audio issues you can also try changing the "Output Method." You'll have to try each option and see which one works best for you as there is no guaranteed best option.

== Multiworld ==
Testrunner made a coop mod for the OoT Randomizer: Nothing is shared communally by all players, however there are now player-specific items which are mixed between all the worlds. So if you obtain an item for yourself, only you get it. If you obtain an item for another player, then only they get it. This effectively means everyone will be playing different intermingled seeds.

''For more information and instructions check the [[Multiworld]] setup guide.''

== Texture Packs ==

[[HiRes Texture Packs#Bizhawk| High Resolution Texture Packs]].

== Aspect Ratio Enhancement ==
{{race rule|rule=You may not use this enhancement|This will allow a player to view more on screen at once and many visual effects will not obscure this extra area giving an unfair advantage. For aspect ratio options allowed for races, review [[#Aspect Ratio|Aspect Ratio]].}}

In the N64 Graphics Plugin Settings change the resolution on the main tab to a custom resolution of whatever Aspect Ratio you desire, then on the GlideN64 tab scroll down to the video section and set Aspect Ratio to Adjust. This will cause the emulator to expand the camera view port in the game to match the specified resolution, allowing you to see more of the game at any given moment.

This can be used to avoid black bars around the game without introducing stretching nor cropping of the image. The downsides to this are that Frame Buffer effects will only render in the original 4:3 view port space and some visual tricks will be rendered incorrectly, in the case of Ocarina of Time and Majora's Mask this ''mostly'' affects the Lens of Truth effect and Shops.

Template:To

2023-05-10T21:16:16Z

Flagrama: Created page with "→"

→

Template:MenuItem

2023-05-10T21:16:13Z

Flagrama: Created page with "<samp>{{{1}}}</samp>"

Template:MenuChoice

2023-05-10T21:16:11Z

Flagrama: Created page with "<kbd>{{{1}}}</kbd>"

Racing

2023-05-07T21:12:06Z

Flagrama: /* Emulator Settings Requirements */ note rom may need to be loaded for certain settings to appear, link to setup as part of that note

'''<span style="font-size:x-small">by LostThePirate</span>'''

This guide will help you get set up for your first race. 

Community races and many privately organized races use [[#racetime.gg|racetime.gg]]. Previously [https://speedrunslive.com SpeedRunsLive] was used, and some people still organize races there, but the community has largely transitioned away from it.

Races can be joined using [[#LiveSplit|LiveSplit]] or through the racetime website. If using LiveSplit, make sure you can log into racetime quickly should LiveSplit fail to load a race channel or crash in the middle of a race.

''We have compiled [https://wiki.ootrandomizer.com/index.php?title=Common_Softlocks_And_Crashes a list of known softlocks and crashes] (WIP). It is recommended to read it through to potentially save you from frustration later.''

{{TOClimit|3}}
== Before You Ready Up ==

Please read the [[Racing#Racing_Rules | Rules]] and be familiar with the allowed and banned techniques for the particular ruleset of the race beforehand.

If you are joining a community race it is best to set everything up nice and early. Community race rooms are opened 1 hour ahead of time so you have plenty of time to get everything set up before they start. You'll certainly run into issues and it is easier to help you long before the race starts rather than struggling to hurry to fix everything just 5 minutes before everyone has to ready up.

If you are just playing a pickup race in one of the race planning channels ({{discord|standard-race-planning}}, {{discord|ddr-race-planning}}, {{discord|rsl-race-planning}}, {{discord|bq-race}}, or {{discord|other-racing-formats}}) the people you are racing with should be patient and be able to help you anywhere you get stuck as there is no set starting time there.

Ensure everything is working before you ready up in the race channel. Get your [[Setup#Emulators|emulator]] or console behaving; get your controller/key bindings set; get your [[Trackers|tracker]] of choice downloaded or installed and learn how to use it. Get everything ready so that you can play all by yourself without outside help.

'''Note''': [https://wiki.ootrandomizer.com/index.php?title=Project64 Project64 v3.0+], [[Retroarch]] and [[Bizhawk]] are the recommended emulators for Ocarina of Time Randomizer. In regards to race participation, Project64 v2.0, v2.1, v2.2, and v2.3 as well as ModLoader64 are '''not allowed''' for official racing. Use of all cheats is also prohibited. If you need to use a cheat code to address pause lag in Project64 v1.7 or v1.6, you '''cannot''' join an official race as long as that cheat is active. Use of texture packs to modify the game's appearance is also prohibited by the Ocarina of Time Randomizer community for official races.

Get acquainted with your streaming software; get your broadcast settings ready; get your scene layouts the way you want; get your [https://twitch.tv Twitch] channel how you'd like it. You can add Randomizer, Competitive, and/or Speedrun to your Twitch tags on your dashboard to let viewers know what kind of OoT you'll be playing.

== racetime.gg ==
[https://racetime.gg racetime.gg] is a modern, sleek and user-friendly system that lets anyone and everyone race video games online, and is an open source, community driven site.

=== Create an account ===
Head to the rt.gg website. In the top right corner of the page you should see a <samp>Log in / Create account</samp> button. {{kbd|Left Click}} that button. On the right side is the log in form. You'll use that to log in to your account in the future, after you create it. On the left side is the <samp>Create an account</samp> form. You'll see a link to the [https://racetime.gg/about/faq rt.gg FAQ] and fields for your <samp>Email</samp>, <samp>Name</samp>, and <samp>Password</samp> and its confirmation.

Fill out these fields. The email address will need to be valid so that you can confirm the account. The name field should be the username you like to go by. Ensure you type the same password into both password fields. At the bottom of both forms is a reCAPTCHA you'll need to interact with to prove you're human. Usually, you can just click the checkbox and that is enough.

Once you have filled out the form and proven you're not a robot, click {{kbd|Create account}}. You should get an email shortly with a link to click to validate your account.

=== Connect with Twitch ===
Once you are logged into your rt.gg account, head to the top right of the screen again. {{kbd|Left Click}} the <samp>Settings</samp> button. On this page, select the {{kbd|Twitch & connections}} tab, then on the following page press the {{kbd|Connect your Twitch.tv account}} button. You'll log into your Twitch account if you're not already, then {{kbd|Authorize}} the connection. Your racetime.gg account and your Twitch account are now linked together. You're now ready to join Ocarina of Time Randomizer races.

=== Joining a Race ===
Generally a race room will be provided in one of the announcements channels ({{discord|racing-announcements}}, {{discord|freaky-friday-races}}, {{discord|standard-announcements}}, {{discord|league-announcements}}, {{discord|ddr-announcements}}, {{discord|rsl-announcements}}, {{discord|bq-announcements}}) for official races, or one of the other race planning channels ({{discord|standard-race-planning}}, {{discord|ddr-race-planning}}, {{discord|rsl-race-planning}}, {{discord|bq-race}}, or {{discord|other-racing-formats}}) for pick-up games and you can just click on that link to be dropped right into the correct room on the website. You can also see active races and races currently waiting for participants in the {{discord|current-races}} channel or on the [https://racetime.gg/ootr Ocarina of Time Randomizer] page on racetime.gg You'll probably see <samp>Current races</samp> above a bunch of <samp>Past races</samp>. You can generally join any race that is accepting entrants, so click on the one you're interested in joining.

On the race page, you'll see details of the race, including the goal, a link to the seed page if one has been generated already, and the entrants to the left, and you'll see chat and a timer to the right. Above the timer is a <samp>Join</samp> button. {{kbd|Left Click}} that button to join the race. It will then split into two buttons. <samp>Ready</samp>, which you should click once you have your seed, emulator, and stream set up, and <samp>Quit</samp> which you can click if you decide you don't wish to race. Once you've readied up, a <samp>Not ready</samp> button will appear if you actually aren't ready yet.

Once the race has been started, the timer will begin to countdown. Once it reaches 0, begin to race. During an active race you have two buttons again. <samp>Done</samp>, which you will press once you finish the seed, and <samp>Forfeit</samp> which you may need to press if you find yourself no longer able to complete the race. Both of these actions can be undone if needed, so don't worry if you accidentally hit one. Just make sure by the end of the race you aren't "Done" when you haven't finished, or that you haven't "Forfeit" if you have actually finished. The very last action you can do after having done one of these is <samp>Add comment</samp> on the race. This will be displayed in a tooltip next to your name and in the chat and is viewable by everyone. Be sure not to leave any spoilers in the comment.

== LiveSplit ==

[[File:Livesplit-race-view.png|thumb|Ensure you are using the latest version of LiveSplit for the best experience. If being in a race does not look like this screenshot, be sure to update.]]

LiveSplit is a convenient Timer program that has racetime.gg integration (as of version 1.8.8). It can be downloaded from [http://livesplit.github.io/downloads/ LiveSplit's GitHub page].

The instruction video linked there is ''very helpful'' and I recommend you check it out to learn a lot more about LiveSplit.

=== Join a Race ===

With LiveSplit open, right-click within the Timer, select racetime.gg Races, and choose from the available races that are currently accepting Entrants. On racetime.gg, the Ocarina of Time Randomizer has its own category, so you shouldn't have any confusion.

Upon selecting a race to participate in, you will be prompted to log into the website for racetime.gg races.

[[File:Livesplit-oauth.png|frameless]]

== Entering and Readying ==

To actually enter a race you'd like to participate in, [[#LiveSplit|Join a Race via LiveSplit]] or [[#Joining a Race|Join a Race on the website if racing on racetime]]. Then, click Enter Race or type {{kbd|.enter}} to join the race.

Click the link in the header below the ruleset name for a link to the seed to be used in the race. Note: This is not set too early before a race's start time, to prevent cheating. During Weeklies, for example, the seed is generated (and the link posted) approximately 15 minutes before the scheduled start time of the race.

Race participation requires streaming your run. Be sure to start your broadcast at least 5 minutes before the expected start time of the race. A bot will verify if you are live, and it can take up to 5 minutes for the fact that you are live streaming to become available to that bot. Budget your time accordingly.

Once you have ''everything'' ready to begin your run, select Ready or type {{kbd|.ready}}. Only do this after you have downloaded the seed, set your file name, had your final bathroom break before the race, gotten your cup of water, etc. Ready means '''ready''', and once everyone has indicated that they are ready, there is a 15 second countdown on racetime.

Once the countdown reaches 0, your LiveSplit timer will start automatically, if linked. '''Do not''' start your game file (and load into your house in the forest) before the Timer starts! Do not attempt to Pause your timer during a race, either - LiveSplit will interpret a Pause as completion of the race.

== Finishing A Race ==

When you are finished with a race depends on whether the goal is to ''Defeat Ganon'', ''Collect All Triforce Pieces'' in Triforce Hunt, or in casual races some other goal. The timing of finishing for defeating Ganon is the start of cutscene after you press B for the final swing. For Triforce Hunt in the Random Settings League it is once the screen is completely black, and in general Ocarina of Time racing is finished either at the last input or once the item you collected is above your head.

Once you achieve your goal, stop your timer using whatever keybinding you have set for it, click Done or type {{kbd|.done}} to complete the race. You can look in the race room to see who has finished and with what times.

If something comes up, you can click Forfeit or type {{kbd|.forfeit}} to forfeit a race. You will lose points and standing on racetime, but sometimes it can't be avoided. Be aware of the penalties for forfeiting, and try to budget plenty of time for a race.

If you think you have to quit, click Forfeit, then realize you were mistaken, you can resume the race (including all the time that has elapsed) by clicking Undo Finish or typing {{kbd|.undone}} – the race timer will continue and will include the time you thought you were out of the race.

== Racing Rules ==
{{race rule|These are several of the most important rules you must follow while racing.}}
# You must follow the [[Rules]] the current race has chosen to follow. The most common ruleset is [[Standard]], however this is not used for all races. Always confirm which ruleset a race is using if it is not in the race goal.
# You can play on [[Everdrive|the Nintendo 64 with a flash cart]], [[Wii Virtual Console]], or [[Setup#Emulators|Emulators]]. Project64 v2.x, ModLoader64, and Dolphin versions older than Beta 5.0-13963 are not allowed for racing. Note that [https://www.pj64-emu.com/public-releases Project64 v3.0+] is race-legal.
#* If playing on emulator, you must also follow the [[#Emulator Settings Requirements|Emulator Settings Requirements]].
# You may not modify the ROM in any way outside of patching it on the [https://ootrandomizer.com Randomizer website] or the Ocarina of Time Randomizer software on your computer.
#* This means changing cosmetics using the randomizer is fine. Adding stuff like models or changing textures is not. Editing RAM is also not allowed.
# Generally there are no rules for streaming except that you must do so, however Tournament races often have additional requirements.
# Spoilers should only be discussed in the relevant "results" channels on the Discord. Do not discuss them in other Discord channels or the race chat channel, and do not put them in race comments.

''The restreaming team also requests that if you use custom music, you try to keep it to only Zelda tracks if they ask you if you want to be restreamed''.

== Emulator Settings Requirements ==
{{race rule|These settings are either useful for identifying a cheater, or preventing an emulator from exceeding the capabilities of the actual Nintendo 64}}
Playing on an emulator for races requires a little bit more setup. Namely, you need to enable an FPS display. If you cannot provide this, you are required to capture the entire emulator window. '''Texture packs are not allowed during races'''.

Some options may not be available unless you are currently running an [[Setup|Ocarina of Time Randomizer ROM]].

=== BizHawk ===
To enable the FPS display, go to {{kbd|View|Display FPS}}. You can configure it further in {{kbd|Config|Messages}}.

=== Project64 ===

To enable the FPS Display (shown as DL/s), launch Project64 and load your ROM. Next, navigate to {{kbd|Options|Settings...}} or press {{kbd|Ctrl+T}} to open the Settings menu.

In the Settings menu, expand the <samp>Options</samp> list on the left-hand side and look for an <samp>Advanced</samp> section. If the <samp>Advanced</samp> section isn't showing, click <samp>Options</samp> and untick <samp>Hide advanced settings</samp>. Afterwards, click <samp>Advanced</samp> and tick the <samp>Speed Display</samp>. The <samp>Speed Display</samp> box must show <samp>VI/s & DL/s</samp>. Click <samp>Apply</samp>.

'''Lowering the VI refresh rate to 1488 is also required for racing with Project64.'''

While in the Settings menu, look for a <samp>Defaults</samp> section. If the <samp>Defaults</samp> section isn't showing, click {{kbd|Options}} and untick {{kbd|Hide advanced settings}}. Afterwards, click {{kbd|Defaults}} and change the <samp>VI refresh rate</samp> from <samp>1500</samp> to {{kbd|1488}}. Click {{kbd|Apply}}.

Finally, in the Settings menu, click on {{kbd|Config: The Legend of Zelda - Ocarina of Time (U) (Randomizer).}} Your <samp>VI refresh rate</samp> should display <samp>1488</samp>. If not, change it accordingly and click {{kbd|Apply}}

Keep in mind that '''you must show your VI Refresh Rate''' in both the <samp>Defaults</samp> section and the <samp>Config: The Legend of Zelda - Ocarina of Time (U) (Randomizer)</samp> section '''before the race starts'''.

==== Allowed Versions ====
{{race rule|Older versions of Project 64 have problematic settings, either overclocking by default or just don't work right with Ocarina of Time Randomizer}}

The allowed versions of Project 64 are version 3.0 and newer stable versions.

=== RetroArch ===
To enable the FPS display, go to {{kbd|Settings|On-Screen Display|On-Screen Notifications}} and switch <samp>On-Screen Notifications</samp> to {{kbd|ON}} if it is not already. Then, change <samp>Display Framerate</samp> to {{kbd|ON}}.

You must also show that you are using the <samp>Framerate</samp> option {{kbd|original}}, as well as having the <samp>VI Refresh (Overclock)</samp> option set to {{kbd|auto}}, before a race starts. To do this, press {{kbd|F1}} to open the <samp>Quick Menu</samp> and choose {{kbd|Options}} and scroll down to the <samp>Framerate</samp> option. This is required for the Mupen64plus Next core and the ParaLLEl core. If you are using the old mupen64plus core, this option will not appear and the text in the bottom left that displays what core you are using will be proof that you are following this rule.

=== Dolphin ===
To enable the frame display, go the settings under {{kbd|Options|Graphics Settings|General}} and check the box which says Show FPS.
Refer to the [[Dolphin|Dolphin]] for setup help to make sure your settings are race legal.
Be aware that you need to show your settings menu to prove that your {{kbd|Speed Limit}} setting is set to 100% and that your {{kbd|Clock Override}} setting is disabled.

==== Allowed Versions ====
{{race rule|Older versions of Dolphin did not emulate loading the ROM from the WAD properly and skipped the Classic Controller text}}

The allowed versions of Dolphin are Beta 5.0-13963 and newer. The newest beta is almost always recommended.

[[Category:Racing Rules]]

Project64

2023-05-07T20:27:00Z

Flagrama: fixes + race rules

Project64 is no doubt the most popular N64 emulator available. Randomizer staff will support Project 64 '''3.0.0 or newer''' which was released on May 26, 2021. We will not directly support any previous version.

{{race rule|Only Project64 3.0 and newer are allowed and supported for racing. Version 2.0 - 2.3 are not allowed for racing. }}
Project64 v3.0.0 or newer as well as [[Bizhawk]] and [[Retroarch]] are the recommended emulators for racing.

[https://www.pj64-emu.com/public-releases Download Project64] '''v3.0.0 or newer'''

Please note that certain ads on the PJ64 download page might lead you to download adware. Only wait for the download to start automatically or click ''Try again'' to start it.

Version 3.0.1 changed the wording in many places. One of the major ones is changing <samp>Settings...</samp> in the <samp>Options</samp> menu, so when using 3.0 anywhere you see <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> look for <kbd><samp>Options</samp> ⇒ <samp>Settings...</samp></kbd> instead.

== Configure Controller ==
First, read the [[Controller Setup]] guide. Ensure the controller is calibrated, and if you are using one of the controllers with additional setups steps in that guide make sure you follow them.

When using an Xbox controller, or any controller that is an XInput device, you must first go to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp> ⇒ <samp>Plugins</samp></kbd> and change the <kbd><samp>Input (controller) plugin</samp></kbd> from <kbd><samp>Project64 Input Plugin</samp></kbd> to <kbd><samp>N-Rage for PJ64</samp></kbd>. Then navigate to <kbd><samp>Options</samp> ⇒ <samp>Configure controller plugin...</samp></kbd> and check <kbd><samp>XInput</samp></kbd> at the top. This will change the bind menu to be more appropriate for your device.<sup>2</sup> The <samp>XControl</samp> column is the button on your controller, and the <samp>N64</samp> column is the button on the N64 controller you want it to use.

For other controllers and keyboard users, use the default <kbd><samp>Project64 Input Plugin</samp></kbd> (or ensure that <samp>XInput</samp> does not have a check by it). Click on the button for the control you want to bind a button to and the menu will wait for you to press a button on the controller or a key on your keyboard to use for the button. ''You may need to change these again if you switch controllers''.

If you use a keyboard, you will also want to increase the <kbd><samp>Analog Stick</samp> ⇒ <samp>Range</samp></kbd> to <kbd>100%</kbd>.

[[File:Project64KeyboardControls.jpg|560x315px]][[File:PJ64 10.png|560x315px]]

== Recommended Settings ==

=== Video (Graphics) Plugin ===

The GlideN64 Plugin is recommended. To do this, launch Project64 and navigate to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> or press <kbd><samp>Ctrl+T</samp></kbd> to open the Settings menu.

In the Settings menu, go to the <samp>Plugins</samp> section and change your <samp>Video (Graphics) Plugin</samp> to <samp>GlideN64</samp>. Click <samp>Apply</samp>.

If your PC doesn't support this, you'll have to use the <samp>Project64 Video Plugin</samp> instead.

<samp>Jabo's Direct3D8 Plugin</samp> is not recommended.

== Optional Settings ==

=== Enable Save States ===

{{race rule|Save states are not allowed to be loaded while racing. Please ensure you do not set up keybinds you may hit on accident during a race.}}
To enable save states, launch Project64 and navigate to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> or press <kbd><samp>Ctrl+T</samp></kbd> to open the Settings menu.

In the Settings menu, click <samp>Options</samp> and untick <samp>Hide advanced settings</samp>. Click <samp>Apply</samp>.

You should now be able to utilize save states while running the game by navigating to <kbd><samp>System</samp></kbd>.

=== Pause/Unpause Emulation when Window is not Active ===

In the Settings menu, expand the <samp>Options/Configuration</samp> list on the left-hand side and tick/untick the box for <samp>Pause emulation when window is not active</samp> section. Click <samp>Apply</samp>.

=== Remove the FPS Cap ===

{{race rule|Unlimited FPS is not allowed for racing. Please ensure you do not set up keybinds you may hit on accident during a race.}}
To remove the FPS cap, launch Project64 and navigate to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp></kbd> or press <kbd><samp>Ctrl+T</samp></kbd> to open the Settings menu.

In the Settings menu, click <samp>Options</samp> and untick <samp>Hide advanced settings</samp>. Click <samp>Apply</samp>.

You should now be able to remove the FPS Cap by loading a ROM, navigating to <kbd><samp>System</samp></kbd> and clicking on <samp>Limit FPS</samp>. Alternatively, you can just press F4 on your keyboard.

=== Resize Emulator Window ===

Go to <kbd><samp>Options</samp> ⇒ <samp>Configure Graphics Plugin</samp></kbd> and change the <samp>Windowed Resolution</samp> to whatever you prefer.

=== Show ROMs in ROM List ===

Right-click anywhere on the white screen and click on <kbd><samp>Choose ROM Directory...</kbd></samp> Select the respective folder that your ROMs are in.

=== Texture Packs ===

{{race rule|Texture packs are not allowed for races. Disable them before participating.}}
The following link will let you set up texture packs for [https://wiki.ootrandomizer.com/index.php?title=HiRes_Texture_Packs Project64 v3.0.0 or newer]

=== Required Settings for Racing ===

If you wish to partake in our community's races, then don't forgot to also configure the settings mentioned [[Racing#Project64|here]].

== Troubleshooting ==

=== Alt+Tabbing Crashes in Full-Screen Mode ===

Use the [[#Video_(Graphics)_Plugin|GlideN64 Video Plugin]]. If your PC doesn't support that plugin, you'll have to be aware to hit the "Escape" key on your keyboard before Alt+Tabbing.

Alternatively, you could also play in Windowed Mode. Navigate to <kbd><samp>Options</samp> ⇒ <samp>Configure Graphics Plugin...</samp></kbd> and adjust the Windowed Resolution accordingly. Click <samp>Save and Close</samp>.

=== Screen Flicker when Streaming ===

If using the [[#Video_(Graphics)_Plugin|GlideN64 Video Plugin]], go to <kbd><samp>Options</samp> ⇒ <samp>Configure Graphics Plugin...</samp></kbd>. In the "Video" tab, check the "Overscan" box. Click <samp>Save and Close</samp>.

=== Error: uCode crc not found in INI, using currently selected uCode ===

This error is caused by Project64 using Project64-video not being able to find the <samp>Video.rdb</samp> file that should be in the <samp>Config</samp> directory in the Project64 folder. Double check that this file is in the right location. Also ensure you are not running Project64 from the zip file as it cannot see any of its required files and will throw strange errors like this one when it can't find them.

If you still get the error, make sure you're using [https://www.pj64-emu.com/public-releases Project64 v3.0.0 or newer]. If your current <samp>Video (Graphics) Plugin</samp> is not already <samp>GlideN64</samp>, then change to that one. [[#Video_(Graphics)_Plugin|You can read here how to swap plugins]]. If that doesn't work, try the <samp>Project64 Video Plugin</samp>. If even this doesn't fix the issue, you can try <samp>Jabo's Direct3D8 Plugin</samp> as a last resort.

Making A Backup

2023-05-01T22:44:50Z

Flagrama: sp

For using the Randomizer you need to have a backup copy of Ocarina of Time on your computer. This guide will demonstrate how to do this.

== Wii Virtual Console ==
The easiest method of backing up a copy of Ocarina of Time is by creating a WAD of the version installed on your Wii and then extracting that WAD using gzinject and finding the file called <samp>rom</samp> inside of the extracted contents.

=== What You Will Need ===
* [[Wii Virtual Console#Softmodding Your Wii|A Softmodded Wii]] or [[Wii Virtual Console#Softmodding Your Wii U's Virtual Wii Mode|A Softmodded vWii]]
* A Dump of your Ocarina of Time Virtual Console Channel ([https://wii.guide/dump-wads.html Wii Guide has a page on doing this])
* gzinject

=== Getting and Setting Up gzinject ===
gzinject is an application by Krim/Krimtonz originally for putting the OoT Practice ROM in a WAD, but now has a variety of uses.

'''Windows''': [https://github.com/krimtonz/gzinject/releases/download/0.3.1/win32.zip Download] then extract the zip file. To run it, open the folder with gzinject in it, then click in the address bar and type <samp><kbd>cmd</kbd></samp> and press <samp><kbd>Enter</kbd></samp>. In the terminal that shows up you should be able to type <samp><kbd>gzinject</kbd></samp> and press <samp><kbd>Enter</kbd></samp> and see a bunch of information on how to use gzinject. If you do, move on to [[#Extracting the ROM From the WAD|the next step]].

'''Linux''': Try using [https://github.com/krimtonz/gzinject/releases/download/0.3.1/ubuntuwsl64.tar.bz2 the WSL build of gzinject]. It doesn't link to many libraries so should work without recompiling. If not, [https://github.com/krimtonz/gzinject/archive/refs/tags/0.3.1.zip download the source code] and then [https://github.com/krimtonz/gzinject/blob/master/BUILDING.md follow the BUILDING file on GitHub].

'''macOS''': Currently you have to build from source. Setting up a build environment is out of scope for this guide, but once you have it set up you should be able to [https://github.com/krimtonz/gzinject/archive/refs/tags/0.3.1.zip download the source code] then [https://github.com/krimtonz/gzinject/blob/master/BUILDING.md follow the BUILDING file on GitHub]

=== Extracting the ROM From the WAD ===
Once you have a version of gzinject that runs, you'll need to find yourself the Wii common key or figure out a way to generate one. It is the same file you will need to make a WAD on the online generator as well. The file should be placed in the same folder as gzinject and called <samp>common-key.bin</samp>. Once you have that in place, gzinject should be ready for use.

To extract all of the data from your dumped WAD, open a terminal and type <samp><kbd>gzinject -a extract -w </kbd></samp>. Don't forget the space at the end. Next drag your dumped WAD onto the terminal. This should put the path to the WAD at the end. If there is not a space between the "w" and the path, use the arrow keys to go back and add the space. If so, press <samp><kbd>Enter</kbd></samp> and gzinject should now extract the WAD to a folder called <samp>wadextract</samp>.

If it does not make sure that you have the <samp>common-key.bin</samp> file in the right place, and that you typed the command in the terminal correctly, including the space.

Now if you open the <samp>wadextract</samp> folder there should be another folder inside called <samp>content5</samp> and inside of that folder is a bunch of files, but the one you are looking for is called <samp>rom</samp>. This is an Ocarina of Time 1.2 ROM that you can run in an emulator. If you want to use it for the Randomizer you will have to downgrade it to 1.0.

== Gamecube ==
Another way to to make a backup of Ocarina of Time is by ripping a Gamecube disc to an ISO using a Wii and then extracting the ROM using Dolphin.

=== What You Will Need ===
* [[Wii Virtual Console#Softmodding Your Wii|A Softmodded Wii]] or [[Wii Virtual Console#Softmodding Your Wii U's Virtual Wii Mode|A Softmodded vWii]]
* A Dump of your Ocarina of Time / Master Quest disc or Zelda Collector's Edition disc ([https://wiki.dolphin-emu.org/index.php?title=Ripping_Games Dolphin's wiki has a guide on doing this.])
* The [[Dolphin]] Emulator
* A Hex Editor and/or Binary File Manipulation Software

=== Extract File From Disc ===
First, in Dolphin you will need to have the ISO backup of your GameCube disc in the list of games in the main window. If you need to add the path the files are located in, go to <samp><kbd>Options</kbd>→<kbd>Configuration</kbd>→<kbd>Paths</kbd></samp> and click the <samp>Add...</samp> button. Next navigate to the folder with your ISO file in it and click <samp>Open</samp>.

With the backup in the game list, right-click the game and click on <samp><kbd>Properties</kbd></samp> then click on the <samp>Filesystem</samp> tab. You may need to click the arrows on the right of the tabs list to find it.

For a Ocarina of Time / Master Quest ISO, you will want to look for the <samp>zlj_f.tgc</samp> file for the US copy, if other copies do not have this file, you want the large 500MB+ size file. For Collector's Edition you want to open the <samp>tgc</samp> folder and select the <samp>zelda_ENG_090903.tgc</samp> file for the US copy, if other copies do not have this file, you want the large 480MB file. Right-click the file and click <samp>Extract File...</samp> and extract it to a folder.

=== Create ROM File From Extracted File ===
For this part you will want a hex editor for finding where the ROM is in the file we extracted.

For '''Windows''': [https://mh-nexus.de/en/hxd/ HxD] is recommended. It will also be able to copy the data you find to make a ROM file.
For '''macOS''': [https://hexfiend.com/ Hex Fiend] looks like a good choice.
For '''Linux''': Any graphical hex editor should work, or if you're experienced with <samp>hexdump</samp> that should also work.

First lets locate the ROM file in the extracted file using a hex editor. Open up the file in a hex editor, then open a find dialog. Hex Fiend has this located at the top of the window. Other software should be able to bring up one by pressing <samp><kbd>Ctrl</kbd>+<kbd>F</kbd></samp> or on macOS <samp><kbd>Command ⌘</kbd>+<kbd>F</kbd></samp>. Make sure it is in <samp>Hex</samp> mode, or you are typing in the <samp>Hex</samp> side of the window. Type <code>80 37 12 40</code> and try to search for that string. This is the "magic" header for a N64 ROM and all N64 ROMs start with these bytes.

Your hex editor should have a place on the window where it displays an "Offset" value somewhere in the window. Make sure you have the 8 or 0 in <code>80</code> selected and then write down this value. It is usually a hex value which means that it uses the numbers 0-9 and the letters A-F. Use [https://www.rapidtables.com/convert/number/hex-to-decimal.html this Hex to Decimal] converter to convert the hex number to a normal decimal number. We will use this in the next section, but the next part is OS specific.

=== Windows ===
Now that you have the decimal value of where the ROM is located, press <samp><kbd>Control</kbd>+<kbd>E</kbd></samp> to open the <samp>Select block</samp> dialog. Make sure that the radio button next to the <samp>dec</samp> option is selected. In the <samp>Start-offset</samp> text box paste or type the decimal value of where the ROM is. Next click the radio button next to <samp>Length</samp> and type in that text box <samp><kbd>33554432</kbd></samp>. Next click <samp>OK</samp> and the ROM file will now be selected.

Copy the ROM file's bytes with <samp><kbd>Ctrl</kbd>+<kbd>C</kbd></samp>, open a new file by pressing <samp><kbd>Ctrl</kbd>+<kbd>N</kbd></samp>. Next press <samp><kbd>Ctrl</kbd>+<kbd>S</kbd></samp> to save the file. Save it with a name you will remember such as <samp>Ocarina of Time.z64</samp> or similar.

=== Linux and macOS ===
Now that you have the decimal value of where the ROM is located, open a terminal. Type <samp><kbd>cd</kbd></samp> and press space, then drag the folder you want to save the ROM in into the terminal such as your Downloads folder then press <samp><kbd>Enter</kbd></samp>.

We will be using <samp>dd</samp> to extract the relevant bytes from the file we extracted. Type <samp><kbd>dd skip=</kbd></samp> and paste the decimal value of where the ROM is located, then press space and continue the command with <samp><kbd>count=33554432 if=</kbd></samp> then drag the file you extracted using Dolphin into the terminal to put it's path here. Press space again then continue the command with <samp><kbd>of=OcarinaOfTime.z64 bs=1</kbd></samp> and press <samp><kbd>Enter</kbd></samp>. This will create a file called
<samp>OcarinaOfTime.z64</samp> in the folder you chose earlier.

== Nintendo 64 ==
You can also dump directly from your own N64 carts too. There are many different methods to do so, but not all of them have been tested so it's not realistic to support all of them.

=== JoeyN64 Cart Flasher ===
'''Supports: Windows'''
Known working with but unsupported: Linux (Issues with updating firmware and writing files back to cart)

[https://bennvenn.myshopify.com/products/joeyn64-cart-flasher Store Page]

The JoeyN64 Cart Flasher by BennVenn focuses more on rewriting bootleg carts, but can also be used for dumping real carts as well. Generally it is pretty easy to use, however it may try to overdump Ocarina of Time ROMs if it uses a different ROM chip than expected internally. In that case you'll need to play with a hex editor to get a working ROM for randomizer. You'll also need a USB wire to plug into your computer on one end, and a USB-C plug on the other that does data transfer to plug into the device.

====Usage====

Using the JoeyN64 itself is easy. You just place the game cart into the cartridge connector, ensure that the label is facing away from the N64 controller port. Then plug the USB cable into your computer, then into the JoeyN64. It should show up like a USB drive would in This PC. Open it up and you should see a <samp>DEBUG</samp> or <samp>DEBUG.TXT</samp> file. Opening that file should open it in notepad or an equivalent text editor. Ensure that the line near the end of the file says <samp>Checksums OK!</samp> and not <samp>Checksums Bad!</samp>. If it says the checksums are bad, unplug the JoeyN64 and try reseating the cartridge. If it continues to happen, try cleaning the contacts on the cartridge with some isopropyl alcohol and a cotton swab, wait for it to dry, and try the JoeyN64 again. Once the checksums are good there should be a <samp>THE_LEGE.Z64</samp> file next to the debug text file. You can copy that to your computer. You can also backup your save file <samp>THE_LEGE.SRA</samp> here too.

You may notice that the file you copied is 64MB. This is due to hardware in the cartridge behaving differently than expected by the firmware. [[#Create ROM File From Extracted File|You'll need to cut out the excess data using a hex editor or disk dumper like for the Gamecube method]]. Just in this case you will be starting at location 0 for Windows, or skipping 0 bytes for macOS and Linux.

Once you have a 32MB file, you can use the [https://oot.flagrama.com downgrader site] to verify or downgrade your ROM to be used for the randomizer. If it is a 1.0 ROM already, you can get started using the randomizer. If it detects as a downgradable/convertable ROM you can do so to get a 1.0 ROM to use. If the site cannot detect your ROM, try again with a fresh dump copied from your cart to your PC.

====Updating Firmware====
Go to [https://bennvenn.myshopify.com/products/joeyn64-cart-flasher#firmware-updates Firmware updates] and download the newest firmware version. It should be near the top of the list. Open the downloaded zip file and copy the <samp>MODE.TXT</samp> file from the zip to the JoeyN64, then wait for it to disconnect then reconnect. Next copy the <samp>FIRMWARE.JR</samp> file and paste it in the JoeyN64. It should disconnect and then reconnect and the <samp>DEBUG.TXT</samp> file should display the new version in the top line.

Making A Backup

2023-05-01T21:54:51Z

Flagrama: /* JoeyN64 Cart Flasher */ update, add firmware updating

For using the Ranodmizer you need to have a backup copy of Ocarina of Time on your computer. This guide will demonstrate how to do this.

== Wii Virtual Console ==
The easiest method of backing up a copy of Ocarina of Time is by creating a WAD of the version installed on your Wii and then extracting that WAD using gzinject and finding the file called <samp>rom</samp> inside of the extracted contents.

=== What You Will Need ===
* [[Wii Virtual Console#Softmodding Your Wii|A Softmodded Wii]] or [[Wii Virtual Console#Softmodding Your Wii U's Virtual Wii Mode|A Softmodded vWii]]
* A Dump of your Ocarina of Time Virtual Console Channel ([https://wii.guide/dump-wads.html Wii Guide has a page on doing this])
* gzinject

=== Getting and Setting Up gzinject ===
gzinject is an application by Krim/Krimtonz originally for putting the OoT Practice ROM in a WAD, but now has a variety of uses.

'''Windows''': [https://github.com/krimtonz/gzinject/releases/download/0.3.1/win32.zip Download] then extract the zip file. To run it, open the folder with gzinject in it, then click in the address bar and type <samp><kbd>cmd</kbd></samp> and press <samp><kbd>Enter</kbd></samp>. In the terminal that shows up you should be able to type <samp><kbd>gzinject</kbd></samp> and press <samp><kbd>Enter</kbd></samp> and see a bunch of information on how to use gzinject. If you do, move on to [[#Extracting the ROM From the WAD|the next step]].

'''Linux''': Try using [https://github.com/krimtonz/gzinject/releases/download/0.3.1/ubuntuwsl64.tar.bz2 the WSL build of gzinject]. It doesn't link to many libraries so should work without recompiling. If not, [https://github.com/krimtonz/gzinject/archive/refs/tags/0.3.1.zip download the source code] and then [https://github.com/krimtonz/gzinject/blob/master/BUILDING.md follow the BUILDING file on GitHub].

'''macOS''': Currently you have to build from source. Setting up a build environment is out of scope for this guide, but once you have it set up you should be able to [https://github.com/krimtonz/gzinject/archive/refs/tags/0.3.1.zip download the source code] then [https://github.com/krimtonz/gzinject/blob/master/BUILDING.md follow the BUILDING file on GitHub]

=== Extracting the ROM From the WAD ===
Once you have a version of gzinject that runs, you'll need to find yourself the Wii common key or figure out a way to generate one. It is the same file you will need to make a WAD on the online generator as well. The file should be placed in the same folder as gzinject and called <samp>common-key.bin</samp>. Once you have that in place, gzinject should be ready for use.

To extract all of the data from your dumped WAD, open a terminal and type <samp><kbd>gzinject -a extract -w </kbd></samp>. Don't forget the space at the end. Next drag your dumped WAD onto the terminal. This should put the path to the WAD at the end. If there is not a space between the "w" and the path, use the arrow keys to go back and add the space. If so, press <samp><kbd>Enter</kbd></samp> and gzinject should now extract the WAD to a folder called <samp>wadextract</samp>.

If it does not make sure that you have the <samp>common-key.bin</samp> file in the right place, and that you typed the command in the terminal correctly, including the space.

Now if you open the <samp>wadextract</samp> folder there should be another folder inside called <samp>content5</samp> and inside of that folder is a bunch of files, but the one you are looking for is called <samp>rom</samp>. This is an Ocarina of Time 1.2 ROM that you can run in an emulator. If you want to use it for the Randomizer you will have to downgrade it to 1.0.

== Gamecube ==
Another way to to make a backup of Ocarina of Time is by ripping a Gamecube disc to an ISO using a Wii and then extracting the ROM using Dolphin.

=== What You Will Need ===
* [[Wii Virtual Console#Softmodding Your Wii|A Softmodded Wii]] or [[Wii Virtual Console#Softmodding Your Wii U's Virtual Wii Mode|A Softmodded vWii]]
* A Dump of your Ocarina of Time / Master Quest disc or Zelda Collector's Edition disc ([https://wiki.dolphin-emu.org/index.php?title=Ripping_Games Dolphin's wiki has a guide on doing this.])
* The [[Dolphin]] Emulator
* A Hex Editor and/or Binary File Manipulation Software

=== Extract File From Disc ===
First, in Dolphin you will need to have the ISO backup of your GameCube disc in the list of games in the main window. If you need to add the path the files are located in, go to <samp><kbd>Options</kbd>→<kbd>Configuration</kbd>→<kbd>Paths</kbd></samp> and click the <samp>Add...</samp> button. Next navigate to the folder with your ISO file in it and click <samp>Open</samp>.

With the backup in the game list, right-click the game and click on <samp><kbd>Properties</kbd></samp> then click on the <samp>Filesystem</samp> tab. You may need to click the arrows on the right of the tabs list to find it.

For a Ocarina of Time / Master Quest ISO, you will want to look for the <samp>zlj_f.tgc</samp> file for the US copy, if other copies do not have this file, you want the large 500MB+ size file. For Collector's Edition you want to open the <samp>tgc</samp> folder and select the <samp>zelda_ENG_090903.tgc</samp> file for the US copy, if other copies do not have this file, you want the large 480MB file. Right-click the file and click <samp>Extract File...</samp> and extract it to a folder.

=== Create ROM File From Extracted File ===
For this part you will want a hex editor for finding where the ROM is in the file we extracted.

For '''Windows''': [https://mh-nexus.de/en/hxd/ HxD] is recommended. It will also be able to copy the data you find to make a ROM file.
For '''macOS''': [https://hexfiend.com/ Hex Fiend] looks like a good choice.
For '''Linux''': Any graphical hex editor should work, or if you're experienced with <samp>hexdump</samp> that should also work.

First lets locate the ROM file in the extracted file using a hex editor. Open up the file in a hex editor, then open a find dialog. Hex Fiend has this located at the top of the window. Other software should be able to bring up one by pressing <samp><kbd>Ctrl</kbd>+<kbd>F</kbd></samp> or on macOS <samp><kbd>Command ⌘</kbd>+<kbd>F</kbd></samp>. Make sure it is in <samp>Hex</samp> mode, or you are typing in the <samp>Hex</samp> side of the window. Type <code>80 37 12 40</code> and try to search for that string. This is the "magic" header for a N64 ROM and all N64 ROMs start with these bytes.

Your hex editor should have a place on the window where it displays an "Offset" value somewhere in the window. Make sure you have the 8 or 0 in <code>80</code> selected and then write down this value. It is usually a hex value which means that it uses the numbers 0-9 and the letters A-F. Use [https://www.rapidtables.com/convert/number/hex-to-decimal.html this Hex to Decimal] converter to convert the hex number to a normal decimal number. We will use this in the next section, but the next part is OS specific.

=== Windows ===
Now that you have the decimal value of where the ROM is located, press <samp><kbd>Control</kbd>+<kbd>E</kbd></samp> to open the <samp>Select block</samp> dialog. Make sure that the radio button next to the <samp>dec</samp> option is selected. In the <samp>Start-offset</samp> text box paste or type the decimal value of where the ROM is. Next click the radio button next to <samp>Length</samp> and type in that text box <samp><kbd>33554432</kbd></samp>. Next click <samp>OK</samp> and the ROM file will now be selected.

Copy the ROM file's bytes with <samp><kbd>Ctrl</kbd>+<kbd>C</kbd></samp>, open a new file by pressing <samp><kbd>Ctrl</kbd>+<kbd>N</kbd></samp>. Next press <samp><kbd>Ctrl</kbd>+<kbd>S</kbd></samp> to save the file. Save it with a name you will remember such as <samp>Ocarina of Time.z64</samp> or similar.

=== Linux and macOS ===
Now that you have the decimal value of where the ROM is located, open a terminal. Type <samp><kbd>cd</kbd></samp> and press space, then drag the folder you want to save the ROM in into the terminal such as your Downloads folder then press <samp><kbd>Enter</kbd></samp>.

We will be using <samp>dd</samp> to extract the relevant bytes from the file we extracted. Type <samp><kbd>dd skip=</kbd></samp> and paste the decimal value of where the ROM is located, then press space and continue the command with <samp><kbd>count=33554432 if=</kbd></samp> then drag the file you extracted using Dolphin into the terminal to put it's path here. Press space again then continue the command with <samp><kbd>of=OcarinaOfTime.z64 bs=1</kbd></samp> and press <samp><kbd>Enter</kbd></samp>. This will create a file called
<samp>OcarinaOfTime.z64</samp> in the folder you chose earlier.

== Nintendo 64 ==
You can also dump directly from your own N64 carts too. There are many different methods to do so, but not all of them have been tested so it's not realistic to support all of them.

=== JoeyN64 Cart Flasher ===
'''Supports: Windows'''
Known working with but unsupported: Linux (Issues with updating firmware and writing files back to cart)

[https://bennvenn.myshopify.com/products/joeyn64-cart-flasher Store Page]

The JoeyN64 Cart Flasher by BennVenn focuses more on rewriting bootleg carts, but can also be used for dumping real carts as well. Generally it is pretty easy to use, however it may try to overdump Ocarina of Time ROMs if it uses a different ROM chip than expected internally. In that case you'll need to play with a hex editor to get a working ROM for randomizer. You'll also need a USB wire to plug into your computer on one end, and a USB-C plug on the other that does data transfer to plug into the device.

====Usage====

Using the JoeyN64 itself is easy. You just place the game cart into the cartridge connector, ensure that the label is facing away from the N64 controller port. Then plug the USB cable into your computer, then into the JoeyN64. It should show up like a USB drive would in This PC. Open it up and you should see a <samp>DEBUG</samp> or <samp>DEBUG.TXT</samp> file. Opening that file should open it in notepad or an equivalent text editor. Ensure that the line near the end of the file says <samp>Checksums OK!</samp> and not <samp>Checksums Bad!</samp>. If it says the checksums are bad, unplug the JoeyN64 and try reseating the cartridge. If it continues to happen, try cleaning the contacts on the cartridge with some isopropyl alcohol and a cotton swab, wait for it to dry, and try the JoeyN64 again. Once the checksums are good there should be a <samp>THE_LEGE.Z64</samp> file next to the debug text file. You can copy that to your computer. You can also backup your save file <samp>THE_LEGE.SRA</samp> here too.

You may notice that the file you copied is 64MB. This is due to hardware in the cartridge behaving differently than expected by the firmware. [[#Create ROM File From Extracted File|You'll need to cut out the excess data using a hex editor or disk dumper like for the Gamecube method]]. Just in this case you will be starting at location 0 for Windows, or skipping 0 bytes for macOS and Linux.

Once you have a 32MB file, you can use the [https://oot.flagrama.com downgrader site] to verify or downgrade your ROM to be used for the randomizer. If it is a 1.0 ROM already, you can get started using the randomizer. If it detects as a downgradable/convertable ROM you can do so to get a 1.0 ROM to use. If the site cannot detect your ROM, try again with a fresh dump copied from your cart to your PC.

====Updating Firmware====
Go to [https://bennvenn.myshopify.com/products/joeyn64-cart-flasher#firmware-updates Firmware updates] and download the newest firmware version. It should be near the top of the list. Open the downloaded zip file and copy the <samp>MODE.TXT</samp> file from the zip to the JoeyN64, then wait for it to disconnect then reconnect. Next copy the <samp>FIRMWARE.JR</samp> file and paste it in the JoeyN64. It should disconnect and then reconnect and the <samp>DEBUG.TXT</samp> file should display the new version in the top line.