OoT Randomizer Wiki - User contributions [en]

GGJ

2023-11-05T22:11:48Z

Dotzo:

Below is the list of allowed and banned techniques for the Glitchless + Ground Jumps (GGJ) ruleset. Because this was based on a ruleset from the vanilla game, you may notice significant differences in the level of detail in describing what is allowed or banned when comparing to the Standard ruleset. Please feel free to assume that if it is not listed, and doesn't otherwise violate one of the explicitly banned conditions, that it is allowed.

This ruleset will update over time to include new discoveries as they are made, however the goal of banning only by technique - regardless of the consequences - will remain in effect.

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 GGJ Ruleset races.''

=== Allowed ===
*Power Crouch Stabbing
*Roll invincibility
*Post-damage invincibility
*Jumpslashing in mid-air for more distance
*Shield dropping
*Using broken deku stick
*Hookshot Extension
*Rolling from the blue switch in Jabu Jabu's Belly
*Damage Boosting
*Damage Buffering
*Placing bombs on lava pits to damage Volvagia
*Skipping text triggers via weapon swapping
*Passing through the back side of a one-sided collision
**EG: bridge clip, darunia's door, forest's falling ceiling
*Attacking to collect or hit an object on the other side of a collision
*Antigravity
**EG: b1 skip, unloading Gerudo Fortress
*Recoil Jump
**Shielding damage midair to take Link out of a backflip or sidehop and into a normal airborne state
*Ground Jumps
**NB: This is included despite being a glitch as it is functionally similar to a Recoil Jump as well as much easier
*Twisted sidehops or backflips out of siderolls or standing ESS shuffles
*Touching misplaced or accidentally-exposed loading zones
**EG: Early Jabu, Trials skip, Market shops at night
*Delaying a timer by pressing cutscene items midair
*Going out of bounds
**NB: The method of reaching OoB must not violate any other rules
*Being in an unloaded area
*Hoverboosting
**IE: Using hoverboots to conserve momentum from recoil via hammer or damage
*Megajumps
**IE: Using hoverboots to concerve momentum from damage during a jump
*Remote wall interactions
*Walking on walls
*Culling actors
**EG: keeping enemies off screen to stop them from moving
*Climbing ladders or vines during cutscenes
*Cutscene skips which use only movement from inputs completed before the cutscene begins
**EG: voiding, entering a loading zone

=== Banned ===
*Infinite Sword Glitch
*Megaflip and megasidehop
*All forms of superslide
*Hovering
*Entrance point glitch or other respawn point manipulation
*Clipping
**NB: This is well defined for both solid collision and soft/actor collision, contact a moderator if you aren't sure if something is a clip
*Cutscene diving to sink into water
*Flame storage
*Item Manipulation
**This is an umbrella term covering the glitches Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*Using collection delay to your advantage
**EG: early eyeball frog or gold scale
**NB: Delay happens naturally in many shops if you buy quickly, this is ok
*Something except for a sword on B
**NB: This does not include normal circumstances like riding Epona
*Bottle Duplication
*Wrong warp
*Void warp
*Walking While Talking
*Causing a switch to remain pressed longer than it should
*Ocarina Items
*Z-slide
*A-slide
*Using restricted items
**IE: Farore's Wind in the Overworld or Ocarina in boss rooms
*Unloading an actor which clearly should be loaded
**EG: Actor Glitch, unloading KZ's ice, overloading the graveyard or trials to remove graves or Gold Gauntlet monoliths, pause buffering the timer expiration during the diving minigame
*SRM (Stale Reference Manipulation)
*Abusing actors which have not had a chance to update after loading
**IE: 0,0,0 glitch and the deku b2 web
*Swimming laterally while wearing Iron Boots
*Opening underwater chests while wearing the Iron Boots
*Action Swap
**NB: This includes using the explosion limit to Ground Jump
*Using the effects of Quick Putaway
**EG: Lighting a torch with a Deku Stick with no present fire source.
*Equip Swap
*Ledge Cancel
*Retaining the Master Sword in Phase 1 of the Ganon Fight
*Dying to achieve anything other than a deathwarp

[[Category:Racing Rules]]

Season 7 Tournament Rules

2023-10-28T13:41:59Z

Dotzo:

This page will contain all of the Alterations and Addenda to the [[GGJ|Base Ruleset]] for use during the Season 7 Tournament.

The [[GGJ|Base Ruleset]] can be referenced for the general bans and allowances. Should any new technique be found, refer to this first to see if it is allowed before referring to a decision by the Racemods for if it will be applicable to Season 7.

=Alterations=
This section will contain any additional bans as well as any additional allowances which differ from the [[GGJ|Base Ruleset]].

==Additional Bans==
*Wall Walking
*Damage Boosting
*Doing a Groundjump while midair in the Hoverboots
*Accessing the Adult side of Spirit Temple as Child

==Additional Allowances==
*Flame Storage
*Opening chests underwater
*Swimming with Iron Boots

=Addenda=
This section will contain a list of goals or requirements which must be met to perform certain actions within the game, as well as any circumstantal suspensions of the aforementioned rules.
*Gerudo Valley Bridge
**Must use Longshot or Epona to cross

*Gerudo Valley Fortress Side
**Must use Longshot, Epona, Requiem + Reverse Wasteland, or a consequence of Entrance Randomizer to reach this area
***NB: Cucco Jump is not allowed

*Death Mountain Crater Bridge
**Must use Hookshot, Longshot, Hoverboots, or a Bean to cross this gap

*Shadow Temple Entrance
**Torches must be lit using Din's Fire and Magic

*Shadow Temple Falling Spikes
**Clipping through these is allowed

*Shadow Temple Wind Room
**Hookshot or Longshot must be used to access this area

*Spirit Temple Boss Door
**Hookshot or Longshot must be used on the grate to access this area

==Notable Implications==
Here we will list large sequence breaks which may not be obvious from previous rulings.

===KZ Skip as Adult===
You may use a precise jump to grab the wall next to KZ and proceed to Ice Cavern without Ruto's Letter

===Water Temple Entrance===
You may enter the Water Temple entrance with a precise Hookshot and the Gold Scale

Season 7 Tournament Rules

2023-10-28T13:41:04Z

Dotzo:

Season 7 Tournament Rules

2023-10-28T13:39:04Z

Dotzo: /* Additional Bans */

Season 7 Tournament Rules

2023-10-28T13:38:45Z

Dotzo:

This page will contain all of the Alterations and Addenda to the [[GGJ|Base Ruleset]] for use during the Season 7 Tournament.

The [[GGJ|Base Ruleset]] can be referenced for the general bans and allowances. Should any new technique be found, refer to this first to see if it is allowed before referring to a decision by the Racemods for if it will be applicable to Season 7.

=Alterations=
This section will contain any additional bans as well as any additional allowances which differ from the [[GGJ|Base Ruleset]].

==Additional Bans==
*WallWalking
*Damage Boosting
*Doing a Groundjump while midair in the Hoverboots
*Accessing the Adult side of Spirit Temple as Child

==Additional Allowances==
*Flame Storage
*Opening chests underwater
*Swimming with Iron Boots

=Addenda=
This section will contain a list of goals or requirements which must be met to perform certain actions within the game, as well as any circumstantal suspensions of the aforementioned rules.
*Gerudo Valley Bridge
**Must use Longshot or Epona to cross

*Gerudo Valley Fortress Side
**Must use Longshot, Epona, Requiem + Reverse Wasteland, or a consequence of Entrance Randomizer to reach this area
***NB: Cucco Jump is not allowed

*Death Mountain Crater Bridge
**Must use Hookshot, Longshot, Hoverboots, or a Bean to cross this gap

*Shadow Temple Entrance
**Torches must be lit using Din's Fire and Magic

*Shadow Temple Falling Spikes
**Clipping through these is allowed

*Shadow Temple Wind Room
**Hookshot or Longshot must be used to access this area

*Spirit Temple Boss Door
**Hookshot or Longshot must be used on the grate to access this area

Season 7 Tournament Rules

2023-09-18T20:03:07Z

Dotzo: Demo of the proposed rule layout

This page will contain all of the Alterations and Addenda to the [[GGJ|Base Ruleset]] for use during the Season 7 Tournament.

The [[GGJ|Base Ruleset]] can be referenced for the general bans and allowances. Should any new technique be found, refer to this first to see if it is allowed before referring to a decision by the Racemods for if it will be applicable to Season 7.

=Altertions=
This section will contain any additional bans as well as any additional allowances which differ from the [[GGJ|Base Ruleset]].

==Additional Bans==
*WallWalking
*Damage Boosting
*Doing a Groundjump while midair in the Hoverboots
*Accessing the Adult side of Spirit Temple as Child

==Additional Allowances==
*Flame Storage
*Opening chests underwater
*Swimming with Iron Boots

=Addenda=
This section will contain a list of goals or requirements which must be met to perform certain actions within the game, as well as any circumstantal suspensions of the aforementioned rules.
*Gerudo Valley Bridge
**Must use Longshot or Epona to cross

*Gerudo Valley Fortress Side
**Must use Longshot, Epona, Requiem + Reverse Wasteland, or a consequence of Entrance Randomizer to reach this area
***NB: Cucco Jump is not allowed

*Death Mountain Crater Bridge
**Must use Hookshot, Longshot, Hoverboots, or a Bean to cross this gap

*Shadow Temple Entrance
**Torches must be lit using Din's Fire and Magic

*Shadow Temple Falling Spikes
**Clipping through these is allowed

*Shadow Temple Wind Room
**Hookshot or Longshot must be used to access this area

*Spirit Temple Boss Door
**Hookshot or Longshot must be used on the grate to access this area

GGJ

2022-11-02T17:59:41Z

Dotzo: /* Banned */

Below is the list of allowed and banned techniques for the Glitchless + Ground Jumps (GGJ) ruleset. Because this was based on a ruleset from the vanilla game, you may notice significant differences in the level of detail in describing what is allowed or banned when comparing to the Standard ruleset. Please feel free to assume that if it is not listed, and doesn't otherwise violate one of the explicitly banned conditions, that it is allowed.

This ruleset will update over time to include new discoveries as they are made, however the goal of banning only by technique - regardless of the consequences - will remain in effect.

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 GGJ Ruleset races.''

=== Allowed ===
*Power Crouch Stabbing
*Roll invincibility
*Post-damage invincibility
*Jumpslashing in mid-air for more distance
*Shield dropping
*Using broken deku stick
*Hookshot Extension
*Rolling from the blue switch in Jabu Jabu's Belly
*Damage Boosting
*Damage Buffering
*Placing bombs on lava pits to damage Volvagia
*Skipping text triggers via weapon swapping
*Passing through the back side of a one-sided collision
**EG: bridge clip, darunia's door, forest's falling ceiling
*Attacking to collect or hit an object on the other side of a collision
*Momentary Antigravity
**EG: b1 skip
*Recoil Jump
**Shielding damage midair to take Link out of a backflip or sidehop and into a normal airborne state
*Ground Jumps
**NB: This is included despite being a glitch as it is functionally similar to a Recoil Jump as well as much easier
*Twisted sidehops or backflips out of siderolls or standing ESS shuffles
*Touching misplaced or accidentally-exposed loading zones
**EG: Early Jabu, Trials skip, Market shops at night
*Delaying a timer by pressing cutscene items midair
*Going out of bounds
**NB: The method of reaching OoB must not violate any other rules
*Being in an unloaded area
*Hoverboosting
**IE: Using hoverboots to conserve momentum from recoil via hammer or damage
*Megajumps
**IE: Using hoverboots to concerve momentum from damage during a jump
*Remote wall interactions
*Walking on walls
*Culling actors
**EG: keeping enemies off screen to stop them from moving
*Climbing ladders or vines during cutscenes
*Cutscene skips which use only movement from inputs completed before the cutscene begins
**EG: voiding, entering a loading zone

=== Banned ===
*Infinite Sword Glitch
*Megaflip and megasidehop
*Extended Antigravity
**EG: unloading lower gerudo fortress
*All forms of superslide
*Hovering
*Entrance point glitch or other respawn point manipulation
*Clipping
**NB: This is well defined for both solid collision and soft/actor collision, contact a moderator if you aren't sure if something is a clip
*Cutscene diving to sink into water
*Flame storage
*Item Manipulation
**This is an umbrella term covering the glitches Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*Using collection delay to your advantage
**EG: early eyeball frog or gold scale
**NB: Delay happens naturally in many shops if you buy quickly, this is ok
*Something except for a sword on B
**NB: This does not include normal circumstances like riding Epona
*Bottle Duplication
*Wrong warp
*Void warp
*Walking While Talking
*Causing a switch to remain pressed longer than it should
*Ocarina Items
*Z-slide
*A-slide
*Using restricted items
**IE: Farore's Wind in the Overworld or Ocarina in boss rooms
*Unloading an actor which clearly should be loaded
**EG: Actor Glitch, unloading KZ's ice, overloading the graveyard or trials to remove graves or Gold Gauntlet monoliths, pause buffering the timer expiration during the diving minigame
*SRM (Stale Reference Manipulation)
*Abusing actors which have not had a chance to update after loading
**IE: 0,0,0 glitch and the deku b2 web
*Swimming laterally while wearing Iron Boots
*Opening underwater chests while wearing the Iron Boots
*Action Swap
**NB: This includes using the explosion limit to Ground Jump
*Using the effects of Quick Putaway
**EG: Lighting a torch with a Deku Stick with no present fire source.
*Equip Swap
*Ledge Cancel
*Retaining the Master Sword in Phase 1 of the Ganon Fight
*Dying to achieve anything other than a deathwarp

[[Category:Racing Rules]]

GGJ

2022-11-02T17:59:15Z

Dotzo: /* Allowed */

Below is the list of allowed and banned techniques for the Glitchless + Ground Jumps (GGJ) ruleset. Because this was based on a ruleset from the vanilla game, you may notice significant differences in the level of detail in describing what is allowed or banned when comparing to the Standard ruleset. Please feel free to assume that if it is not listed, and doesn't otherwise violate one of the explicitly banned conditions, that it is allowed.

This ruleset will update over time to include new discoveries as they are made, however the goal of banning only by technique - regardless of the consequences - will remain in effect.

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 GGJ Ruleset races.''

=== Allowed ===
*Power Crouch Stabbing
*Roll invincibility
*Post-damage invincibility
*Jumpslashing in mid-air for more distance
*Shield dropping
*Using broken deku stick
*Hookshot Extension
*Rolling from the blue switch in Jabu Jabu's Belly
*Damage Boosting
*Damage Buffering
*Placing bombs on lava pits to damage Volvagia
*Skipping text triggers via weapon swapping
*Passing through the back side of a one-sided collision
**EG: bridge clip, darunia's door, forest's falling ceiling
*Attacking to collect or hit an object on the other side of a collision
*Momentary Antigravity
**EG: b1 skip
*Recoil Jump
**Shielding damage midair to take Link out of a backflip or sidehop and into a normal airborne state
*Ground Jumps
**NB: This is included despite being a glitch as it is functionally similar to a Recoil Jump as well as much easier
*Twisted sidehops or backflips out of siderolls or standing ESS shuffles
*Touching misplaced or accidentally-exposed loading zones
**EG: Early Jabu, Trials skip, Market shops at night
*Delaying a timer by pressing cutscene items midair
*Going out of bounds
**NB: The method of reaching OoB must not violate any other rules
*Being in an unloaded area
*Hoverboosting
**IE: Using hoverboots to conserve momentum from recoil via hammer or damage
*Megajumps
**IE: Using hoverboots to concerve momentum from damage during a jump
*Remote wall interactions
*Walking on walls
*Culling actors
**EG: keeping enemies off screen to stop them from moving
*Climbing ladders or vines during cutscenes
*Cutscene skips which use only movement from inputs completed before the cutscene begins
**EG: voiding, entering a loading zone

=== Banned ===
*Infinite Sword Glitch
*Megaflip and megasidehop
*Extended Antigravity
**EG: unloading lower gerudo fortress
*All forms of superslide
*Hovering
*Entrance point glitch or other respawn point manipulation
*Clipping
**NB: This is well defined for both solid collision and soft/actor collision, contact a moderator if you aren't sure if something is a clip
*Cutscene diving to sink into water
*Flame storage
*Item Manipulation
**This is an umbrella term covering the glitches Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*Using collection delay to your advantage
**EG: early eyeball frog or gold scale
**NB: Delay happens naturally in many shops if you buy quickly, this is ok
*Something except for a sword on B
**NB: This does not include normal circumstances like riding Epona
*Bottle Duplication
*Wrong warp
*Void warp
*Walking While Talking
*Causing a switch to remain pressed longer than it should
*Ocarina Items
*Z-slide
*A-slide
*Using restricted items
**IE: Farore's Wind in the Overworld or Ocarina in boss rooms
*Being in an unloaded area
*Unloading an actor which clearly should be loaded
**EG: Actor Glitch, unloading KZ's ice, overloading the graveyard or trials to remove graves or Gold Gauntlet monoliths, pause buffering the timer expiration during the diving minigame
*SRM (Stale Reference Manipulation)
*Abusing actors which have not had a chance to update after loading
**IE: 0,0,0 glitch and the deku b2 web
*Opening underwater chests while wearing the Iron Boots
*Action Swap
**NB: This includes using the explosion limit to Ground Jump
*Using the effects of Quick Putaway
**EG: Lighting a torch with a Deku Stick with no present fire source.
*Equip Swap
*Ledge Cancel
*Retaining the Master Sword in Phase 1 of the Ganon Fight
*Dying to achieve anything other than a deathwarp

[[Category:Racing Rules]]

GGJ

2022-11-02T17:57:34Z

Dotzo: /* Allowed */

Below is the list of allowed and banned techniques for the Glitchless + Ground Jumps (GGJ) ruleset. Because this was based on a ruleset from the vanilla game, you may notice significant differences in the level of detail in describing what is allowed or banned when comparing to the Standard ruleset. Please feel free to assume that if it is not listed, and doesn't otherwise violate one of the explicitly banned conditions, that it is allowed.

This ruleset will update over time to include new discoveries as they are made, however the goal of banning only by technique - regardless of the consequences - will remain in effect.

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 GGJ Ruleset races.''

=== Allowed ===
*Power Crouch Stabbing
*Roll invincibility
*Post-damage invincibility
*Jumpslashing in mid-air for more distance
*Shield dropping
*Using broken deku stick
*Hookshot Extension
*Rolling from the blue switch in Jabu Jabu's Belly
*Damage Boosting
*Damage Buffering
*Placing bombs on lava pits to damage Volvagia
*Skipping text triggers via weapon swapping
*Passing through the back side of a one-sided collision
**EG: bridge clip, darunia's door, forest's falling ceiling
*Attacking to collect or hit an object on the other side of a collision
*Momentary Antigravity
**EG: b1 skip
*Recoil Jump
**Shielding damage midair to take Link out of a backflip or sidehop and into a normal airborne state
*Ground Jumps
**NB: This is included despite being a glitch as it is functionally similar to a Recoil Jump as well as much easier
*Twisted sidehops or backflips out of siderolls or standing ESS shuffles
*Touching misplaced or accidentally-exposed loading zones
**EG: Early Jabu, Trials skip, Market shops at night
*Delaying a timer by pressing cutscene items midair
*Going out of bounds
**NB: The method of reaching OoB must not violate any other rules
*Being in an unloaded area
*Hoverboosting
**IE: Using hoverboots to conserve momentum from recoil via hammer or damage
*Megajumps
**IE: Using hoverboots to concerve momentum from damage during a jump
*Remote wall interactions
*Walking on walls
*Culling actors
**EG: keeping enemies off screen to stop them from moving
*Swimming laterally while wearing Iron Boots
*Climbing ladders or vines during cutscenes
*Cutscene skips which use only movement from inputs completed before the cutscene begins
**EG: voiding, entering a loading zone

=== Banned ===
*Infinite Sword Glitch
*Megaflip and megasidehop
*Extended Antigravity
**EG: unloading lower gerudo fortress
*All forms of superslide
*Hovering
*Entrance point glitch or other respawn point manipulation
*Clipping
**NB: This is well defined for both solid collision and soft/actor collision, contact a moderator if you aren't sure if something is a clip
*Cutscene diving to sink into water
*Flame storage
*Item Manipulation
**This is an umbrella term covering the glitches Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*Using collection delay to your advantage
**EG: early eyeball frog or gold scale
**NB: Delay happens naturally in many shops if you buy quickly, this is ok
*Something except for a sword on B
**NB: This does not include normal circumstances like riding Epona
*Bottle Duplication
*Wrong warp
*Void warp
*Walking While Talking
*Causing a switch to remain pressed longer than it should
*Ocarina Items
*Z-slide
*A-slide
*Using restricted items
**IE: Farore's Wind in the Overworld or Ocarina in boss rooms
*Being in an unloaded area
*Unloading an actor which clearly should be loaded
**EG: Actor Glitch, unloading KZ's ice, overloading the graveyard or trials to remove graves or Gold Gauntlet monoliths, pause buffering the timer expiration during the diving minigame
*SRM (Stale Reference Manipulation)
*Abusing actors which have not had a chance to update after loading
**IE: 0,0,0 glitch and the deku b2 web
*Opening underwater chests while wearing the Iron Boots
*Action Swap
**NB: This includes using the explosion limit to Ground Jump
*Using the effects of Quick Putaway
**EG: Lighting a torch with a Deku Stick with no present fire source.
*Equip Swap
*Ledge Cancel
*Retaining the Master Sword in Phase 1 of the Ganon Fight
*Dying to achieve anything other than a deathwarp

[[Category:Racing Rules]]

Dolphin

2021-10-07T15:16:33Z

Dotzo:

'''Please keep in mind that:'''
<ol style="color: red;">
<li>'''Dolphin has not been tested extensively for OoTR.'''</li>
<li>'''Using Dolphin for racing is against our community's racing rules.'''</li>
</ol>

Dolphin is a popular emulator for both Gamecube and Wii games, but it can also be used to play Ocarina of Time Randomizer on thru the Wii's Virtual Console mode. Dolphin is very good at emulating Wii VC and only suffers from potential slight additional lag in certain areas (such as Market as child), which can be mitigated using settings discussed below.

While Dolphin will be used as a Wii emulator, it is actually much simpler than setting up a Wii. There is no need to softmod, move data onto an SD card, or install a WAD. That being said, there are some steps that need to be taken first.

== First Time Dolphin User Set Up ==

[https://dolphin-emu.org/download/ Download the latest beta release of Dolphin.] Like other emulators, you will need the latest beta release of Dolphin rather than the latest stable release. Note that, by default, Dolphin will check for a new beta release monthly and auto-update. You will need a version specific to the operating system you use, see below for details.

=== Windows ===

Once Dolphin is downloaded, extract the zip and open Dolphin.exe. You should see something like this (except that, if this is your first time, your games list will be empty):

[[File:DolphinHome.png|RTENOTITLE]]

Note the buttons within the red box, these will be used in the upcoming steps. The first thing you will want to do is create a game directory. Go to <kbd><samp>Config</samp> ⇒ <samp>Paths</samp> ⇒ <samp>Add...</samp></kbd> and select the directory in which you would like your games to be placed. You can even have multiple game directories, if you wish. This will then cause any .iso or .wad files in your selected directory to show up in the home menu, as seen above.

[[File:DolphinPaths.png|RTENOTITLE]]

=== Mac OS ===

On the Dolphin page, download the latest MacOS Intel version and drag to Application folder per normal installation.

[[File:MacDownloadPage.png|Mac Download Page]]

The Disk Image (DMG) will include Dolphin and the Dolphin Updater.

[[File:DMG.png|Mac OS Dolphin DMG]]

Similar to the Windows setup, create a filepath directory to where the WAD will be located.

[[File:DolphinMacEmu.png|Dolphin main screen]]

=== Controller Configuration ===

Click on <kbd><samp>Controllers</samp></kbd> on the home page. Controllers can be setup either as "GameCube Controllers", or as "Wii Remotes". For the purpose of the randomizer your controller will need to be configured as a "GameCube Controller" (even if it is, say, an Xbox controller). Under Gamecube controllers, click <samp>Configure</samp> next to Port 1.

[[File:DolphinControlConfig1.png|275px|DolphinControlConfig1.png]]

If you are using a Gamecube Controller with a Wii U Adapter by either Nintendo or Mayflash (Wii U mode), then your controller should be detected and configured automatically and the new window that opens will simply ask you to enable/disable the Rumble Pak.

[[File:Gcnadapter.png|RTENOTITLE]]

For reference, these are the default controller mappings Dolphin will use. Keep in mind that if you've used the webpatcher, or gzinjectgui with the right configuration, that D-pad left/right/down will be overwritten to properly work with boots/ocarina on D-pad.

[[File:Gamecube Controls.png|RTENOTITLE]]

If you are using any other controller, or if you're using a Gamecube adapter in PC mode, then you will need to configure the controller yourself. Note that, even if you have a controller with analog triggers, you must set <samp>L</samp> and <samp>R</samp> for the buttons to work properly, not just <samp>L-Analog</samp> and <samp>R-Analog</samp>. Below shows a sample controller config with an Xbox controller.

[[File:DolphinControlConfig2.png|725px|DolphinControlConfig2.png]]

[[File:DolphinControlerConfig.png|Controller Configuration screen]]

== Randomizer Dolphin Set Up ==

So, now you have either just finished setting up Dolphin for the first time, or are an experienced Dolphin user. There are a few more settings that must be set to certain values to properly play the randomizer.

First, under <kbd><samp>Config</samp> ⇒ <samp>General</samp></kbd> make sure that <samp>Allow Mismatched Region Settings</samp> is unchecked and <samp>Fallback Region</samp> is set to <samp>NTSC-J</samp>. This ensures that you don't get a PAL frame rate.

[[File:DolphinRegion.png|350px|DolphinRegion.png]]

Next, close the window and under <kbd><samp>Options</samp> ⇒ <samp>Graphics Settings</samp> ⇒ <samp>Hacks</samp></kbd>, ensure that <samp>Store EFB Copies to Texture Only</samp> is unchecked. This fixes the black pause screens

[[File:EFBImage.png|Setting for EFB]]

=== Enable FPS Display ===

Under <kbd><samp>Options</samp> ⇒ <samp>Graphics Settings</samp> ⇒ <samp>General</samp></kbd>, check the box which says <samp>Show FPS</samp>.

== Starting a Seed ==

This is the only part of setting up Dolphin which is similar to the set up for Wii VC. [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Generating_a_Seed Refer to the "Generating a Seed" section on the Wii VC page for how to generate a WAD.]

After generating the WAD, place it in your game directory. It should appear in your home menu. Double-clicking the seed should then launch it the same way any other .iso is launched from Dolphin, no NAND installation or Wii channel required. If there is already an in-game save file present, delete it before starting the new seed.

== After Finishing a Seed ==

Since all OoTR WADs use the same internal ID, Dolphin will consider them all the same game, meaning saves will carry over between seeds. You'll just need to delete the old save data to make room for a new save.

== Optional Settings ==

=== Recommended Baseline Settings ===

If you are experiencing lag, these are optional settings to change from default.

First go to <kbd><samp>Options</samp> ⇒ <samp>Graphics Settings</samp></kbd>, and then in the <samp>General</samp> tab change the <samp>Backend</samp> from <samp>OpenGL</samp> to <samp>Vulcan</samp> if you are on Windows. Dolphin recommends switching this driver as there may or may not be performance driven issues using OpenGL and its compatibility: [https://dolphin-emu.org/docs/guides/performance-guide/ Dolphin Performance Page]

[[File:VideoDriver.png|Video Driver Screen]]

Second, there are optional graphics settings enabled for more frame rate heavy games which are not required for Ocarina of Time. Below are some settings to verify if you are experiencing lag and what to uncheck.

[[File:VulcanGraphicsConfigEnhancements.png|Under the Enhancements tab]]

[[File:VulcanGraphicsConfigAdvanced.png|Advanced Tab]]

=== Graphical Enhancements ===

Depending on the power of your computer, you may want to enable some graphics enhancements. If your computer can handle it as it makes games look much nicer. Back on the home page, go to <kbd><samp>Options</samp> ⇒ <samp>Graphics Settings</samp> ⇒ <samp>Enhancements</samp></kbd>. There is no exact guide for what to do here, mouse over each individual component to see what it does. If your computer is powerful enough, you can probably enable most things without worrying about it. Otherwise, you may have to do some trial and error to figure out what your computer can handle. <samp>Per-Pixel Lighting</samp> and <samp>Anti-Aliasing</samp> above 4x are particularly demanding. <samp>Post-Processing Effects</samp> are mostly gimmicks.

[[File:DolphinEnhancements.png|350px|DolphinEnhancements.png]]

=== Aspect Ratio ===

Go to <kbd><samp>Options</samp> ⇒ <samp>Graphics Settings</samp> ⇒ <samp>General</samp> ⇒ <samp>Aspect Ratio</samp> </kbd>, and select whatever you prefer. Note that if you update Dolphin, this setting may return to its default state of 16x9.

[[File:DolphinAspect.png|RTENOTITLE]]

== Troubleshooting ==

These are common issues with running Dolphin. If you are having issues, try any of these that seem like they may help. If you continue to have problems running the randomizer in Dolphin, please come to <kbd><samp>#setup-support</samp></kbd> on [https://discord.gg/q6m6kzK our Discord].

=== MacOS will not open Dolphin ===

Some security settings may affect whether the application has privledges to write to a file directory. This can be overridden by giving permission to Dolphin to write to Finder. Open Terminal and in the command line copy these two commands and run them in one after the other:

<samp>sudo xattr -r -d com.apple.quarantine /path/to/Dolphin.app</samp>

<samp>sudo xattr -r -d com.apple.quarantine /path/to/DolphinUpdater.app</samp>

Change where it says path to your path directory location before running the command. You can copy the path by right clicking Dolphin.app with <samp>Opt key</samp> held and click <samp>Copy Path Name</samp>.

After running the commands, Dolphin should reopen normally.

=== Performance may be poor message on startup ===

When starting the emulator, yellow text may appear which says "Performance may be poor". This only occurs on older computers or computers with specifications lower than Dolphin recommends. Refer to the previous section on Optional Settings to decrease Graphical Enhancements and change Video Driver. Actual gameplay may not be affected, however you may experience some lag.

[[File:PerformanceMayBePoor.png|Performance may be poor]]

=== The Game is Running Slowly/Less than 20 FPS ===

The first thing you need to do in this case is look to the top left of your emulation window. There it should display both FPS and VPS. FPS is the framerate of the game you're running, while VPS is the framerate of Dolphin's output. Based on the VPS value, continue to one of the following subsections.

[[File:DolphinVPS.png|RTENOTITLE]]

==== VPS is less than 60 and unstable ====

If this is the case, your computer can not handle the current emulation, you should turn down some of [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Graphical_Enhancements your graphical enhancements].

==== VPS is stable at 50 ====

There is likely some issue with the region being stuck at PAL, ensure you took the proper steps regarding the region in [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Randomizer_Dolphin_Set_Up Randomizer Dolphin Set Up].

==== VPS is stable at 60 ====

This one is much trickier, as this implies that, as far as the emulator is concerned, the game is running at full frame rate. '''This should be a last resort''', go to <kbd><samp>Config</samp> ⇒ <samp>Advanced</samp> ⇒ <samp>Clock Override</samp></kbd>, checking <samp>Enable Emulated CPU Clock Override</samp>, and setting the slider to 200% (or whatever number seems to work for you). '''This is not allowed for racing.'''

[[File:DolphinOverclock.png|RTENOTITLE]]

=== The Wii Home Menu Randomly Pops Up ===

Click on <kbd><samp>Controllers</samp></kbd> on the home page and then either untick <samp>Background Input</samp> (your controller inputs will still be registered with this setting unticked even when the window is unfocused), or change the <samp>HOME</samp> binding of <samp>Wii Remote 1</samp>.

=== GFX FIFO Unknown Opcode on Resetting ===

This is a known bug with resetting VC on Dolphin. You can click OK on both dialogs that pop up and then won't have to worry about it again until you restart Dolphin itself. You can also go to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp> ⇒ <samp>Interface</samp></kbd> and disable <samp>Use Panic Handlers</samp> to always ignore it.

Dolphin

2021-10-06T20:07:49Z

Dotzo:

'''Please keep in mind that:'''
<ol style="color: red;">
'''<li>Dolphin has not been tested extensively for OoTR.</li>'''
'''<li>Using Dolphin for racing is against our community's racing rules.</li>'''
</ol>

Dolphin is a popular emulator for both Gamecube and Wii games, but it can also be used to play Ocarina of Time Randomizer on thru the Wii's Virtual Console mode. Dolphin is very good at emulating Wii VC and only suffers from potential slight additional lag in certain areas (such as Market as child), which can be mitigated using settings discussed below. However, compared to N64 emulators Dolphin inherits the advantages of faster load times and faster pausing from Wii VC. It's also not as resource intensive as some of the alternatives. That being said, playing OoTR on Dolphin is still largely experimental, and this page will be updated as more issues and fixes for those issues are found.

While Dolphin will be used as a Wii emulator, it is actually much simpler than setting up a Wii. There is no need to softmod, move data onto an SD card, or install a WAD. That being said, there are some steps that need to be taken first.

== First Time Dolphin User Set Up ==

[https://dolphin-emu.org/download/ Download the latest beta release of Dolphin.] Like other emulators, you will need the latest beta release of Dolphin rather than the latest stable release. Note that, by default, Dolphin will check for a new beta release monthly and auto-update. You will need a version specific to the operating system you use, see below for details.

=== Windows ===

Once Dolphin is downloaded, extract the zip and open Dolphin.exe. You should see something like this (except that, if this is your first time, your games list will be empty):

[[File:DolphinHome.png]]

Note the buttons within the red box, these will be used in the upcoming steps. The first thing you will want to do is create a game directory. Go to <kbd><samp>Config</samp> ⇒ <samp>Paths</samp> ⇒ <samp>Add...</samp></kbd> and select the directory in which you would like your games to be placed. You can even have multiple game directories, if you wish. This will then cause any .iso or .wad files in your selected directory to show up in the home menu, as seen above.

[[File:DolphinPaths.png]]

Click on <kbd><samp>Controllers</samp></kbd> on the home page. Controllers can be setup either as "GameCube Controllers", or as "Wii Remotes". For the purpose of the randomizer your controller will need to be configured as a "GameCube Controller" (even if it is, say, an Xbox controller). Under Gamecube controllers, click <samp>Configure</samp> next to Port 1.

[[File:DolphinControlConfig1.png|275px]]

If you are using a Gamecube Controller with a Wii U Adapter by either Nintendo or Mayflash (Wii U mode), then your controller should be detected and configured automatically and the new window that opens will simply ask you to enable/disable the Rumble Pak.

[[File:Gcnadapter.png]]

For reference, these are the default controller mappings Dolphin will use. Keep in mind that if you've used the webpatcher, or gzinjectgui with the right configuration, that D-pad left/right/down will be overwritten to properly work with boots/ocarina on D-pad.

[[File:Gamecube Controls.png]]

If you are using any other controller, or if you're using a Gamecube adapter in PC mode, then you will need to configure the controller yourself. Note that, even if you have a controller with analog triggers, you must set <samp>L</samp> and <samp>R</samp> for the buttons to work properly, not just <samp>L-Analog</samp> and <samp>R-Analog</samp>. Below shows a sample controller config with an Xbox controller.

[[File:DolphinControlConfig2.png|725px]]

=== Mac OS ===
On the Dolphin page, download the latest MacOS Intel version and drag to Application folder per normal installation.

[[File:MacDownloadPage.png|Mac Download Page]]

The Disk Image (DMG) will include Dolphin and the Dolphin Updater.

[[File:DMG.png|Mac OS Dolphin DMG]]

Similar to the Windows setup, create a filepath directory to where the WAD will be located.

[[File:DolphinMacEmu.png|Dolphin main screen]]

For setting up controllers, you may use either USB or BlueTooth enabled devices. In the controller setup screen, configure your specific setup and map the button inputs. Virtual notches can be configured in this screen as well.

[[File:DolphinControlerConfig.png|Controller Configuration screen]]

== Randomizer Dolphin Set Up ==

So, now you have either just finished setting up Dolphin for the first time, or are an experienced Dolphin user. There are a few more settings that must be set to certain values to properly play the randomizer.

First, under <kbd><samp>Config</samp> ⇒ <samp>General</samp></kbd> make sure that <samp>Allow Mismatched Region Settings</samp> is unchecked and <samp>Fallback Region</samp> is set to <samp>NTSC-J</samp>. This ensures that you don't get a PAL frame rate.

[[File:DolphinRegion.png|350px]]

Next, under <kbd><samp>Graphics</samp> ⇒ <samp>Hacks</samp></kbd>, ensure that <samp>Store EFB Copies to Texture Only</samp> is unchecked. This fixes the black pause screens

[[File:EFBImage.png|Setting for EFB]]

=== Enable FPS Display ===

In the first tab of the <samp>Graphics Configuration</samp> in the <samp>Other</samp> section, check the box which says <samp>Show FPS</samp>.

== Starting a Seed ==

This is the only part of setting up Dolphin which is similar to the set up for Wii VC. [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Generating_a_Seed Refer to the "Generating a Seed" section on the Wii VC page for how to generate a WAD.]

After generating the WAD, place it in your game directory. It should appear in your home menu. Double-clicking the seed should then launch it the same way any other .iso is launched from Dolphin, no NAND installation or Wii channel required. If there is already an in-game save file present, delete it before starting the new seed.

== After Finishing a Seed ==

Since all OoTR WADs use the same internal ID, Dolphin will consider them all the same game, meaning saves will carry over between seeds. You'll just need to delete the old save data to make room for a new save.

== Optional Settings ==

=== Recommended Baseline Settings ===

If you are experiencing lag, these are optional settings to change from default.

First, in the <samp>Graphics</samp> tab, change the <samp>Backend</samp> in <samp>General</samp> from <samp>OpenGL</samp> to <samp>Vulcan</samp> if you are on Windows. Dolphin recommends switching this driver as there may or may not be performance driven issues using OpenGL and its compatibility: [https://dolphin-emu.org/docs/guides/performance-guide/ Dolphin Performance Page]

[[File:VideoDriver.png|Video Driver Screen]]

Second, there are optional graphics settings enabled for more frame rate heavy games which are not required for Ocarina of Time. Below are some settings to verify if you are experiencing lag and what to uncheck.

[[File:VulcanGraphicsConfigEnhancements.png|Under the Enhancements tab]]

[[File:VulcanGraphicsConfigAdvanced.png|Advanced Tab]]

=== Graphical Enhancements ===

Depending on the power of your computer, you may want to enable some graphics enhancements. If your computer can handle it as it makes games look much nicer. Back on the home page, go to <kbd><samp>Graphics</samp> ⇒ <samp>Enhancements</samp></kbd>. There is no exact guide for what to do here, mouse over each individual component to see what it does. If your computer is powerful enough, you can probably enable most things without worrying about it. Otherwise, you may have to do some trial and error to figure out what your computer can handle. <samp>Per-Pixel Lighting</samp> and <samp>Anti-Aliasing</samp> above 4x are particularly demanding. <samp>Post-Processing Effects</samp> are mostly gimmicks.

[[File:DolphinEnhancements.png|350px]]

=== Aspect Ratio ===

Go to <kbd><samp>Graphics</samp> ⇒ <samp>General</samp> ⇒ <samp>Aspect Ratio</samp></kbd>, and select whatever you prefer.

[[File:DolphinAspect.png]]

== Troubleshooting ==

These are common issues with running Dolphin. If you are having issues, try any of these that seem like they may help. If you continue to have problems running the randomizer in Dolphin, please come to <kbd><samp>#setup-support</samp></kbd> on [https://discord.gg/q6m6kzK our Discord].

=== MacOS will not open Dolphin ===

Some security settings may affect whether the application has privledges to write to a file directory. This can be overridden by giving permission to Dolphin to write to Finder. Open Terminal and in the command line copy these two commands and run them in one after the other:

<samp>sudo xattr -r -d com.apple.quarantine /path/to/Dolphin.app</samp>

<samp>sudo xattr -r -d com.apple.quarantine /path/to/DolphinUpdater.app</samp>

Change where it says path to your path directory location before running the command. You can copy the path by right clicking Dolphin.app with <samp>Opt key</samp> held and click <samp>Copy Path Name</samp>.

After running the commands, Dolphin should reopen normally.

=== Performance may be poor message on startup ===

When starting the emulator, yellow text may appear which says "Performance may be poor". This only occurs on older computers or computers with specifications lower than Dolphin recommends. Refer to the previous section on Optional Settings to decrease Graphical Enhancements and change Video Driver. Actual gameplay may not be affected, however you may experience some lag.

[[File:PerformanceMayBePoor.png|Performance may be poor]]

=== The Game is Running Slowly/Less than 20 FPS ===

The first thing you need to do in this case is look to the top left of your emulation window. There it should display both FPS and VPS. FPS is the framerate of the game you're running, while VPS is the framerate of Dolphin's output. Based on the VPS value, continue to one of the following subsections.

[[File:DolphinVPS.png]]

==== VPS is less than 60 and unstable ====

If this is the case, your computer can not handle the current emulation, you should turn down some of [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Graphical_Enhancements your graphical enhancements].

==== VPS is stable at 50 ====

There is likely some issue with the region being stuck at PAL, ensure you took the proper steps regarding the region in [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Randomizer_Dolphin_Set_Up Randomizer Dolphin Set Up].

==== VPS is stable at 60 ====

This one is much trickier, as this implies that, as far as the emulator is concerned, the game is running at full frame rate. '''This should be a last resort''', go to <kbd><samp>Config</samp> ⇒ <samp>Advanced</samp> ⇒ <samp>Clock Override</samp></kbd>, checking <samp>Enable Emulated CPU Clock Override</samp>, and setting the slider to 200% (or whatever number seems to work for you). '''This is not allowed for racing.'''

[[File:DolphinOverclock.png]]

=== The Wii Home Menu Randomly Pops Up ===

Click on <kbd><samp>Controllers</samp></kbd> on the home page and then either untick <samp>Background Input</samp> (your controller inputs will still be registered with this setting unticked even when the window is unfocused), or change the <samp>HOME</samp> binding of <samp>Wii Remote 1</samp>.

=== GFX FIFO Unknown Opcode on Resetting ===

This is a known bug with resetting VC on Dolphin. You can click OK on both dialogs that pop up and then won't have to worry about it again until you restart Dolphin itself. You can also go to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp> ⇒ <samp>Interface</samp></kbd> and disable <samp>Use Panic Handlers</samp> to always ignore it.

Dolphin

2021-10-06T18:26:16Z

Dotzo: /* Mac OS */

'''Please keep in mind that:'''
<ol style="color: red;">
'''<li>Dolphin has not been tested extensively for OoTR.</li>'''
'''<li>Using Dolphin for racing is against our community's racing rules.</li>'''
</ol>

Dolphin is a popular emulator for both Gamecube and Wii games, but it can also be used to play Ocarina of Time Randomizer on thru the Wii's Virtual Console mode. Dolphin is very good at emulating Wii VC and only suffers from slight additional lag in certain areas (such as Market as child), which could be mitigated by increasing the clock rate. However, compared to N64 emulators Dolphin inherits the advantages of faster load times and faster pausing from Wii VC. It's also not as resource intensive as some of the alternatives. That being said, playing OoTR on Dolphin is still largely experimental, and this page will be updated as more issues and fixes for those issues are found.

While Dolphin will be used as a Wii emulator, it is actually much simpler than setting up a Wii. There is no need to softmod, move data onto an SD card, or install a WAD. That being said, there are some steps that need to be taken first.

== First Time Dolphin User Set Up ==

[https://dolphin-emu.org/download/ Download the latest beta release of Dolphin.] Like other emulators, you will need the latest beta release of Dolphin rather than the latest stable release. Note that, by default, Dolphin will check for a new beta release monthly and auto-update. You will need a version specific to the operating system you use, see below for details.

=== Windows ===

Once Dolphin is downloaded, extract the zip and open Dolphin.exe. You should see something like this (except that, if this is your first time, your games list will be empty):

[[File:DolphinHome.png]]

Note the buttons within the red box, these will be used in the upcoming steps. The first thing you will want to do is create a game directory. Go to <kbd><samp>Config</samp> ⇒ <samp>Paths</samp> ⇒ <samp>Add...</samp></kbd> and select the directory in which you would like your games to be placed. You can even have multiple game directories, if you wish. This will then cause any .iso or .wad files in your selected directory to show up in the home menu, as seen above.

[[File:DolphinPaths.png]]

Click on <kbd><samp>Controllers</samp></kbd> on the home page. Controllers can be setup either as "GameCube Controllers", or as "Wii Remotes". For the purpose of the randomizer your controller will need to be configured as a "GameCube Controller" (even if it is, say, an Xbox controller). Under Gamecube controllers, click <samp>Configure</samp> next to Port 1.

[[File:DolphinControlConfig1.png|275px]]

If you are using a Gamecube Controller with a Wii U Adapter by either Nintendo or Mayflash (Wii U mode), then your controller should be detected and configured automatically and the new window that opens will simply ask you to enable/disable the Rumble Pak.

[[File:Gcnadapter.png]]

For reference, these are the default controller mappings Dolphin will use. Keep in mind that if you've used the webpatcher, or gzinjectgui with the right configuration, that D-pad left/right/down will be overwritten to properly work with boots/ocarina on D-pad.

[[File:Gamecube Controls.png]]

If you are using any other controller, or if you're using a Gamecube adapter in PC mode, then you will need to configure the controller yourself. Note that, even if you have a controller with analog triggers, you must set <samp>L</samp> and <samp>R</samp> for the buttons to work properly, not just <samp>L-Analog</samp> and <samp>R-Analog</samp>. Below shows a sample controller config with an Xbox controller.

[[File:DolphinControlConfig2.png|725px]]

=== Mac OS ===
On the Dolphin page, download the latest MacOS Intel version and drag to Application folder per normal installation.

[[File:MacDownloadPage.png|Mac Download Page]]

The Disk Image (DMG) will include Dolphin and the Dolphin Updater.

[[File:DMG.png|Mac OS Dolphin DMG]]

Similar to the Windows setup, create a filepath directory to where the WAD will be located.

[[File:DolphinMacEmu.png|Dolphin main screen]]

For setting up controllers, you may use either USB or BlueTooth enabled devices. In the controller setup screen, configure your specific setup and map the button inputs. Virtual notches can be configured in this screen as well.

[[File:DolphinControlerConfig.png|Controller Configuration screen]]

== Randomizer Dolphin Set Up ==

So, now you have either just finished setting up Dolphin for the first time, or are an experienced Dolphin user. There are a few more settings that must be set to certain values to properly play the randomizer.

First, under <kbd><samp>Config</samp> ⇒ <samp>General</samp></kbd> make sure that <samp>Allow Mismatched Region Settings</samp> is unchecked and <samp>Fallback Region</samp> is set to <samp>NTSC-J</samp>. This ensures that you don't get a PAL frame rate.

[[File:DolphinRegion.png|350px]]

Next, under <kbd><samp>Graphics</samp> ⇒ <samp>Hacks</samp></kbd>, ensure that <samp>Store EFB Copies to Texture Only</samp> is unchecked. This fixes the black pause screens

[[File:EFBImage.png|Setting for EFB]]

=== Enable FPS Display ===

In the first tab of the <samp>Graphics Configuration</samp> in the <samp>Other</samp> section, check the box which says <samp>Show FPS</samp>.

== Starting a Seed ==

This is the only part of setting up Dolphin which is similar to the set up for Wii VC. [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Generating_a_Seed Refer to the "Generating a Seed" section on the Wii VC page for how to generate a WAD.]

After generating the WAD, place it in your game directory. It should appear in your home menu. Double-clicking the seed should then launch it the same way any other .iso is launched from Dolphin, no NAND installation or Wii channel required. If there is already an in-game save file present, delete it before starting the new seed.

== After Finishing a Seed ==

Since all OoTR WADs use the same internal ID, Dolphin will consider them all the same game, meaning saves will carry over between seeds. You'll just need to delete the old save data to make room for a new save.

== Optional Settings ==

=== Recommended Baseline Settings ===

If you are experiencing lag, these are optional settings to change from default.

First, in the <samp>Graphics</samp> tab, change the <samp>Backend</samp> in <samp>General</samp> from <samp>OpenGL</samp> to <samp>Vulcan</samp> if you are on Windows. Dolphin recommends switching this driver as there may or may not be performance driven issues using OpenGL and its compatibility: [https://dolphin-emu.org/docs/guides/performance-guide/ Dolphin Performance Page]

[[File:VideoDriver.png|Video Driver Screen]]

Second, there are optional graphics settings enabled for more frame rate heavy games which are not required for Ocarina of Time. Below are some settings to verify if you are experiencing lag and what to uncheck.

[[File:VulcanGraphicsConfigEnhancements.png|Under the Enhancements tab]]

[[File:VulcanGraphicsConfigAdvanced.png|Advanced Tab]]

=== Graphical Enhancements ===

Depending on the power of your computer, you may want to enable some graphics enhancements. If your computer can handle it as it makes games look much nicer. Back on the home page, go to <kbd><samp>Graphics</samp> ⇒ <samp>Enhancements</samp></kbd>. There is no exact guide for what to do here, mouse over each individual component to see what it does. If your computer is powerful enough, you can probably enable most things without worrying about it. Otherwise, you may have to do some trial and error to figure out what your computer can handle. <samp>Per-Pixel Lighting</samp> and <samp>Anti-Aliasing</samp> above 4x are particularly demanding. <samp>Post-Processing Effects</samp> are mostly gimmicks.

[[File:DolphinEnhancements.png|350px]]

=== Aspect Ratio ===

Go to <kbd><samp>Graphics</samp> ⇒ <samp>General</samp> ⇒ <samp>Aspect Ratio</samp></kbd>, and select whatever you prefer.

[[File:DolphinAspect.png]]

== Troubleshooting ==

These are common issues with running Dolphin. If you are having issues, try any of these that seem like they may help. If you continue to have problems running the randomizer in Dolphin, please come to <kbd><samp>#setup-support</samp></kbd> on [https://discord.gg/q6m6kzK our Discord].

=== MacOS will not open Dolphin ===

Some security settings may affect whether the application has privledges to write to a file directory. This can be overridden by giving permission to Dolphin to write to Finder. Open Terminal and in the command line copy these two commands and run them in one after the other:

<samp>sudo xattr -r -d com.apple.quarantine /path/to/Dolphin.app</samp>

<samp>sudo xattr -r -d com.apple.quarantine /path/to/DolphinUpdater.app</samp>

Change where it says path to your path directory location before running the command. You can copy the path by right clicking Dolphin.app with <samp>Opt key</samp> held and click <samp>Copy Path Name</samp>.

After running the commands, Dolphin should reopen normally.

=== Performance may be poor message on startup ===

When starting the emulator, yellow text may appear which says "Performance may be poor". This only occurs on older computers or computers with specifications lower than Dolphin recommends. Refer to the previous section on Optional Settings to decrease Graphical Enhancements and change Video Driver. Actual gameplay may not be affected, however you may experience some lag.

[[File:PerformanceMayBePoor.png|Performance may be poor]]

=== The Game is Running Slowly/Less than 20 FPS ===

The first thing you need to do in this case is look to the top left of your emulation window. There it should display both FPS and VPS. FPS is the framerate of the game you're running, while VPS is the framerate of Dolphin's output. Based on the VPS value, continue to one of the following subsections.

[[File:DolphinVPS.png]]

==== VPS is less than 60 and unstable ====

If this is the case, your computer can not handle the current emulation, you should turn down some of [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Graphical_Enhancements your graphical enhancements].

==== VPS is stable at 50 ====

There is likely some issue with the region being stuck at PAL, ensure you took the proper steps regarding the region in [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Randomizer_Dolphin_Set_Up Randomizer Dolphin Set Up].

==== VPS is stable at 60 ====

This one is much trickier, as this implies that, as far as the emulator is concerned, the game is running at full frame rate. '''This should be a last resort''', go to <kbd><samp>Config</samp> ⇒ <samp>Advanced</samp> ⇒ <samp>Clock Override</samp></kbd>, checking <samp>Enable Emulated CPU Clock Override</samp>, and setting the slider to 200% (or whatever number seems to work for you). '''This is not allowed for racing.'''

[[File:DolphinOverclock.png]]

=== The Wii Home Menu Randomly Pops Up ===

Click on <kbd><samp>Controllers</samp></kbd> on the home page and then either untick <samp>Background Input</samp> (your controller inputs will still be registered with this setting unticked even when the window is unfocused), or change the <samp>HOME</samp> binding of <samp>Wii Remote 1</samp>.

=== GFX FIFO Unknown Opcode on Resetting ===

This is a known bug with resetting VC on Dolphin. You can click OK on both dialogs that pop up and then won't have to worry about it again until you restart Dolphin itself. You can also go to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp> ⇒ <samp>Interface</samp></kbd> and disable <samp>Use Panic Handlers</samp> to always ignore it.

Dolphin

2021-10-06T17:01:30Z

Dotzo: /* Randomizer Dolphin Set Up */

'''Please keep in mind that:'''
<ol style="color: red;">
'''<li>Dolphin has not been tested extensively for OoTR.</li>'''
'''<li>Using Dolphin for racing is against our community's racing rules.</li>'''
</ol>

Dolphin is a popular emulator for both Gamecube and Wii games, but it can also be used to play Ocarina of Time Randomizer on thru the Wii's Virtual Console mode. Dolphin is very good at emulating Wii VC and only suffers from slight additional lag in certain areas (such as Market as child), which could be mitigated by increasing the clock rate. However, compared to N64 emulators Dolphin inherits the advantages of faster load times and faster pausing from Wii VC. It's also not as resource intensive as some of the alternatives. That being said, playing OoTR on Dolphin is still largely experimental, and this page will be updated as more issues and fixes for those issues are found.

While Dolphin will be used as a Wii emulator, it is actually much simpler than setting up a Wii. There is no need to softmod, move data onto an SD card, or install a WAD. That being said, there are some steps that need to be taken first.

== First Time Dolphin User Set Up ==

[https://dolphin-emu.org/download/ Download the latest beta release of Dolphin.] Like other emulators, you will need the latest beta release of Dolphin rather than the latest stable release. Note that, by default, Dolphin will check for a new beta release monthly and auto-update. You will need a version specific to the operating system you use, see below for details.

=== Windows ===

Once Dolphin is downloaded, extract the zip and open Dolphin.exe. You should see something like this (except that, if this is your first time, your games list will be empty):

[[File:DolphinHome.png]]

Note the buttons within the red box, these will be used in the upcoming steps. The first thing you will want to do is create a game directory. Go to <kbd><samp>Config</samp> ⇒ <samp>Paths</samp> ⇒ <samp>Add...</samp></kbd> and select the directory in which you would like your games to be placed. You can even have multiple game directories, if you wish. This will then cause any .iso or .wad files in your selected directory to show up in the home menu, as seen above.

[[File:DolphinPaths.png]]

Click on <kbd><samp>Controllers</samp></kbd> on the home page. Controllers can be setup either as "GameCube Controllers", or as "Wii Remotes". For the purpose of the randomizer your controller will need to be configured as a "GameCube Controller" (even if it is, say, an Xbox controller). Under Gamecube controllers, click <samp>Configure</samp> next to Port 1.

[[File:DolphinControlConfig1.png|275px]]

If you are using a Gamecube Controller with a Wii U Adapter by either Nintendo or Mayflash (Wii U mode), then your controller should be detected and configured automatically and the new window that opens will simply ask you to enable/disable the Rumble Pak.

[[File:Gcnadapter.png]]

For reference, these are the default controller mappings Dolphin will use. Keep in mind that if you've used the webpatcher, or gzinjectgui with the right configuration, that D-pad left/right/down will be overwritten to properly work with boots/ocarina on D-pad.

[[File:Gamecube Controls.png]]

If you are using any other controller, or if you're using a Gamecube adapter in PC mode, then you will need to configure the controller yourself. Note that, even if you have a controller with analog triggers, you must set <samp>L</samp> and <samp>R</samp> for the buttons to work properly, not just <samp>L-Analog</samp> and <samp>R-Analog</samp>. Below shows a sample controller config with an Xbox controller.

[[File:DolphinControlConfig2.png|725px]]

=== Mac OS ===
On the Dolphin page, download the MacOS Intel version and drag to Application folder per normal installation.

[[File:MacDownloadPage.png|Mac Download Page]]

The Disk Image (DMG) will include Dolphin and the Dolphin Updater.

[[File:DMG.png|Mac OS Dolphin DMG]]

Similar to the Windows setup, create a filepath directory to where the WAD will be located.

[[File:DolphinMacEmu.png|Dolphin main screen]]

For setting up controllers, you may use either USB or BlueTooth enabled devices. In the controller setup screen, configure your specific setup and map the button inputs. Virtual notches can be configured in this screen as well.

[[File:DolphinControlerConfig.png|Controller Configuration screen]]

== Randomizer Dolphin Set Up ==

So, now you have either just finished setting up Dolphin for the first time, or are an experienced Dolphin user. There are a few more settings that must be set to certain values to properly play the randomizer.

First, under <kbd><samp>Config</samp> ⇒ <samp>General</samp></kbd> make sure that <samp>Allow Mismatched Region Settings</samp> is unchecked and <samp>Fallback Region</samp> is set to <samp>NTSC-J</samp>. This ensures that you don't get a PAL frame rate.

[[File:DolphinRegion.png|350px]]

Next, under <kbd><samp>Graphics</samp> ⇒ <samp>Hacks</samp></kbd>, ensure that <samp>Store EFB Copies to Texture Only</samp> is unchecked. This fixes the black pause screens

[[File:EFBImage.png|Setting for EFB]]

=== Enable FPS Display ===

In the first tab of the <samp>Graphics Configuration</samp> in the <samp>Other</samp> section, check the box which says <samp>Show FPS</samp>.

== Starting a Seed ==

This is the only part of setting up Dolphin which is similar to the set up for Wii VC. [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Generating_a_Seed Refer to the "Generating a Seed" section on the Wii VC page for how to generate a WAD.]

After generating the WAD, place it in your game directory. It should appear in your home menu. Double-clicking the seed should then launch it the same way any other .iso is launched from Dolphin, no NAND installation or Wii channel required. If there is already an in-game save file present, delete it before starting the new seed.

== After Finishing a Seed ==

Since all OoTR WADs use the same internal ID, Dolphin will consider them all the same game, meaning saves will carry over between seeds. You'll just need to delete the old save data to make room for a new save.

== Optional Settings ==

=== Recommended Baseline Settings ===

If you are experiencing lag, these are optional settings to change from default.

First, in the <samp>Graphics</samp> tab, change the <samp>Backend</samp> in <samp>General</samp> from <samp>OpenGL</samp> to <samp>Vulcan</samp> if you are on Windows. Dolphin recommends switching this driver as there may or may not be performance driven issues using OpenGL and its compatibility: [https://dolphin-emu.org/docs/guides/performance-guide/ Dolphin Performance Page]

[[File:VideoDriver.png|Video Driver Screen]]

Second, there are optional graphics settings enabled for more frame rate heavy games which are not required for Ocarina of Time. Below are some settings to verify if you are experiencing lag and what to uncheck.

[[File:VulcanGraphicsConfigEnhancements.png|Under the Enhancements tab]]

[[File:VulcanGraphicsConfigAdvanced.png|Advanced Tab]]

=== Graphical Enhancements ===

Depending on the power of your computer, you may want to enable some graphics enhancements. If your computer can handle it as it makes games look much nicer. Back on the home page, go to <kbd><samp>Graphics</samp> ⇒ <samp>Enhancements</samp></kbd>. There is no exact guide for what to do here, mouse over each individual component to see what it does. If your computer is powerful enough, you can probably enable most things without worrying about it. Otherwise, you may have to do some trial and error to figure out what your computer can handle. <samp>Per-Pixel Lighting</samp> and <samp>Anti-Aliasing</samp> above 4x are particularly demanding. <samp>Post-Processing Effects</samp> are mostly gimmicks.

[[File:DolphinEnhancements.png|350px]]

=== Aspect Ratio ===

Go to <kbd><samp>Graphics</samp> ⇒ <samp>General</samp> ⇒ <samp>Aspect Ratio</samp></kbd>, and select whatever you prefer.

[[File:DolphinAspect.png]]

== Troubleshooting ==

These are common issues with running Dolphin. If you are having issues, try any of these that seem like they may help. If you continue to have problems running the randomizer in Dolphin, please come to <kbd><samp>#setup-support</samp></kbd> on [https://discord.gg/q6m6kzK our Discord].

=== MacOS will not open Dolphin ===

Some security settings may affect whether the application has privledges to write to a file directory. This can be overridden by giving permission to Dolphin to write to Finder. Open Terminal and in the command line copy these two commands and run them in one after the other:

<samp>sudo xattr -r -d com.apple.quarantine /path/to/Dolphin.app</samp>

<samp>sudo xattr -r -d com.apple.quarantine /path/to/DolphinUpdater.app</samp>

Change where it says path to your path directory location before running the command. You can copy the path by right clicking Dolphin.app with <samp>Opt key</samp> held and click <samp>Copy Path Name</samp>.

After running the commands, Dolphin should reopen normally.

=== Performance may be poor message on startup ===

When starting the emulator, yellow text may appear which says "Performance may be poor". This only occurs on older computers or computers with specifications lower than Dolphin recommends. Refer to the previous section on Optional Settings to decrease Graphical Enhancements and change Video Driver. Actual gameplay may not be affected, however you may experience some lag.

[[File:PerformanceMayBePoor.png|Performance may be poor]]

=== The Game is Running Slowly/Less than 20 FPS ===

The first thing you need to do in this case is look to the top left of your emulation window. There it should display both FPS and VPS. FPS is the framerate of the game you're running, while VPS is the framerate of Dolphin's output. Based on the VPS value, continue to one of the following subsections.

[[File:DolphinVPS.png]]

==== VPS is less than 60 and unstable ====

If this is the case, your computer can not handle the current emulation, you should turn down some of [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Graphical_Enhancements your graphical enhancements].

==== VPS is stable at 50 ====

There is likely some issue with the region being stuck at PAL, ensure you took the proper steps regarding the region in [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Randomizer_Dolphin_Set_Up Randomizer Dolphin Set Up].

==== VPS is stable at 60 ====

This one is much trickier, as this implies that, as far as the emulator is concerned, the game is running at full frame rate. '''This should be a last resort''', go to <kbd><samp>Config</samp> ⇒ <samp>Advanced</samp> ⇒ <samp>Clock Override</samp></kbd>, checking <samp>Enable Emulated CPU Clock Override</samp>, and setting the slider to 200% (or whatever number seems to work for you). '''This is not allowed for racing.'''

[[File:DolphinOverclock.png]]

=== The Wii Home Menu Randomly Pops Up ===

Click on <kbd><samp>Controllers</samp></kbd> on the home page and then either untick <samp>Background Input</samp> (your controller inputs will still be registered with this setting unticked even when the window is unfocused), or change the <samp>HOME</samp> binding of <samp>Wii Remote 1</samp>.

=== GFX FIFO Unknown Opcode on Resetting ===

This is a known bug with resetting VC on Dolphin. You can click OK on both dialogs that pop up and then won't have to worry about it again until you restart Dolphin itself. You can also go to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp> ⇒ <samp>Interface</samp></kbd> and disable <samp>Use Panic Handlers</samp> to always ignore it.

Dolphin

2021-10-06T16:59:41Z

Dotzo: Troubleshooting updates for mac and poor performance

'''Please keep in mind that:'''
<ol style="color: red;">
'''<li>Dolphin has not been tested extensively for OoTR.</li>'''
'''<li>Using Dolphin for racing is against our community's racing rules.</li>'''
</ol>

Dolphin is a popular emulator for both Gamecube and Wii games, but it can also be used to play Ocarina of Time Randomizer on thru the Wii's Virtual Console mode. Dolphin is very good at emulating Wii VC and only suffers from slight additional lag in certain areas (such as Market as child), which could be mitigated by increasing the clock rate. However, compared to N64 emulators Dolphin inherits the advantages of faster load times and faster pausing from Wii VC. It's also not as resource intensive as some of the alternatives. That being said, playing OoTR on Dolphin is still largely experimental, and this page will be updated as more issues and fixes for those issues are found.

While Dolphin will be used as a Wii emulator, it is actually much simpler than setting up a Wii. There is no need to softmod, move data onto an SD card, or install a WAD. That being said, there are some steps that need to be taken first.

== First Time Dolphin User Set Up ==

[https://dolphin-emu.org/download/ Download the latest beta release of Dolphin.] Like other emulators, you will need the latest beta release of Dolphin rather than the latest stable release. Note that, by default, Dolphin will check for a new beta release monthly and auto-update. You will need a version specific to the operating system you use, see below for details.

=== Windows ===

Once Dolphin is downloaded, extract the zip and open Dolphin.exe. You should see something like this (except that, if this is your first time, your games list will be empty):

[[File:DolphinHome.png]]

Note the buttons within the red box, these will be used in the upcoming steps. The first thing you will want to do is create a game directory. Go to <kbd><samp>Config</samp> ⇒ <samp>Paths</samp> ⇒ <samp>Add...</samp></kbd> and select the directory in which you would like your games to be placed. You can even have multiple game directories, if you wish. This will then cause any .iso or .wad files in your selected directory to show up in the home menu, as seen above.

[[File:DolphinPaths.png]]

Click on <kbd><samp>Controllers</samp></kbd> on the home page. Controllers can be setup either as "GameCube Controllers", or as "Wii Remotes". For the purpose of the randomizer your controller will need to be configured as a "GameCube Controller" (even if it is, say, an Xbox controller). Under Gamecube controllers, click <samp>Configure</samp> next to Port 1.

[[File:DolphinControlConfig1.png|275px]]

If you are using a Gamecube Controller with a Wii U Adapter by either Nintendo or Mayflash (Wii U mode), then your controller should be detected and configured automatically and the new window that opens will simply ask you to enable/disable the Rumble Pak.

[[File:Gcnadapter.png]]

For reference, these are the default controller mappings Dolphin will use. Keep in mind that if you've used the webpatcher, or gzinjectgui with the right configuration, that D-pad left/right/down will be overwritten to properly work with boots/ocarina on D-pad.

[[File:Gamecube Controls.png]]

If you are using any other controller, or if you're using a Gamecube adapter in PC mode, then you will need to configure the controller yourself. Note that, even if you have a controller with analog triggers, you must set <samp>L</samp> and <samp>R</samp> for the buttons to work properly, not just <samp>L-Analog</samp> and <samp>R-Analog</samp>. Below shows a sample controller config with an Xbox controller.

[[File:DolphinControlConfig2.png|725px]]

=== Mac OS ===
On the Dolphin page, download the MacOS Intel version and drag to Application folder per normal installation.

[[File:MacDownloadPage.png|Mac Download Page]]

The Disk Image (DMG) will include Dolphin and the Dolphin Updater.

[[File:DMG.png|Mac OS Dolphin DMG]]

Similar to the Windows setup, create a filepath directory to where the WAD will be located.

[[File:DolphinMacEmu.png|Dolphin main screen]]

For setting up controllers, you may use either USB or BlueTooth enabled devices. In the controller setup screen, configure your specific setup and map the button inputs. Virtual notches can be configured in this screen as well.

[[File:DolphinControlerConfig.png|Controller Configuration screen]]

== Randomizer Dolphin Set Up ==

So, now you have either just finished setting up Dolphin for the first time, or are an experienced Dolphin user. There are a few more settings that must be set to certain values to properly play the randomizer.

First, under <kbd><samp>Config</samp> ⇒ <samp>General</samp></kbd> make sure that <samp>Allow Mismatched Region Settings</samp> is unchecked and <samp>Fallback Region</samp> is set to <samp>NTSC-J</samp>. This ensures that you don't get a PAL frame rate.

[[File:DolphinRegion.png|350px]]

Next, under <kbd><samp>Graphics</samp> ⇒ <samp>Hacks</samp></kbd>, ensure that <samp>Store EFB Copies to Texture Only</samp> is unchecked. This fixes the black pause screens

[[File:EFBImage.png|Setting for EFB]]

== Starting a Seed ==

This is the only part of setting up Dolphin which is similar to the set up for Wii VC. [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Generating_a_Seed Refer to the "Generating a Seed" section on the Wii VC page for how to generate a WAD.]

After generating the WAD, place it in your game directory. It should appear in your home menu. Double-clicking the seed should then launch it the same way any other .iso is launched from Dolphin, no NAND installation or Wii channel required. If there is already an in-game save file present, delete it before starting the new seed.

== After Finishing a Seed ==

Since all OoTR WADs use the same internal ID, Dolphin will consider them all the same game, meaning saves will carry over between seeds. You'll just need to delete the old save data to make room for a new save.

== Optional Settings ==

=== Recommended Baseline Settings ===

If you are experiencing lag, these are optional settings to change from default.

First, in the <samp>Graphics</samp> tab, change the <samp>Backend</samp> in <samp>General</samp> from <samp>OpenGL</samp> to <samp>Vulcan</samp> if you are on Windows. Dolphin recommends switching this driver as there may or may not be performance driven issues using OpenGL and its compatibility: [https://dolphin-emu.org/docs/guides/performance-guide/ Dolphin Performance Page]

[[File:VideoDriver.png|Video Driver Screen]]

Second, there are optional graphics settings enabled for more frame rate heavy games which are not required for Ocarina of Time. Below are some settings to verify if you are experiencing lag and what to uncheck.

[[File:VulcanGraphicsConfigEnhancements.png|Under the Enhancements tab]]

[[File:VulcanGraphicsConfigAdvanced.png|Advanced Tab]]

=== Graphical Enhancements ===

Depending on the power of your computer, you may want to enable some graphics enhancements. If your computer can handle it as it makes games look much nicer. Back on the home page, go to <kbd><samp>Graphics</samp> ⇒ <samp>Enhancements</samp></kbd>. There is no exact guide for what to do here, mouse over each individual component to see what it does. If your computer is powerful enough, you can probably enable most things without worrying about it. Otherwise, you may have to do some trial and error to figure out what your computer can handle. <samp>Per-Pixel Lighting</samp> and <samp>Anti-Aliasing</samp> above 4x are particularly demanding. <samp>Post-Processing Effects</samp> are mostly gimmicks.

[[File:DolphinEnhancements.png|350px]]

=== Aspect Ratio ===

Go to <kbd><samp>Graphics</samp> ⇒ <samp>General</samp> ⇒ <samp>Aspect Ratio</samp></kbd>, and select whatever you prefer.

[[File:DolphinAspect.png]]

== Troubleshooting ==

These are common issues with running Dolphin. If you are having issues, try any of these that seem like they may help. If you continue to have problems running the randomizer in Dolphin, please come to <kbd><samp>#setup-support</samp></kbd> on [https://discord.gg/q6m6kzK our Discord].

=== MacOS will not open Dolphin ===

Some security settings may affect whether the application has privledges to write to a file directory. This can be overridden by giving permission to Dolphin to write to Finder. Open Terminal and in the command line copy these two commands and run them in one after the other:

<samp>sudo xattr -r -d com.apple.quarantine /path/to/Dolphin.app</samp>

<samp>sudo xattr -r -d com.apple.quarantine /path/to/DolphinUpdater.app</samp>

Change where it says path to your path directory location before running the command. You can copy the path by right clicking Dolphin.app with <samp>Opt key</samp> held and click <samp>Copy Path Name</samp>.

After running the commands, Dolphin should reopen normally.

=== Performance may be poor message on startup ===

When starting the emulator, yellow text may appear which says "Performance may be poor". This only occurs on older computers or computers with specifications lower than Dolphin recommends. Refer to the previous section on Optional Settings to decrease Graphical Enhancements and change Video Driver. Actual gameplay may not be affected, however you may experience some lag.

[[File:PerformanceMayBePoor.png|Performance may be poor]]

=== The Game is Running Slowly/Less than 20 FPS ===

The first thing you need to do in this case is look to the top left of your emulation window. There it should display both FPS and VPS. FPS is the framerate of the game you're running, while VPS is the framerate of Dolphin's output. Based on the VPS value, continue to one of the following subsections.

[[File:DolphinVPS.png]]

==== VPS is less than 60 and unstable ====

If this is the case, your computer can not handle the current emulation, you should turn down some of [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Graphical_Enhancements your graphical enhancements].

==== VPS is stable at 50 ====

There is likely some issue with the region being stuck at PAL, ensure you took the proper steps regarding the region in [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Randomizer_Dolphin_Set_Up Randomizer Dolphin Set Up].

==== VPS is stable at 60 ====

This one is much trickier, as this implies that, as far as the emulator is concerned, the game is running at full frame rate. '''This should be a last resort''', go to <kbd><samp>Config</samp> ⇒ <samp>Advanced</samp> ⇒ <samp>Clock Override</samp></kbd>, checking <samp>Enable Emulated CPU Clock Override</samp>, and setting the slider to 200% (or whatever number seems to work for you). '''This is not allowed for racing.'''

[[File:DolphinOverclock.png]]

=== The Wii Home Menu Randomly Pops Up ===

Click on <kbd><samp>Controllers</samp></kbd> on the home page and then either untick <samp>Background Input</samp> (your controller inputs will still be registered with this setting unticked even when the window is unfocused), or change the <samp>HOME</samp> binding of <samp>Wii Remote 1</samp>.

=== GFX FIFO Unknown Opcode on Resetting ===

This is a known bug with resetting VC on Dolphin. You can click OK on both dialogs that pop up and then won't have to worry about it again until you restart Dolphin itself. You can also go to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp> ⇒ <samp>Interface</samp></kbd> and disable <samp>Use Panic Handlers</samp> to always ignore it.

File:PerformanceMayBePoor.png

2021-10-06T16:57:20Z

Dotzo:

Popup for if Performance may be poor

Dolphin

2021-10-06T16:42:33Z

Dotzo: Adding changes for lag, notably video drivers

'''Please keep in mind that:'''
<ol style="color: red;">
'''<li>Dolphin has not been tested extensively for OoTR.</li>'''
'''<li>Using Dolphin for racing is against our community's racing rules.</li>'''
</ol>

Dolphin is a popular emulator for both Gamecube and Wii games, but it can also be used to play Ocarina of Time Randomizer on thru the Wii's Virtual Console mode. Dolphin is very good at emulating Wii VC and only suffers from slight additional lag in certain areas (such as Market as child), which could be mitigated by increasing the clock rate. However, compared to N64 emulators Dolphin inherits the advantages of faster load times and faster pausing from Wii VC. It's also not as resource intensive as some of the alternatives. That being said, playing OoTR on Dolphin is still largely experimental, and this page will be updated as more issues and fixes for those issues are found.

While Dolphin will be used as a Wii emulator, it is actually much simpler than setting up a Wii. There is no need to softmod, move data onto an SD card, or install a WAD. That being said, there are some steps that need to be taken first.

== First Time Dolphin User Set Up ==

[https://dolphin-emu.org/download/ Download the latest beta release of Dolphin.] Like other emulators, you will need the latest beta release of Dolphin rather than the latest stable release. Note that, by default, Dolphin will check for a new beta release monthly and auto-update. You will need a version specific to the operating system you use, see below for details.

=== Windows ===

Once Dolphin is downloaded, extract the zip and open Dolphin.exe. You should see something like this (except that, if this is your first time, your games list will be empty):

[[File:DolphinHome.png]]

Note the buttons within the red box, these will be used in the upcoming steps. The first thing you will want to do is create a game directory. Go to <kbd><samp>Config</samp> ⇒ <samp>Paths</samp> ⇒ <samp>Add...</samp></kbd> and select the directory in which you would like your games to be placed. You can even have multiple game directories, if you wish. This will then cause any .iso or .wad files in your selected directory to show up in the home menu, as seen above.

[[File:DolphinPaths.png]]

Click on <kbd><samp>Controllers</samp></kbd> on the home page. Controllers can be setup either as "GameCube Controllers", or as "Wii Remotes". For the purpose of the randomizer your controller will need to be configured as a "GameCube Controller" (even if it is, say, an Xbox controller). Under Gamecube controllers, click <samp>Configure</samp> next to Port 1.

[[File:DolphinControlConfig1.png|275px]]

If you are using a Gamecube Controller with a Wii U Adapter by either Nintendo or Mayflash (Wii U mode), then your controller should be detected and configured automatically and the new window that opens will simply ask you to enable/disable the Rumble Pak.

[[File:Gcnadapter.png]]

For reference, these are the default controller mappings Dolphin will use. Keep in mind that if you've used the webpatcher, or gzinjectgui with the right configuration, that D-pad left/right/down will be overwritten to properly work with boots/ocarina on D-pad.

[[File:Gamecube Controls.png]]

If you are using any other controller, or if you're using a Gamecube adapter in PC mode, then you will need to configure the controller yourself. Note that, even if you have a controller with analog triggers, you must set <samp>L</samp> and <samp>R</samp> for the buttons to work properly, not just <samp>L-Analog</samp> and <samp>R-Analog</samp>. Below shows a sample controller config with an Xbox controller.

[[File:DolphinControlConfig2.png|725px]]

=== Mac OS ===
On the Dolphin page, download the MacOS Intel version and drag to Application folder per normal installation.

[[File:MacDownloadPage.png|Mac Download Page]]

The Disk Image (DMG) will include Dolphin and the Dolphin Updater.

[[File:DMG.png|Mac OS Dolphin DMG]]

Similar to the Windows setup, create a filepath directory to where the WAD will be located.

[[File:DolphinMacEmu.png|Dolphin main screen]]

For setting up controllers, you may use either USB or BlueTooth enabled devices. In the controller setup screen, configure your specific setup and map the button inputs. Virtual notches can be configured in this screen as well.

[[File:DolphinControlerConfig.png|Controller Configuration screen]]

== Randomizer Dolphin Set Up ==

So, now you have either just finished setting up Dolphin for the first time, or are an experienced Dolphin user. There are a few more settings that must be set to certain values to properly play the randomizer.

First, under <kbd><samp>Config</samp> ⇒ <samp>General</samp></kbd> make sure that <samp>Allow Mismatched Region Settings</samp> is unchecked and <samp>Fallback Region</samp> is set to <samp>NTSC-J</samp>. This ensures that you don't get a PAL frame rate.

[[File:DolphinRegion.png|350px]]

Next, under <kbd><samp>Graphics</samp> ⇒ <samp>Hacks</samp></kbd>, ensure that <samp>Store EFB Copies to Texture Only</samp> is unchecked. This fixes the black pause screens

[[File:EFBImage.png|Setting for EFB]]

== Starting a Seed ==

This is the only part of setting up Dolphin which is similar to the set up for Wii VC. [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Generating_a_Seed Refer to the "Generating a Seed" section on the Wii VC page for how to generate a WAD.]

After generating the WAD, place it in your game directory. It should appear in your home menu. Double-clicking the seed should then launch it the same way any other .iso is launched from Dolphin, no NAND installation or Wii channel required. If there is already an in-game save file present, delete it before starting the new seed.

== After Finishing a Seed ==

Since all OoTR WADs use the same internal ID, Dolphin will consider them all the same game, meaning saves will carry over between seeds. You'll just need to delete the old save data to make room for a new save.

== Optional Settings ==

=== Recommended Baseline Settings ===

If you are experiencing lag, these are optional settings to change from default.

First, in the <samp>Graphics</samp> tab, change the <samp>Backend</samp> in <samp>General</samp> from <samp>OpenGL</samp> to <samp>Vulcan</samp> if you are on Windows. Dolphin recommends switching this driver as there may or may not be performance driven issues using OpenGL and its compatibility: [https://dolphin-emu.org/docs/guides/performance-guide/ Dolphin Performance Page]

[[File:VideoDriver.png|Video Driver Screen]]

Second, there are optional graphics settings enabled for more frame rate heavy games which are not required for Ocarina of Time. Below are some settings to verify if you are experiencing lag and what to uncheck.

[[File:VulcanGraphicsConfigEnhancements.png|Under the Enhancements tab]]

[[File:VulcanGraphicsConfigAdvanced.png|Advanced Tab]]

=== Graphical Enhancements ===

Depending on the power of your computer, you may want to enable some graphics enhancements. If your computer can handle it as it makes games look much nicer. Back on the home page, go to <kbd><samp>Graphics</samp> ⇒ <samp>Enhancements</samp></kbd>. There is no exact guide for what to do here, mouse over each individual component to see what it does. If your computer is powerful enough, you can probably enable most things without worrying about it. Otherwise, you may have to do some trial and error to figure out what your computer can handle. <samp>Per-Pixel Lighting</samp> and <samp>Anti-Aliasing</samp> above 4x are particularly demanding. <samp>Post-Processing Effects</samp> are mostly gimmicks.

[[File:DolphinEnhancements.png|350px]]

=== Aspect Ratio ===

Go to <kbd><samp>Graphics</samp> ⇒ <samp>General</samp> ⇒ <samp>Aspect Ratio</samp></kbd>, and select whatever you prefer.

[[File:DolphinAspect.png]]

== Troubleshooting ==

These are common issues with running Dolphin. If you are having issues, try any of these that seem like they may help. If you continue to have problems running the randomizer in Dolphin, please come to <kbd><samp>#setup-support</samp></kbd> on [https://discord.gg/q6m6kzK our Discord].

=== The Game is Running Slowly/Less than 20 FPS ===

The first thing you need to do in this case is look to the top left of your emulation window. There it should display both FPS and VPS. FPS is the framerate of the game you're running, while VPS is the framerate of Dolphin's output. Based on the VPS value, continue to one of the following subsections.

[[File:DolphinVPS.png]]

==== VPS is less than 60 and unstable ====

If this is the case, your computer can not handle the current emulation, you should turn down some of [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Graphical_Enhancements your graphical enhancements].

==== VPS is stable at 50 ====

There is likely some issue with the region being stuck at PAL, ensure you took the proper steps regarding the region in [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Randomizer_Dolphin_Set_Up Randomizer Dolphin Set Up].

==== VPS is stable at 60 ====

This one is much trickier, as this implies that, as far as the emulator is concerned, the game is running at full frame rate. The current workaround for this is to go to <kbd><samp>Config</samp> ⇒ <samp>Advanced</samp> ⇒ <samp>Clock Override</samp></kbd>, checking <samp>Enable Emulated CPU Clock Override</samp>, and setting the slider to 200% (or whatever number seems to work for you). Note this is not a permanent solution and currently considered a workaround.

[[File:DolphinOverclock.png]]

=== The Wii Home Menu Randomly Pops Up ===

Click on <kbd><samp>Controllers</samp></kbd> on the home page and then either untick <samp>Background Input</samp> (your controller inputs will still be registered with this setting unticked even when the window is unfocused), or change the <samp>HOME</samp> binding of <samp>Wii Remote 1</samp>.

=== GFX FIFO Unknown Opcode on Resetting ===

This is a known bug with resetting VC on Dolphin. You can click OK on both dialogs that pop up and then won't have to worry about it again until you restart Dolphin itself. You can also go to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp> ⇒ <samp>Interface</samp></kbd> and disable <samp>Use Panic Handlers</samp> to always ignore it.

File:VulcanGraphicsConfigAdvanced.png

2021-10-06T16:40:55Z

Dotzo:

Advanced Tab of Graphics settings

File:VulcanGraphicsConfigEnhancements.png

2021-10-06T16:40:17Z

Dotzo:

Graphics Enhancements tab for verification

File:VideoDriver.png

2021-10-06T16:34:57Z

Dotzo:

Dolphin's Video Drivers

Dolphin

2021-10-06T16:30:16Z

Dotzo: /* Randomizer Dolphin Set Up */

'''Please keep in mind that:'''
<ol style="color: red;">
'''<li>Dolphin has not been tested extensively for OoTR.</li>'''
'''<li>Using Dolphin for racing is against our community's racing rules.</li>'''
</ol>

Dolphin is a popular emulator for both Gamecube and Wii games, but it can also be used to play Ocarina of Time Randomizer on thru the Wii's Virtual Console mode. Dolphin is very good at emulating Wii VC and only suffers from slight additional lag in certain areas (such as Market as child), which could be mitigated by increasing the clock rate. However, compared to N64 emulators Dolphin inherits the advantages of faster load times and faster pausing from Wii VC. It's also not as resource intensive as some of the alternatives. That being said, playing OoTR on Dolphin is still largely experimental, and this page will be updated as more issues and fixes for those issues are found.

While Dolphin will be used as a Wii emulator, it is actually much simpler than setting up a Wii. There is no need to softmod, move data onto an SD card, or install a WAD. That being said, there are some steps that need to be taken first.

== First Time Dolphin User Set Up ==

[https://dolphin-emu.org/download/ Download the latest beta release of Dolphin.] Like other emulators, you will need the latest beta release of Dolphin rather than the latest stable release. Note that, by default, Dolphin will check for a new beta release monthly and auto-update. You will need a version specific to the operating system you use, see below for details.

=== Windows ===

Once Dolphin is downloaded, extract the zip and open Dolphin.exe. You should see something like this (except that, if this is your first time, your games list will be empty):

[[File:DolphinHome.png]]

Note the buttons within the red box, these will be used in the upcoming steps. The first thing you will want to do is create a game directory. Go to <kbd><samp>Config</samp> ⇒ <samp>Paths</samp> ⇒ <samp>Add...</samp></kbd> and select the directory in which you would like your games to be placed. You can even have multiple game directories, if you wish. This will then cause any .iso or .wad files in your selected directory to show up in the home menu, as seen above.

[[File:DolphinPaths.png]]

Click on <kbd><samp>Controllers</samp></kbd> on the home page. Controllers can be setup either as "GameCube Controllers", or as "Wii Remotes". For the purpose of the randomizer your controller will need to be configured as a "GameCube Controller" (even if it is, say, an Xbox controller). Under Gamecube controllers, click <samp>Configure</samp> next to Port 1.

[[File:DolphinControlConfig1.png|275px]]

If you are using a Gamecube Controller with a Wii U Adapter by either Nintendo or Mayflash (Wii U mode), then your controller should be detected and configured automatically and the new window that opens will simply ask you to enable/disable the Rumble Pak.

[[File:Gcnadapter.png]]

For reference, these are the default controller mappings Dolphin will use. Keep in mind that if you've used the webpatcher, or gzinjectgui with the right configuration, that D-pad left/right/down will be overwritten to properly work with boots/ocarina on D-pad.

[[File:Gamecube Controls.png]]

If you are using any other controller, or if you're using a Gamecube adapter in PC mode, then you will need to configure the controller yourself. Note that, even if you have a controller with analog triggers, you must set <samp>L</samp> and <samp>R</samp> for the buttons to work properly, not just <samp>L-Analog</samp> and <samp>R-Analog</samp>. Below shows a sample controller config with an Xbox controller.

[[File:DolphinControlConfig2.png|725px]]

=== Mac OS ===
On the Dolphin page, download the MacOS Intel version and drag to Application folder per normal installation.

[[File:MacDownloadPage.png|Mac Download Page]]

The Disk Image (DMG) will include Dolphin and the Dolphin Updater.

[[File:DMG.png|Mac OS Dolphin DMG]]

Similar to the Windows setup, create a filepath directory to where the WAD will be located.

[[File:DolphinMacEmu.png|Dolphin main screen]]

For setting up controllers, you may use either USB or BlueTooth enabled devices. In the controller setup screen, configure your specific setup and map the button inputs. Virtual notches can be configured in this screen as well.

[[File:DolphinControlerConfig.png|Controller Configuration screen]]

== Randomizer Dolphin Set Up ==

So, now you have either just finished setting up Dolphin for the first time, or are an experienced Dolphin user. There are a few more settings that must be set to certain values to properly play the randomizer.

First, under <kbd><samp>Config</samp> ⇒ <samp>General</samp></kbd> make sure that <samp>Allow Mismatched Region Settings</samp> is unchecked and <samp>Fallback Region</samp> is set to <samp>NTSC-J</samp>. This ensures that you don't get a PAL frame rate.

[[File:DolphinRegion.png|350px]]

Next, under <kbd><samp>Graphics</samp> ⇒ <samp>Hacks</samp></kbd>, ensure that <samp>Store EFB Copies to Texture Only</samp> is unchecked. This fixes the black pause screens

[[File:EFBImage.png|Setting for EFB]]

== Starting a Seed ==

This is the only part of setting up Dolphin which is similar to the set up for Wii VC. [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Generating_a_Seed Refer to the "Generating a Seed" section on the Wii VC page for how to generate a WAD.]

After generating the WAD, place it in your game directory. It should appear in your home menu. Double-clicking the seed should then launch it the same way any other .iso is launched from Dolphin, no NAND installation or Wii channel required. If there is already an in-game save file present, delete it before starting the new seed.

== After Finishing a Seed ==

Since all OoTR WADs use the same internal ID, Dolphin will consider them all the same game, meaning saves will carry over between seeds. You'll just need to delete the old save data to make room for a new save.

== Optional Settings ==

=== Graphical Enhancements ===

Depending on the power of your computer, you may want to enable some graphics enhancements. If your computer can handle it as it makes games look much nicer. Back on the home page, go to <kbd><samp>Graphics</samp> ⇒ <samp>Enhancements</samp></kbd>. There is no exact guide for what to do here, mouse over each individual component to see what it does. If your computer is powerful enough, you can probably enable most things without worrying about it. Otherwise, you may have to do some trial and error to figure out what your computer can handle. <samp>Per-Pixel Lighting</samp> and <samp>Anti-Aliasing</samp> above 4x are particularly demanding. <samp>Post-Processing Effects</samp> are mostly gimmicks.

[[File:DolphinEnhancements.png|350px]]

=== Aspect Ratio ===

Go to <kbd><samp>Graphics</samp> ⇒ <samp>General</samp> ⇒ <samp>Aspect Ratio</samp></kbd>, and select whatever you prefer.

[[File:DolphinAspect.png]]

== Troubleshooting ==

These are common issues with running Dolphin. If you are having issues, try any of these that seem like they may help. If you continue to have problems running the randomizer in Dolphin, please come to <kbd><samp>#setup-support</samp></kbd> on [https://discord.gg/q6m6kzK our Discord].

=== The Game is Running Slowly/Less than 20 FPS ===

The first thing you need to do in this case is look to the top left of your emulation window. There it should display both FPS and VPS. FPS is the framerate of the game you're running, while VPS is the framerate of Dolphin's output. Based on the VPS value, continue to one of the following subsections.

[[File:DolphinVPS.png]]

==== VPS is less than 60 and unstable ====

If this is the case, your computer can not handle the current emulation, you should turn down some of [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Graphical_Enhancements your graphical enhancements].

==== VPS is stable at 50 ====

There is likely some issue with the region being stuck at PAL, ensure you took the proper steps regarding the region in [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Randomizer_Dolphin_Set_Up Randomizer Dolphin Set Up].

==== VPS is stable at 60 ====

This one is much trickier, as this implies that, as far as the emulator is concerned, the game is running at full frame rate. The current workaround for this is to go to <kbd><samp>Config</samp> ⇒ <samp>Advanced</samp> ⇒ <samp>Clock Override</samp></kbd>, checking <samp>Enable Emulated CPU Clock Override</samp>, and setting the slider to 200% (or whatever number seems to work for you). Note this is not a permanent solution and currently considered a workaround.

[[File:DolphinOverclock.png]]

=== The Wii Home Menu Randomly Pops Up ===

Click on <kbd><samp>Controllers</samp></kbd> on the home page and then either untick <samp>Background Input</samp> (your controller inputs will still be registered with this setting unticked even when the window is unfocused), or change the <samp>HOME</samp> binding of <samp>Wii Remote 1</samp>.

=== GFX FIFO Unknown Opcode on Resetting ===

This is a known bug with resetting VC on Dolphin. You can click OK on both dialogs that pop up and then won't have to worry about it again until you restart Dolphin itself. You can also go to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp> ⇒ <samp>Interface</samp></kbd> and disable <samp>Use Panic Handlers</samp> to always ignore it.

File:EFBImage.png

2021-10-06T16:30:04Z

Dotzo:

Displaying where to check box for EFB settings

Dolphin

2021-10-06T16:25:31Z

Dotzo: Updating for Mac OS instructions

'''Please keep in mind that:'''
<ol style="color: red;">
'''<li>Dolphin has not been tested extensively for OoTR.</li>'''
'''<li>Using Dolphin for racing is against our community's racing rules.</li>'''
</ol>

Dolphin is a popular emulator for both Gamecube and Wii games, but it can also be used to play Ocarina of Time Randomizer on thru the Wii's Virtual Console mode. Dolphin is very good at emulating Wii VC and only suffers from slight additional lag in certain areas (such as Market as child), which could be mitigated by increasing the clock rate. However, compared to N64 emulators Dolphin inherits the advantages of faster load times and faster pausing from Wii VC. It's also not as resource intensive as some of the alternatives. That being said, playing OoTR on Dolphin is still largely experimental, and this page will be updated as more issues and fixes for those issues are found.

While Dolphin will be used as a Wii emulator, it is actually much simpler than setting up a Wii. There is no need to softmod, move data onto an SD card, or install a WAD. That being said, there are some steps that need to be taken first.

== First Time Dolphin User Set Up ==

[https://dolphin-emu.org/download/ Download the latest beta release of Dolphin.] Like other emulators, you will need the latest beta release of Dolphin rather than the latest stable release. Note that, by default, Dolphin will check for a new beta release monthly and auto-update. You will need a version specific to the operating system you use, see below for details.

=== Windows ===

Once Dolphin is downloaded, extract the zip and open Dolphin.exe. You should see something like this (except that, if this is your first time, your games list will be empty):

[[File:DolphinHome.png]]

Note the buttons within the red box, these will be used in the upcoming steps. The first thing you will want to do is create a game directory. Go to <kbd><samp>Config</samp> ⇒ <samp>Paths</samp> ⇒ <samp>Add...</samp></kbd> and select the directory in which you would like your games to be placed. You can even have multiple game directories, if you wish. This will then cause any .iso or .wad files in your selected directory to show up in the home menu, as seen above.

[[File:DolphinPaths.png]]

Click on <kbd><samp>Controllers</samp></kbd> on the home page. Controllers can be setup either as "GameCube Controllers", or as "Wii Remotes". For the purpose of the randomizer your controller will need to be configured as a "GameCube Controller" (even if it is, say, an Xbox controller). Under Gamecube controllers, click <samp>Configure</samp> next to Port 1.

[[File:DolphinControlConfig1.png|275px]]

If you are using a Gamecube Controller with a Wii U Adapter by either Nintendo or Mayflash (Wii U mode), then your controller should be detected and configured automatically and the new window that opens will simply ask you to enable/disable the Rumble Pak.

[[File:Gcnadapter.png]]

For reference, these are the default controller mappings Dolphin will use. Keep in mind that if you've used the webpatcher, or gzinjectgui with the right configuration, that D-pad left/right/down will be overwritten to properly work with boots/ocarina on D-pad.

[[File:Gamecube Controls.png]]

If you are using any other controller, or if you're using a Gamecube adapter in PC mode, then you will need to configure the controller yourself. Note that, even if you have a controller with analog triggers, you must set <samp>L</samp> and <samp>R</samp> for the buttons to work properly, not just <samp>L-Analog</samp> and <samp>R-Analog</samp>. Below shows a sample controller config with an Xbox controller.

[[File:DolphinControlConfig2.png|725px]]

=== Mac OS ===
On the Dolphin page, download the MacOS Intel version and drag to Application folder per normal installation.

[[File:MacDownloadPage.png|Mac Download Page]]

The Disk Image (DMG) will include Dolphin and the Dolphin Updater.

[[File:DMG.png|Mac OS Dolphin DMG]]

Similar to the Windows setup, create a filepath directory to where the WAD will be located.

[[File:DolphinMacEmu.png|Dolphin main screen]]

For setting up controllers, you may use either USB or BlueTooth enabled devices. In the controller setup screen, configure your specific setup and map the button inputs. Virtual notches can be configured in this screen as well.

[[File:DolphinControlerConfig.png|Controller Configuration screen]]

== Randomizer Dolphin Set Up ==

So, now you have either just finished setting up Dolphin for the first time, or are an experienced Dolphin user. There are a few more settings that must be set to certain values to properly play the randomizer.

First, under <kbd><samp>Config</samp> ⇒ <samp>General</samp></kbd> make sure that <samp>Allow Mismatched Region Settings</samp> is unchecked and <samp>Fallback Region</samp> is set to <samp>NTSC-J</samp>. This ensures that you don't get a PAL frame rate.

[[File:DolphinRegion.png|350px]]

Next, under <kbd><samp>Graphics</samp> ⇒ <samp>Hacks</samp></kbd>, ensure that <samp>Store EFB Copies to Texture Only</samp> is unchecked. This fixes the black pause screens

== Starting a Seed ==

This is the only part of setting up Dolphin which is similar to the set up for Wii VC. [https://wiki.ootrandomizer.com/index.php?title=Wii_Virtual_Console#Generating_a_Seed Refer to the "Generating a Seed" section on the Wii VC page for how to generate a WAD.]

After generating the WAD, place it in your game directory. It should appear in your home menu. Double-clicking the seed should then launch it the same way any other .iso is launched from Dolphin, no NAND installation or Wii channel required. If there is already an in-game save file present, delete it before starting the new seed.

== After Finishing a Seed ==

Since all OoTR WADs use the same internal ID, Dolphin will consider them all the same game, meaning saves will carry over between seeds. You'll just need to delete the old save data to make room for a new save.

== Optional Settings ==

=== Graphical Enhancements ===

Depending on the power of your computer, you may want to enable some graphics enhancements. If your computer can handle it as it makes games look much nicer. Back on the home page, go to <kbd><samp>Graphics</samp> ⇒ <samp>Enhancements</samp></kbd>. There is no exact guide for what to do here, mouse over each individual component to see what it does. If your computer is powerful enough, you can probably enable most things without worrying about it. Otherwise, you may have to do some trial and error to figure out what your computer can handle. <samp>Per-Pixel Lighting</samp> and <samp>Anti-Aliasing</samp> above 4x are particularly demanding. <samp>Post-Processing Effects</samp> are mostly gimmicks.

[[File:DolphinEnhancements.png|350px]]

=== Aspect Ratio ===

Go to <kbd><samp>Graphics</samp> ⇒ <samp>General</samp> ⇒ <samp>Aspect Ratio</samp></kbd>, and select whatever you prefer.

[[File:DolphinAspect.png]]

== Troubleshooting ==

These are common issues with running Dolphin. If you are having issues, try any of these that seem like they may help. If you continue to have problems running the randomizer in Dolphin, please come to <kbd><samp>#setup-support</samp></kbd> on [https://discord.gg/q6m6kzK our Discord].

=== The Game is Running Slowly/Less than 20 FPS ===

The first thing you need to do in this case is look to the top left of your emulation window. There it should display both FPS and VPS. FPS is the framerate of the game you're running, while VPS is the framerate of Dolphin's output. Based on the VPS value, continue to one of the following subsections.

[[File:DolphinVPS.png]]

==== VPS is less than 60 and unstable ====

If this is the case, your computer can not handle the current emulation, you should turn down some of [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Graphical_Enhancements your graphical enhancements].

==== VPS is stable at 50 ====

There is likely some issue with the region being stuck at PAL, ensure you took the proper steps regarding the region in [https://wiki.ootrandomizer.com/index.php?title=Dolphin#Randomizer_Dolphin_Set_Up Randomizer Dolphin Set Up].

==== VPS is stable at 60 ====

This one is much trickier, as this implies that, as far as the emulator is concerned, the game is running at full frame rate. The current workaround for this is to go to <kbd><samp>Config</samp> ⇒ <samp>Advanced</samp> ⇒ <samp>Clock Override</samp></kbd>, checking <samp>Enable Emulated CPU Clock Override</samp>, and setting the slider to 200% (or whatever number seems to work for you). Note this is not a permanent solution and currently considered a workaround.

[[File:DolphinOverclock.png]]

=== The Wii Home Menu Randomly Pops Up ===

Click on <kbd><samp>Controllers</samp></kbd> on the home page and then either untick <samp>Background Input</samp> (your controller inputs will still be registered with this setting unticked even when the window is unfocused), or change the <samp>HOME</samp> binding of <samp>Wii Remote 1</samp>.

=== GFX FIFO Unknown Opcode on Resetting ===

This is a known bug with resetting VC on Dolphin. You can click OK on both dialogs that pop up and then won't have to worry about it again until you restart Dolphin itself. You can also go to <kbd><samp>Options</samp> ⇒ <samp>Configuration</samp> ⇒ <samp>Interface</samp></kbd> and disable <samp>Use Panic Handlers</samp> to always ignore it.

File:DolphinControlerConfig.png

2021-10-06T16:23:32Z

Dotzo:

Controller Setup screen for Dolphin in the Mac version

File:DolphinMacEmu.png

2021-10-06T16:19:56Z

Dotzo:

This is what the main screen of Dolphin looks like before any WADs are added.

File:DMG.png

2021-10-06T16:16:46Z

Dotzo:

This is what the Disk Image looks like for Dolphin

File:MacDownloadPage.png

2021-10-06T16:14:47Z

Dotzo:

This is the download page for Dolphin for mac.

GGJ

2021-09-12T20:50:38Z

Dotzo: /* Allowed */

Below is the list of allowed and banned techniques for the Glitchless + Ground Jumps (GGJ) ruleset. Because this was based on a ruleset from the vanilla game, you may notice significant differences in the level of detail in describing what is allowed or banned when comparing to the Standard ruleset. Please feel free to assume that if it is not listed, and doesn't otherwise violate one of the explicitly banned conditions, that it is allowed.

This ruleset will update over time to include new discoveries as they are made, however the goal of banning only by technique - regardless of the consequences - will remain in effect.

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 GGJ Ruleset races.''

=== Allowed ===
*Power Crouch Stabbing
*Roll invincibility
*Post-damage invincibility
*Jumpslashing in mid-air for more distance
*Shield dropping
*Using broken deku stick
*Hookshot Extension
*Rolling from the blue switch in Jabu Jabu's Belly
*Damage Boosting
*Damage Buffering
*Placing bombs on lava pits to damage Volvagia
*Skipping text triggers via weapon swapping
*Passing through the back side of a one-sided collision
**EG: bridge clip, darunia's door, forest's falling ceiling
*Attacking to collect or hit an object on the other side of a collision
*Momentary Antigravity
**EG: b1 skip
*Recoil Jump
**Shielding damage midair to take Link out of a backflip or sidehop and into a normal airborne state
*Ground Jumps
*NB: This is included despite being a glitch as it is functionally similar to a Recoil Jump as well as much easier
*Twisted sidehops or backflips out of siderolls or standing ESS shuffles
*Touching misplaced or accidentally-exposed loading zones
**EG: Early Jabu, Trials skip, Market shops at night
*Delaying a timer by pressing cutscene items midair
*Going out of bounds
**NB: The method of reaching OoB must not violate any other rules
*Being in an unloaded area
*Hoverboosting
**IE: Using hoverboots to conserve momentum from recoil via hammer or damage
*Megajumps
**IE: Using hoverboots to concerve momentum from damage during a jump
*Remote wall interactions
*Walking on walls
*Culling actors
**EG: keeping enemies off screen to stop them from moving
*Swimming laterally while wearing Iron Boots
*Climbing ladders or vines during cutscenes
*Cutscene skips which use only movement from inputs completed before the cutscene begins
**EG: voiding, entering a loading zone

=== Banned ===
*Infinite Sword Glitch
*Megaflip and megasidehop
*Extended Antigravity
**EG: unloading lower gerudo fortress
*All forms of superslide
*Hovering
*Entrance point glitch or other respawn point manipulation
*Clipping
**NB: This is well defined for both solid collision and soft/actor collision, contact a moderator if you aren't sure if something is a clip
*Cutscene diving to sink into water
*Flame storage
*Item Manipulation
**This is an umbrella term covering the glitches Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*Using collection delay to your advantage
**EG: early eyeball frog or gold scale
**NB: Delay happens naturally in many shops if you buy quickly, this is ok
*Something except for a sword on B
**NB: This does not include normal circumstances like riding Epona
*Bottle Duplication
*Wrong warp
*Void warp
*Walking While Talking
*Causing a switch to remain pressed longer than it should
*Ocarina Items
*Z-slide
*A-slide
*Using restricted items
**IE: Farore's Wind in the Overworld or Ocarina in boss rooms
*Being in an unloaded area
*Unloading an actor which clearly should be loaded
**EG: Actor Glitch, unloading KZ's ice, overloading the graveyard or trials to remove graves or Gold Gauntlet monoliths, pause buffering the timer expiration during the diving minigame
*SRM (Stale Reference Manipulation)
*Abusing actors which have not had a chance to update after loading
**IE: 0,0,0 glitch and the deku b2 web
*Opening underwater chests while wearing the Iron Boots
*Action Swap
**NB: This includes using the explosion limit to Ground Jump
*Using the effects of Quick Putaway
**EG: Lighting a torch with a Deku Stick with no present fire source.
*Equip Swap
*Ledge Cancel
*Retaining the Master Sword in Phase 1 of the Ganon Fight
*Dying to achieve anything other than a deathwarp

GGJ

2021-05-01T18:13:40Z

Dotzo:

Below is the list of allowed and banned techniques for the Glitchless + Ground Jumps (GGJ) ruleset. Because this was based on a ruleset from the vanilla game, you may notice significant differences in the level of detail in describing what is allowed or banned when comparing to the Standard ruleset. Please feel free to assume that if it is not listed, and doesn't otherwise violate one of the explicitly banned conditions, that it is allowed.

This ruleset will update over time to include new discoveries as they are made, however the goal of banning only by technique - regardless of the consequences - will remain in effect.

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 GGJ Ruleset races.''

=== Allowed ===
*Power Crouch Stabbing
*Roll invincibility
*Post-damage invincibility
*Jumpslashing in mid-air for more distance
*Shield dropping
*Using broken deku stick
*Hookshot Extension
*Rolling from the blue switch in Jabu Jabu's Belly
*Damage Boosting
*Damage Buffering
*Placing bombs on lava pits to damage Volvagia
*Skipping text triggers via weapon swapping
*Opening underwater chests while wearing the Iron Boots
*Passing through the back side of a one-sided collision
**EG: bridge clip, darunia's door, forest's falling ceiling
*Attacking to collect or hit an object on the other side of a collision
*Momentary Antigravity
**EG: b1 skip
*Recoil Jump
**Shielding damage midair to take Link out of a backflip or sidehop and into a normal airborne state
*Ground Jumps
*NB: This is included despite being a glitch as it is functionally similar to a Recoil Jump as well as much easier
*Twisted sidehops or backflips out of siderolls or standing ESS shuffles
*Touching misplaced or accidentally-exposed loading zones
**EG: Early Jabu, Trials skip, Market shops at night
*Delaying a timer by pressing cutscene items midair
*Going out of bounds
**NB: The method of reaching OoB must not violate any other rules
*Being in an unloaded area
*Hoverboosting
**IE: Using hoverboots to conserve momentum from recoil via hammer or damage
*Megajumps
**IE: Using hoverboots to concerve momentum from damage during a jump
*Remote wall interactions
*Walking on walls
*Culling actors
**EG: keeping enemies off screen to stop them from moving
*Swimming laterally while wearing Iron Boots
*Climbing ladders or vines during cutscenes
*Cutscene skips which use only movement from inputs completed before the cutscene begins
**EG: voiding, entering a loading zone

=== Banned ===
*Infinite Sword Glitch
*Megaflip and megasidehop
*Extended Antigravity
**EG: unloading lower gerudo fortress
*All forms of superslide
*Hovering
*Entrance point glitch or other respawn point manipulation
*Clipping
**NB: This is well defined for both solid collision and soft/actor collision, contact a moderator if you aren't sure if something is a clip
*Cutscene diving to sink into water
*Flame storage
*Item Manipulation
**This is an umbrella term covering the glitches Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*Using collection delay to your advantage
**EG: early eyeball frog or gold scale
**NB: Delay happens naturally in many shops if you buy quickly, this is ok
*Something except for a sword on B
**NB: This does not include normal circumstances like riding Epona
*Bottle Duplication
*Wrong warp
*Void warp
*Walking While Talking
*Causing a switch to remain pressed longer than it should
*Ocarina Items
*Z-slide
*A-slide
*Using restricted items
**IE: Farore's Wind in the Overworld or Ocarina in boss rooms
*Being in an unloaded area
*Unloading an actor which clearly should be loaded
**EG: Actor Glitch, unloading KZ's ice, overloading the graveyard or trials to remove graves or Gold Gauntlet monoliths, pause buffering the timer expiration during the diving minigame
*SRM (Stale Reference Manipulation)
*Abusing actors which have not had a chance to update after loading
**IE: 0,0,0 glitch and the deku b2 web
*Opening underwater chests while wearing the Iron Boots
*Action Swap
**NB: This includes using the explosion limit to Ground Jump
*Using the effects of Quick Putaway
**EG: Lighting a torch with a Deku Stick with no present fire source.
*Equip Swap
*Ledge Cancel
*Retaining the Master Sword in Phase 1 of the Ganon Fight
*Dying to achieve anything other than a deathwarp

GGJ

2021-05-01T18:12:19Z

Dotzo:

Below is the list of allowed and banned techniques for the Glitchless + Ground Jumps (GGJ) ruleset. Because this was based on a ruleset from the vanilla game, you may notice significant differences in the level of detail in describing what is allowed or banned when comparing to the Standard ruleset. Please feel free to assume that if it is not listed, and doesn't otherwise violate one of the explicitly banned conditions, that it is allowed.

This ruleset will update over time to include new discoveries as they are made, however the goal of banning only by technique - regardless of the consequences - will remain in effect.

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 GGJ Ruleset races.''

=== Allowed ===
*Power Crouch Stabbing
*Roll invincibility
*Post-damage invincibility
*Jumpslashing in mid-air for more distance
*Shield dropping
*Using broken deku stick
*Hookshot Extension
*Rolling from the blue switch in Jabu Jabu's Belly
*Damage Boosting
*Damage Buffering
*Placing bombs on lava pits to damage Volvagia
*Skipping text triggers via weapon swapping
*Opening underwater chests while wearing the Iron Boots
*Passing through the back side of a one-sided collision
**EG: bridge clip, darunia's door, forest's falling ceiling
*Attacking to collect or hit an object on the other side of a collision
*Momentary Antigravity
**EG: b1 skip
*Recoil Jump
**Shielding damage midair to take Link out of a backflip or sidehop and into a normal airborne state
*Ground Jumps
*NB: This is included despite being a glitch as it is functionally similar to a Recoil Jump as well as much easier
*Twisted sidehops or backflips out of siderolls or standing ESS shuffles
*Touching misplaced or accidentally-exposed loading zones
**EG: Early Jabu, Trials skip, Market shops at night
*Delaying a timer by pressing cutscene items midair
*Going out of bounds
**NB: The method of reaching OoB must not violate any other rules
*Being in an unloaded area
*Hoverboosting
**IE: Using hoverboots to conserve momentum from recoil via hammer or damage
*Megajumps
**IE: Using hoverboots to concerve momentum from damage during a jump
*Remote wall interactions
*Walking on walls
*Culling actors
**EG: keeping enemies off screen to stop them from moving

=== Banned ===
*Infinite Sword Glitch
*Megaflip and megasidehop
*Extended Antigravity
**EG: unloading lower gerudo fortress
*All forms of superslide
*Hovering
*Entrance point glitch or other respawn point manipulation
*Clipping
**NB: This is well defined for both solid collision and soft/actor collision, contact a moderator if you aren't sure if something is a clip
*Cutscene diving to sink into water
*Flame storage
*Item Manipulation
**This is an umbrella term covering the glitches Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*Using collection delay to your advantage
**EG: early eyeball frog or gold scale
**NB: Delay happens naturally in many shops if you buy quickly, this is ok
*Something except for a sword on B
**NB: This does not include normal circumstances like riding Epona
*Bottle Duplication
*Wrong warp
*Void warp
*Walking While Talking
*Causing a switch to remain pressed longer than it should
*Ocarina Items
*Z-slide
*A-slide
*Using restricted items
**IE: Farore's Wind in the Overworld or Ocarina in boss rooms
*Being in an unloaded area
*Unloading an actor which clearly should be loaded
**EG: Actor Glitch, unloading KZ's ice, overloading the graveyard or trials to remove graves or Gold Gauntlet monoliths, pause buffering the timer expiration during the diving minigame
*SRM (Stale Reference Manipulation)
*Abusing actors which have not had a chance to update after loading
**IE: 0,0,0 glitch and the deku b2 web
*Opening underwater chests while wearing the Iron Boots
*Action Swap
**NB: This includes using the explosion limit to Ground Jump
*Using the effects of Quick Putaway
**EG: Lighting a torch with a Deku Stick with no present fire source.
*Equip Swap
*Ledge Cancel
*Retaining the Master Sword in Phase 1 of the Ganon Fight
*Dying to achieve anything other than a deathwarp

GGJ

2021-02-21T00:21:14Z

Dotzo:

Below is the list of allowed and banned techniques for the Glitchless + Ground Jumps (GGJ) ruleset. Because this was based on a ruleset from the vanilla game, you may notice significant differences in the level of detail in describing what is allowed or banned when comparing to the Standard ruleset. Please feel free to assume that if it is not listed, and doesn't otherwise violate one of the explicitly banned conditions, that it is allowed.

This ruleset will update over time to include new discoveries as they are made, however the goal of banning only by technique - regardless of the consequences - will remain in effect.

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 GGJ Ruleset races.''

=== Allowed ===
*Damage Boosting
*Hoverboosting
**IE: Using hoverboots to conserve momentum from recoil via hammer or damage
*Megajumps
**IE: Using hoverboots to concerve momentum from damage during a jump
*Power Crouch Stabbing
*Roll invincibility
*Post-damage invincibility
*Jumpslashing in mid-air for more distance
*Shield dropping
*Using broken deku stick
*Hookshot Extension
*Rolling from the blue switch in Jabu Jabu's Belly
*Damage Buffering
*Placing bombs on lava pits to damage Volvagia
*Skipping text triggers via weapon swapping
*Opening underwater chests while wearing the Iron Boots
*Passing through the back side of a one-sided collision
**EG: bridge clip, darunia's door, forest's falling ceiling
*Attacking to collect or hit an object on the other side of a collision
*Momentary Antigravity
**EG: b1 skip
*Recoil Jump
**Shielding damage midair to take Link out of a backflip or sidehop and into a normal airborne state
*Twisted sidehops or backflips out of siderolls or standing ESS shuffles
*Ground Jumps
*Culling actors
**EG: keeping enemies off screen to stop them from moving, hookshotting through boulders' hitboxes
*Using cutscene items to delay timers
*Moving through cylindrical collision
**EG: Sidehopping into double magic

=== Banned ===
*Infinite Sword Glitch
*Megaflip and megasidehop
*Extended Antigravity
**EG: unloading lower gerudo fortress
*All forms of superslide
*Hovering
*Going Out of Bounds
**Any area which is beyond the boundary walls of the map such as an outer seam, or any area which is exposed to the lowest void plane in the map
*Entrance point glitch or other respawn point manipulation
*Passing through collision from the front
**IE: clipping
**NB: This includes passing through the falling spikes in shadow temple since they have been shown to be solid
*Cutscene diving to sink into water
*Flame storage
*Item Manipulation
**This is an umbrella term covering the glitches Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*Using collection delay to your advantage
**EG: early eyeball frog or gold scale
**NB: Delay happens naturally in many shops if you buy quickly, this is ok
*Something except for a sword on B
**NB: This does not include normal circumstances like riding Epona
*Bottle Duplication
*Wrong warp
*Void warp
*Walking While Talking
*Causing a switch to remain pressed longer than it should
*Ocarina Items
*Z-slide
*A-slide
*Using restricted items
**IE: Farore's Wind in the Overworld or Ocarina in boss rooms
*Being in an unloaded area
*Unloading an actor which clearly should be loaded
**EG: Actor Glitch, unloading KZ's ice, overloading the graveyard or trials to remove graves or Gold Gauntlet monoliths, pause buffering the timer expiration during the diving minigame
*SRM (Stale Reference Manipulation)
*Action Swap
**NB: This includes using the explosion limit to Ground Jump
*Using the effects of Quick Putaway
**EG: Lighting a torch with a Deku Stick with no present fire source.
*Equip Swap
*Ledge Cancel
*Retaining the Master Sword in Phase 1 of the Ganon Fight
*Dying to achieve anything other than a deathwarp

Hints

2020-12-31T21:32:46Z

Dotzo: Added S4 tourney, renamed old Tournament to Scrubs, Reworked a bit to add 2 layers for Weighted vs exact distros

Hints are given by the Gossip Stones all over Hyrule. There are 40 Gossip Stones in total that give hints once the requirement to get them have been met. This requirement can be set to nothing, having the Stone of Agony in your inventory, and wearing the Mask of Truth. A Gossip Stone was added on the largest island in Lake Hylia which doesn't give a hint, but is instead used to lower and raise the water level in the lake once Morpha has been defeated.

== Hint Categories ==
Hints are split up in multiple categories, to allow customization of the amount of hints of each category in the different hint distributions and with [[Plandomizer]]. Some hint categories only show up in certain hint distributions, and some only show up if certain settings are enabled.

=== Trial ===
Trial Hints tell you which of Ganon's Trials are enabled, if this isn't implicitly known from the settings. There are different possibilities for this to happen, so the amount of them varies by setting:
* If trials are set to random and all 6 trials end up being enabled you will get a single hint: "Ganon's Tower is protected by a powerful barrier."
* If trials are set to random and no trials end up being enabled you will get a single hint: "Sheik dispelled the barrier around Ganon's Tower."
* If 1-3 trials end up being enabled you will get 1-3 of the following hint: "the [Medallion Type] Trial protects Ganon's Tower."
* If 4-5 trials end up being enabled you will get 1-2 of the following hint: "the [Medallion Type] Trial was dispelled by Sheik."

=== Location ===
Location hints are hints that tell you which item is at a specific location. Excluded Locations will never get a hint. These hints are split into four different categories:
* Song Hints
* Minigame Hints
* Overworld Hints
* Dungeon Hints

Locations are also classified as either "Always" or "Sometimes" hints.
==== Always ====
Always Hints are hints for item locations that are considered to be so bad that they will get a hint in every seed. Some of these are dynamic based on other settings in your seed.

==== Sometimes ====
Sometimes Hints are hints manually picked for race settings (Weeklies and Tournaments) and therefore only show up in the Tournament Distribution.

For more information on which hints falls into which category see [[List of all location hints]]

=== Entrance ===
Entrance Hints are exclusive to Entrance Randomizer, and are similar to Location Hints, but instead give you info about which Entrance leads where.

=== Item and Random ===
Item Hints and Random Hints are hints that state that an area has a certain items in it. For example: "The Hookshot can be found at Zora's River" or "Spirit Temple hoards a Red Rupee". Item Hints only hint towards Major Items, whereas Random Hints can hint towards any item in the game.

=== Junk ===
Junk Hints are hints that tell you nothing about the seed. They can be funny in nature or give general gameplay tips.

=== Way of the Hero ===
Way of the Hero (WotH) Hints are hints that tell you that an area holds an item that is logically required to beat the seed. For Example: "Kakariko Village is on the way of the hero." It will only tell you that an area is way of the hero if that specific instance of the item is required. For example, even though a Bow is always required to beat Ganondorf, it might not be on the way of the hero if you have a choice on which one to get first, since there are multiple of them in a seed.
WotH Hints give info only about that area, not any sub-areas. For example, Gerudo Fortress being on the Way of the Hero tells you nothing about Gerudo Training Grounds.

In any seed, a maximum of two WotH hints can point at dungeons (including two hints pointing at the same dungeon) unless the hint distribution is set to Very Strong.

=== Path of Gold ===
Path of Gold hints are exclusive to Triforce Hunt and replace Way of the Hero hints in that mode. They point to items that logically lock any of the Triforce Pieces in that seed. They cannot point at the Triforce Pieces themselves. The hinted item isn't necessarily required to beat the seed, since the amount of Triforce Pieces in the world can be higher than the goal. Otherwise, they work similarly to Way of the Hero hints, including the maximum of two dungeons.

=== Foolish Choice ===
Foolish Choice Hints point towards areas that contain no [[Major Items]]. This means that you can ignore this area when looking for progression in the seed. To increase the amount of Foolish Areas per seed, there are three exceptions where a Major Item can show up in a Foolish Areas:

# The Major Item isn't shuffled (For example Ocarina), or not considered in logic (Bombchus).
# The item in question doesn't unlock any Location. This list is mostly predetermined and consists of Double Defense, Ice Arrows and Biggoron Sword. Nayrus Love is also in this list damage is not set to Quadruple Damage or OHKO, Scrub Shuffle is disabled, and [[Entrance_Randomizer | ER]] is disabled or set to Dungeons Only. Stone of Agony is also in this list if it isn't used for hints and the trick to open hidden grottos without it is enabled. Serenade of Water and Prelude of Light are also in this list unless Full Indoors or Overworld ER is enabled.
# An exact duplicate of the item is on the WotH AND getting that duplicate would make the item in the Foolish Area obsolete. For Weekly/Tourney standards this can only be Bows, Bombs, "Normal" Bottles, Slingshots and Magic. Depending on other settings this can also include Bombchus, Ocarina, or any non-progressive item if the Item Pool is set to Plentiful.

Special Progressive Major Items are items where getting copies of the item changes the functionality of the item in logic. These items can only be in Foolish Areas if there are more copies in the item pool than there are useful upgrades, and only if the amount of them that are WotH is the same as the amount of useful upgrades. For example: If there are 3 Hookshots in the pool, the third one can be in a Foolish Area, since you only need 2 upgrades to get the Longshot, but only if both other Hookshots are WotH. Special Progressive Major Items and their amount of useful upgrades are: Hookshots (2), Wallets (3), Strength Upgrades (3), and Scales (2). Small Keys (Infinite), but only with Keysanity. Gold Skulltula Tokens (Infinite), but only with Token Bridge and Tokensanity.

One tiny caveat with this is that Skulltula Tokens are not considered Major Items when not playing with Token Bridge, even in tokensanity. This means there's a chance that you'll be required to get Skulltula Tokens from a Foolish area to get to a certain Token Reward.

Foolish Choice Hints give info only about that area, not any sub-areas. For example, Gerudo Fortress being a foolish choice tells you nothing about Gerudo Training Grounds.

In any seed, a maximum of one dungeon can be hinted as Foolish, unless the hint distribution is set to Very Strong.

== Hint Overlap ==
Item locations can never be hinted towards by more than one hint. For example: This means that if you get a hint for the Song on Ocarina of Time and a hint that Hyrule Field is on the way of the hero, that WotH hint isn't pointing at the song. The hint types that follow this rule are:
* WotH hints
* Location Hints (Song, Minigame, Overworld, Dungeon, Always, and Sometimes)
* Item Hints
* Random Hints

In the development versions of the randomizer and from v5.2 forward this will be extended in a way to also include Foolish Choice Hints. However, it will only follow this rule if the Foolish Choice Hint is chosen before the other hint. This means that it is only consistent in the Tournament Distribution. For more info on why this is, see the next section.

== Hint Distributions ==
How hints get distributed amongst the 40 available gossip stones is quite flexible, but falls into two main camps: Weighted Distributions and Exact Distributions. These two main categories have commonalities otherwise, such as allowing duplicates of certain chosen hint types. These are done by type, some having a single copy while others having multiple copies. It's also imporotant to keep in mind that some of the hint types such as Trials hints and Entrance hints are only placed if the settings allow for it.

=== Weighted Distributions ===
Most hint distributions don't have a set amount of hints for each category. Instead, they use weights to pick hint types randomly. The higher the weight, the higher the chance of that hint type getting picked. Trial Hints and Always Hints are exempt from this, and their amount is dependent on the settings.

The amounts and weights for each of the built-in weighted hint distributions are as follows:

==== Useless ====
{| class="wikitable"
|-
! Type !! Weight !! Copies
|-
| Junk || 9.0 || 1
|-
| All other types || 0.0 || 0
|}
Note that this distribution doesn't have any Trial or Always Hints, since the amount of copies is set to 0.

==== Balanced ====
{| class="wikitable"
|-
! Type !! Weight !! Copies
|-
| Trial || 0.0 || 1
|-
| Always || 0.0 || 1
|-
| WOTH || 3.5 || 1
|-
| Foolish || 2.0 || 1
|-
| Item || 5.0 || 1
|-
| Song || 1.0 || 1
|-
| Minigame || 0.5 || 1
|-
| Overworld || 2.0 || 1
|-
| Dungeon || 1.5 || 1
|-
| Entrance || 3.0 || 1
|-
| Random || 6.0 || 1
|-
| Junk || 3.0 || 1
|}

==== Strong ====
{| class="wikitable"
|-
! Type !! Weight !! Copies
|-
| Trial || 0.0 || 1
|-
| Always || 0.0 || 2
|-
| WOTH || 3.0 || 2
|-
| Foolish || 3.0 || 1
|-
| Item || 1.0 || 1
|-
| Song || 0.33 || 1
|-
| Minigame || 0.33 || 1
|-
| Overworld || 0.66 || 1
|-
| Dungeon || 0.66 || 1
|-
| Entrance || 1.0 || 1
|-
| Random || 2.0 || 1
|-
| Junk || 0.0 || 0
|}

==== Very Strong ====
{| class="wikitable"
|-
! Type !! Weight !! Copies
|-
| Trial || 0.0 || 1
|-
| Always || 0.0 || 2
|-
| WOTH || 3.0 || 2
|-
| Foolish || 3.0 || 1
|-
| Item || 1.0 || 1
|-
| Song || 0.5 || 1
|-
| Minigame || 0.5 || 1
|-
| Overworld || 1.5 || 1
|-
| Dungeon || 1.5 || 1
|-
| Entrance || 2.0 || 1
|-
| Random || 0.0 || 0
|-
| Junk || 0.0 || 0
|}

=== Exact Distributions ===
Rather than use weights to randomly choose how many hints of a given type should be chosen, these distributions instead specify exactly how many should exist. For example, you can specify that there should be exactly 4 Way of the Hero (or Path of Gold if Triforce Hunt is enabled) type hints, rather than simply giving them a weight. This allows for structuring the hints so that they are the same every time, particularly useful when a lot of players will be using the same settings for a long time, such as the case with weeklies or tournaments, which is where these types of hints originated.

An important note: if not enough hints of a certain type can be generated, it will just move on to the next type. Additionally, Entrance, Trials, and Always type hints are still dependent on settings, and as such you will often see their amounts as 0. This can be misleading as these hint types will still be generated, but their amounts will vary absed on settings.

==== Scrubs ====
The Scrubs Distribution is a continuation of the original Tournament Distribution as was in use from Season 1 to Season 3. This distribution was renamed and is still in use by the Scrub Community and others.

The description from the Hint Distribution file reads: "Tournament hints used for Scrubs Races. Duplicates of each hint, Skull Mask is an always hint, 5 WotH, 3 Foolish, 8 sometimes. Can also be used to simulate S3 Tournament hints."
{| class="wikitable"
|-
! Type !! Amount !! Copies
|-
| Trial || 0 || 2
|-
| Always || 0 || 2
|-
| WOTH || 5 || 2
|-
| Foolish || 3 || 2
|-
| Entrance || 4 || 2
|-
| Sometimes || 0 || 2
|-
| Random || 0 || 2
|}
The Sometimes and Random Hints are used as filler hints. This means that once all other hint types above have been placed, it'll start placing Sometimes hints on the remaining Gossip Stones. If it runs out of those, it'll start placing Random Hints instead.

==== Tournament ====
This distribution covers the current Ocarina of Time Randomizer Tournament's choice of hint distribution as it changes season to season. For Season 4, a new feature was added which allows the removal of certain groups of hint stones, forcing them to be Junk type hints. This allows for better routing of hints, disabling certain locations of hints, or in the case of Season 4 emulating earlier versions of the randomizer where the hints inside the generic grottos were all the same.

Therefore this distribution has the unique sub-category of disabled locations, listed thus: HC (Storms Grotto), HF (Cow Grotto), HF (Near Market Grotto), HF (Southeast Grotto), HF (Open Grotto), Kak (Open Grotto), ZR (Open Grotto), KF (Storms Grotto), LW (Near Shortcuts Grotto), DMT (Storms Grotto), DMC (Upper Grotto).

The description from the Hint Distribution file reads: "Tournament hints used for OoTR Season 4. Gossip stones in grottos are disabled. 4 WotH, 2 Barren, remainder filled with Sometimes. Always, WotH, and Barren hints duplicated."

And lastly the distribution itself is:
{| class="wikitable"
|-
! Type !! Amount !! Copies
|-
| Trial || 0 || 2
|-
| Always || 0 || 2
|-
| WOTH || 4 || 2
|-
| Foolish || 2 || 2
|-
| Entrance || 4 || 1
|-
| Sometimes || 0 || 1
|-
| Random || 0 || 1
|}
This distribution is pretty unique because rather than working with all 40 stones, 11 are removed from consideration, giving a final pool of 29. Also this uses another new feature which allows for certain items to be removed from consideration from a specified hint type. On this distribution, Zelda's Lullaby cannot be hinted as Way of the Hero.

=== Copies of WotH hints ===
Because the amount of copies of every hint type is known, you can determine how many WotH items an area has at minimum by the amount of hints you find for it. For example, if you find 2 WotH hints for Shadow Temple in the Tournament Distribution, that only means there's at least one WotH item in there (original hint plus the copy). Once you find a third hint you know for certain that there has to be a second WotH item in Shadow Temple (original hint plus copy plus another hint). Ditto for 5, 7 etc. In distributions where there's only one of each hint you can treat every WotH hint as it's own separate WotH item.

== Hint Logic ==
When a hint points towards a Major Item (WotH hints, location hints, random/item hints), at least one of the hints has to be available before you have to use said item. For example: If Ruto's Letter is on 50 Skultulla Tokens in a non-ER seed with Tournament Distribution, both hints towards it can't be at Zora's Fountain at the same time. At least one of them has to be available without the use of Ruto's Letter. You can (very rarely) use this info to your advantage. For example, if instead Ruto's Letter is at Man on Roof in Kakariko village and you find two WotH Kakariko hints in Zora's Fountain, you now know that at least one of those doesn't point towards Ruto's Letter, so there has to be a different WotH item in Kakariko.

In Beatable Only, some of these hints can still end up on completely unreachable Gossip Stones. You probably won't notice this during gameplay since the stone is completely unreachable in logic. You would have to sequence break to get to the hint in the first place.

Standard

2020-12-08T02:45:10Z

Dotzo: fixing a typo

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

=== Allowed ===
*Any accidental glitch which does not grant the player an advantage is okay
*Any technique required by the settings of the randomizer is allowed
*Savewarping
*Deathwarping
*Voiding to reset Link’s position
*Jumpslashing while mid-air for more distance
*Jumpslashing against walls for recoil
*Attacking to collect or hit an object on the other side of collision
*Power Crouch Stabbing
*Broken Deku Stick
*Damaging Volvagia’s second hitbox
*Crossing the Haunted Wasteland without Longshot or Hover Boots
*Rolling from blue switches to open doors
*Momentary Antigravity
**EG: B1 Skip in Deku Tree, going to the alcove in Forest Temple Block Room
*Using a cucco as child or hoverboots as adult to get behind the waterfall in Zora's River.
*Damage Buffering
*Invincibility Frame Abuse
**This includes passing through flame walls and opening flaming chests
*Backflip over Mido in the Lost Woods as Adult
*Flame Storage
*Schrodinger’s Chain
**This is the act of culling the drawbridge to the castle so that it no longer updates its collision. It's also gotten the affectionate name "cat chain" by the community.
*Twisted sidehops/backflips
*Recoil Jump
**This is the act of shielding damage midair to reset Link's animation, usually in order to grab a ledge
*Ground Jump
**NB: it is disallowed to Ground Jump off of the fake ground created by the Hover Boots
*Hookshotless Gerudo Training Grounds
*Hookshot extension
**See below for a caveat
**NB: Doing this with a Bow to shoot through collision is also allowed
*Passing through the back side of one-sided collision
**EG: the bottom of the bridge in Kokiri Forest, Darunia’s door, Song of Time block in Forest, Impa’s House ledge
*Backflipping through the spikes in the spike room of Shadow Temple
*Getting grabbed or thrown into collectibles such as GS tokens or Silver Rupees
*Swimming with Iron Boots
*Opening underwater chests while wearing Iron Boots and completing the Diving in the Lab with Iron Boots

=== Banned ===
*“Crazy Dance” or other variants in Spirit Temple
**This is the crossing of the interior statue in Spirit Temple by child Link to reach the adult side of the temple.
*Crossing the Gerudo Bridge without Longshot, Epona, or Requiem of Spirit
**NB: unless settings make it otherwise necessary, such as Entrance Randomizer
*Cucco Jump in Gerudo Valley to cross over the bridge
**NB: Using the cucco to reach the waterfall, soil, or crate is still allowed
*Child in Gerudo Fortress
**NB: unless settings make it otherwise necessary, such as Entrance Randomizer
*Opening Shadow Temple without Din's Fire
**NB: There is a trick that puts this in logic. If that trick is enabled, this is allowed.
*Culling cylindrical hitboxes in order to circumvent their collision
**EG: Hookshoting/Longshoting through boulders, shooting arrows through culled red ice, etc.
*Pause buffering to prevent timers from ending minigames
*Damage boosting to cross an otherwise uncrossable gap
*Ground Jump while in mid-air (as with Hover Boots)
*Using Temp B manipulation to allow Child Link to use an Adult sword, or vice versa
**IE: Riding Epona as Adult to store Master Sword to Temp B, going back to Child and dying with a blank B button
*Infinite Sword Glitch
*All forms of Superslide
*Hoverboosting
**Equipping hover boots on a specific frame of an instance of damage in order to conserve momentum and avoid friction
*Recoil Boosting
**Equipping hover boots on a specific frame of an instance of recoil in order to conserve momentum and avoid friction
*Megajumping
*Megafliping
*Megasidehoping
*Weirdshoting
*Hookshot Jump
*Extended Antigravity
*Low Gravity Glitch
*Seamwalking
*Being Out of Bounds
**Defined as: any area which is beyond the boundary walls of the map such as an outer seam, or any area which is exposed to the lowest void plane in the map
*Touching misplaced or accidentally exposed loading zones
**EG: early Jabu, Trials Skip, Market shops at night
*Passing through collision from the front
**IE: all forms of clipping
*Bypassing boulders blocking Crater Fairy and the Gerudo Valley boulder chest without breaking the boulders
*Cutscene diving to sink into water
**NB: This includes with Navi and Cuccos
*Using restricted items
**EG: Farore’s Wind in the overworld, or Ocarina in boss rooms
*Item Manipulation
**This is an umbrella term covering the glitches Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*Equip Swap
*Action Swap
**NB: This includes using the explosion limit to Ground Jump
*Using the effects of Quick Putaway
**EG: Lighting a torch with a Deku Stick with no present fire source.
*Ocarina Items
*Bottle Duplication
*Gold Skulltula Token/Heart Piece Duplication
*Collection delay
**EG: early Eyeball Frog or Gold Scale.
**NB: Delay happens naturally in many shops if you buy quickly, this is ok
*Something except for a Sword on B
**NB: This excludes normal circumstances like riding Epona or playing minigames
*Down A, Return A, and Blank A
*Causing a switch to remain pressed longer than it should
*Wrong Warp
*Void Warp
*Entrance Point Glitch
*Actor Glitch
*Bongo Bongo quick kill
*Bombing (0,0,0) to kill unloaded actors
*Unloading actors which should clearly be loaded
**EG: King Zora’s ice, graves in the graveyard, Gold Gauntlet monoliths
*Being in unloaded areas
*Dying to achieve anything other than a deathwarp or health refill (
**EG: Jabu “Slimy Thing” skip
*Walking while talking
*Z-Slide
*A-Slide
*SRM (Stale Reference Manipulation)
*Retaining the Master Sword in Phase 1 of the Ganon Fight
*Platform exclusive tricks

Standard

2020-11-11T20:21:26Z

Dotzo: /* Banned */

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 will of the Chamber of Sages. This ruleset is typically raced with [[Logic | glitchless]] logic. [[Rules | Other rulesets are also available.]]

=== Allowed ===
*Any accidental glitch which does not grant the player an advantage is okay
*Any technique required by the settings of the randomizer is allowed
*Savewarping
*Deathwarping
*Voiding to reset Link’s position
*Jumpslashing while mid-air for more distance
*Jumpslashing against walls for recoil
*Attacking to collect or hit an object on the other side of collision
*Power Crouch Stabbing
*Broken Deku Stick
*Damaging Volvagia’s second hitbox
*Crossing the Haunted Wasteland without Longshot or Hover Boots
*Rolling from blue switches to open doors
*Momentary Antigravity
**EG: B1 Skip in Deku Tree, going to the alcove in Forest Temple Block Room
*Using a cucco as child or hoverboots as adult to get behind the waterfall in Zora's River.
*Damage Buffering
*Invincibility Frame Abuse
**This includes passing through flame walls and opening flaming chests
*Backflip over Mido in the Lost Woods as Adult
*Flame Storage
*Schrodinger’s Chain
**This is the act of culling the drawbridge to the castle so that it no longer updates its collision. It's also gotten the affectionate name "cat chain" by the community.
*Twisted sidehops/backflips
*Recoil Jump
**This is the act of shielding damage midair to reset Link's animation, usually in order to grab a ledge
*Ground Jump
**NB: it is disallowed to Ground Jump off of the fake ground created by the Hover Boots
*Hookshotless Gerudo Training Grounds
*Hookshot extension
**See below for a caveat
**NB: Doing this with a Bow to shoot through collision is also allowed
*Passing through the back side of one-sided collision
**EG: the bottom of the bridge in Kokiri Forest, Darunia’s door, Song of Time block in Forest, Impa’s House ledge
*Backflipping through the spikes in the spike room of Shadow Temple
*Getting grabbed or thrown into collectibles such as GS tokens or Silver Rupees
*Swimming with Iron Boots
*Opening underwater chests while wearing Iron Boots and completing the Diving in the Lab with Iron Boots

=== Banned ===
*“Crazy Dance” or other variants in Spirit Temple
**This is the crossing of the interior statue in Spirit Temple by child Link to reach the adult side of the temple.
*Crossing the Gerudo Bridge without Longshot, Epona, or Requiem of Spirit
**NB: unless settings make it otherwise necessary, such as Entrance Randomizer
*Cucco Jump in Gerudo Valley to cross over the bridge
**NB: Using the cucco to reach the waterfall, soil, or crate is still allowed
*Child in Gerudo Fortress
**NB: unless settings make it otherwise necessary, such as Entrance Randomizer
*Opening Shadow Temple without Din's Fire
**NB: There is a trick that puts this in logic. If that trick is enabled, this is allowed.
*Culling cyclindrical hitboxes in order to circumvent their collision
**EG: Hookshoting/Longshoting through boulders, shooting arrows through culled red ice, etc.
*Pause buffering to prevent timers from ending minigames
*Damage boosting to cross an otherwise uncrossable gap
*Ground Jump while in mid-air (as with Hover Boots)
*Using Temp B manipulation to allow Child Link to use an Adult sword, or vice versa
**IE: Riding Epona as Adult to store Master Sword to Temp B, going back to Child and dying with a blank B button
*Infinite Sword Glitch
*All forms of Superslide
*Hoverboosting
**Equipping hover boots on a specific frame of an instance of damage in order to conserve momentum and avoid friction
*Recoil Boosting
**Equipping hover boots on a specific frame of an instance of recoil in order to conserve momentum and avoid friction
*Megajumping
*Megafliping
*Megasidehoping
*Weirdshoting
*Hookshot Jump
*Extended Antigravity
*Low Gravity Glitch
*Seamwalking
*Being Out of Bounds
**Defined as: any area which is beyond the boundary walls of the map such as an outer seam, or any area which is exposed to the lowest void plane in the map
*Touching misplaced or accidentally exposed loading zones
**EG: early Jabu, Trials Skip, Market shops at night
*Passing through collision from the front
**IE: all forms of clipping
*Bypassing boulders blocking Crater Fairy and the Gerudo Valley boulder chest without breaking the boulders
*Cutscene diving to sink into water
**NB: This includes with Navi and Cuccos
*Using restricted items
**EG: Farore’s Wind in the overworld, or Ocarina in boss rooms
*Item Manipulation
**This is an umbrella term covering the glitches Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*Equip Swap
*Action Swap
**NB: This includes using the explosion limit to Ground Jump
*Using the effects of Quick Putaway
**EG: Lighting a torch with a Deku Stick with no present fire source.
*Ocarina Items
*Bottle Duplication
*Gold Skulltula Token/Heart Piece Duplication
*Collection delay
**EG: early Eyeball Frog or Gold Scale.
**NB: Delay happens naturally in many shops if you buy quickly, this is ok
*Something except for a Sword on B
**NB: This excludes normal circumstances like riding Epona or playing minigames
*Down A, Return A, and Blank A
*Causing a switch to remain pressed longer than it should
*Wrong Warp
*Void Warp
*Entrance Point Glitch
*Actor Glitch
*Bongo Bongo quick kill
*Bombing (0,0,0) to kill unloaded actors
*Unloading actors which should clearly be loaded
**EG: King Zora’s ice, graves in the graveyard, Gold Gauntlet monoliths
*Being in unloaded areas
*Dying to achieve anything other than a deathwarp or health refill (
**EG: Jabu “Slimy Thing” skip
*Walking while talking
*Z-Slide
*A-Slide
*SRM (Stale Reference Manipulation)
*Retaining the Master Sword in Phase 1 of the Ganon Fight
*Platform exclusive tricks

Standard

2020-11-11T20:12:52Z

Dotzo: /* Banned */

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 will of the Chamber of Sages. This ruleset is typically raced with [[Logic | glitchless]] logic. [[Rules | Other rulesets are also available.]]

=== Allowed ===
*Any accidental glitch which does not grant the player an advantage is okay
*Any technique required by the settings of the randomizer is allowed
*Savewarping
*Deathwarping
*Voiding to reset Link’s position
*Jumpslashing while mid-air for more distance
*Jumpslashing against walls for recoil
*Attacking to collect or hit an object on the other side of collision
*Power Crouch Stabbing
*Broken Deku Stick
*Damaging Volvagia’s second hitbox
*Crossing the Haunted Wasteland without Longshot or Hover Boots
*Rolling from blue switches to open doors
*Momentary Antigravity
**EG: B1 Skip in Deku Tree, going to the alcove in Forest Temple Block Room
*Using a cucco as child or hoverboots as adult to get behind the waterfall in Zora's River.
*Damage Buffering
*Invincibility Frame Abuse
**This includes passing through flame walls and opening flaming chests
*Backflip over Mido in the Lost Woods as Adult
*Flame Storage
*Schrodinger’s Chain
**This is the act of culling the drawbridge to the castle so that it no longer updates its collision. It's also gotten the affectionate name "cat chain" by the community.
*Twisted sidehops/backflips
*Recoil Jump
**This is the act of shielding damage midair to reset Link's animation, usually in order to grab a ledge
*Ground Jump
**NB: it is disallowed to Ground Jump off of the fake ground created by the Hover Boots
*Hookshotless Gerudo Training Grounds
*Hookshot extension
**See below for a caveat
**NB: Doing this with a Bow to shoot through collision is also allowed
*Passing through the back side of one-sided collision
**EG: the bottom of the bridge in Kokiri Forest, Darunia’s door, Song of Time block in Forest, Impa’s House ledge
*Backflipping through the spikes in the spike room of Shadow Temple
*Getting grabbed or thrown into collectibles such as GS tokens or Silver Rupees
*Swimming with Iron Boots
*Opening underwater chests while wearing Iron Boots and completing the Diving in the Lab with Iron Boots

=== Banned ===
*“Crazy Dance” or other variants in Spirit Temple
**This is the crossing of the interior statue in Spirit Temple by child Link to reach the adult side of the temple.
*Crossing the Gerudo Bridge without Longshot, Epona, or Requiem of Spirit
**NB: unless settings make it otherwise necessary, such as Entrance Randomizer
*Cucco Jump in Gerudo Valley to cross over the bridge
**NB: Using the cucco to reach the waterfall, soil, or crate is still allowed
*Child in Gerudo Fortress
**NB: unless settings make it otherwise necessary, such as Entrance Randomizer
*Opening Shadow Temple without Din's Fire
**NB: There is a trick that puts this in logic. If that trick is enabled, this is allowed.
*Culling cyclindrical hitboxes in order to circumvent their collision
**EG: Hookshoting/Longshoting through boulders, shooting arrows through culled red ice, etc.
*Pause buffering to prevent timers from ending minigames
*Damage boosting
*Ground Jump while in mid-air (as with Hover Boots)
*Using Temp B manipulation to allow Child Link to use an Adult sword, or vice versa
**IE: Riding Epona as Adult to store Master Sword to Temp B, going back to Child and dying with a blank B button
*Infinite Sword Glitch
*All forms of Superslide
*Hoverboosting
**Equipping hover boots on a specific frame of an instance of damage in order to conserve momentum and avoid friction
*Recoil Boosting
**Equipping hover boots on a specific frame of an instance of recoil in order to conserve momentum and avoid friction
*Megajumping
*Megafliping
*Megasidehoping
*Weirdshoting
*Hookshot Jump
*Extended Antigravity
*Low Gravity Glitch
*Seamwalking
*Being Out of Bounds
**Defined as: any area which is beyond the boundary walls of the map such as an outer seam, or any area which is exposed to the lowest void plane in the map
*Touching misplaced or accidentally exposed loading zones
**EG: early Jabu, Trials Skip, Market shops at night
*Passing through collision from the front
**IE: all forms of clipping
*Bypassing boulders blocking Crater Fairy and the Gerudo Valley boulder chest without breaking the boulders
*Cutscene diving to sink into water
**NB: This includes with Navi and Cuccos
*Using restricted items
**EG: Farore’s Wind in the overworld, or Ocarina in boss rooms
*Item Manipulation
**This is an umbrella term covering the glitches Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*Equip Swap
*Action Swap
**NB: This includes using the explosion limit to Ground Jump
*Using the effects of Quick Putaway
**EG: Lighting a torch with a Deku Stick with no present fire source.
*Ocarina Items
*Bottle Duplication
*Gold Skulltula Token/Heart Piece Duplication
*Collection delay
**EG: early Eyeball Frog or Gold Scale.
**NB: Delay happens naturally in many shops if you buy quickly, this is ok
*Something except for a Sword on B
**NB: This excludes normal circumstances like riding Epona or playing minigames
*Down A, Return A, and Blank A
*Causing a switch to remain pressed longer than it should
*Wrong Warp
*Void Warp
*Entrance Point Glitch
*Actor Glitch
*Bongo Bongo quick kill
*Bombing (0,0,0) to kill unloaded actors
*Unloading actors which should clearly be loaded
**EG: King Zora’s ice, graves in the graveyard, Gold Gauntlet monoliths
*Being in unloaded areas
*Dying to achieve anything other than a deathwarp or health refill (
**EG: Jabu “Slimy Thing” skip
*Walking while talking
*Z-Slide
*A-Slide
*SRM (Stale Reference Manipulation)
*Retaining the Master Sword in Phase 1 of the Ganon Fight
*Platform exclusive tricks

Standard

2020-11-11T20:11:04Z

Dotzo: /* Allowed */

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 will of the Chamber of Sages. This ruleset is typically raced with [[Logic | glitchless]] logic. [[Rules | Other rulesets are also available.]]

=== Allowed ===
*Any accidental glitch which does not grant the player an advantage is okay
*Any technique required by the settings of the randomizer is allowed
*Savewarping
*Deathwarping
*Voiding to reset Link’s position
*Jumpslashing while mid-air for more distance
*Jumpslashing against walls for recoil
*Attacking to collect or hit an object on the other side of collision
*Power Crouch Stabbing
*Broken Deku Stick
*Damaging Volvagia’s second hitbox
*Crossing the Haunted Wasteland without Longshot or Hover Boots
*Rolling from blue switches to open doors
*Momentary Antigravity
**EG: B1 Skip in Deku Tree, going to the alcove in Forest Temple Block Room
*Using a cucco as child or hoverboots as adult to get behind the waterfall in Zora's River.
*Damage Buffering
*Invincibility Frame Abuse
**This includes passing through flame walls and opening flaming chests
*Backflip over Mido in the Lost Woods as Adult
*Flame Storage
*Schrodinger’s Chain
**This is the act of culling the drawbridge to the castle so that it no longer updates its collision. It's also gotten the affectionate name "cat chain" by the community.
*Twisted sidehops/backflips
*Recoil Jump
**This is the act of shielding damage midair to reset Link's animation, usually in order to grab a ledge
*Ground Jump
**NB: it is disallowed to Ground Jump off of the fake ground created by the Hover Boots
*Hookshotless Gerudo Training Grounds
*Hookshot extension
**See below for a caveat
**NB: Doing this with a Bow to shoot through collision is also allowed
*Passing through the back side of one-sided collision
**EG: the bottom of the bridge in Kokiri Forest, Darunia’s door, Song of Time block in Forest, Impa’s House ledge
*Backflipping through the spikes in the spike room of Shadow Temple
*Getting grabbed or thrown into collectibles such as GS tokens or Silver Rupees
*Swimming with Iron Boots
*Opening underwater chests while wearing Iron Boots and completing the Diving in the Lab with Iron Boots

=== Banned ===
*“Crazy Dance” or other variants in Spirit Temple
**This is the crossing of the interior statue in Spirit Temple by child Link to reach the adult side of the temple.
*Crossing the Gerudo Bridge without Longshot, Epona, or Requiem of Spirit
**NB: unless settings make it otherwise necessary, such as Entrance Randomizer
*Cucco Jump in Gerudo Valley to cross over the bridge
**NB: Using the cucco to reach the waterfall, soil, or crate is still allowed
*Child in Gerudo Fortress
**NB: unless settings make it otherwise necessary, such as Entrance Randomizer
*Opening Shadow Temple without Din's Fire
**NB: There is a trick that puts this in logic. If that trick is enabled, this is allowed.
*Culling cyclindrical hitboxes in order to circumvent their collision
**EG: Hookshoting/Longshoting through boulders, shooting arrows through culled red ice, etc.
*Pause buffering to prevent timers from ending minigames
*Damage boosting
*Ground Jump while in mid-air (as with Hover Boots)
*Infinite Sword Glitch
*All forms of Superslide
*Hoverboosting
**Equipping hover boots on a specific frame of an instance of damage in order to conserve momentum and avoid friction
*Recoil Boosting
**Equipping hover boots on a specific frame of an instance of recoil in order to conserve momentum and avoid friction
*Megajumping
*Megafliping
*Megasidehoping
*Weirdshoting
*Hookshot Jump
*Extended Antigravity
*Low Gravity Glitch
*Seamwalking
*Being Out of Bounds
**Defined as: any area which is beyond the boundary walls of the map such as an outer seam, or any area which is exposed to the lowest void plane in the map
*Touching misplaced or accidentally exposed loading zones
**EG: early Jabu, Trials Skip, Market shops at night
*Passing through collision from the front
**IE: all forms of clipping
*Bypassing boulders blocking Crater Fairy and the Gerudo Valley boulder chest without breaking the boulders
*Cutscene diving to sink into water
**NB: This includes with Navi and Cuccos
*Using restricted items
**EG: Farore’s Wind in the overworld, or Ocarina in boss rooms
*Item Manipulation
**This is an umbrella term covering the glitches Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*Equip Swap
*Action Swap
**NB: This includes using the explosion limit to Ground Jump
*Using the effects of Quick Putaway
**EG: Lighting a torch with a Deku Stick with no present fire source.
*Ocarina Items
*Bottle Duplication
*Gold Skulltula Token/Heart Piece Duplication
*Collection delay
**EG: early Eyeball Frog or Gold Scale.
**NB: Delay happens naturally in many shops if you buy quickly, this is ok
*Something except for a Sword on B
**NB: This excludes normal circumstances like riding Epona or playing minigames
*Down A, Return A, and Blank A
*Causing a switch to remain pressed longer than it should
*Wrong Warp
*Void Warp
*Entrance Point Glitch
*Actor Glitch
*Bongo Bongo quick kill
*Bombing (0,0,0) to kill unloaded actors
*Unloading actors which should clearly be loaded
**EG: King Zora’s ice, graves in the graveyard, Gold Gauntlet monoliths
*Being in unloaded areas
*Dying to achieve anything other than a deathwarp or health refill (
**EG: Jabu “Slimy Thing” skip
*Walking while talking
*Z-Slide
*A-Slide
*SRM (Stale Reference Manipulation)
*Retaining the Master Sword in Phase 1 of the Ganon Fight
*Platform exclusive tricks

No IM/WW

2020-11-01T19:09:58Z

Dotzo: /* Banned */

Banning only the most broken glitches in Ocarina of Time, the noIM/WW ruleset seeks to provide a way for experienced players to use their favorite glitches to their hearts' content, skipping large swathes of the game. This is also the default ruleset of [[Glitched_Logic|Glitched Logic]] as well as what that is based on. While the name is almost fully descriptive of what is banned, there are some extra things.

[[Rules | Other rulesets are also available.]]

=== Allowed ===
*Everything that isn't banned

=== Banned ===
*Wrong Warps
*Item Manipulation
**An umbrella term for Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*SRM (Stale Reference Manipulation)
*ACE (Arbitrary Code Execution)
*Dropping Bombchus Out of Bounds
**NB: This crashes N64

No IM/WW

2020-11-01T19:09:40Z

Dotzo: /* Banned */

Banning only the most broken glitches in Ocarina of Time, the noIM/WW ruleset seeks to provide a way for experienced players to use their favorite glitches to their hearts' content, skipping large swathes of the game. This is also the default ruleset of [[Glitched_Logic|Glitched Logic]] as well as what that is based on. While the name is almost fully descriptive of what is banned, there are some extra things.

[[Rules | Other rulesets are also available.]]

=== Allowed ===
*Everything that isn't banned

=== Banned ===
*Wrong Warps
*Item Manipulation
**An umbrella term for Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*SRM (Stale Reference Manipulation)
*Dropping Bombchus Out of Bounds
**NB: This crashes N64

Glossary

2020-10-26T03:27:47Z

Dotzo: /* B */

Most every small community will eventually create its own jargon and abbreviations for things naturally out of the desire to communicate more quickly.  Ocarina of Time and the Randomizer which was built for it is no different.  Below you'll find an alphabetized list of both terminology and abbreviations commonly used in both the Ocarina of Time speedrunning and randomizer communities.  If you join the discord or a stream chat and are curious what something means, but don't want to ask, this is the place for you.

{{TOClimit|limit=2}}

= A =
=== ACE ===
- Arbitrary Code Execution. Allows the player to write data into the game's memory and have it executed as code. This is one of the most powerful glitches any video game can have as it theoretically allows you to rewrite the entire game into something else using nothing but the game itself.
=== AD ===
- An abbreviation for All Dungeons. In randomizer this can refer to both a setting which requires all of the dungeons to be beaten, but often it is refering to a seed where it was not required by the settings to beat every dungeon yet the item placement and ruleset combination forced it. This is also a speedrun category where the goal is to beat every dungeon and reach the credits.
=== All Locations Reachable ===
- A setting available as part of the randomizer which ensures that you can reach every location in the game under your current [[logic]] setting.
=== ALR ===
- [[#All Locations Reachable|All Locations Reachable]].

= B =
=== BA ===
- Bottle Adventure. A glitch which allows the player to write an arbitrary value to their B button.
=== Bait ===
- A term used to describe an item, location, or hint that may be unnecessary if the player knows a way to circumvent it.
=== Barren ===
- A synonym for [[#Foolish|Foolish]].
=== Beatable Only ===
- A reference to turning the [[#All Locations Reachable|All Locations Reachable]] setting off which can logically lock off entire sections of the game, based on an older name for this setting.
=== BGS ===
- Biggoron's Sword.
=== Bingo ===
- A game mode where you generate a 5x5 board of goals to complete. When you've completed a goal you check it off the board. There are many sub-variants of bingo which change how it is played. The most common ways to play, however, are standard bingo (any 5 in a row, column, or diagonal), blackout (complete all 25 goals), and lockout (only 1 person can complete any goal, person who has the most wins).
=== BK ===
- Boss Key.
=== BK Mode ===
- A commonly used phrase in [[Multiworld]] games describing the situation where a player can no longer do any [[#Check|checks]] due to their lacking of items. Stands for "Burger King Mode" after a player actually went to Burger King to get food while their teammates gathered items.
=== Blue Potato ===
- A nickname for the Ocarina of Time, due to its color and shape.
=== BotW ===
- Bottom of the Well. This is also used as an abbreviation for the game The Legend of Zelda: Breath of the Wild. Normally it is clear from context which is meant, however this shared abbreviation is often used in jokes.
=== BQ ===
- Beta Quest. A romhack which randomizes shuffles the entrance table completely randomly. Items remain in their vanilla areas, but those areas can be anywhere.
=== Burning Kak ===
- Alternative name for the Nocturne of Shadow [[#Check|check]], requiring the Forest, Fire, and Water Medallions and then walking into Kakariko Village.

= C =
=== Check ===
- A location in the game where you can receive a randomized item.
=== Co-op ===
- Often written as simply "coop", this can be referring to a couple things. "Local coop" is where multiple people play the same seed separately, but share information. "[[#Online|Online]] coop" refers to a separate emulator setup that allows multiple people to play in the same game as the same time.
=== Culling ===
- The act of moving the camera or Link far enough away from an actor so that it ceases updating every frame. This can be used glitchlessly to hold actors in place, most useful for Keese. If glitches are allowed, then it can be used to ignore some collision as well.

= D =
=== Damage ESS ===
- An alternative name for a [[#FESS|FESS]].
=== DC ===
- Dodongo's Cavern.
=== DDR ===
- [[Dungeon Door Requirement]]. A [[Rules|ruleset]] for racing which allows more glitches than [[#Standard|Standard]].

=== DMC ===
- Death Mountain Crater.
=== DMT ===
- Death Mountain Trail.
=== DoT ===
- The Door of Time. Openable with just the [[#SoT|Song of Time]]. One of the oldest glitches in Ocarina of Time is the DoT skip, allowing the player to become adult without first obtaining the Song of Time.
=== DT ===
- Deku Tree. An uncommon abbreviation.

= E =
=== Egg ===
- Can refer to either the [[#Pocket Egg|Pocket Egg]] or the [[#Weird Egg|Weird Egg]].
=== Entrance Randomizer ===
- A setting which shuffles the entrances in the world giving it an entirely new geography.
=== ER ===
- [[Entrance Randomizer|Entrance Randomizer]].

=== ESS ===
- Extended Superslide. However, this acronym is most commonly used in reference to the region on the control stick in which the game recognizes minimal input. Link will turn in place at a constant angle per frame, which is exceedingly useful for setups. You will almost never see this written out.

=== ESS Turns ===
- Using [[#ESS|ESS]] position in small increments to turn specific angles. Often seen in discrete amounts such as "3 ess turns right" or "3 ess right."

= F =
=== FESS ===
- An abbreviation for Forward [[#Extended Superslide|Extended Superslide]]. Also known as a [[#Damage ESS|Damage ESS]], this is a method of failure when attempting a [[#HESS|HESS]]. This is almost never seen typed out fully.
=== Flame Storange ===
- A glitch which allows you to remotely light a Deku Stick on fire, allowing you to carry it a longer distance.
=== Foolish ===
- Used to describe a region of the game which is devoid of logically useful items. Hints will say that searching the area is a "[[Hints#Foolish Choice|Foolish Choice]]."

=== Freestanding ===
- This is used to describe [[#Check|checks]] which are not in a chest and instead just items on the ground to be picked up. In randomizer, they will take on the appearance of the item which you will receive as in vanilla they are all Heart Pieces, Heart Containers, and small keys. Be careful of ice traps!
=== Frog Song ===
- After playing the 6 white note songs for the frogs in Zora's River, you can prompt them to play a bug catching game. The goal of the game is to press the button of the corresponding frog when the bug is over their head. However, the order of this song never changes. It is always: A < > v < > v A v A v > < v

= G =
=== GBK ===
- Ganon's Boss Key.
=== GC ===
- A abbreviation for either Ganon's Castle or Goron City. This is used inconsistently, but is usually clear from context.
=== GF ===
- Gerudo Fortress.
=== GIM ===
- Get Item Manipulation. A glitch which allows the player to modify the item which is queued to be given to them.
=== GJ ===
- [[#Groundjump|Groundjump]].
=== GK ===
- Giant's Knife. This is a very uncommon abbreviation. Can refer to both the [[#Check|check]] and the item itself.
=== Glow Mode ===
- The point in a randomizer game when you only need to gather the Light Arrows to proceed to the end of the game.
=== Go Mode ===
- The point in a randomizer game when you either have or know the location of every item you require to beat the game.
=== Greg ===
- A nickname for the "Rupee (1)" item, standing for Green Rupee of Eternal Glory.
=== Groundjump ===
- A glitch that allows the player to cancel a backflip or sidehop, effectively giving Link the ability to jump slightly higher.
=== GS ===
- Gold Skulltula.
=== GT ===
- An abbreviation for Ganon's Tower. This is not very commonly used.
=== GTG ===
- Gerudo Training Grounds.
=== GV ===
- Gerudo Valley.
=== GY ===
- An uncommon abbreviation for the Graveyard.
=== GZ ===
- Our [https://practicerom.com/ practice tool], also known as the Practice ROM.

= H =
=== HBA ===
- Horseback Archery. Refers to both the 1000 and 1500 game in the Gerudo Fortress that in vanilla rewards a Heart Piece and Quiver upgrade, respectively.
=== HC ===
- Heart Container.
=== HESS ===
- Hyper [[#Extended Superslide|Extended Superslide]]. A glitch which allows the player to move backwards at the highest sustainable in-game speed. This is almost never seen typed out fully.
=== HF ===
- Hyrule Field.
=== Hookshot Extension ===
- A technique which allows the player to fire their hookshot, longshot, bow, or slingshot from slightly in front of where it would normally fire, allowing you to hook on to things a little bit easier and even shoot through some walls.
=== Hover ===
- In a glitchless context, refers to using the Hover boots to cross a gap. In glitch contexts, can also refer to using [[#ISG|ISG]] and a damage source to literally hover in midair.
=== HP ===
- Heart Piece. Also commonly referred to as PoH or Piece of Heart.

= I =
=== IC ===
- Ice Cavern.
=== IM ===
- An umbrella term for the three glitches: [[#RBA|RBA]], [[#BA|BA]], and [[#GIM|GIM]].
=== ISG ===
- A glitch which results in your weapon being in a constant attack state.

= J =
=== Jabu ===
- Jabu Jabu's Belly. Sometimes referred to as JJB, although this is exceedingly rare.

= K =
=== Kak ===
- Short for Kakariko Village.
=== KD ===
- King Dodongo.
=== KF ===
- Kokiri Forest.
=== Know Mode ===
- Exclusive to restreams, this is a point in the randomizer whereby the audience knows the location of every item required to beat the game through the means of watching multiple players at once.
=== KZ ===
- King Zora.

= L =
=== LACS ===
- Light Arrow Cutscene. In randomizer, this mainly refers to the location where you would normally receive the Light Arrows in vanilla.
=== Ladder ===
- A type of randomizer race where a pool of racers are ranked on one leaderboard where rank is determined by a pairing of many 1-vs.-1 races. Please see their [https://ootrladder.com/ website] for more details.
=== Lensless Wasteland ===
- The act of crossing the Haunted Wasteland without the Lens of Truth. The path is always the same, so memorizing it removes the need for following the Poe.
=== LLR ===
- Lon Lon Ranch.

= M =
=== Megaflip ===
- A glitch which allows the player to backflip with maximum sustainable speed to extend its distance.
=== Megasidehop ===
- A glitch which allows the player to sidehop with maximum sustainable speed to extend its distance.
=== MoT ===
- Mask of Truth. Refers to both the item and the [[#Check|check]] from showing it in the Deku Theatre.

= N =
=== Naked Wasteland ===
- The act of crossing the Haunted Wasteland, although more specifically the quicksand on the Gerudo Fortress side of the Wasteland, without the use of any items. This can be achieved with a well-aimed backwalk.
=== No IM/WW ===
- A [[No IM/WW|ruleset]] for racing.
=== No Logic ===
- A setting that will place items into the world completely at random without checking that the game is beatable. Ocarina of Time has many glitches, so most seeds will still be beatable but often may require use of very advanced tech.

= O =
=== Ocarina Minigame ===
- The minigame in Lost Woods in which you repeat back a series of ocarina notes to two skull kids.
=== OGC ===
- Outside Ganon's Castle. Refers to the area where the Rainbow Bridge spawns, the Gold Skulltula there, as well as the Fairy Fountain reward.
=== Online ===
- Refers to the [https://discord.gg/UFVY9DE ModLoader64] emulator and setup which allows multiple people to play in the same game at the same time.
=== OoT ===
- The Legend of Zelda: Ocarina of Time. Also commonly used to refer to the Ocarina of Time item or location.
=== Out of Logic ===
- Obtaining an item or performing an activity outside of the intended order determined by the program's logic.

= P =
=== Path of Gold ===
- A type of [[Hints#Path of Gold|hint]] describing an area which contains an item logically required to collect every Triforce Piece in the seed. Appears only when [[#Triforce Hunt|Triforce Hunt]] is enabled.
=== PCS ===
- [[#Power Crouch Stab|Power Crouch Stab]]
=== PG ===
- Phantom Ganon.
=== Pocket Egg ===
- The first item in the adult trade sequence, ultimately resulting in the Biggoron's Sword.
=== PoG ===
- [[#Path of Gold|Path of Gold]].
=== PoH ===
- Piece of Heart. Also commonly referred to as HP or Heart Piece.
=== Potato ===
- A nickname for the Fairy Ocarina, due to its color and shape.
=== Power Crouch Stab ===
- The damage value used for crouch stabs is the last attack used with a sword/hammer/stick. Most often used in conjuction with a jumpslash to "store" a high damage attack in order to deal damage more quickly. This technique is known as ''Power Crouch Stabbing''. When no sword/hammer/stick has been used since entering the current area the crouch stab will take the damage value of a regular Kokiri Sword slash.

= Q =
=== QPA ===
- Quick Putaway. A glitch which allows the player to store a glitched [[#Power Crouch Stab|Power Crouch Stab]] value.

= R =
=== RA ===
- A common abbreviation for the emulator [[Retroarch]].
=== Reverse Wasteland ===
- The act of traveling the Haunted Wasteland from the Colossus side to the Fortress side. This is considered [[#Out of Logic|Out of Logic]] by default, though can be enabled via the Tricks menu.
=== RBA ===
- Reverse Bottle Adventure. A glitch which allows the player to write values into memory. It is extremely powerful, but very limited.

= S =
=== Skull Mask ===
- This refers to both the item itself which is part of the Child Trade Quest, as well as the [[#Check|check]] in which the mask is shown off in the Deku Theater.
=== SoS ===
- Song of Storms. Can refer to both the song itself and the location you would normally find it in vanilla.
=== SoT ===
- Song of Time. Can refer to both the song itself and the location you would normally find it in vanilla.
=== Spoiler Log ===
- A document created by the randomizer which lists all the settings, item locations, hints, etc. This will not open automatically or give you any extra information. It simply serves as a resource in case you get stuck or if you really wanted to know what was in that one chest you forgot.
=== SRM ===
- Stale Reference Manipulation. A glitch which allows the player to take advantage of free but uncleared memory to do a variety of things including but not limited to calling arbitrary functions, redirecting pointers, and [[#ACE|Arbitrary Code Execution]].
=== Standard ===
- [[Standard]] is the most common racing [[rules|ruleset]].

= T =
=== TH ===
- [[#Triforce Hunt|Triforce Hunt]].
=== Three Song Route ===
- A common opener for the [[Standard]] weekly races that involves [[#Check|checking]] all 3 child song locations - Zelda's Lullaby, Epona's Song, Saria's Song - in quick succession.
=== Trials ===
- Another way to refer to entirety of Ganon's Castle and Ganon's Tower.
=== Triforce Hunt===
- An alternative game mode where pieces of the Triforce are spread throughout the world and you must collect a certain number to win.

= U =

= V =

= W =
=== Way of the Hero ===
- A [[Hints#Way of the Hero|hint]] which describes an area which contains an item that is logically required to beat the game.

=== Weird Egg ===
- The first item in the child trade series, ultimately resulting in the Mask of Truth.
=== Weirdshot ===
- A glitch which allows the player to fire first person weapons from underground.
=== WOTH ===
- [[#Way of the Hero|Way of the Hero]]

= X =

= Y =

= Z =
=== ZD ===
- Zora's Domain.
=== ZF ===
- Zora's Fountain.
=== ZL ===
- An abbreviation for either Zelda's Letter or Zelda's Lullaby. It is often clear from context which is meant. It can also refer to the vanilla location of Zelda's Lullaby to refer to it as a [[#Check|check]].
=== ZR ===
- Zora's River.

Glitch Logic (outdated)

2020-10-26T02:57:16Z

Dotzo:

Glitch Logic is a different set of logic files to the normal [[Logic|Glitchless Logic]] files. These take into account a massive amount of tricks, glitches, clips, etc. for placement of items throughout the world. This option is a somewhat middle ground between the Glitchless Logic, which expects only what the player can normally perform with no special knowledge, and No Logic, which randomly places items throughout the world without regard to potential softlocks. This set of logic files was designed around the no IM/WW ruleset.

== no IM/WW ==

[[No_IM/WW|No Item Manipulation or Wrong warp]], commonly abbreviated no IM/WW is a [[Rules|ruleset]] originating from the speedrun community of Ocarina of Time. It has evolved over the years from its humble beginnings and has changed names many times. The name currently comes from the two major categories of glitches which are banned by the ruleset: Item Manipulation and Wrong Warping.

==== Item Manipulation ====

This is an umbrella term for 3 glitches in particular which can be used to effectively hack items into your inventory or HUD. These 3 glitches are Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM). These glitches can allow you to write medallions straight into your inventory, give yourself a Hammer on B even if you don't have one in the inventory, and even turn a Recovery Heart into Light Arrows, just to name a few examples. The overarching power of these glitches to circumvent gameplay is why they are banned.

==== Wrong Warp ====

The Wrong Warp is probably the most famous glitch in Ocarina of Time as it is the crux of the any% route, allowing the player to instantly teleport themselves from Gohma's Boss Room straight to the Collapse sequence following the Ganondorf Fight, essentially skipping the entire game. How it works is beyond the scope of this description, however essentially we can influence what entrance the game pulls from an internal table. Blue warps are not the only way to do this as one can also use Trade Item timers and Farore's Wind, amongst other things, to achieve similar effects. As with Item Manipulation this is banned as it circumvents a lot of gameplay.

== Guidelines ==

Because playing Ocarina of Time with glitches, even ones not so powerful as IM and WW, allows the player to do some crazy stuff and skip a lot of things, certain guidelines were put in place when considering how to handle the logic. There were 4 tenets that went into building the logic and they are as follows:

# Any trick or glitch must be infinitely repeatable to be considered in logic.
# Obscurity of a trick or glitch is not a factor in its inclusion .
# Difficulty of a trick or glitch may be a factor.
#* Any trick which has a reliable setup can be considered regardless of its difficulty or precision.
# In regards to hovering, only those which are incredibly common, obviously possible, or quite short will be considered.
#* A maximum of 20 bombs or 50 chus, with chus in logic, is the distance/height limit.

==== Allowed but not in logic ====

As these guidelines are both fairly strict and fairly loose at the same time, a list of tricks/glitches which are possible under the no IM/WW ruleset, but are not logically considered are as follows:

*Ocarina Items
**When done improperly you can dupe a bottle over an item which is irretrievable violating tenet #1.
*Equip Swap
**Allows duping bottles over irretrievable items in much the same way as ocarina items.
*Actor Push Clips
**These are clips where actors such as bombs or small rocks push Link through seams or other actors. Unless a repeatable setup exists, these are not considered due to their extreme precision.
*Reaching Zelda as a child without moving sleeping Talon.
**Getting Zelda's Letter prior to the Weird Egg can lead to a situation whereby you are unable to trade masks at all, locking the Skull Mask and Mask of Truth checks forever.
*Out of Bounds Chu Hovers
**These crash the game on N64 and emulator, thus are not considered in logic for any reason.
*Item Duping
**Duping Skulltula tokens, GTG Keys, Heart Pieces, etc. by any means.
*Extra Heart Pieces
**These are not randomized at all, so if you want an extra Heart Piece go grab the 37th.

== Oddities ==

Because the game is so incredibly open and free under this ruleset there are many situations that you can find yourself in which could potentially softlock your game by not allowing you access to a specific check. These are listed below:

*Any of the tricks/glitches mentioned above.
*Obtaining the last chest in Ice Cavern as a child will not give you the song check.
**NOTE: This is no longer the case as of dev version 5.2.71, where you will get the Serenade check no matter which age you open the chest as.
*Collection delay such as Hold R or Gold Scale as child.
*The Colossus hands chests (vanilla Mirror Shield and Silver Gauntlets) are considered part of Spirit Temple for hints.
*Child Fire Temple
**Logically child isn't considered to have any access to Fire Temple.

== Less Common Maneuvers ==

This table consists of things which can be expected of the player logically and which are less common in the world of speedrunning, or aren't as widely known by the public. This list is NOT exhaustive of what's required, however simply serves to highlight some of the most esoteric things which aren't immediately obvious as possible to someone who otherwise has general knowledge of glitches in OoT.

{| class="wikitable"
| Area || Description || Video(s) || Name
|-
| Dodongo's Cavern || Hover onto the head or hookshot jump || https://www.youtube.com/watch?v=XlJU9IR4Yc8 || DC Hookshot Jump
|-
| Dodongo's Cavern || Hoverboost to it || https://www.youtube.com/watch?v=aGoR-nCXVKQ || DC Stairs Skulltula Hoverboost
|-
| Dodongo's Cavern || Connected to lobby, hover into head and jump into the door || https://www.youtube.com/watch?v=PU7FfP0zYiM || DC Enter Back Area with Head Closed
|-
| Ice Cavern || Child clip || https://www.youtube.com/watch?v=KWuhClJKaNU || Ice Child Clip to Compass Room
|-
| Ice Cavern || Adult hover recoil or HESS through red ice || https://www.youtube.com/watch?v=qkNQOAXV_DM || Ice Adult Clip to Iron Boots
|-
| Ice Cavern || Clip red ice as child or hoverboost as adult || https://www.youtube.com/watch?v=asxpTMImoJ4 || Ice Puzzle Room Skulltula
|-
| Fire Temple || Ledge clip the boss platform, hover OOB || https://www.youtube.com/watch?v=iFGpHVLysoI https://www.youtube.com/watch?v=lug_wipqBdI || Fire BK Skip with Hover
|-
| Fire Temple || Break door and reload the room || https://www.youtube.com/watch?v=-bOCrfxafnw || Fire Flare Dancer no Explosives
|-
| Deku Tree || Only is_adult because 231 skip from compass room || https://www.youtube.com/watch?v=FRNf34xShqE || 231 Skip as Adult
|-
| Kokiri Forest || Get into the roof as adult with just ISG || https://www.youtube.com/watch?v=0athDHNrqz4 || Adult Skull No Hookshot
|-
| Bottom of the Well || Actor glitch or vine clip || https://www.youtube.com/watch?v=Y8gunZf4vEk || Deadhand without ZL
|-
| Ganon's Castle || Gold gauntlets skip without hovers || https://www.youtube.com/watch?v=knD785hDfjw || Fire Trial Gold Gauntlets Skip
|-
| Ganon's Castle || Weirdshot the torch slug || https://www.youtube.com/watch?v=1fYWFCiozc8 || Spirit Trial Chus skip
|-
| Ganon's Castle || Rupee without hookshot/shield || https://www.twitch.tv/videos/49443412 || Spirit Trial Hookshot skip
|-
| Water Temple || Hookshot the chest around the door above || https://www.youtube.com/watch?v=xzUnMvDBwo0 || Cracked Wall Chest No Explosives
|-
| Water Temple || Various tricks to get around in Water Temple || https://www.youtube.com/watch?v=jLWPQ__MO4A || Showcase of Water Temple Mobility
|-
| Water Temple || Hover to river chest from dragon head room || https://www.youtube.com/watch?v=ZgyG1JLxLF4 || Hover to River Chest from Dragon Head Room
|-
| Water Temple || Song of Time skip for longshot to river || https://www.youtube.com/watch?v=rOFJipW6aoQ || Song of Time Skip
|-
| Water Temple || Ledge clip out of bounds || https://www.youtube.com/watch?v=0RTgJZURmHk || Ledge Clip in the Alcove
|-
| Lake Hylia || Child Navi dive and adult can ground clip or swim around if Morpha beaten || https://www.youtube.com/watch?v=LOgjpPd5A_Y https://www.youtube.com/watch?v=W6I_moafi8A || To Zora's Domain from Lake Hylia
|-
| Water Temple || Child entry || https://www.youtube.com/watch?v=CU57Cpgtsv8 || Enter Water with Nothing
|-
| General || Child swordless DoT skip and adult DoT skip || https://www.youtube.com/watch?v=GRyP43DidF8 https://www.youtube.com/watch?v=aolcugsrlkg || DoT Skip
|-
| Hyrule Castle || Clip into Din's Fire without explosives swordless || https://www.youtube.com/watch?v=WGf-8oJQrWk || Din's Fire without Explosives
|-
| Hyrule Castle || Seam walk swordless || https://www.youtube.com/watch?v=5R6-ViFgoiY || Swordless Seamwalk Setup in Hyrule Castle
|-
| Kokiri Forest || Rock push escape || https://www.youtube.com/watch?v=kvW3sJmmmBY || Itemless Escape
|-
| Ganon's Castle || Damage clip into double defense || https://www.youtube.com/watch?v=I3pwrLRSo8U || Damage Clip to Double Defense
|-
| Ganon's Castle || Superslide/recoil clip into double defense || https://www.youtube.com/watch?v=dJQTB4TKJh8 https://www.youtube.com/watch?v=UoPvmiHUMhQ || Superslide or Recoil Clip to Double Defense
|-
| Kakariko Village || Drop off ladder and jumpslash || https://www.youtube.com/watch?v=7XDrhExj3M4 || Tower Skull with Jumpslash
|-
| Graveyard || Unload graves and Shadow door || https://www.youtube.com/watch?v=MKXJHbEpkcw ||
|-
| DMT Chest Clip || Jumpslash clip past the explody wall || https://www.youtube.com/watch?v=wlDgntC5MS0 ||
|-
| DMC Upper from DMT || Tektite Hover || ||
|-
| DMT Magic || Explosiveless magic || ||
|-
| Goron City || Boulder maze hess || ||
|-
| Goron City || Pot with chus || https://www.youtube.com/watch?v=RlBz7qFljZQ ||
|-
| Goron City || Clip into Darunia's room || ||
|-
| DMC Lower || Clip statue in Darunia's chamber as child || ||
|-
| DMC Hammer Grotto || Weirdclip || ||
|-
| Zora's River Clip to LW || Clip or cucco dive || https://www.youtube.com/watch?v=zy9sW50GXhQ ||
|-
| Domain to Lake Clip || Humpslash clip || https://www.youtube.com/watch?v=Tw0E7nCSVLE ||
|-
| GS Domain || Throw pot through the ceiling to kill jumpslash to collect || https://www.youtube.com/watch?v=oVsdZ1URaqk ||
|-
| Frozen Domain to Lake || Ladder clip || https://www.youtube.com/watch?v=nFNtKyGu-Jo ||
|-
| Kokiri Forest || Itemless escape || https://www.youtube.com/watch?v=yKjlROAWPDU ||
|-
| Lake Hylia || Tektite hover || ||
|-
| Gerudo Valley || Crate HP as adult with just hoverboots || https://youtu.be/qzqgDPbOY7o ||
|-
| Zora's Domain || Unfreeze king zora with Navi || ||
|-
| Spirit Trial || Rupee with no items - needs setup || ||
|-
| BotW || Ocarina dive || https://www.youtube.com/watch?v=msx6hwUHXKM ||
|-
| BotW || Vine clip with sticks || https://www.youtube.com/watch?v=kweZHHT56-0 ||
|-
| BotW || Vineclip || https://www.youtube.com/watch?v=AbbLcln2PIs ||
|-
| BotW Keese Room GS || Keese hover || https://youtu.be/tuWC0PiXs0c ||
|-
| BotW Pot Room GS || No item hover (watch the right side at the timestamp) || https://youtu.be/G_r44m9Ggjs?t=40 ||
|-
| Dodongo's Cavern || Recoil jump to switch as child || https://www.youtube.com/watch?v=v0TpAcM51AI&t=7s ||
|-
| Goron City || Statue clip to crater as child || https://youtu.be/UCnoWTA4xE8 ||
|-
| Spirit trial || Silver rupees with just mastersword || https://youtu.be/2wR9Pw8CwRg ||
|-
| Ice Cavern || Left side red ice HESS clip || https://www.youtube.com/watch?v=ggzKbvYXv94 ||
|-
| Jabu Compass || Adult no boots/fairy || https://www.youtube.com/watch?v=Dj46eaWJpHs ||
|-
| Jabu Compass || Adult no damage || https://www.youtube.com/watch?v=cXjNjygQK3o ||
|-
| GTG|| Dlame circle key room - gold switch without hammer || https://www.youtube.com/watch?v=DiWbVbyK-J0 ||
|-
| Spirit Temple || Child side as adult with just hoverboots || https://www.youtube.com/watch?v=rLRro_F7MxY ||
|-
| Spirit Temple || Child side as adult with just explosives || https://www.youtube.com/watch?v=VwxYwVHDnPE ||
|-
| SPirit Temple || Clip child side pillar as adult with bombs || https://www.youtube.com/watch?v=ZHANwJT929c ||
|-
| Spirit Temple || Reach adult side as child from main room (crazy dance) || https://www.youtube.com/watch?v=OsWBm2bjsbA ||
|-
| Forest Temple || Reach boss as child || https://youtu.be/wDXpoH5iwnI ||
|-
| Shadow Temple || Child fence clip with jumpslash || https://www.youtube.com/watch?v=pP4JNCU8fgU ||
|-
| Water Temple || Tektite Navi dive || https://youtu.be/iAOlgvI2eaU ||
|}

Glitch Logic (outdated)

2020-10-26T02:56:49Z

Dotzo:

Glitch Logic is a different set of logic files to the normal [[Logic|Glitchless Logic] files. These take into account a massive amount of tricks, glitches, clips, etc. for placement of items throughout the world. This option is a somewhat middle ground between the Glitchless Logic, which expects only what the player can normally perform with no special knowledge, and No Logic, which randomly places items throughout the world without regard to potential softlocks. This set of logic files was designed around the no IM/WW ruleset.

== no IM/WW ==

[[No_IM/WW|No Item Manipulation or Wrong warp]], commonly abbreviated no IM/WW is a [[Rules|ruleset]] originating from the speedrun community of Ocarina of Time. It has evolved over the years from its humble beginnings and has changed names many times. The name currently comes from the two major categories of glitches which are banned by the ruleset: Item Manipulation and Wrong Warping.

==== Item Manipulation ====

This is an umbrella term for 3 glitches in particular which can be used to effectively hack items into your inventory or HUD. These 3 glitches are Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM). These glitches can allow you to write medallions straight into your inventory, give yourself a Hammer on B even if you don't have one in the inventory, and even turn a Recovery Heart into Light Arrows, just to name a few examples. The overarching power of these glitches to circumvent gameplay is why they are banned.

==== Wrong Warp ====

The Wrong Warp is probably the most famous glitch in Ocarina of Time as it is the crux of the any% route, allowing the player to instantly teleport themselves from Gohma's Boss Room straight to the Collapse sequence following the Ganondorf Fight, essentially skipping the entire game. How it works is beyond the scope of this description, however essentially we can influence what entrance the game pulls from an internal table. Blue warps are not the only way to do this as one can also use Trade Item timers and Farore's Wind, amongst other things, to achieve similar effects. As with Item Manipulation this is banned as it circumvents a lot of gameplay.

== Guidelines ==

Because playing Ocarina of Time with glitches, even ones not so powerful as IM and WW, allows the player to do some crazy stuff and skip a lot of things, certain guidelines were put in place when considering how to handle the logic. There were 4 tenets that went into building the logic and they are as follows:

# Any trick or glitch must be infinitely repeatable to be considered in logic.
# Obscurity of a trick or glitch is not a factor in its inclusion .
# Difficulty of a trick or glitch may be a factor.
#* Any trick which has a reliable setup can be considered regardless of its difficulty or precision.
# In regards to hovering, only those which are incredibly common, obviously possible, or quite short will be considered.
#* A maximum of 20 bombs or 50 chus, with chus in logic, is the distance/height limit.

==== Allowed but not in logic ====

As these guidelines are both fairly strict and fairly loose at the same time, a list of tricks/glitches which are possible under the no IM/WW ruleset, but are not logically considered are as follows:

*Ocarina Items
**When done improperly you can dupe a bottle over an item which is irretrievable violating tenet #1.
*Equip Swap
**Allows duping bottles over irretrievable items in much the same way as ocarina items.
*Actor Push Clips
**These are clips where actors such as bombs or small rocks push Link through seams or other actors. Unless a repeatable setup exists, these are not considered due to their extreme precision.
*Reaching Zelda as a child without moving sleeping Talon.
**Getting Zelda's Letter prior to the Weird Egg can lead to a situation whereby you are unable to trade masks at all, locking the Skull Mask and Mask of Truth checks forever.
*Out of Bounds Chu Hovers
**These crash the game on N64 and emulator, thus are not considered in logic for any reason.
*Item Duping
**Duping Skulltula tokens, GTG Keys, Heart Pieces, etc. by any means.
*Extra Heart Pieces
**These are not randomized at all, so if you want an extra Heart Piece go grab the 37th.

== Oddities ==

Because the game is so incredibly open and free under this ruleset there are many situations that you can find yourself in which could potentially softlock your game by not allowing you access to a specific check. These are listed below:

*Any of the tricks/glitches mentioned above.
*Obtaining the last chest in Ice Cavern as a child will not give you the song check.
**NOTE: This is no longer the case as of dev version 5.2.71, where you will get the Serenade check no matter which age you open the chest as.
*Collection delay such as Hold R or Gold Scale as child.
*The Colossus hands chests (vanilla Mirror Shield and Silver Gauntlets) are considered part of Spirit Temple for hints.
*Child Fire Temple
**Logically child isn't considered to have any access to Fire Temple.

== Less Common Maneuvers ==

This table consists of things which can be expected of the player logically and which are less common in the world of speedrunning, or aren't as widely known by the public. This list is NOT exhaustive of what's required, however simply serves to highlight some of the most esoteric things which aren't immediately obvious as possible to someone who otherwise has general knowledge of glitches in OoT.

{| class="wikitable"
| Area || Description || Video(s) || Name
|-
| Dodongo's Cavern || Hover onto the head or hookshot jump || https://www.youtube.com/watch?v=XlJU9IR4Yc8 || DC Hookshot Jump
|-
| Dodongo's Cavern || Hoverboost to it || https://www.youtube.com/watch?v=aGoR-nCXVKQ || DC Stairs Skulltula Hoverboost
|-
| Dodongo's Cavern || Connected to lobby, hover into head and jump into the door || https://www.youtube.com/watch?v=PU7FfP0zYiM || DC Enter Back Area with Head Closed
|-
| Ice Cavern || Child clip || https://www.youtube.com/watch?v=KWuhClJKaNU || Ice Child Clip to Compass Room
|-
| Ice Cavern || Adult hover recoil or HESS through red ice || https://www.youtube.com/watch?v=qkNQOAXV_DM || Ice Adult Clip to Iron Boots
|-
| Ice Cavern || Clip red ice as child or hoverboost as adult || https://www.youtube.com/watch?v=asxpTMImoJ4 || Ice Puzzle Room Skulltula
|-
| Fire Temple || Ledge clip the boss platform, hover OOB || https://www.youtube.com/watch?v=iFGpHVLysoI https://www.youtube.com/watch?v=lug_wipqBdI || Fire BK Skip with Hover
|-
| Fire Temple || Break door and reload the room || https://www.youtube.com/watch?v=-bOCrfxafnw || Fire Flare Dancer no Explosives
|-
| Deku Tree || Only is_adult because 231 skip from compass room || https://www.youtube.com/watch?v=FRNf34xShqE || 231 Skip as Adult
|-
| Kokiri Forest || Get into the roof as adult with just ISG || https://www.youtube.com/watch?v=0athDHNrqz4 || Adult Skull No Hookshot
|-
| Bottom of the Well || Actor glitch or vine clip || https://www.youtube.com/watch?v=Y8gunZf4vEk || Deadhand without ZL
|-
| Ganon's Castle || Gold gauntlets skip without hovers || https://www.youtube.com/watch?v=knD785hDfjw || Fire Trial Gold Gauntlets Skip
|-
| Ganon's Castle || Weirdshot the torch slug || https://www.youtube.com/watch?v=1fYWFCiozc8 || Spirit Trial Chus skip
|-
| Ganon's Castle || Rupee without hookshot/shield || https://www.twitch.tv/videos/49443412 || Spirit Trial Hookshot skip
|-
| Water Temple || Hookshot the chest around the door above || https://www.youtube.com/watch?v=xzUnMvDBwo0 || Cracked Wall Chest No Explosives
|-
| Water Temple || Various tricks to get around in Water Temple || https://www.youtube.com/watch?v=jLWPQ__MO4A || Showcase of Water Temple Mobility
|-
| Water Temple || Hover to river chest from dragon head room || https://www.youtube.com/watch?v=ZgyG1JLxLF4 || Hover to River Chest from Dragon Head Room
|-
| Water Temple || Song of Time skip for longshot to river || https://www.youtube.com/watch?v=rOFJipW6aoQ || Song of Time Skip
|-
| Water Temple || Ledge clip out of bounds || https://www.youtube.com/watch?v=0RTgJZURmHk || Ledge Clip in the Alcove
|-
| Lake Hylia || Child Navi dive and adult can ground clip or swim around if Morpha beaten || https://www.youtube.com/watch?v=LOgjpPd5A_Y https://www.youtube.com/watch?v=W6I_moafi8A || To Zora's Domain from Lake Hylia
|-
| Water Temple || Child entry || https://www.youtube.com/watch?v=CU57Cpgtsv8 || Enter Water with Nothing
|-
| General || Child swordless DoT skip and adult DoT skip || https://www.youtube.com/watch?v=GRyP43DidF8 https://www.youtube.com/watch?v=aolcugsrlkg || DoT Skip
|-
| Hyrule Castle || Clip into Din's Fire without explosives swordless || https://www.youtube.com/watch?v=WGf-8oJQrWk || Din's Fire without Explosives
|-
| Hyrule Castle || Seam walk swordless || https://www.youtube.com/watch?v=5R6-ViFgoiY || Swordless Seamwalk Setup in Hyrule Castle
|-
| Kokiri Forest || Rock push escape || https://www.youtube.com/watch?v=kvW3sJmmmBY || Itemless Escape
|-
| Ganon's Castle || Damage clip into double defense || https://www.youtube.com/watch?v=I3pwrLRSo8U || Damage Clip to Double Defense
|-
| Ganon's Castle || Superslide/recoil clip into double defense || https://www.youtube.com/watch?v=dJQTB4TKJh8 https://www.youtube.com/watch?v=UoPvmiHUMhQ || Superslide or Recoil Clip to Double Defense
|-
| Kakariko Village || Drop off ladder and jumpslash || https://www.youtube.com/watch?v=7XDrhExj3M4 || Tower Skull with Jumpslash
|-
| Graveyard || Unload graves and Shadow door || https://www.youtube.com/watch?v=MKXJHbEpkcw ||
|-
| DMT Chest Clip || Jumpslash clip past the explody wall || https://www.youtube.com/watch?v=wlDgntC5MS0 ||
|-
| DMC Upper from DMT || Tektite Hover || ||
|-
| DMT Magic || Explosiveless magic || ||
|-
| Goron City || Boulder maze hess || ||
|-
| Goron City || Pot with chus || https://www.youtube.com/watch?v=RlBz7qFljZQ ||
|-
| Goron City || Clip into Darunia's room || ||
|-
| DMC Lower || Clip statue in Darunia's chamber as child || ||
|-
| DMC Hammer Grotto || Weirdclip || ||
|-
| Zora's River Clip to LW || Clip or cucco dive || https://www.youtube.com/watch?v=zy9sW50GXhQ ||
|-
| Domain to Lake Clip || Humpslash clip || https://www.youtube.com/watch?v=Tw0E7nCSVLE ||
|-
| GS Domain || Throw pot through the ceiling to kill jumpslash to collect || https://www.youtube.com/watch?v=oVsdZ1URaqk ||
|-
| Frozen Domain to Lake || Ladder clip || https://www.youtube.com/watch?v=nFNtKyGu-Jo ||
|-
| Kokiri Forest || Itemless escape || https://www.youtube.com/watch?v=yKjlROAWPDU ||
|-
| Lake Hylia || Tektite hover || ||
|-
| Gerudo Valley || Crate HP as adult with just hoverboots || https://youtu.be/qzqgDPbOY7o ||
|-
| Zora's Domain || Unfreeze king zora with Navi || ||
|-
| Spirit Trial || Rupee with no items - needs setup || ||
|-
| BotW || Ocarina dive || https://www.youtube.com/watch?v=msx6hwUHXKM ||
|-
| BotW || Vine clip with sticks || https://www.youtube.com/watch?v=kweZHHT56-0 ||
|-
| BotW || Vineclip || https://www.youtube.com/watch?v=AbbLcln2PIs ||
|-
| BotW Keese Room GS || Keese hover || https://youtu.be/tuWC0PiXs0c ||
|-
| BotW Pot Room GS || No item hover (watch the right side at the timestamp) || https://youtu.be/G_r44m9Ggjs?t=40 ||
|-
| Dodongo's Cavern || Recoil jump to switch as child || https://www.youtube.com/watch?v=v0TpAcM51AI&t=7s ||
|-
| Goron City || Statue clip to crater as child || https://youtu.be/UCnoWTA4xE8 ||
|-
| Spirit trial || Silver rupees with just mastersword || https://youtu.be/2wR9Pw8CwRg ||
|-
| Ice Cavern || Left side red ice HESS clip || https://www.youtube.com/watch?v=ggzKbvYXv94 ||
|-
| Jabu Compass || Adult no boots/fairy || https://www.youtube.com/watch?v=Dj46eaWJpHs ||
|-
| Jabu Compass || Adult no damage || https://www.youtube.com/watch?v=cXjNjygQK3o ||
|-
| GTG|| Dlame circle key room - gold switch without hammer || https://www.youtube.com/watch?v=DiWbVbyK-J0 ||
|-
| Spirit Temple || Child side as adult with just hoverboots || https://www.youtube.com/watch?v=rLRro_F7MxY ||
|-
| Spirit Temple || Child side as adult with just explosives || https://www.youtube.com/watch?v=VwxYwVHDnPE ||
|-
| SPirit Temple || Clip child side pillar as adult with bombs || https://www.youtube.com/watch?v=ZHANwJT929c ||
|-
| Spirit Temple || Reach adult side as child from main room (crazy dance) || https://www.youtube.com/watch?v=OsWBm2bjsbA ||
|-
| Forest Temple || Reach boss as child || https://youtu.be/wDXpoH5iwnI ||
|-
| Shadow Temple || Child fence clip with jumpslash || https://www.youtube.com/watch?v=pP4JNCU8fgU ||
|-
| Water Temple || Tektite Navi dive || https://youtu.be/iAOlgvI2eaU ||
|}

Glitched Logic

2020-10-26T02:56:38Z

Dotzo: Dotzo moved page Glitched Logic to Glitch Logic: remove the implication that the logic is bugged somehow

#REDIRECT [[Glitch Logic]]

Glitch Logic (outdated)

2020-10-26T02:56:38Z

Dotzo: Dotzo moved page Glitched Logic to Glitch Logic: remove the implication that the logic is bugged somehow

Glitched Logic is a different set of logic files to the normal [[Logic|Glitchless Logic] files. These take into account a massive amount of tricks, glitches, clips, etc. for placement of items throughout the world. This option is a somewhat middle ground between the Glitchless Logic, which expects only what the player can normally perform with no special knowledge, and No Logic, which randomly places items throughout the world without regard to potential softlocks. This set of logic files was designed around the no IM/WW ruleset.

== no IM/WW ==

[[No_IM/WW|No Item Manipulation or Wrong warp]], commonly abbreviated no IM/WW is a [[Rules|ruleset]] originating from the speedrun community of Ocarina of Time. It has evolved over the years from its humble beginnings and has changed names many times. The name currently comes from the two major categories of glitches which are banned by the ruleset: Item Manipulation and Wrong Warping.

==== Item Manipulation ====

This is an umbrella term for 3 glitches in particular which can be used to effectively hack items into your inventory or HUD. These 3 glitches are Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM). These glitches can allow you to write medallions straight into your inventory, give yourself a Hammer on B even if you don't have one in the inventory, and even turn a Recovery Heart into Light Arrows, just to name a few examples. The overarching power of these glitches to circumvent gameplay is why they are banned.

==== Wrong Warp ====

The Wrong Warp is probably the most famous glitch in Ocarina of Time as it is the crux of the any% route, allowing the player to instantly teleport themselves from Gohma's Boss Room straight to the Collapse sequence following the Ganondorf Fight, essentially skipping the entire game. How it works is beyond the scope of this description, however essentially we can influence what entrance the game pulls from an internal table. Blue warps are not the only way to do this as one can also use Trade Item timers and Farore's Wind, amongst other things, to achieve similar effects. As with Item Manipulation this is banned as it circumvents a lot of gameplay.

== Guidelines ==

Because playing Ocarina of Time with glitches, even ones not so powerful as IM and WW, allows the player to do some crazy stuff and skip a lot of things, certain guidelines were put in place when considering how to handle the logic. There were 4 tenets that went into building the logic and they are as follows:

# Any trick or glitch must be infinitely repeatable to be considered in logic.
# Obscurity of a trick or glitch is not a factor in its inclusion .
# Difficulty of a trick or glitch may be a factor.
#* Any trick which has a reliable setup can be considered regardless of its difficulty or precision.
# In regards to hovering, only those which are incredibly common, obviously possible, or quite short will be considered.
#* A maximum of 20 bombs or 50 chus, with chus in logic, is the distance/height limit.

==== Allowed but not in logic ====

As these guidelines are both fairly strict and fairly loose at the same time, a list of tricks/glitches which are possible under the no IM/WW ruleset, but are not logically considered are as follows:

*Ocarina Items
**When done improperly you can dupe a bottle over an item which is irretrievable violating tenet #1.
*Equip Swap
**Allows duping bottles over irretrievable items in much the same way as ocarina items.
*Actor Push Clips
**These are clips where actors such as bombs or small rocks push Link through seams or other actors. Unless a repeatable setup exists, these are not considered due to their extreme precision.
*Reaching Zelda as a child without moving sleeping Talon.
**Getting Zelda's Letter prior to the Weird Egg can lead to a situation whereby you are unable to trade masks at all, locking the Skull Mask and Mask of Truth checks forever.
*Out of Bounds Chu Hovers
**These crash the game on N64 and emulator, thus are not considered in logic for any reason.
*Item Duping
**Duping Skulltula tokens, GTG Keys, Heart Pieces, etc. by any means.
*Extra Heart Pieces
**These are not randomized at all, so if you want an extra Heart Piece go grab the 37th.

== Oddities ==

Because the game is so incredibly open and free under this ruleset there are many situations that you can find yourself in which could potentially softlock your game by not allowing you access to a specific check. These are listed below:

*Any of the tricks/glitches mentioned above.
*Obtaining the last chest in Ice Cavern as a child will not give you the song check.
**NOTE: This is no longer the case as of dev version 5.2.71, where you will get the Serenade check no matter which age you open the chest as.
*Collection delay such as Hold R or Gold Scale as child.
*The Colossus hands chests (vanilla Mirror Shield and Silver Gauntlets) are considered part of Spirit Temple for hints.
*Child Fire Temple
**Logically child isn't considered to have any access to Fire Temple.

== Less Common Maneuvers ==

This table consists of things which can be expected of the player logically and which are less common in the world of speedrunning, or aren't as widely known by the public. This list is NOT exhaustive of what's required, however simply serves to highlight some of the most esoteric things which aren't immediately obvious as possible to someone who otherwise has general knowledge of glitches in OoT.

{| class="wikitable"
| Area || Description || Video(s) || Name
|-
| Dodongo's Cavern || Hover onto the head or hookshot jump || https://www.youtube.com/watch?v=XlJU9IR4Yc8 || DC Hookshot Jump
|-
| Dodongo's Cavern || Hoverboost to it || https://www.youtube.com/watch?v=aGoR-nCXVKQ || DC Stairs Skulltula Hoverboost
|-
| Dodongo's Cavern || Connected to lobby, hover into head and jump into the door || https://www.youtube.com/watch?v=PU7FfP0zYiM || DC Enter Back Area with Head Closed
|-
| Ice Cavern || Child clip || https://www.youtube.com/watch?v=KWuhClJKaNU || Ice Child Clip to Compass Room
|-
| Ice Cavern || Adult hover recoil or HESS through red ice || https://www.youtube.com/watch?v=qkNQOAXV_DM || Ice Adult Clip to Iron Boots
|-
| Ice Cavern || Clip red ice as child or hoverboost as adult || https://www.youtube.com/watch?v=asxpTMImoJ4 || Ice Puzzle Room Skulltula
|-
| Fire Temple || Ledge clip the boss platform, hover OOB || https://www.youtube.com/watch?v=iFGpHVLysoI https://www.youtube.com/watch?v=lug_wipqBdI || Fire BK Skip with Hover
|-
| Fire Temple || Break door and reload the room || https://www.youtube.com/watch?v=-bOCrfxafnw || Fire Flare Dancer no Explosives
|-
| Deku Tree || Only is_adult because 231 skip from compass room || https://www.youtube.com/watch?v=FRNf34xShqE || 231 Skip as Adult
|-
| Kokiri Forest || Get into the roof as adult with just ISG || https://www.youtube.com/watch?v=0athDHNrqz4 || Adult Skull No Hookshot
|-
| Bottom of the Well || Actor glitch or vine clip || https://www.youtube.com/watch?v=Y8gunZf4vEk || Deadhand without ZL
|-
| Ganon's Castle || Gold gauntlets skip without hovers || https://www.youtube.com/watch?v=knD785hDfjw || Fire Trial Gold Gauntlets Skip
|-
| Ganon's Castle || Weirdshot the torch slug || https://www.youtube.com/watch?v=1fYWFCiozc8 || Spirit Trial Chus skip
|-
| Ganon's Castle || Rupee without hookshot/shield || https://www.twitch.tv/videos/49443412 || Spirit Trial Hookshot skip
|-
| Water Temple || Hookshot the chest around the door above || https://www.youtube.com/watch?v=xzUnMvDBwo0 || Cracked Wall Chest No Explosives
|-
| Water Temple || Various tricks to get around in Water Temple || https://www.youtube.com/watch?v=jLWPQ__MO4A || Showcase of Water Temple Mobility
|-
| Water Temple || Hover to river chest from dragon head room || https://www.youtube.com/watch?v=ZgyG1JLxLF4 || Hover to River Chest from Dragon Head Room
|-
| Water Temple || Song of Time skip for longshot to river || https://www.youtube.com/watch?v=rOFJipW6aoQ || Song of Time Skip
|-
| Water Temple || Ledge clip out of bounds || https://www.youtube.com/watch?v=0RTgJZURmHk || Ledge Clip in the Alcove
|-
| Lake Hylia || Child Navi dive and adult can ground clip or swim around if Morpha beaten || https://www.youtube.com/watch?v=LOgjpPd5A_Y https://www.youtube.com/watch?v=W6I_moafi8A || To Zora's Domain from Lake Hylia
|-
| Water Temple || Child entry || https://www.youtube.com/watch?v=CU57Cpgtsv8 || Enter Water with Nothing
|-
| General || Child swordless DoT skip and adult DoT skip || https://www.youtube.com/watch?v=GRyP43DidF8 https://www.youtube.com/watch?v=aolcugsrlkg || DoT Skip
|-
| Hyrule Castle || Clip into Din's Fire without explosives swordless || https://www.youtube.com/watch?v=WGf-8oJQrWk || Din's Fire without Explosives
|-
| Hyrule Castle || Seam walk swordless || https://www.youtube.com/watch?v=5R6-ViFgoiY || Swordless Seamwalk Setup in Hyrule Castle
|-
| Kokiri Forest || Rock push escape || https://www.youtube.com/watch?v=kvW3sJmmmBY || Itemless Escape
|-
| Ganon's Castle || Damage clip into double defense || https://www.youtube.com/watch?v=I3pwrLRSo8U || Damage Clip to Double Defense
|-
| Ganon's Castle || Superslide/recoil clip into double defense || https://www.youtube.com/watch?v=dJQTB4TKJh8 https://www.youtube.com/watch?v=UoPvmiHUMhQ || Superslide or Recoil Clip to Double Defense
|-
| Kakariko Village || Drop off ladder and jumpslash || https://www.youtube.com/watch?v=7XDrhExj3M4 || Tower Skull with Jumpslash
|-
| Graveyard || Unload graves and Shadow door || https://www.youtube.com/watch?v=MKXJHbEpkcw ||
|-
| DMT Chest Clip || Jumpslash clip past the explody wall || https://www.youtube.com/watch?v=wlDgntC5MS0 ||
|-
| DMC Upper from DMT || Tektite Hover || ||
|-
| DMT Magic || Explosiveless magic || ||
|-
| Goron City || Boulder maze hess || ||
|-
| Goron City || Pot with chus || https://www.youtube.com/watch?v=RlBz7qFljZQ ||
|-
| Goron City || Clip into Darunia's room || ||
|-
| DMC Lower || Clip statue in Darunia's chamber as child || ||
|-
| DMC Hammer Grotto || Weirdclip || ||
|-
| Zora's River Clip to LW || Clip or cucco dive || https://www.youtube.com/watch?v=zy9sW50GXhQ ||
|-
| Domain to Lake Clip || Humpslash clip || https://www.youtube.com/watch?v=Tw0E7nCSVLE ||
|-
| GS Domain || Throw pot through the ceiling to kill jumpslash to collect || https://www.youtube.com/watch?v=oVsdZ1URaqk ||
|-
| Frozen Domain to Lake || Ladder clip || https://www.youtube.com/watch?v=nFNtKyGu-Jo ||
|-
| Kokiri Forest || Itemless escape || https://www.youtube.com/watch?v=yKjlROAWPDU ||
|-
| Lake Hylia || Tektite hover || ||
|-
| Gerudo Valley || Crate HP as adult with just hoverboots || https://youtu.be/qzqgDPbOY7o ||
|-
| Zora's Domain || Unfreeze king zora with Navi || ||
|-
| Spirit Trial || Rupee with no items - needs setup || ||
|-
| BotW || Ocarina dive || https://www.youtube.com/watch?v=msx6hwUHXKM ||
|-
| BotW || Vine clip with sticks || https://www.youtube.com/watch?v=kweZHHT56-0 ||
|-
| BotW || Vineclip || https://www.youtube.com/watch?v=AbbLcln2PIs ||
|-
| BotW Keese Room GS || Keese hover || https://youtu.be/tuWC0PiXs0c ||
|-
| BotW Pot Room GS || No item hover (watch the right side at the timestamp) || https://youtu.be/G_r44m9Ggjs?t=40 ||
|-
| Dodongo's Cavern || Recoil jump to switch as child || https://www.youtube.com/watch?v=v0TpAcM51AI&t=7s ||
|-
| Goron City || Statue clip to crater as child || https://youtu.be/UCnoWTA4xE8 ||
|-
| Spirit trial || Silver rupees with just mastersword || https://youtu.be/2wR9Pw8CwRg ||
|-
| Ice Cavern || Left side red ice HESS clip || https://www.youtube.com/watch?v=ggzKbvYXv94 ||
|-
| Jabu Compass || Adult no boots/fairy || https://www.youtube.com/watch?v=Dj46eaWJpHs ||
|-
| Jabu Compass || Adult no damage || https://www.youtube.com/watch?v=cXjNjygQK3o ||
|-
| GTG|| Dlame circle key room - gold switch without hammer || https://www.youtube.com/watch?v=DiWbVbyK-J0 ||
|-
| Spirit Temple || Child side as adult with just hoverboots || https://www.youtube.com/watch?v=rLRro_F7MxY ||
|-
| Spirit Temple || Child side as adult with just explosives || https://www.youtube.com/watch?v=VwxYwVHDnPE ||
|-
| SPirit Temple || Clip child side pillar as adult with bombs || https://www.youtube.com/watch?v=ZHANwJT929c ||
|-
| Spirit Temple || Reach adult side as child from main room (crazy dance) || https://www.youtube.com/watch?v=OsWBm2bjsbA ||
|-
| Forest Temple || Reach boss as child || https://youtu.be/wDXpoH5iwnI ||
|-
| Shadow Temple || Child fence clip with jumpslash || https://www.youtube.com/watch?v=pP4JNCU8fgU ||
|-
| Water Temple || Tektite Navi dive || https://youtu.be/iAOlgvI2eaU ||
|}

Dungeon Door Requirement

2020-10-14T04:25:27Z

Dotzo: /* Tips and Advice */

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

== Banned Glitches ==
*Item Manipulation:
**Reverse Bottle Adventure (RBA)
**Bottle Adventure (BA)
**Get Item Manipulation (GIM)
*Wrong Warp
*Stale Reference Manipulation (SRM)
*Platform Exclusive Tricks (such as Deku Sticks as Adult, 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, bari hover, etc.)
*Anything other than sword on B (beyond normal cases, such as minigames)
*Collection Delay (e.g., Gold Scale from child fishing)
*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 key requirement'''.

=== Dungeon Entrance Requirement ===
All dungeons must be opened their intended way (as defined below), so any glitch that gains entry to these dungeons prematurely are not allowed. 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) and Ganon’s Castle. This means that Bottom of the Well, Ice Cavern, and Gerudo Training Grounds are not restricted in their access. If the Trials are on, there is no need to complete any of them.

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 in (note that Spirit Hovers 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).

=== Boss Key Requirement ===
If a player wishes to enter a boss room locked by a boss key (including Ganondorf), the door MUST be opened with the corresponding boss key. This means that all boss key skips are banned. This requirement does not apply to child dungeons (i.e., Deku Tree, Dodongo's Cavern, and Jabu) as the boss doors do not have boss keys, so access to bosses in child dungeons is unrestricted.

== 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 Kokiri Tunic green value less than 0x98, as anything higher will crash should you get the "weird" type of weirdshot. For a full technical explanation, [https://pastebin.com/K0AdCBNn click here].

Dungeon Door Requirement

2020-10-13T16:50:45Z

Dotzo: /* Dungeon Entrance Requirement */

GGJ

2020-09-28T14:27:32Z

Dotzo: /* Allowed */

Below is the list of allowed and banned techniques for the Glitchless + Ground Jumps (GGJ) ruleset. Because this was based on a ruleset from the vanilla game, you may notice significant differences in the level of detail in describing what is allowed or banned when comparing to the Standard ruleset. Please feel free to assume that if it is not listed, and doesn't otherwise violate one of the explicitly banned conditions, that it is allowed.

This ruleset will update over time to include new discoveries as they are made, however the goal of banning only by technique - regardless of the consequences - will remain in effect.

This ruleset is typically raced with [[Logic | glitchless]] logic. [[Rules | Other rulesets are also available.]]

=== Allowed ===
*Damage Boosting
*Hoverboosting
*Power Crouch Stabbing
*Roll invincibility
*Post-damage invincibility
*Jumpslashing in mid-air for more distance
*Shield dropping
*Using broken deku stick
*Hookshot Extension
*Rolling from the blue switch in Jabu Jabu's Belly
*Damage Buffering
*Placing bombs on lava pits to damage Volvagia
*Skipping text triggers via weapon swapping
*Opening underwater chests while wearing the Iron Boots
*Passing through the back side of a one-sided collision
**EG: bridge clip, darunia's door, forest's falling ceiling
*Attacking to collect or hit an object on the other side of a collision
*Momentary Antigravity
**EG: b1 skip
*Recoil Jump
**Shielding damage midair to take Link out of a backflip or sidehop and into a normal airborne state
*Twisted sidehops or backflips out of siderolls or standing ESS shuffles
*Ground Jumps
*Culling actors
**EG: keeping enemies off screen to stop them from moving, hookshotting through boulders' hitboxes
*Using cutscene items to delay timers
*Moving through cylindrical collision
**EG: Sidehopping into double magic

=== Banned ===
*Infinite Sword Glitch
*Megaflip and megasidehop
*Extended Antigravity
**EG: unloading lower gerudo fortress
*All forms of superslide
*Hovering
*Going Out of Bounds
**Any area which is beyond the boundary walls of the map such as an outer seam, or any area which is exposed to the lowest void plane in the map
*Entrance point glitch or other respawn point manipulation
*Passing through collision from the front
**IE: clipping
**NB: This includes passing through the falling spikes in shadow temple since they have been shown to be solid
*Cutscene diving to sink into water
*Flame storage
*Item Manipulation
**This is an umbrella term covering the glitches Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*Using collection delay to your advantage
**EG: early eyeball frog or gold scale
**NB: Delay happens naturally in many shops if you buy quickly, this is ok
*Something except for a sword on B
**NB: This does not include normal circumstances like riding Epona
*Bottle Duplication
*Wrong warp
*Void warp
*Walking While Talking
*Causing a switch to remain pressed longer than it should
*Ocarina Items
*Z-slide
*A-slide
*Using restricted items
**IE: Farore's Wind in the Overworld or Ocarina in boss rooms
*Being in an unloaded area
*Unloading an actor which clearly should be loaded
**EG: Actor Glitch, unloading KZ's ice, overloading the graveyard or trials to remove graves or Gold Gauntlet monoliths, pause buffering the timer expiration during the diving minigame
*SRM (Stale Reference Manipulation)
*Action Swap
**NB: This includes using the explosion limit to Ground Jump
*Using the effects of Quick Putaway
**EG: Lighting a torch with a Deku Stick with no present fire source.
*Equip Swap
*Ledge Cancel
*Retaining the Master Sword in Phase 1 of the Ganon Fight
*Dying to achieve anything other than a deathwarp

GGJ

2020-09-28T14:27:19Z

Dotzo: /* Banned */

Below is the list of allowed and banned techniques for the Glitchless + Ground Jumps (GGJ) ruleset. Because this was based on a ruleset from the vanilla game, you may notice significant differences in the level of detail in describing what is allowed or banned when comparing to the Standard ruleset. Please feel free to assume that if it is not listed, and doesn't otherwise violate one of the explicitly banned conditions, that it is allowed.

This ruleset will update over time to include new discoveries as they are made, however the goal of banning only by technique - regardless of the consequences - will remain in effect.

This ruleset is typically raced with [[Logic | glitchless]] logic. [[Rules | Other rulesets are also available.]]

=== Allowed ===
*Damage Boosting
*Power Crouch Stabbing
*Roll invincibility
*Post-damage invincibility
*Jumpslashing in mid-air for more distance
*Shield dropping
*Using broken deku stick
*Hookshot Extension
*Rolling from the blue switch in Jabu Jabu's Belly
*Damage Buffering
*Placing bombs on lava pits to damage Volvagia
*Skipping text triggers via weapon swapping
*Opening underwater chests while wearing the Iron Boots
*Passing through the back side of a one-sided collision
**EG: bridge clip, darunia's door, forest's falling ceiling
*Attacking to collect or hit an object on the other side of a collision
*Momentary Antigravity
**EG: b1 skip
*Recoil Jump
**Shielding damage midair to take Link out of a backflip or sidehop and into a normal airborne state
*Twisted sidehops or backflips out of siderolls or standing ESS shuffles
*Ground Jumps
*Culling actors
**EG: keeping enemies off screen to stop them from moving, hookshotting through boulders' hitboxes
*Using cutscene items to delay timers
*Moving through cylindrical collision
**EG: Sidehopping into double magic

=== Banned ===
*Infinite Sword Glitch
*Megaflip and megasidehop
*Extended Antigravity
**EG: unloading lower gerudo fortress
*All forms of superslide
*Hovering
*Going Out of Bounds
**Any area which is beyond the boundary walls of the map such as an outer seam, or any area which is exposed to the lowest void plane in the map
*Entrance point glitch or other respawn point manipulation
*Passing through collision from the front
**IE: clipping
**NB: This includes passing through the falling spikes in shadow temple since they have been shown to be solid
*Cutscene diving to sink into water
*Flame storage
*Item Manipulation
**This is an umbrella term covering the glitches Bottle Adventure (BA), Reverse Bottle Adventure (RBA), and Get Item Manipulation (GIM)
*Using collection delay to your advantage
**EG: early eyeball frog or gold scale
**NB: Delay happens naturally in many shops if you buy quickly, this is ok
*Something except for a sword on B
**NB: This does not include normal circumstances like riding Epona
*Bottle Duplication
*Wrong warp
*Void warp
*Walking While Talking
*Causing a switch to remain pressed longer than it should
*Ocarina Items
*Z-slide
*A-slide
*Using restricted items
**IE: Farore's Wind in the Overworld or Ocarina in boss rooms
*Being in an unloaded area
*Unloading an actor which clearly should be loaded
**EG: Actor Glitch, unloading KZ's ice, overloading the graveyard or trials to remove graves or Gold Gauntlet monoliths, pause buffering the timer expiration during the diving minigame
*SRM (Stale Reference Manipulation)
*Action Swap
**NB: This includes using the explosion limit to Ground Jump
*Using the effects of Quick Putaway
**EG: Lighting a torch with a Deku Stick with no present fire source.
*Equip Swap
*Ledge Cancel
*Retaining the Master Sword in Phase 1 of the Ganon Fight
*Dying to achieve anything other than a deathwarp

Plandomizer

2020-09-09T00:52:25Z

Dotzo: /* Fixed Hints */

'''Plandomizer''', often shortened to just '''Plando''', allows you to have total control over item placement. You can place a specific item on any location and locations not specified will be filled following the normal algorithm. Using a <samp>.json</samp> format text file, referred to as a '''distribution file''' when using plandomizer, you can override many different aspects of the randomizer.

This can allow you to create custom challenges you can play through yourself or share with others. The more details defined in a plandomizer the less the randomizer interferes, though the randomizer will still verify whether it is beatable based on your logic settings, and if it is logically impossible it will refuse to generate a seed.

There is a [https://ootrandomizer.com/plandoMaker beta GUI for Plandomizer on the website] that can help you with simpler plandomizer ideas, however to truly grasp the power of plandomizer you will have to modify a distribution file yourself.

== Using a Plandomizer Distribution File on the Generator ==
Plandomizer's distribution file text box is hidden by default. To enable it all you have to do is go to <samp>ROM Options</samp> on the generator and turn on the <kbd><samp>Enable Plandomizer (Optional)</samp></kbd> setting. Then use the <kbd><samp>Browse</samp></kbd> button next to the new text box to find your Plandomizer distribution <samp>.json</samp> file.

== Opening and Editing a Distribution File ==
Distributions are just normal text files using the <samp>.json</samp> extension instead of the <samp>.txt</samp> extension. They can be opened in any text editor that will open <samp>.txt</samp> 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.

=== Distribution File Format ===
'''JSON''' is a common format used for data that both a human and a computer are intended to read. It's a fairly picky format so it is a good idea to use a text editor that can tell you if you did something wrong through syntax highlighting. [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 if you go down this path. You can also check that your file is properly formatted by using a validator such as [https://jsonlint.com/ JSONLint] if you prefer to keep on using a text editor without syntax highlighting. It might also help you find an issue that you're having a hard time understanding in VSCode.

The randomizer generator on the website will also give you an error if you try to use a distribution file that is not in the proper JSON format. You may wish to use this, JSONLint, and VSCode all together to figure out how to fix any formatting problems you are having.

=== Understanding a Distribution File ===
When you generate a seed with a spoiler log, that spoiler log is actually a distribution file itself. It can be used directly to generate the exact same seed. Because of this, you can take a look at a spoiler log to help you get familiar with the types of things that can be changed, and how to format the distribution file.

Since a distribution file is in JSON format, it's somewhat rigid about how things can be written.

=== The Base Dictionary ===
First, a distribution file starts with a <kbd>{</kbd> opening curly brace, and ends with a <kbd>}</kbd> closing curly brace. Everything you define must be placed between these braces. These braces mark a '''Dictionary''' or an [https://en.wikipedia.org/wiki/Associative_array associative array], and while that link has a lot of useful information, you don't really have to understand it. Think of a dictionary data structure like you would a dictionary in the real world. You have a term, then you have the definition of that term. As this is the base dictionary, you don't write a term as the code that reads the JSON file creates its own term for this dictionary.

=== The Dictionary "Terms" ===
Within the base dictionary there are many terms, such as <samp>:version</samp>, <samp>file_hash</samp>, and <samp>locations</samp>. If you are viewing a spoiler log you'll notice some of these terms start with a <kbd>:</kbd>. These terms are ignored when Plandomizer is used and are autogenerated by the randomizer. When you are creating a distribution file yourself you can delete these terms.

Terms are followed by a <kbd>:</kbd> and then some spaces, then their definitions.

Definitions that start and end with <kbd>"</kbd> are '''Strings'''. They are just text you write, but it is important that they are between quotes.

Definitions starting with <kbd>[</kbd> an open bracket and ending with a <kbd>]</kbd> closing bracket are called '''Lists'''. In a distribution file lists will usually only contain strings. However, with other types of JSON files you could see them containing other data structures such as dictionaries, or other lists.

The rest of the definitions are just more dictionaries with their own terms that have definitions. These are the only data structures that you have to keep in mind, and generally they are already defined properly in the spoiler log for you so you can just modify them how you see fit. Just ensure you don't accidentally remove the symbols that go before and after the term.

=== The Most Common Format/Syntax Issue ===
You'll notice that each of these terms is followed at the very end by a <kbd>,</kbd> comma, except the very last one. This is probably the most common mistake someone will make when making their own distribution file. Each term needs to be separated by a comma, but the last one cannot have a comma after it. This is true for strings inside of lists, and lists, strings, and other dictionaries within a dictionary as well. If you are getting a syntax error, you probably added a comma you shouldn't have, or removed one you need. The generator will tell you that your JSON is invalid if you try to use a distribution file with one of these errors.

== What Can Plandomizer Affect ==
Plandomizer can affect an enormous amount of the resulting seed. Everything from inconsequential things like the File Hash, to the Settings the randomizer uses to fill the world, and even specifically set items in locations that the world fill algorithm will have to work around.

=== File Hash ===
The file hash is the 5 icons that are displayed at the top of the file select screen. You can set these to any valid [https://github.com/TestRunnerSRL/OoT-Randomizer/blob/Dev/Spoiler.py#L9-L42 HASH_ICON].

You can set the <samp>file_hash</samp> definition to a list of up to 5 hash icons. If you do not want to specify an icon for a set position you can either set it to the value '''null''', or if it is after all the ones you do want to set you can just not include it.

==== Hash Icons ====
<div class="mw-collapsible mw-collapsed" style="display:inline-block">
Expand to view the full list of valid hash icons for the current version of the randomizer.
<pre class="mw-collapsible-content" style="display:inline-block">
'Deku Stick',
'Deku Nut',
'Bow',
'Slingshot',
'Fairy Ocarina',
'Bombchu',
'Longshot',
'Boomerang',
'Lens of Truth',
'Beans',
'Hammer',
'Bottled Fish',
'Bottled Milk',
'Mask of Truth',
'SOLD OUT',
'Cucco',
'Mushroom',
'Saw',
'Frog',
'Master Sword',
'Mirror Shield',
'Kokiri Tunic',
'Hover Boots',
'Silver Gauntlets',
'Gold Scale',
'Stone of Agony',
'Skull Token',
'Heart Container',
'Boss Key',
'Compass',
'Map',
'Big Magic',
</pre></div>

==== Examples ====
'''Set all 5 icons to Deku Nut''':
<blockquote><pre>
"file_hash": ["Deku Nut", "Deku Nut", "Deku Nut", "Deku Nut", "Deku Nut"]
</pre></blockquote>

'''Set only the first icon to Deku Nut''':
<blockquote><pre>
"file_hash": ["Deku Nut", null, null, null, null]
</pre>
or
<pre>
"file_hash": ["Deku Nut"]
</pre></blockquote>

'''Set only the last icon to Deku Nut''':
<blockquote><pre>
"file_hash": [null, null, null, null, "Deku Nut"]
</pre></blockquote>

=== Settings ===
This is a dictionary defining the rules that the randomizer uses to fill the world. ''Any settings you set here will override the ones set in the GUI''. That also means that you can leave some settings out of this dictionary and the person using your distribution file to create a seed can have a small amount of customization they can apply in case they need a little more additional help, or perhaps want to increase the difficulty a little bit.

It is not recommended to set these manually. Instead, you should go to the beta plandomizer maker on the website. You can set all the settings you want on the first tab, then create the JSON file. From here you can copy the settings dictionary from that file into this file and remove any settings you don't want to enforce. Alternatively, if you only want a few settings to be enforced, you can copy only the settings you want from the dictionary in that other JSON file into the settings dictionary in your settings file.

There are two major issues with creating the settings dictionary entirely manually:
# If you mistype, or the name of a setting changes between versions, you will not get an error. The randomizer will just ignore this issue entirely.
# The process of figuring out the proper name for a setting, and the various values it can hold is tedious.

If you still think you want to try this method, the file in the source code you want to look at to see all this necessary information is [https://github.com/TestRunnerSRL/OoT-Randomizer/blob/Dev/SettingsList.py SettingsList.py]. This is a 3000 line monstrosity that isn't very useful if you're not already pretty familiar with the settings you are looking for in the first place. Each setting has a <var>name</var> that you have to use for a definition inside of the settings dictionary. Then various other variables within the option's object in the settings list file are used to determine what possible definitions you want to use for that setting.

Just using the plandomizer maker on the website is highly recommended over putting yourself through this experience.

=== Starting Items ===
The starting items dictionary lets you define what items a player starts with, and how many of them. This includes both items you find in the world, and consumables you would pick up such as ammo and bombs. Any items you start with will be replaced by junk in the item pool. Songs placed here will force an item to be on one of the song locations even if <var>shuffle_song_items</var> is not set. This will completely override the starting items set on the randomizer generator GUI.

The term is the item you want to start with. The definition is how many of that item you want to start with. The number is not a string and should not be put in quotes.

==== Examples ====
'''Start with full wallet without Max Rupees setting''':
<blockquote><pre>
"starting_items": {
"Rupees": 99
}
</pre></blockquote>

'''Start with all shields''':
<blockquote><pre>
"starting_items": {
"Deku Shield": 1,
"Hylian Shield": 1,
"Mirror Shiled": 1
}
</pre></blockquote>

=== Item Pool ===
This is a dictionary defining every item possible to place in the world. ''It is highly recommended that you do not set every possible item to a value in this dictionary.'' Primarily junk items. This would make your plandomizer very rigid and can cause various issues if you try changing settings that change what, and how many items you start with, or that are available in the base pool.

You can also specify if you want to <var>add</var> to the base number, <var>remove</var> from the base number, or <var>set</var> the base number for the item. The default is to set the value. If you want to use the other options you'll need to set the definition to be another dictionary.

The term is the item you want to specify the number of in the pool. The definition is either:
# The number of that item you want in the pool
# A dictionary with a term of <var>type</var> set to any of the strings "add", "remove", or "set" and a term of <var>count</var> set to the number to modify by.

==== Examples ====
'''Set Mirror Shield to have 3 copies placed in the world''':
<blockquote><pre>
"item_pool": {
"Mirror Shield": 3
}
</pre>
or
<pre>
"item_pool": {
"Mirror Shield": {
"type": "set",
"count": 3
}
}
</pre></blockquote>

'''Add 3 Deku Shields to place in the world in addition to the ones already in the base pool''':
<blockquote><pre>
"item_pool": {
"Deku Shield": {
"type": "add",
"count": 3
}
}
</pre></blockquote>

=== Dungeons ===
This dictionary lets you define which dungeons are <var>vanilla</var> and which are <var>mq</var> (master quest). ''You will have to set the number of MQ dungeons setting to match at least whatever master quest dungeons you define here''. However, you do not have to define all of the dungeons and the rest will be defined by the randomizer generator instead.

The term is the name of the dungeon. The definitions is either the string "vanilla", the string "mq", or the string "random".

==== Examples ====
'''Set only Deku Tree to mq''':
<blockquote><pre>
"dungeons": {
"Deku Tree": "mq"
}
</pre></blockquote>

'''Set only Spirit Temple to vanilla, because you don't want to learn the second version of spirit logic''':
<blockquote><pre>
"dungeons": {
"Spirit Temple": "vanilla"
}
</pre></blockquote>

'''Set Dodongo's Cavern to random''':
<blockquote><pre>
"dungeons": {
"Dodongos Cavern": "random"
}
</pre></blockquote>

=== Trials ===
You will define which trials are <var>active</var> and which ones are <var>inactive</var> in this dictionary. ''You will have to set the number of trials to match at least the trials you define here''. However, you do not have to define all of the trials and the rest will be defined by the randomizer generator instead.

The term is the name of the trial. The definition is either the string "active", the string "inactive", or the string "random".

==== Examples ====
'''Set forest, fire, and water trials as inactive''':
<blockquote><pre>
"trials": {
"Forest": "inactive",
"Fire": "inactive",
"Water": "inactive"
}
</pre></blockquote>

'''Set light trial to active, ensuring that 3 strength upgrades are required for fighting Ganon''':
<blockquote><pre>
"trials": {
"Light": "active"
}
</pre></blockquote>

'''Set water trial to random''':
<blockquote><pre>
"trials": {
"Water": "random"
}
</pre></blockquote>

=== Entrances ===
This dictionary defines how different entrances are linked together when using entrance randomizer. Entrances must be shuffled among their respective groups so you cannot use plandomizer to force a mixed entrance pool seed. You may wish to generate a entrance randomizer seed and use its spoiler log to ensure you use the correct names for the locations.

The term is the loading zone you pass through. The definition is:
* '''For Dungeons and Interiors''': a string with the name of the location you end up at
* '''For Overworld''': a dictionary with a term of <var>region</var> set to a string of the overworld region it leads to and a term of <var>from</var> set to a string of the loading zone in that region that you will appear out of.

==== Examples ====
'''Set Deku Tree entrance to Gerudo Training Grounds''':
<blockquote><pre>
"entrances": {
"Outside Deku Tree -> Deku Tree Lobby": "Gerudo Training Grounds Lobby"
}
</pre></blockquote>

'''Set Hyrule Castle exit from Market to Lon Lon Ranch main entrance''':
<blockquote><pre>
"entrances": {
"Castle Town -> Castle Grounds": {
"region": "Lon Lon Ranch",
"from": "Hyrule Field"
}
}
</pre></blockquote>

=== Locations ===
This dictionary handles what is probably the main feature of plandomizer. You can assign items to any location in the game world here. Which locations are available are heavily influenced by what settings you choose, so ensure you have the proper settings set.

The term is the name of the location. The definition is either:
* A string of an item to place there
* A list containing multiple items to randomly choose from to place there
* A dictionary containing the term <var>item</var> containing one of the above two bullet points.
** If making a multiworld plandomizer: the term <var>player</var> with the world number value of the player the item belongs to.
** If the location is a shop: the term <var>price</var> with the rupee number value the item should cost. ''You cannot set scrub prices using plandomizer''
** If the item can be an ice trap: the term <var>model</var> set to a string of the item model it should appear as in the overworld.

==== Shop Location Numbers ====
Due to the odd way the shop items are stored in the game files, using shopsanity item placement is not very intuitive.

When using 1 item shopsanity, the number you use is 7 and is the bottom left item on the left side. 
When using 2 items shopsanity, you also have number 5 which is the bottom right item on the left side. 
When using 3 items shopsanity, you add on the number 8 which is the top left item on the left side. 
When using 4 items shopsanity, you can now use all 4 numbers 5-8 for all of the left side items.

==== Special Item Groups ====
There are shortcut terms you can use for certain items when using plandomizer. They start with the <kbd>#</kbd> character. The ones that should work fine are:
<pre style="display:inline-block">
#Bottle - Places a bottle and randomly chooses a contents for it
#Junk - Places a junk item (used by exclude locations)
#AdultTrade - Places the adult trade item without specifying which one
</pre>

If you are feeling a little bit more daring, you can try:
<pre style="display:inline-block">
#Song - Places a song item
#NonWarpSong - Places non warp song item
#WarpSong - Places a warp song item
#JunkSong - Places Serenade or Prelude in non-entrance randomizer.
#Spell - Places one of the three spells
#Shield - Deku or Hylian. Doesn't include Mirror.
#HealthUpgrade - Heart Container or Piece of Heart
</pre>

All of these should work, but only the first list have been extensively tested.

==== Examples ====
'''Ready to fight Ganon after Mido's''':
<blockquote><pre>
"locations": {
"Mido Chest Top Left": "Bow",
"Mido Chest Top Right": "Magic Meter",
"Mido Chest Bottom Left": "Light Arrows",
"Mido Chest Bottom Right": "Ice Trap"
}
</pre></blockquote>

'''Bottles in Mido's''':
<blockquote><pre>
"locations": {
"Mido Chest Top Left": "#Bottle",
"Mido Chest Top Right": "#Bottle",
"Mido Chest Bottom Left": "#Bottle",
"Mido Chest Bottom Right": "#Bottle"
}
</pre></blockquote>

'''One step to fighting Ganon in the Kokiri Sword chest''':
<blockquote><pre>
"locations": {
"Kokiri Sword Chest": ["Bow", "Magic Meter", "Light Arrows"]
}
</pre></blockquote>

'''Setting shopsanity 1 item in Kokiri Shop to Ice Trap posing as Light Arrows''':
<blockquote><pre>
"locations": {
"Kokiri Shop Item 7": {
"item": "Ice Trap",
"price": 60,
"model": "Light Arrows"
}
}
</pre></blockquote>

'''Place player 2's Light Arrows in player 1's Kokiri Sword chest''':
<blockquote><pre>
"locations": {
"World 1": {
"Kokiri Sword Chest": {
"item": "Light Arrows",
"player": 2
}
}
}
</pre></blockquote>

=== Hint Distribution Files ===

Hint distribution file format is similar to the old hard-coded dictionaries, plus new keys to offer finer control of different hint groups. The goal of this change is to facilitate easier sharing and updating of custom hint distributions for the different racing tournaments. An example with the Tournament distribution is provided below.

<pre>{
"name": "tournament",
"gui_name": "Tournament",
"description": "Fixed number of hints for each type, contains duplicates, and only useful hints.",
"add_locations": [
{ "location": "Deku Theater Skull Mask", "types": ["always"] }
],
"remove_locations": [],
"add_items": [],
"remove_items": [],
"dungeons_woth_limit": 2,
"dungeons_barren_limit": 1,
"named_items_required": "True",
"distribution": {
"trial": {"order": 1, "weight": 0.0, "fixed": 0, "copies": 2},
"always": {"order": 2, "weight": 0.0, "fixed": 0, "copies": 2},
"woth": {"order": 3, "weight": 0.0, "fixed": 5, "copies": 2},
"barren": {"order": 4, "weight": 0.0, "fixed": 3, "copies": 2},
"entrance": {"order": 5, "weight": 0.0, "fixed": 4, "copies": 2},
"sometimes": {"order": 6, "weight": 0.0, "fixed": 100, "copies": 2},
"random": {"order": 7, "weight": 9.0, "fixed": 0, "copies": 2},
"item": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2},
"song": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2},
"overworld": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2},
"dungeon": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2},
"junk": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2},
"named-item": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2}
}
}</pre>
GUI names and tooltip descriptions are now defined with each distribution file. Tooltips are automatically parsed to add line returns as needed for the GUI.

==== Hint Type Distribution ====

The <code>distribution</code> key is a similar format to the previous dictionary. Each hint group must be listed with the following keys:

* <code>order</code>: Integer to sort hint types from smallest to largest
* <code>weight</code>: Same as hint type weight in balanced and similar hint distributions
* <code>fixed</code>: Same as tournament distribution number of hints per world
* <code>copies</code>: Same as count per hint in predefined distributions

Tournament-style fixed hints and weighted-style hints are defined together in the same distribution. Fixed hints are rolled first. Any remaining gossip stones are filled from a random choice of hint types with assigned weights. Checks exist to make sure there are enough gossip stones left for a given random hint type count per hint. Fixed hints do not have this safeguard and rely on the user not to overfill them. Using the tournament distribution as an example, fixed hints are rolled according to the defined order and fixed number. If any gossip stones remain, the <code>random</code> hint group is rolled as part of the weighted hint types (in this case the only one, so it is guaranteed upon exhaustion of all sometimes hints). Other built-in hint types with no fixed hints have non-zero orders for all types and weights equal to the old style weight, and all types have a <code>fixed</code> value of <code>0</code>.

==== Dungeon Limits ====

Dungeon way of the hero and barren limitations are moved out of the hint generation functions into the distribution files. Values are identical in all built-in distributions except <code>very_strong</code>, which has a limit of <code>40</code> for both (equivalent to no limit).

==== Hint Type Requirements and Exclusions ====

Four new lists are provided to include or exclude hinted locations from different hint groups, as specified by the location name or filled item name. As seen in the tournament distribution, the <code>add_locations</code> key can be used to force a given location to be hinted by adding it to the <code>always</code> hint type. Locations can be added to (or removed from) any hint type. Likewise, the item keys allow for adding or removing locations to be hinted based on what items they contain. For example, to remove all songs from being hinted as way of the hero, the following would be utilized:

<pre>"remove_items": [
{ "item": "Zeldas Lullaby", "types": ["woth"] },
{ "item": "Eponas Song", "types": ["woth"] },
{ "item": "Sarias Song", "types": ["woth"] },
{ "item": "Suns Song", "types": ["woth"] },
{ "item": "Song of Time", "types": ["woth"] },
{ "item": "Song of Storms", "types": ["woth"] },
{ "item": "Minuet of Forest", "types": ["woth"] },
{ "item": "Bolero of Fire", "types": ["woth"] },
{ "item": "Serenade of Water", "types": ["woth"] },
{ "item": "Requiem of Spirit", "types": ["woth"] },
{ "item": "Nocturne of Shadow", "types": ["woth"] },
{ "item": "Prelude of Light", "types": ["woth"] }
]</pre>
Alternately, if songsanity is disabled, the song locations could be removed from the <code>woth</code> hint type to achieve the same effect.

Barren hints are the only hint type that cannot have locations added to or removed via <code>add_locations</code> or <code>remove_locations</code>. This is to prevent situations where required items are in hinted barren areas. Using the song example again, a foolish Song of Storms that leads to a required item in Bottom of the Well would be confusing to players unfamiliar with the setting. Excluding from way of the hero means it won’t be hinted, not that the game is actively lying to you. However, caution should be exercised in adding items as hinted way of the hero outside of meme settings.

Barren hints can be added or removed from consideration for specific items via the <code>add_items</code> and <code>remove_items</code> lists. This affects not just hints, but also the <code>:barren_regions</code> list in the spoiler log. In contrast, way of the hero items will still be listed in the <code>:woth_locations</code> section regardless of hint distribution changes. Forced barren items that are logically required still show up in the <code>:woth_locations</code> list if required by the seed.

=== Plando Support ===

The <code>hint_dist_user</code> setting takes a hint distribution dictionary as defined by the built-in hint distribution files. If specified, it overrides the GUI-selected hint distribution. Internally, the distribution is defined as <code>custom</code>.

=== Example Plando ===

The attached plando

* Requires a “random”-type location hint for the location containing Lens of Truth
* Adds shooting the sun in Lake Hylia as an always hint with custom text
* Removes Frog Ocarina Game and 40 Skulls as always hints
* Keeps other “conditional” always hints from Standard weekly settings, including Skull Mask
* Adds the location with Zelda’s Lullaby as an always hint
* Removes all other song locations from way of the hero and sometimes hint types
* Forces Rutos Letter to be considered foolish, and places it outside Ganon’s Castle to verify
* Excludes Biggoron Sword from foolish hints, and places it in the Haunted Wasteland to verify

and applies a custom hint distribution as follows:

===== Fixed Hints =====

(in order)
* Always and Trials hints at 2 stones/hint
* 1 Named Item hint for Lens of Truth at 2 stones/hint (as required by <code>named_items_required</code>)
* 3 Way of the Hero hints at 2 stones/hint
* 2 Foolish hints at 1 stone/hint
* 4 Entrance hints at 2 stones/hint
* 5 Sometimes hints at 1 stone/hint

===== Weighted Hints =====

On weekly settings, this is 27-29 gossip stones filled, depending on if Zelda’s Lullaby is on Ocarina of Time. The remaining 11-13 stones draw hints from weighted hint types as follows:

* Random (0.5 weight, 2 stones/hint)
* Item (1.0 weight, 2 stones/hint)
* Song (2.0 weight, 2 stones/hint)
* Overworld (3.0 weight, 2 stones/hint)
* Dungeon (1.0 weight, 2 stones/hint)
* Junk (0.5 weight, 1 stone/hint)

At least 1 junk hint will be added due to the odd number of remaining stones.

<pre>{
"settings": {
"item_hints": [
"Lens of Truth"
],
"hint_dist_user": {
"name": "custom",
"gui_name": "Plando Test Hint Distribution",
"description": "for debugging",
"add_locations": [
{ "location": "LH Sun", "types": ["always"], "text": "those who #blot out the sun# will find" },
{ "location": "Deku Theater Skull Mask", "types": ["always"] }
],
"remove_locations": [
{ "location": "ZR Frogs Ocarina Game", "types": ["always"] },
{ "location": "Kak 40 Gold Skulltula Reward", "types": ["always"] }
],
"add_items": [
{ "item": "Zeldas Lullaby", "types": ["always"] },
{ "item": "Rutos Letter", "types": ["barren"] }
],
"remove_items": [
{ "item": "Eponas Song", "types": ["woth", "sometimes"] },
{ "item": "Sarias Song", "types": ["woth", "sometimes"] },
{ "item": "Suns Song", "types": ["woth", "sometimes"] },
{ "item": "Song of Time", "types": ["woth", "sometimes"] },
{ "item": "Song of Storms", "types": ["woth", "sometimes"] },
{ "item": "Minuet of Forest", "types": ["woth", "sometimes"] },
{ "item": "Bolero of Fire", "types": ["woth", "sometimes"] },
{ "item": "Serenade of Water", "types": ["woth", "sometimes"] },
{ "item": "Requiem of Spirit", "types": ["woth", "sometimes"] },
{ "item": "Nocturne of Shadow", "types": ["woth", "sometimes"] },
{ "item": "Prelude of Light", "types": ["woth", "sometimes"] },
{ "item": "Biggoron Sword", "types": ["barren"] }
],
"dungeons_woth_limit": 2,
"dungeons_barren_limit": 1,
"named_items_required": "True",
"distribution": {
"trial": {"order": 1, "weight": 0.0, "fixed": 0, "copies": 2},
"always": {"order": 2, "weight": 0.0, "fixed": 0, "copies": 2},
"woth": {"order": 3, "weight": 0.0, "fixed": 3, "copies": 2},
"barren": {"order": 4, "weight": 0.0, "fixed": 2, "copies": 1},
"entrance": {"order": 5, "weight": 0.0, "fixed": 4, "copies": 2},
"sometimes": {"order": 6, "weight": 0.0, "fixed": 5, "copies": 1},
"random": {"order": 7, "weight": 0.5, "fixed": 0, "copies": 2},
"item": {"order": 8, "weight": 1.0, "fixed": 0, "copies": 2},
"song": {"order": 9, "weight": 2.0, "fixed": 0, "copies": 2},
"overworld": {"order": 10, "weight": 3.0, "fixed": 0, "copies": 2},
"dungeon": {"order": 11, "weight": 1.0, "fixed": 0, "copies": 2},
"junk": {"order": 12, "weight": 0.5, "fixed": 0, "copies": 1},
"named-item": {"order": 13, "weight": 0.0, "fixed": 0, "copies": 2}
}
}
},
"randomized_settings": {},
"starting_items": {},
"item_pool": {},
"entrances": {},
"locations": {
"OGC Great Fairy Reward": "Rutos Letter",
"Wasteland Chest": "Biggoron Sword"
}
}</pre>
=== Item Hints for Bingo ===

The <code>item_hints</code> plando setting contains a list of items as named in ItemList.py to be added as “random” location hints. This is outside of the hint distribution setting. Built-in hint distributions assume copies per hint is the same as the sometimes category equivalent of the original distribution. The <code>named_items_required</code> hint distribution key controls if named item hints are treated as always hints. In contrast to always hints, an error will be thrown if any required named item hint cannot be placed.

Plando or third party hint distribution files can specify fixed or weighted <code>named-item</code> group hints if <code>named_items_required</code> is false.

Note that <code>add_items</code> provides similar functionality to the <code>item_hints</code> plando key if an item is added to the <code>always</code> group. The reason for duplication of this feature is to provide an easier interface for Bingo races desiring hinted tile goals without building a whole hint distribution from scratch.

==== Example Bingo Plando ====

The example plando below:

* Requires two separate strength upgrades to be hinted
* Requires Lens of Truth to be hinted
* Modifies the item pool to contain 3 empty bottles, one of which will be hinted.

<pre>{
"settings": {
"item_hints": [
"Progressive Strength Upgrade",
"Progressive Strength Upgrade",
"Lens of Truth",
"Bottle"
]
},
"randomized_settings": {},
"starting_items": {},
"item_pool": {
"Bottle": 3
},
"entrances": {},
"locations": {}
}</pre>

=== Gossip Stones ===
This dictionary is just evil. It lets you replace the Gossip Stone text with any text you wish. Unlike normal randomizer, this text can lie and mislead the player. It is recommended that you use it more for inside jokes, or different types of hints than you'd normally get using the randomizer to keep the plandomizer fun for the player. Gossip stones set here will not be taken into consideration for hints by logic.

The term is the name of the Gossip Stone. The definition is a dictionary with the term <var>text</var>.
* Any text you surround with <kbd>#</kbd> can also be colored. If you wish to do this add another term to the inner dictionary with the term <var>colors</var> and set it to a list containing strings of the colors you wish to use. You can have multiple groups of text surrounded by <kbd>#</kbd> and each one can be a different color.

==== Valid Colors ====
<pre style="display:inline-block">
White
Red
Green
Blue
Light Blue
Pink
Yellow
Black
</pre>

==== Examples ====
'''Just white text''':
<blockquote><pre>
"gossip_stones": {
"Death Mountain Crater (Bombable Wall)": {
"text": "It's hot in here!"
}
}
</pre></blockquote>

'''Colored text''':
<blockquote><pre>
"gossip_stones": {
"Death Mountain Crater (Bombable Wall)": {
"text": "They say #Luigi# was put in this game instead of Super #Mario# 64",
"colors": ["Green", "Red"]
}
}
</pre></blockquote>

== Common Errors ==
You're very likely to run into many errors while trying to make a plandomizer. These explanations should help you with some of the more cryptic ones.

=== Game Unbeatable ===
The randomizer generator could not place items following your defined settings. You've created a situation that is not logically possible to complete.

Sometimes this is just bad luck and you have to try generating again, but if you continuously get the same exact error messages over and over, you most likely need to modify your settings or where items are placed in the world. Think carefully about what logical problems your settings and item placements might have. Refer to the [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/master/data/World Release logic files] or the [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/Dev/data/World Dev logic files] depending on which one you are using to try to help find any you have forgotten.

Of course you can always come to the [https://discordapp.com/channels/274180765816848384/476723801032491008 #setup-support] channel on the Discord to ask for help if you're feeling stuck. We can usually point you in the right direction or find the exact issue causing the error.

Plandomizer

2020-09-09T00:51:13Z

Dotzo:

'''Plandomizer''', often shortened to just '''Plando''', allows you to have total control over item placement. You can place a specific item on any location and locations not specified will be filled following the normal algorithm. Using a <samp>.json</samp> format text file, referred to as a '''distribution file''' when using plandomizer, you can override many different aspects of the randomizer.

This can allow you to create custom challenges you can play through yourself or share with others. The more details defined in a plandomizer the less the randomizer interferes, though the randomizer will still verify whether it is beatable based on your logic settings, and if it is logically impossible it will refuse to generate a seed.

There is a [https://ootrandomizer.com/plandoMaker beta GUI for Plandomizer on the website] that can help you with simpler plandomizer ideas, however to truly grasp the power of plandomizer you will have to modify a distribution file yourself.

== Using a Plandomizer Distribution File on the Generator ==
Plandomizer's distribution file text box is hidden by default. To enable it all you have to do is go to <samp>ROM Options</samp> on the generator and turn on the <kbd><samp>Enable Plandomizer (Optional)</samp></kbd> setting. Then use the <kbd><samp>Browse</samp></kbd> button next to the new text box to find your Plandomizer distribution <samp>.json</samp> file.

== Opening and Editing a Distribution File ==
Distributions are just normal text files using the <samp>.json</samp> extension instead of the <samp>.txt</samp> extension. They can be opened in any text editor that will open <samp>.txt</samp> 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.

=== Distribution File Format ===
'''JSON''' is a common format used for data that both a human and a computer are intended to read. It's a fairly picky format so it is a good idea to use a text editor that can tell you if you did something wrong through syntax highlighting. [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 if you go down this path. You can also check that your file is properly formatted by using a validator such as [https://jsonlint.com/ JSONLint] if you prefer to keep on using a text editor without syntax highlighting. It might also help you find an issue that you're having a hard time understanding in VSCode.

The randomizer generator on the website will also give you an error if you try to use a distribution file that is not in the proper JSON format. You may wish to use this, JSONLint, and VSCode all together to figure out how to fix any formatting problems you are having.

=== Understanding a Distribution File ===
When you generate a seed with a spoiler log, that spoiler log is actually a distribution file itself. It can be used directly to generate the exact same seed. Because of this, you can take a look at a spoiler log to help you get familiar with the types of things that can be changed, and how to format the distribution file.

Since a distribution file is in JSON format, it's somewhat rigid about how things can be written.

=== The Base Dictionary ===
First, a distribution file starts with a <kbd>{</kbd> opening curly brace, and ends with a <kbd>}</kbd> closing curly brace. Everything you define must be placed between these braces. These braces mark a '''Dictionary''' or an [https://en.wikipedia.org/wiki/Associative_array associative array], and while that link has a lot of useful information, you don't really have to understand it. Think of a dictionary data structure like you would a dictionary in the real world. You have a term, then you have the definition of that term. As this is the base dictionary, you don't write a term as the code that reads the JSON file creates its own term for this dictionary.

=== The Dictionary "Terms" ===
Within the base dictionary there are many terms, such as <samp>:version</samp>, <samp>file_hash</samp>, and <samp>locations</samp>. If you are viewing a spoiler log you'll notice some of these terms start with a <kbd>:</kbd>. These terms are ignored when Plandomizer is used and are autogenerated by the randomizer. When you are creating a distribution file yourself you can delete these terms.

Terms are followed by a <kbd>:</kbd> and then some spaces, then their definitions.

Definitions that start and end with <kbd>"</kbd> are '''Strings'''. They are just text you write, but it is important that they are between quotes.

Definitions starting with <kbd>[</kbd> an open bracket and ending with a <kbd>]</kbd> closing bracket are called '''Lists'''. In a distribution file lists will usually only contain strings. However, with other types of JSON files you could see them containing other data structures such as dictionaries, or other lists.

The rest of the definitions are just more dictionaries with their own terms that have definitions. These are the only data structures that you have to keep in mind, and generally they are already defined properly in the spoiler log for you so you can just modify them how you see fit. Just ensure you don't accidentally remove the symbols that go before and after the term.

=== The Most Common Format/Syntax Issue ===
You'll notice that each of these terms is followed at the very end by a <kbd>,</kbd> comma, except the very last one. This is probably the most common mistake someone will make when making their own distribution file. Each term needs to be separated by a comma, but the last one cannot have a comma after it. This is true for strings inside of lists, and lists, strings, and other dictionaries within a dictionary as well. If you are getting a syntax error, you probably added a comma you shouldn't have, or removed one you need. The generator will tell you that your JSON is invalid if you try to use a distribution file with one of these errors.

== What Can Plandomizer Affect ==
Plandomizer can affect an enormous amount of the resulting seed. Everything from inconsequential things like the File Hash, to the Settings the randomizer uses to fill the world, and even specifically set items in locations that the world fill algorithm will have to work around.

=== File Hash ===
The file hash is the 5 icons that are displayed at the top of the file select screen. You can set these to any valid [https://github.com/TestRunnerSRL/OoT-Randomizer/blob/Dev/Spoiler.py#L9-L42 HASH_ICON].

You can set the <samp>file_hash</samp> definition to a list of up to 5 hash icons. If you do not want to specify an icon for a set position you can either set it to the value '''null''', or if it is after all the ones you do want to set you can just not include it.

==== Hash Icons ====
<div class="mw-collapsible mw-collapsed" style="display:inline-block">
Expand to view the full list of valid hash icons for the current version of the randomizer.
<pre class="mw-collapsible-content" style="display:inline-block">
'Deku Stick',
'Deku Nut',
'Bow',
'Slingshot',
'Fairy Ocarina',
'Bombchu',
'Longshot',
'Boomerang',
'Lens of Truth',
'Beans',
'Hammer',
'Bottled Fish',
'Bottled Milk',
'Mask of Truth',
'SOLD OUT',
'Cucco',
'Mushroom',
'Saw',
'Frog',
'Master Sword',
'Mirror Shield',
'Kokiri Tunic',
'Hover Boots',
'Silver Gauntlets',
'Gold Scale',
'Stone of Agony',
'Skull Token',
'Heart Container',
'Boss Key',
'Compass',
'Map',
'Big Magic',
</pre></div>

==== Examples ====
'''Set all 5 icons to Deku Nut''':
<blockquote><pre>
"file_hash": ["Deku Nut", "Deku Nut", "Deku Nut", "Deku Nut", "Deku Nut"]
</pre></blockquote>

'''Set only the first icon to Deku Nut''':
<blockquote><pre>
"file_hash": ["Deku Nut", null, null, null, null]
</pre>
or
<pre>
"file_hash": ["Deku Nut"]
</pre></blockquote>

'''Set only the last icon to Deku Nut''':
<blockquote><pre>
"file_hash": [null, null, null, null, "Deku Nut"]
</pre></blockquote>

=== Settings ===
This is a dictionary defining the rules that the randomizer uses to fill the world. ''Any settings you set here will override the ones set in the GUI''. That also means that you can leave some settings out of this dictionary and the person using your distribution file to create a seed can have a small amount of customization they can apply in case they need a little more additional help, or perhaps want to increase the difficulty a little bit.

It is not recommended to set these manually. Instead, you should go to the beta plandomizer maker on the website. You can set all the settings you want on the first tab, then create the JSON file. From here you can copy the settings dictionary from that file into this file and remove any settings you don't want to enforce. Alternatively, if you only want a few settings to be enforced, you can copy only the settings you want from the dictionary in that other JSON file into the settings dictionary in your settings file.

There are two major issues with creating the settings dictionary entirely manually:
# If you mistype, or the name of a setting changes between versions, you will not get an error. The randomizer will just ignore this issue entirely.
# The process of figuring out the proper name for a setting, and the various values it can hold is tedious.

If you still think you want to try this method, the file in the source code you want to look at to see all this necessary information is [https://github.com/TestRunnerSRL/OoT-Randomizer/blob/Dev/SettingsList.py SettingsList.py]. This is a 3000 line monstrosity that isn't very useful if you're not already pretty familiar with the settings you are looking for in the first place. Each setting has a <var>name</var> that you have to use for a definition inside of the settings dictionary. Then various other variables within the option's object in the settings list file are used to determine what possible definitions you want to use for that setting.

Just using the plandomizer maker on the website is highly recommended over putting yourself through this experience.

=== Starting Items ===
The starting items dictionary lets you define what items a player starts with, and how many of them. This includes both items you find in the world, and consumables you would pick up such as ammo and bombs. Any items you start with will be replaced by junk in the item pool. Songs placed here will force an item to be on one of the song locations even if <var>shuffle_song_items</var> is not set. This will completely override the starting items set on the randomizer generator GUI.

The term is the item you want to start with. The definition is how many of that item you want to start with. The number is not a string and should not be put in quotes.

==== Examples ====
'''Start with full wallet without Max Rupees setting''':
<blockquote><pre>
"starting_items": {
"Rupees": 99
}
</pre></blockquote>

'''Start with all shields''':
<blockquote><pre>
"starting_items": {
"Deku Shield": 1,
"Hylian Shield": 1,
"Mirror Shiled": 1
}
</pre></blockquote>

=== Item Pool ===
This is a dictionary defining every item possible to place in the world. ''It is highly recommended that you do not set every possible item to a value in this dictionary.'' Primarily junk items. This would make your plandomizer very rigid and can cause various issues if you try changing settings that change what, and how many items you start with, or that are available in the base pool.

You can also specify if you want to <var>add</var> to the base number, <var>remove</var> from the base number, or <var>set</var> the base number for the item. The default is to set the value. If you want to use the other options you'll need to set the definition to be another dictionary.

The term is the item you want to specify the number of in the pool. The definition is either:
# The number of that item you want in the pool
# A dictionary with a term of <var>type</var> set to any of the strings "add", "remove", or "set" and a term of <var>count</var> set to the number to modify by.

==== Examples ====
'''Set Mirror Shield to have 3 copies placed in the world''':
<blockquote><pre>
"item_pool": {
"Mirror Shield": 3
}
</pre>
or
<pre>
"item_pool": {
"Mirror Shield": {
"type": "set",
"count": 3
}
}
</pre></blockquote>

'''Add 3 Deku Shields to place in the world in addition to the ones already in the base pool''':
<blockquote><pre>
"item_pool": {
"Deku Shield": {
"type": "add",
"count": 3
}
}
</pre></blockquote>

=== Dungeons ===
This dictionary lets you define which dungeons are <var>vanilla</var> and which are <var>mq</var> (master quest). ''You will have to set the number of MQ dungeons setting to match at least whatever master quest dungeons you define here''. However, you do not have to define all of the dungeons and the rest will be defined by the randomizer generator instead.

The term is the name of the dungeon. The definitions is either the string "vanilla", the string "mq", or the string "random".

==== Examples ====
'''Set only Deku Tree to mq''':
<blockquote><pre>
"dungeons": {
"Deku Tree": "mq"
}
</pre></blockquote>

'''Set only Spirit Temple to vanilla, because you don't want to learn the second version of spirit logic''':
<blockquote><pre>
"dungeons": {
"Spirit Temple": "vanilla"
}
</pre></blockquote>

'''Set Dodongo's Cavern to random''':
<blockquote><pre>
"dungeons": {
"Dodongos Cavern": "random"
}
</pre></blockquote>

=== Trials ===
You will define which trials are <var>active</var> and which ones are <var>inactive</var> in this dictionary. ''You will have to set the number of trials to match at least the trials you define here''. However, you do not have to define all of the trials and the rest will be defined by the randomizer generator instead.

The term is the name of the trial. The definition is either the string "active", the string "inactive", or the string "random".

==== Examples ====
'''Set forest, fire, and water trials as inactive''':
<blockquote><pre>
"trials": {
"Forest": "inactive",
"Fire": "inactive",
"Water": "inactive"
}
</pre></blockquote>

'''Set light trial to active, ensuring that 3 strength upgrades are required for fighting Ganon''':
<blockquote><pre>
"trials": {
"Light": "active"
}
</pre></blockquote>

'''Set water trial to random''':
<blockquote><pre>
"trials": {
"Water": "random"
}
</pre></blockquote>

=== Entrances ===
This dictionary defines how different entrances are linked together when using entrance randomizer. Entrances must be shuffled among their respective groups so you cannot use plandomizer to force a mixed entrance pool seed. You may wish to generate a entrance randomizer seed and use its spoiler log to ensure you use the correct names for the locations.

The term is the loading zone you pass through. The definition is:
* '''For Dungeons and Interiors''': a string with the name of the location you end up at
* '''For Overworld''': a dictionary with a term of <var>region</var> set to a string of the overworld region it leads to and a term of <var>from</var> set to a string of the loading zone in that region that you will appear out of.

==== Examples ====
'''Set Deku Tree entrance to Gerudo Training Grounds''':
<blockquote><pre>
"entrances": {
"Outside Deku Tree -> Deku Tree Lobby": "Gerudo Training Grounds Lobby"
}
</pre></blockquote>

'''Set Hyrule Castle exit from Market to Lon Lon Ranch main entrance''':
<blockquote><pre>
"entrances": {
"Castle Town -> Castle Grounds": {
"region": "Lon Lon Ranch",
"from": "Hyrule Field"
}
}
</pre></blockquote>

=== Locations ===
This dictionary handles what is probably the main feature of plandomizer. You can assign items to any location in the game world here. Which locations are available are heavily influenced by what settings you choose, so ensure you have the proper settings set.

The term is the name of the location. The definition is either:
* A string of an item to place there
* A list containing multiple items to randomly choose from to place there
* A dictionary containing the term <var>item</var> containing one of the above two bullet points.
** If making a multiworld plandomizer: the term <var>player</var> with the world number value of the player the item belongs to.
** If the location is a shop: the term <var>price</var> with the rupee number value the item should cost. ''You cannot set scrub prices using plandomizer''
** If the item can be an ice trap: the term <var>model</var> set to a string of the item model it should appear as in the overworld.

==== Shop Location Numbers ====
Due to the odd way the shop items are stored in the game files, using shopsanity item placement is not very intuitive.

When using 1 item shopsanity, the number you use is 7 and is the bottom left item on the left side. 
When using 2 items shopsanity, you also have number 5 which is the bottom right item on the left side. 
When using 3 items shopsanity, you add on the number 8 which is the top left item on the left side. 
When using 4 items shopsanity, you can now use all 4 numbers 5-8 for all of the left side items.

==== Special Item Groups ====
There are shortcut terms you can use for certain items when using plandomizer. They start with the <kbd>#</kbd> character. The ones that should work fine are:
<pre style="display:inline-block">
#Bottle - Places a bottle and randomly chooses a contents for it
#Junk - Places a junk item (used by exclude locations)
#AdultTrade - Places the adult trade item without specifying which one
</pre>

If you are feeling a little bit more daring, you can try:
<pre style="display:inline-block">
#Song - Places a song item
#NonWarpSong - Places non warp song item
#WarpSong - Places a warp song item
#JunkSong - Places Serenade or Prelude in non-entrance randomizer.
#Spell - Places one of the three spells
#Shield - Deku or Hylian. Doesn't include Mirror.
#HealthUpgrade - Heart Container or Piece of Heart
</pre>

All of these should work, but only the first list have been extensively tested.

==== Examples ====
'''Ready to fight Ganon after Mido's''':
<blockquote><pre>
"locations": {
"Mido Chest Top Left": "Bow",
"Mido Chest Top Right": "Magic Meter",
"Mido Chest Bottom Left": "Light Arrows",
"Mido Chest Bottom Right": "Ice Trap"
}
</pre></blockquote>

'''Bottles in Mido's''':
<blockquote><pre>
"locations": {
"Mido Chest Top Left": "#Bottle",
"Mido Chest Top Right": "#Bottle",
"Mido Chest Bottom Left": "#Bottle",
"Mido Chest Bottom Right": "#Bottle"
}
</pre></blockquote>

'''One step to fighting Ganon in the Kokiri Sword chest''':
<blockquote><pre>
"locations": {
"Kokiri Sword Chest": ["Bow", "Magic Meter", "Light Arrows"]
}
</pre></blockquote>

'''Setting shopsanity 1 item in Kokiri Shop to Ice Trap posing as Light Arrows''':
<blockquote><pre>
"locations": {
"Kokiri Shop Item 7": {
"item": "Ice Trap",
"price": 60,
"model": "Light Arrows"
}
}
</pre></blockquote>

'''Place player 2's Light Arrows in player 1's Kokiri Sword chest''':
<blockquote><pre>
"locations": {
"World 1": {
"Kokiri Sword Chest": {
"item": "Light Arrows",
"player": 2
}
}
}
</pre></blockquote>

=== Hint Distribution Files ===

Hint distribution file format is similar to the old hard-coded dictionaries, plus new keys to offer finer control of different hint groups. The goal of this change is to facilitate easier sharing and updating of custom hint distributions for the different racing tournaments. An example with the Tournament distribution is provided below.

<pre>{
"name": "tournament",
"gui_name": "Tournament",
"description": "Fixed number of hints for each type, contains duplicates, and only useful hints.",
"add_locations": [
{ "location": "Deku Theater Skull Mask", "types": ["always"] }
],
"remove_locations": [],
"add_items": [],
"remove_items": [],
"dungeons_woth_limit": 2,
"dungeons_barren_limit": 1,
"named_items_required": "True",
"distribution": {
"trial": {"order": 1, "weight": 0.0, "fixed": 0, "copies": 2},
"always": {"order": 2, "weight": 0.0, "fixed": 0, "copies": 2},
"woth": {"order": 3, "weight": 0.0, "fixed": 5, "copies": 2},
"barren": {"order": 4, "weight": 0.0, "fixed": 3, "copies": 2},
"entrance": {"order": 5, "weight": 0.0, "fixed": 4, "copies": 2},
"sometimes": {"order": 6, "weight": 0.0, "fixed": 100, "copies": 2},
"random": {"order": 7, "weight": 9.0, "fixed": 0, "copies": 2},
"item": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2},
"song": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2},
"overworld": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2},
"dungeon": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2},
"junk": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2},
"named-item": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2}
}
}</pre>
GUI names and tooltip descriptions are now defined with each distribution file. Tooltips are automatically parsed to add line returns as needed for the GUI.

==== Hint Type Distribution ====

The <code>distribution</code> key is a similar format to the previous dictionary. Each hint group must be listed with the following keys:

* <code>order</code>: Integer to sort hint types from smallest to largest
* <code>weight</code>: Same as hint type weight in balanced and similar hint distributions
* <code>fixed</code>: Same as tournament distribution number of hints per world
* <code>copies</code>: Same as count per hint in predefined distributions

Tournament-style fixed hints and weighted-style hints are defined together in the same distribution. Fixed hints are rolled first. Any remaining gossip stones are filled from a random choice of hint types with assigned weights. Checks exist to make sure there are enough gossip stones left for a given random hint type count per hint. Fixed hints do not have this safeguard and rely on the user not to overfill them. Using the tournament distribution as an example, fixed hints are rolled according to the defined order and fixed number. If any gossip stones remain, the <code>random</code> hint group is rolled as part of the weighted hint types (in this case the only one, so it is guaranteed upon exhaustion of all sometimes hints). Other built-in hint types with no fixed hints have non-zero orders for all types and weights equal to the old style weight, and all types have a <code>fixed</code> value of <code>0</code>.

==== Dungeon Limits ====

Dungeon way of the hero and barren limitations are moved out of the hint generation functions into the distribution files. Values are identical in all built-in distributions except <code>very_strong</code>, which has a limit of <code>40</code> for both (equivalent to no limit).

==== Hint Type Requirements and Exclusions ====

Four new lists are provided to include or exclude hinted locations from different hint groups, as specified by the location name or filled item name. As seen in the tournament distribution, the <code>add_locations</code> key can be used to force a given location to be hinted by adding it to the <code>always</code> hint type. Locations can be added to (or removed from) any hint type. Likewise, the item keys allow for adding or removing locations to be hinted based on what items they contain. For example, to remove all songs from being hinted as way of the hero, the following would be utilized:

<pre>"remove_items": [
{ "item": "Zeldas Lullaby", "types": ["woth"] },
{ "item": "Eponas Song", "types": ["woth"] },
{ "item": "Sarias Song", "types": ["woth"] },
{ "item": "Suns Song", "types": ["woth"] },
{ "item": "Song of Time", "types": ["woth"] },
{ "item": "Song of Storms", "types": ["woth"] },
{ "item": "Minuet of Forest", "types": ["woth"] },
{ "item": "Bolero of Fire", "types": ["woth"] },
{ "item": "Serenade of Water", "types": ["woth"] },
{ "item": "Requiem of Spirit", "types": ["woth"] },
{ "item": "Nocturne of Shadow", "types": ["woth"] },
{ "item": "Prelude of Light", "types": ["woth"] }
]</pre>
Alternately, if songsanity is disabled, the song locations could be removed from the <code>woth</code> hint type to achieve the same effect.

Barren hints are the only hint type that cannot have locations added to or removed via <code>add_locations</code> or <code>remove_locations</code>. This is to prevent situations where required items are in hinted barren areas. Using the song example again, a foolish Song of Storms that leads to a required item in Bottom of the Well would be confusing to players unfamiliar with the setting. Excluding from way of the hero means it won’t be hinted, not that the game is actively lying to you. However, caution should be exercised in adding items as hinted way of the hero outside of meme settings.

Barren hints can be added or removed from consideration for specific items via the <code>add_items</code> and <code>remove_items</code> lists. This affects not just hints, but also the <code>:barren_regions</code> list in the spoiler log. In contrast, way of the hero items will still be listed in the <code>:woth_locations</code> section regardless of hint distribution changes. Forced barren items that are logically required still show up in the <code>:woth_locations</code> list if required by the seed.

=== Plando Support ===

The <code>hint_dist_user</code> setting takes a hint distribution dictionary as defined by the built-in hint distribution files. If specified, it overrides the GUI-selected hint distribution. Internally, the distribution is defined as <code>custom</code>.

=== Example Plando ===

The attached plando

* Requires a “random”-type location hint for the location containing Lens of Truth
* Adds shooting the sun in Lake Hylia as an always hint with custom text
* Removes Frog Ocarina Game and 40 Skulls as always hints
* Keeps other “conditional” always hints from Standard weekly settings, including Skull Mask
* Adds the location with Zelda’s Lullaby as an always hint
* Removes all other song locations from way of the hero and sometimes hint types
* Forces Rutos Letter to be considered foolish, and places it outside Ganon’s Castle to verify
* Excludes Biggoron Sword from foolish hints, and places it in the Haunted Wasteland to verify

and applies a custom hint distribution as follows:

===== Fixed Hints =====

(in order) * Always and Trials hints at 2 stones/hint * 1 Named Item hint for Lens of Truth at 2 stones/hint (as required by <code>named_items_required</code>) * 3 Way of the Hero hints at 2 stones/hint * 2 Foolish hints at 1 stone/hint * 4 Entrance hints at 2 stones/hint * 5 Sometimes hints at 1 stone/hint

===== Weighted Hints =====

On weekly settings, this is 27-29 gossip stones filled, depending on if Zelda’s Lullaby is on Ocarina of Time. The remaining 11-13 stones draw hints from weighted hint types as follows:

* Random (0.5 weight, 2 stones/hint)
* Item (1.0 weight, 2 stones/hint)
* Song (2.0 weight, 2 stones/hint)
* Overworld (3.0 weight, 2 stones/hint)
* Dungeon (1.0 weight, 2 stones/hint)
* Junk (0.5 weight, 1 stone/hint)

At least 1 junk hint will be added due to the odd number of remaining stones.

<pre>{
"settings": {
"item_hints": [
"Lens of Truth"
],
"hint_dist_user": {
"name": "custom",
"gui_name": "Plando Test Hint Distribution",
"description": "for debugging",
"add_locations": [
{ "location": "LH Sun", "types": ["always"], "text": "those who #blot out the sun# will find" },
{ "location": "Deku Theater Skull Mask", "types": ["always"] }
],
"remove_locations": [
{ "location": "ZR Frogs Ocarina Game", "types": ["always"] },
{ "location": "Kak 40 Gold Skulltula Reward", "types": ["always"] }
],
"add_items": [
{ "item": "Zeldas Lullaby", "types": ["always"] },
{ "item": "Rutos Letter", "types": ["barren"] }
],
"remove_items": [
{ "item": "Eponas Song", "types": ["woth", "sometimes"] },
{ "item": "Sarias Song", "types": ["woth", "sometimes"] },
{ "item": "Suns Song", "types": ["woth", "sometimes"] },
{ "item": "Song of Time", "types": ["woth", "sometimes"] },
{ "item": "Song of Storms", "types": ["woth", "sometimes"] },
{ "item": "Minuet of Forest", "types": ["woth", "sometimes"] },
{ "item": "Bolero of Fire", "types": ["woth", "sometimes"] },
{ "item": "Serenade of Water", "types": ["woth", "sometimes"] },
{ "item": "Requiem of Spirit", "types": ["woth", "sometimes"] },
{ "item": "Nocturne of Shadow", "types": ["woth", "sometimes"] },
{ "item": "Prelude of Light", "types": ["woth", "sometimes"] },
{ "item": "Biggoron Sword", "types": ["barren"] }
],
"dungeons_woth_limit": 2,
"dungeons_barren_limit": 1,
"named_items_required": "True",
"distribution": {
"trial": {"order": 1, "weight": 0.0, "fixed": 0, "copies": 2},
"always": {"order": 2, "weight": 0.0, "fixed": 0, "copies": 2},
"woth": {"order": 3, "weight": 0.0, "fixed": 3, "copies": 2},
"barren": {"order": 4, "weight": 0.0, "fixed": 2, "copies": 1},
"entrance": {"order": 5, "weight": 0.0, "fixed": 4, "copies": 2},
"sometimes": {"order": 6, "weight": 0.0, "fixed": 5, "copies": 1},
"random": {"order": 7, "weight": 0.5, "fixed": 0, "copies": 2},
"item": {"order": 8, "weight": 1.0, "fixed": 0, "copies": 2},
"song": {"order": 9, "weight": 2.0, "fixed": 0, "copies": 2},
"overworld": {"order": 10, "weight": 3.0, "fixed": 0, "copies": 2},
"dungeon": {"order": 11, "weight": 1.0, "fixed": 0, "copies": 2},
"junk": {"order": 12, "weight": 0.5, "fixed": 0, "copies": 1},
"named-item": {"order": 13, "weight": 0.0, "fixed": 0, "copies": 2}
}
}
},
"randomized_settings": {},
"starting_items": {},
"item_pool": {},
"entrances": {},
"locations": {
"OGC Great Fairy Reward": "Rutos Letter",
"Wasteland Chest": "Biggoron Sword"
}
}</pre>
=== Item Hints for Bingo ===

The <code>item_hints</code> plando setting contains a list of items as named in ItemList.py to be added as “random” location hints. This is outside of the hint distribution setting. Built-in hint distributions assume copies per hint is the same as the sometimes category equivalent of the original distribution. The <code>named_items_required</code> hint distribution key controls if named item hints are treated as always hints. In contrast to always hints, an error will be thrown if any required named item hint cannot be placed.

Plando or third party hint distribution files can specify fixed or weighted <code>named-item</code> group hints if <code>named_items_required</code> is false.

Note that <code>add_items</code> provides similar functionality to the <code>item_hints</code> plando key if an item is added to the <code>always</code> group. The reason for duplication of this feature is to provide an easier interface for Bingo races desiring hinted tile goals without building a whole hint distribution from scratch.

==== Example Bingo Plando ====

The example plando below:

* Requires two separate strength upgrades to be hinted
* Requires Lens of Truth to be hinted
* Modifies the item pool to contain 3 empty bottles, one of which will be hinted.

<pre>{
"settings": {
"item_hints": [
"Progressive Strength Upgrade",
"Progressive Strength Upgrade",
"Lens of Truth",
"Bottle"
]
},
"randomized_settings": {},
"starting_items": {},
"item_pool": {
"Bottle": 3
},
"entrances": {},
"locations": {}
}</pre>

=== Gossip Stones ===
This dictionary is just evil. It lets you replace the Gossip Stone text with any text you wish. Unlike normal randomizer, this text can lie and mislead the player. It is recommended that you use it more for inside jokes, or different types of hints than you'd normally get using the randomizer to keep the plandomizer fun for the player. Gossip stones set here will not be taken into consideration for hints by logic.

The term is the name of the Gossip Stone. The definition is a dictionary with the term <var>text</var>.
* Any text you surround with <kbd>#</kbd> can also be colored. If you wish to do this add another term to the inner dictionary with the term <var>colors</var> and set it to a list containing strings of the colors you wish to use. You can have multiple groups of text surrounded by <kbd>#</kbd> and each one can be a different color.

==== Valid Colors ====
<pre style="display:inline-block">
White
Red
Green
Blue
Light Blue
Pink
Yellow
Black
</pre>

==== Examples ====
'''Just white text''':
<blockquote><pre>
"gossip_stones": {
"Death Mountain Crater (Bombable Wall)": {
"text": "It's hot in here!"
}
}
</pre></blockquote>

'''Colored text''':
<blockquote><pre>
"gossip_stones": {
"Death Mountain Crater (Bombable Wall)": {
"text": "They say #Luigi# was put in this game instead of Super #Mario# 64",
"colors": ["Green", "Red"]
}
}
</pre></blockquote>

== Common Errors ==
You're very likely to run into many errors while trying to make a plandomizer. These explanations should help you with some of the more cryptic ones.

=== Game Unbeatable ===
The randomizer generator could not place items following your defined settings. You've created a situation that is not logically possible to complete.

Sometimes this is just bad luck and you have to try generating again, but if you continuously get the same exact error messages over and over, you most likely need to modify your settings or where items are placed in the world. Think carefully about what logical problems your settings and item placements might have. Refer to the [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/master/data/World Release logic files] or the [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/Dev/data/World Dev logic files] depending on which one you are using to try to help find any you have forgotten.

Of course you can always come to the [https://discordapp.com/channels/274180765816848384/476723801032491008 #setup-support] channel on the Discord to ask for help if you're feeling stuck. We can usually point you in the right direction or find the exact issue causing the error.

Plandomizer

2020-09-09T00:41:01Z

Dotzo: /* Gossip Stones */

'''Plandomizer''', often shortened to just '''Plando''', allows you to have total control over item placement. You can place a specific item on any location and locations not specified will be filled following the normal algorithm. Using a <samp>.json</samp> format text file, referred to as a '''distribution file''' when using plandomizer, you can override many different aspects of the randomizer.

This can allow you to create custom challenges you can play through yourself or share with others. The more details defined in a plandomizer the less the randomizer interferes, though the randomizer will still verify whether it is beatable based on your logic settings, and if it is logically impossible it will refuse to generate a seed.

There is a [https://ootrandomizer.com/plandoMaker beta GUI for Plandomizer on the website] that can help you with simpler plandomizer ideas, however to truly grasp the power of plandomizer you will have to modify a distribution file yourself.

== Using a Plandomizer Distribution File on the Generator ==
Plandomizer's distribution file text box is hidden by default. To enable it all you have to do is go to <samp>ROM Options</samp> on the generator and turn on the <kbd><samp>Enable Plandomizer (Optional)</samp></kbd> setting. Then use the <kbd><samp>Browse</samp></kbd> button next to the new text box to find your Plandomizer distribution <samp>.json</samp> file.

== Opening and Editing a Distribution File ==
Distributions are just normal text files using the <samp>.json</samp> extension instead of the <samp>.txt</samp> extension. They can be opened in any text editor that will open <samp>.txt</samp> 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.

=== Distribution File Format ===
'''JSON''' is a common format used for data that both a human and a computer are intended to read. It's a fairly picky format so it is a good idea to use a text editor that can tell you if you did something wrong through syntax highlighting. [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 if you go down this path. You can also check that your file is properly formatted by using a validator such as [https://jsonlint.com/ JSONLint] if you prefer to keep on using a text editor without syntax highlighting. It might also help you find an issue that you're having a hard time understanding in VSCode.

The randomizer generator on the website will also give you an error if you try to use a distribution file that is not in the proper JSON format. You may wish to use this, JSONLint, and VSCode all together to figure out how to fix any formatting problems you are having.

=== Understanding a Distribution File ===
When you generate a seed with a spoiler log, that spoiler log is actually a distribution file itself. It can be used directly to generate the exact same seed. Because of this, you can take a look at a spoiler log to help you get familiar with the types of things that can be changed, and how to format the distribution file.

Since a distribution file is in JSON format, it's somewhat rigid about how things can be written.

=== The Base Dictionary ===
First, a distribution file starts with a <kbd>{</kbd> opening curly brace, and ends with a <kbd>}</kbd> closing curly brace. Everything you define must be placed between these braces. These braces mark a '''Dictionary''' or an [https://en.wikipedia.org/wiki/Associative_array associative array], and while that link has a lot of useful information, you don't really have to understand it. Think of a dictionary data structure like you would a dictionary in the real world. You have a term, then you have the definition of that term. As this is the base dictionary, you don't write a term as the code that reads the JSON file creates its own term for this dictionary.

=== The Dictionary "Terms" ===
Within the base dictionary there are many terms, such as <samp>:version</samp>, <samp>file_hash</samp>, and <samp>locations</samp>. If you are viewing a spoiler log you'll notice some of these terms start with a <kbd>:</kbd>. These terms are ignored when Plandomizer is used and are autogenerated by the randomizer. When you are creating a distribution file yourself you can delete these terms.

Terms are followed by a <kbd>:</kbd> and then some spaces, then their definitions.

Definitions that start and end with <kbd>"</kbd> are '''Strings'''. They are just text you write, but it is important that they are between quotes.

Definitions starting with <kbd>[</kbd> an open bracket and ending with a <kbd>]</kbd> closing bracket are called '''Lists'''. In a distribution file lists will usually only contain strings. However, with other types of JSON files you could see them containing other data structures such as dictionaries, or other lists.

The rest of the definitions are just more dictionaries with their own terms that have definitions. These are the only data structures that you have to keep in mind, and generally they are already defined properly in the spoiler log for you so you can just modify them how you see fit. Just ensure you don't accidentally remove the symbols that go before and after the term.

=== The Most Common Format/Syntax Issue ===
You'll notice that each of these terms is followed at the very end by a <kbd>,</kbd> comma, except the very last one. This is probably the most common mistake someone will make when making their own distribution file. Each term needs to be separated by a comma, but the last one cannot have a comma after it. This is true for strings inside of lists, and lists, strings, and other dictionaries within a dictionary as well. If you are getting a syntax error, you probably added a comma you shouldn't have, or removed one you need. The generator will tell you that your JSON is invalid if you try to use a distribution file with one of these errors.

== What Can Plandomizer Affect ==
Plandomizer can affect an enormous amount of the resulting seed. Everything from inconsequential things like the File Hash, to the Settings the randomizer uses to fill the world, and even specifically set items in locations that the world fill algorithm will have to work around.

=== File Hash ===
The file hash is the 5 icons that are displayed at the top of the file select screen. You can set these to any valid [https://github.com/TestRunnerSRL/OoT-Randomizer/blob/Dev/Spoiler.py#L9-L42 HASH_ICON].

You can set the <samp>file_hash</samp> definition to a list of up to 5 hash icons. If you do not want to specify an icon for a set position you can either set it to the value '''null''', or if it is after all the ones you do want to set you can just not include it.

==== Hash Icons ====
<div class="mw-collapsible mw-collapsed" style="display:inline-block">
Expand to view the full list of valid hash icons for the current version of the randomizer.
<pre class="mw-collapsible-content" style="display:inline-block">
'Deku Stick',
'Deku Nut',
'Bow',
'Slingshot',
'Fairy Ocarina',
'Bombchu',
'Longshot',
'Boomerang',
'Lens of Truth',
'Beans',
'Hammer',
'Bottled Fish',
'Bottled Milk',
'Mask of Truth',
'SOLD OUT',
'Cucco',
'Mushroom',
'Saw',
'Frog',
'Master Sword',
'Mirror Shield',
'Kokiri Tunic',
'Hover Boots',
'Silver Gauntlets',
'Gold Scale',
'Stone of Agony',
'Skull Token',
'Heart Container',
'Boss Key',
'Compass',
'Map',
'Big Magic',
</pre></div>

==== Examples ====
'''Set all 5 icons to Deku Nut''':
<blockquote><pre>
"file_hash": ["Deku Nut", "Deku Nut", "Deku Nut", "Deku Nut", "Deku Nut"]
</pre></blockquote>

'''Set only the first icon to Deku Nut''':
<blockquote><pre>
"file_hash": ["Deku Nut", null, null, null, null]
</pre>
or
<pre>
"file_hash": ["Deku Nut"]
</pre></blockquote>

'''Set only the last icon to Deku Nut''':
<blockquote><pre>
"file_hash": [null, null, null, null, "Deku Nut"]
</pre></blockquote>

=== Settings ===
This is a dictionary defining the rules that the randomizer uses to fill the world. ''Any settings you set here will override the ones set in the GUI''. That also means that you can leave some settings out of this dictionary and the person using your distribution file to create a seed can have a small amount of customization they can apply in case they need a little more additional help, or perhaps want to increase the difficulty a little bit.

It is not recommended to set these manually. Instead, you should go to the beta plandomizer maker on the website. You can set all the settings you want on the first tab, then create the JSON file. From here you can copy the settings dictionary from that file into this file and remove any settings you don't want to enforce. Alternatively, if you only want a few settings to be enforced, you can copy only the settings you want from the dictionary in that other JSON file into the settings dictionary in your settings file.

There are two major issues with creating the settings dictionary entirely manually:
# If you mistype, or the name of a setting changes between versions, you will not get an error. The randomizer will just ignore this issue entirely.
# The process of figuring out the proper name for a setting, and the various values it can hold is tedious.

If you still think you want to try this method, the file in the source code you want to look at to see all this necessary information is [https://github.com/TestRunnerSRL/OoT-Randomizer/blob/Dev/SettingsList.py SettingsList.py]. This is a 3000 line monstrosity that isn't very useful if you're not already pretty familiar with the settings you are looking for in the first place. Each setting has a <var>name</var> that you have to use for a definition inside of the settings dictionary. Then various other variables within the option's object in the settings list file are used to determine what possible definitions you want to use for that setting.

Just using the plandomizer maker on the website is highly recommended over putting yourself through this experience.

=== Starting Items ===
The starting items dictionary lets you define what items a player starts with, and how many of them. This includes both items you find in the world, and consumables you would pick up such as ammo and bombs. Any items you start with will be replaced by junk in the item pool. Songs placed here will force an item to be on one of the song locations even if <var>shuffle_song_items</var> is not set. This will completely override the starting items set on the randomizer generator GUI.

The term is the item you want to start with. The definition is how many of that item you want to start with. The number is not a string and should not be put in quotes.

==== Examples ====
'''Start with full wallet without Max Rupees setting''':
<blockquote><pre>
"starting_items": {
"Rupees": 99
}
</pre></blockquote>

'''Start with all shields''':
<blockquote><pre>
"starting_items": {
"Deku Shield": 1,
"Hylian Shield": 1,
"Mirror Shiled": 1
}
</pre></blockquote>

=== Item Pool ===
This is a dictionary defining every item possible to place in the world. ''It is highly recommended that you do not set every possible item to a value in this dictionary.'' Primarily junk items. This would make your plandomizer very rigid and can cause various issues if you try changing settings that change what, and how many items you start with, or that are available in the base pool.

You can also specify if you want to <var>add</var> to the base number, <var>remove</var> from the base number, or <var>set</var> the base number for the item. The default is to set the value. If you want to use the other options you'll need to set the definition to be another dictionary.

The term is the item you want to specify the number of in the pool. The definition is either:
# The number of that item you want in the pool
# A dictionary with a term of <var>type</var> set to any of the strings "add", "remove", or "set" and a term of <var>count</var> set to the number to modify by.

==== Examples ====
'''Set Mirror Shield to have 3 copies placed in the world''':
<blockquote><pre>
"item_pool": {
"Mirror Shield": 3
}
</pre>
or
<pre>
"item_pool": {
"Mirror Shield": {
"type": "set",
"count": 3
}
}
</pre></blockquote>

'''Add 3 Deku Shields to place in the world in addition to the ones already in the base pool''':
<blockquote><pre>
"item_pool": {
"Deku Shield": {
"type": "add",
"count": 3
}
}
</pre></blockquote>

=== Dungeons ===
This dictionary lets you define which dungeons are <var>vanilla</var> and which are <var>mq</var> (master quest). ''You will have to set the number of MQ dungeons setting to match at least whatever master quest dungeons you define here''. However, you do not have to define all of the dungeons and the rest will be defined by the randomizer generator instead.

The term is the name of the dungeon. The definitions is either the string "vanilla", the string "mq", or the string "random".

==== Examples ====
'''Set only Deku Tree to mq''':
<blockquote><pre>
"dungeons": {
"Deku Tree": "mq"
}
</pre></blockquote>

'''Set only Spirit Temple to vanilla, because you don't want to learn the second version of spirit logic''':
<blockquote><pre>
"dungeons": {
"Spirit Temple": "vanilla"
}
</pre></blockquote>

'''Set Dodongo's Cavern to random''':
<blockquote><pre>
"dungeons": {
"Dodongos Cavern": "random"
}
</pre></blockquote>

=== Trials ===
You will define which trials are <var>active</var> and which ones are <var>inactive</var> in this dictionary. ''You will have to set the number of trials to match at least the trials you define here''. However, you do not have to define all of the trials and the rest will be defined by the randomizer generator instead.

The term is the name of the trial. The definition is either the string "active", the string "inactive", or the string "random".

==== Examples ====
'''Set forest, fire, and water trials as inactive''':
<blockquote><pre>
"trials": {
"Forest": "inactive",
"Fire": "inactive",
"Water": "inactive"
}
</pre></blockquote>

'''Set light trial to active, ensuring that 3 strength upgrades are required for fighting Ganon''':
<blockquote><pre>
"trials": {
"Light": "active"
}
</pre></blockquote>

'''Set water trial to random''':
<blockquote><pre>
"trials": {
"Water": "random"
}
</pre></blockquote>

=== Entrances ===
This dictionary defines how different entrances are linked together when using entrance randomizer. Entrances must be shuffled among their respective groups so you cannot use plandomizer to force a mixed entrance pool seed. You may wish to generate a entrance randomizer seed and use its spoiler log to ensure you use the correct names for the locations.

The term is the loading zone you pass through. The definition is:
* '''For Dungeons and Interiors''': a string with the name of the location you end up at
* '''For Overworld''': a dictionary with a term of <var>region</var> set to a string of the overworld region it leads to and a term of <var>from</var> set to a string of the loading zone in that region that you will appear out of.

==== Examples ====
'''Set Deku Tree entrance to Gerudo Training Grounds''':
<blockquote><pre>
"entrances": {
"Outside Deku Tree -> Deku Tree Lobby": "Gerudo Training Grounds Lobby"
}
</pre></blockquote>

'''Set Hyrule Castle exit from Market to Lon Lon Ranch main entrance''':
<blockquote><pre>
"entrances": {
"Castle Town -> Castle Grounds": {
"region": "Lon Lon Ranch",
"from": "Hyrule Field"
}
}
</pre></blockquote>

=== Locations ===
This dictionary handles what is probably the main feature of plandomizer. You can assign items to any location in the game world here. Which locations are available are heavily influenced by what settings you choose, so ensure you have the proper settings set.

The term is the name of the location. The definition is either:
* A string of an item to place there
* A list containing multiple items to randomly choose from to place there
* A dictionary containing the term <var>item</var> containing one of the above two bullet points.
** If making a multiworld plandomizer: the term <var>player</var> with the world number value of the player the item belongs to.
** If the location is a shop: the term <var>price</var> with the rupee number value the item should cost. ''You cannot set scrub prices using plandomizer''
** If the item can be an ice trap: the term <var>model</var> set to a string of the item model it should appear as in the overworld.

==== Shop Location Numbers ====
Due to the odd way the shop items are stored in the game files, using shopsanity item placement is not very intuitive.

When using 1 item shopsanity, the number you use is 7 and is the bottom left item on the left side. 
When using 2 items shopsanity, you also have number 5 which is the bottom right item on the left side. 
When using 3 items shopsanity, you add on the number 8 which is the top left item on the left side. 
When using 4 items shopsanity, you can now use all 4 numbers 5-8 for all of the left side items.

==== Special Item Groups ====
There are shortcut terms you can use for certain items when using plandomizer. They start with the <kbd>#</kbd> character. The ones that should work fine are:
<pre style="display:inline-block">
#Bottle - Places a bottle and randomly chooses a contents for it
#Junk - Places a junk item (used by exclude locations)
#AdultTrade - Places the adult trade item without specifying which one
</pre>

If you are feeling a little bit more daring, you can try:
<pre style="display:inline-block">
#Song - Places a song item
#NonWarpSong - Places non warp song item
#WarpSong - Places a warp song item
#JunkSong - Places Serenade or Prelude in non-entrance randomizer.
#Spell - Places one of the three spells
#Shield - Deku or Hylian. Doesn't include Mirror.
#HealthUpgrade - Heart Container or Piece of Heart
</pre>

All of these should work, but only the first list have been extensively tested.

==== Examples ====
'''Ready to fight Ganon after Mido's''':
<blockquote><pre>
"locations": {
"Mido Chest Top Left": "Bow",
"Mido Chest Top Right": "Magic Meter",
"Mido Chest Bottom Left": "Light Arrows",
"Mido Chest Bottom Right": "Ice Trap"
}
</pre></blockquote>

'''Bottles in Mido's''':
<blockquote><pre>
"locations": {
"Mido Chest Top Left": "#Bottle",
"Mido Chest Top Right": "#Bottle",
"Mido Chest Bottom Left": "#Bottle",
"Mido Chest Bottom Right": "#Bottle"
}
</pre></blockquote>

'''One step to fighting Ganon in the Kokiri Sword chest''':
<blockquote><pre>
"locations": {
"Kokiri Sword Chest": ["Bow", "Magic Meter", "Light Arrows"]
}
</pre></blockquote>

'''Setting shopsanity 1 item in Kokiri Shop to Ice Trap posing as Light Arrows''':
<blockquote><pre>
"locations": {
"Kokiri Shop Item 7": {
"item": "Ice Trap",
"price": 60,
"model": "Light Arrows"
}
}
</pre></blockquote>

'''Place player 2's Light Arrows in player 1's Kokiri Sword chest''':
<blockquote><pre>
"locations": {
"World 1": {
"Kokiri Sword Chest": {
"item": "Light Arrows",
"player": 2
}
}
}
</pre></blockquote>

== Hint Distribution Files ==

Hint distribution file format is similar to the old hard-coded dictionaries, plus new keys to offer finer control of different hint groups. The goal of this change is to facilitate easier sharing and updating of custom hint distributions for the different racing tournaments. An example with the Tournament distribution is provided below.

<pre>{
"name": "tournament",
"gui_name": "Tournament",
"description": "Fixed number of hints for each type, contains duplicates, and only useful hints.",
"add_locations": [
{ "location": "Deku Theater Skull Mask", "types": ["always"] }
],
"remove_locations": [],
"add_items": [],
"remove_items": [],
"dungeons_woth_limit": 2,
"dungeons_barren_limit": 1,
"named_items_required": "True",
"distribution": {
"trial": {"order": 1, "weight": 0.0, "fixed": 0, "copies": 2},
"always": {"order": 2, "weight": 0.0, "fixed": 0, "copies": 2},
"woth": {"order": 3, "weight": 0.0, "fixed": 5, "copies": 2},
"barren": {"order": 4, "weight": 0.0, "fixed": 3, "copies": 2},
"entrance": {"order": 5, "weight": 0.0, "fixed": 4, "copies": 2},
"sometimes": {"order": 6, "weight": 0.0, "fixed": 100, "copies": 2},
"random": {"order": 7, "weight": 9.0, "fixed": 0, "copies": 2},
"item": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2},
"song": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2},
"overworld": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2},
"dungeon": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2},
"junk": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2},
"named-item": {"order": 0, "weight": 0.0, "fixed": 0, "copies": 2}
}
}</pre>
GUI names and tooltip descriptions are now defined with each distribution file. Tooltips are automatically parsed to add line returns as needed for the GUI.

=== Hint Type Distribution ===

The <code>distribution</code> key is a similar format to the previous dictionary. Each hint group must be listed with the following keys:

* <code>order</code>: Integer to sort hint types from smallest to largest
* <code>weight</code>: Same as hint type weight in balanced and similar hint distributions
* <code>fixed</code>: Same as tournament distribution number of hints per world
* <code>copies</code>: Same as count per hint in predefined distributions

Tournament-style fixed hints and weighted-style hints are defined together in the same distribution. Fixed hints are rolled first. Any remaining gossip stones are filled from a random choice of hint types with assigned weights. Checks exist to make sure there are enough gossip stones left for a given random hint type count per hint. Fixed hints do not have this safeguard and rely on the user not to overfill them. Using the tournament distribution as an example, fixed hints are rolled according to the defined order and fixed number. If any gossip stones remain, the <code>random</code> hint group is rolled as part of the weighted hint types (in this case the only one, so it is guaranteed upon exhaustion of all sometimes hints). Other built-in hint types with no fixed hints have non-zero orders for all types and weights equal to the old style weight, and all types have a <code>fixed</code> value of <code>0</code>.

=== Dungeon Limits ===

Dungeon way of the hero and barren limitations are moved out of the hint generation functions into the distribution files. Values are identical in all built-in distributions except <code>very_strong</code>, which has a limit of <code>40</code> for both (equivalent to no limit).

=== Hint Type Requirements and Exclusions ===

Four new lists are provided to include or exclude hinted locations from different hint groups, as specified by the location name or filled item name. As seen in the tournament distribution, the <code>add_locations</code> key can be used to force a given location to be hinted by adding it to the <code>always</code> hint type. Locations can be added to (or removed from) any hint type. Likewise, the item keys allow for adding or removing locations to be hinted based on what items they contain. For example, to remove all songs from being hinted as way of the hero, the following would be utilized:

<pre>"remove_items": [
{ "item": "Zeldas Lullaby", "types": ["woth"] },
{ "item": "Eponas Song", "types": ["woth"] },
{ "item": "Sarias Song", "types": ["woth"] },
{ "item": "Suns Song", "types": ["woth"] },
{ "item": "Song of Time", "types": ["woth"] },
{ "item": "Song of Storms", "types": ["woth"] },
{ "item": "Minuet of Forest", "types": ["woth"] },
{ "item": "Bolero of Fire", "types": ["woth"] },
{ "item": "Serenade of Water", "types": ["woth"] },
{ "item": "Requiem of Spirit", "types": ["woth"] },
{ "item": "Nocturne of Shadow", "types": ["woth"] },
{ "item": "Prelude of Light", "types": ["woth"] }
]</pre>
Alternately, if songsanity is disabled, the song locations could be removed from the <code>woth</code> hint type to achieve the same effect.

Barren hints are the only hint type that cannot have locations added to or removed via <code>add_locations</code> or <code>remove_locations</code>. This is to prevent situations where required items are in hinted barren areas. Using the song example again, a foolish Song of Storms that leads to a required item in Bottom of the Well would be confusing to players unfamiliar with the setting. Excluding from way of the hero means it won’t be hinted, not that the game is actively lying to you. However, caution should be exercised in adding items as hinted way of the hero outside of meme settings.

Barren hints can be added or removed from consideration for specific items via the <code>add_items</code> and <code>remove_items</code> lists. This affects not just hints, but also the <code>:barren_regions</code> list in the spoiler log. In contrast, way of the hero items will still be listed in the <code>:woth_locations</code> section regardless of hint distribution changes. Forced barren items that are logically required still show up in the <code>:woth_locations</code> list if required by the seed.

== Plando Support ==

The <code>hint_dist_user</code> setting takes a hint distribution dictionary as defined by the built-in hint distribution files. If specified, it overrides the GUI-selected hint distribution. Internally, the distribution is defined as <code>custom</code>.

== Example Plando ==

The attached plando

* Requires a “random”-type location hint for the location containing Lens of Truth
* Adds shooting the sun in Lake Hylia as an always hint with custom text
* Removes Frog Ocarina Game and 40 Skulls as always hints
* Keeps other “conditional” always hints from Standard weekly settings, including Skull Mask
* Adds the location with Zelda’s Lullaby as an always hint
* Removes all other song locations from way of the hero and sometimes hint types
* Forces Rutos Letter to be considered foolish, and places it outside Ganon’s Castle to verify
* Excludes Biggoron Sword from foolish hints, and places it in the Haunted Wasteland to verify

and applies a custom hint distribution as follows:

==== Fixed Hints ====

(in order) * Always and Trials hints at 2 stones/hint * 1 Named Item hint for Lens of Truth at 2 stones/hint (as required by <code>named_items_required</code>) * 3 Way of the Hero hints at 2 stones/hint * 2 Foolish hints at 1 stone/hint * 4 Entrance hints at 2 stones/hint * 5 Sometimes hints at 1 stone/hint

==== Weighted Hints ====

On weekly settings, this is 27-29 gossip stones filled, depending on if Zelda’s Lullaby is on Ocarina of Time. The remaining 11-13 stones draw hints from weighted hint types as follows:

* Random (0.5 weight, 2 stones/hint)
* Item (1.0 weight, 2 stones/hint)
* Song (2.0 weight, 2 stones/hint)
* Overworld (3.0 weight, 2 stones/hint)
* Dungeon (1.0 weight, 2 stones/hint)
* Junk (0.5 weight, 1 stone/hint)

At least 1 junk hint will be added due to the odd number of remaining stones.

<pre>{
"settings": {
"item_hints": [
"Lens of Truth"
],
"hint_dist_user": {
"name": "custom",
"gui_name": "Plando Test Hint Distribution",
"description": "for debugging",
"add_locations": [
{ "location": "LH Sun", "types": ["always"], "text": "those who #blot out the sun# will find" },
{ "location": "Deku Theater Skull Mask", "types": ["always"] }
],
"remove_locations": [
{ "location": "ZR Frogs Ocarina Game", "types": ["always"] },
{ "location": "Kak 40 Gold Skulltula Reward", "types": ["always"] }
],
"add_items": [
{ "item": "Zeldas Lullaby", "types": ["always"] },
{ "item": "Rutos Letter", "types": ["barren"] }
],
"remove_items": [
{ "item": "Eponas Song", "types": ["woth", "sometimes"] },
{ "item": "Sarias Song", "types": ["woth", "sometimes"] },
{ "item": "Suns Song", "types": ["woth", "sometimes"] },
{ "item": "Song of Time", "types": ["woth", "sometimes"] },
{ "item": "Song of Storms", "types": ["woth", "sometimes"] },
{ "item": "Minuet of Forest", "types": ["woth", "sometimes"] },
{ "item": "Bolero of Fire", "types": ["woth", "sometimes"] },
{ "item": "Serenade of Water", "types": ["woth", "sometimes"] },
{ "item": "Requiem of Spirit", "types": ["woth", "sometimes"] },
{ "item": "Nocturne of Shadow", "types": ["woth", "sometimes"] },
{ "item": "Prelude of Light", "types": ["woth", "sometimes"] },
{ "item": "Biggoron Sword", "types": ["barren"] }
],
"dungeons_woth_limit": 2,
"dungeons_barren_limit": 1,
"named_items_required": "True",
"distribution": {
"trial": {"order": 1, "weight": 0.0, "fixed": 0, "copies": 2},
"always": {"order": 2, "weight": 0.0, "fixed": 0, "copies": 2},
"woth": {"order": 3, "weight": 0.0, "fixed": 3, "copies": 2},
"barren": {"order": 4, "weight": 0.0, "fixed": 2, "copies": 1},
"entrance": {"order": 5, "weight": 0.0, "fixed": 4, "copies": 2},
"sometimes": {"order": 6, "weight": 0.0, "fixed": 5, "copies": 1},
"random": {"order": 7, "weight": 0.5, "fixed": 0, "copies": 2},
"item": {"order": 8, "weight": 1.0, "fixed": 0, "copies": 2},
"song": {"order": 9, "weight": 2.0, "fixed": 0, "copies": 2},
"overworld": {"order": 10, "weight": 3.0, "fixed": 0, "copies": 2},
"dungeon": {"order": 11, "weight": 1.0, "fixed": 0, "copies": 2},
"junk": {"order": 12, "weight": 0.5, "fixed": 0, "copies": 1},
"named-item": {"order": 13, "weight": 0.0, "fixed": 0, "copies": 2}
}
}
},
"randomized_settings": {},
"starting_items": {},
"item_pool": {},
"entrances": {},
"locations": {
"OGC Great Fairy Reward": "Rutos Letter",
"Wasteland Chest": "Biggoron Sword"
}
}</pre>
== Item Hints for Bingo ==

The <code>item_hints</code> plando setting contains a list of items as named in ItemList.py to be added as “random” location hints. This is outside of the hint distribution setting. Built-in hint distributions assume copies per hint is the same as the sometimes category equivalent of the original distribution. The <code>named_items_required</code> hint distribution key controls if named item hints are treated as always hints. In contrast to always hints, an error will be thrown if any required named item hint cannot be placed.

Plando or third party hint distribution files can specify fixed or weighted <code>named-item</code> group hints if <code>named_items_required</code> is false.

Note that <code>add_items</code> provides similar functionality to the <code>item_hints</code> plando key if an item is added to the <code>always</code> group. The reason for duplication of this feature is to provide an easier interface for Bingo races desiring hinted tile goals without building a whole hint distribution from scratch.

=== Example Bingo Plando ===

The example plando below:

* Requires two separate strength upgrades to be hinted
* Requires Lens of Truth to be hinted
* Modifies the item pool to contain 3 empty bottles, one of which will be hinted.

<pre>{
"settings": {
"item_hints": [
"Progressive Strength Upgrade",
"Progressive Strength Upgrade",
"Lens of Truth",
"Bottle"
]
},
"randomized_settings": {},
"starting_items": {},
"item_pool": {
"Bottle": 3
},
"entrances": {},
"locations": {}
}</pre>

=== Gossip Stones ===
This dictionary is just evil. It lets you replace the Gossip Stone text with any text you wish. Unlike normal randomizer, this text can lie and mislead the player. It is recommended that you use it more for inside jokes, or different types of hints than you'd normally get using the randomizer to keep the plandomizer fun for the player. Gossip stones set here will not be taken into consideration for hints by logic.

The term is the name of the Gossip Stone. The definition is a dictionary with the term <var>text</var>.
* Any text you surround with <kbd>#</kbd> can also be colored. If you wish to do this add another term to the inner dictionary with the term <var>colors</var> and set it to a list containing strings of the colors you wish to use. You can have multiple groups of text surrounded by <kbd>#</kbd> and each one can be a different color.

==== Valid Colors ====
<pre style="display:inline-block">
White
Red
Green
Blue
Light Blue
Pink
Yellow
Black
</pre>

==== Examples ====
'''Just white text''':
<blockquote><pre>
"gossip_stones": {
"Death Mountain Crater (Bombable Wall)": {
"text": "It's hot in here!"
}
}
</pre></blockquote>

'''Colored text''':
<blockquote><pre>
"gossip_stones": {
"Death Mountain Crater (Bombable Wall)": {
"text": "They say #Luigi# was put in this game instead of Super #Mario# 64",
"colors": ["Green", "Red"]
}
}
</pre></blockquote>

== Common Errors ==
You're very likely to run into many errors while trying to make a plandomizer. These explanations should help you with some of the more cryptic ones.

=== Game Unbeatable ===
The randomizer generator could not place items following your defined settings. You've created a situation that is not logically possible to complete.

Sometimes this is just bad luck and you have to try generating again, but if you continuously get the same exact error messages over and over, you most likely need to modify your settings or where items are placed in the world. Think carefully about what logical problems your settings and item placements might have. Refer to the [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/master/data/World Release logic files] or the [https://github.com/TestRunnerSRL/OoT-Randomizer/tree/Dev/data/World Dev logic files] depending on which one you are using to try to help find any you have forgotten.

Of course you can always come to the [https://discordapp.com/channels/274180765816848384/476723801032491008 #setup-support] channel on the Discord to ask for help if you're feeling stuck. We can usually point you in the right direction or find the exact issue causing the error.

Glossary

2020-09-09T00:34:39Z

Dotzo: /* Way of the Hero */

Most every small community will eventually create its own jargon and abbreviations for things naturally out of the desire to communicate more quickly.  Ocarina of Time and the Randomizer which was built for it is no different.  Below you'll find an alphabetized list of both terminology and abbrevations commonly used in both the Ocarina of Time speedrunning and randomizer communities.  If you join the discord or a stream chat and are curious what something means, but don't want to ask, this is the place for you.

{{TOClimit|limit=2}}

= A =
=== ACE ===
- Arbitrary Code Execution. Allows the player to write data into the game's memory and have it executed as code. This is one of the most powerful glitches any video game can have as it theoretically allows you to rewrite the entire game into something else using nothing but the game itself.
=== AD ===
- An abbreviation for All Dungeons. In randomizer this can refer to both a setting which requires all of the dungeons to be beaten, but often it is refering to a seed where it was not required by the settings to beat every dungeon yet the item placement and ruleset combination forced it. This is also a speedrun category where the goal is to beat every dungeon and reach the credits.
=== All Locations Reachable ===
- A setting available as part of the randomizer which ensures that you can reach every location in the game under your current [[logic]] setting.
=== ALR ===
- [[#All Locations Reachable|All Locations Reachable]].

= B =
=== BA ===
- Bottle Adventure. A glitch which allows the player to write an arbitrary value to their B button.
=== Barren ===
- A synonym for [[#Foolish|Foolish]].
=== Beatable Only ===
- A reference to turning the [[#All Locations Reachable|All Locations Reachable]] setting off which can logically lock off entire sections of the game, based on an older name for this setting.
=== BGS ===
- Biggoron's Sword.
=== Bingo ===
- A game mode where you generate a 5x5 board of goals to complete. When you've completed a goal you check it off the board. There are many sub-variants of bingo which change how it is played. The most common ways to play, however, are standard bingo (any 5 in a row, column, or diagonal), blackout (complete all 25 goals), and lockout (only 1 person can complete any goal, person who has the most wins).
=== BK ===
- Boss Key.
=== BK Mode ===
- A commonly used phrase in [[Multiworld]] games describing the situation where a player can no longer do any [[#Check|checks]] due to their lacking of items. Stands for "Burger King Mode" after a player actually went to Burger King to get food while their teammates gathered items.
=== Blue Potato ===
- A nickname for the Ocarina of Time, due to its color and shape.
=== BotW ===
- Bottom of the Well. This is also used as an abbreviation for the game The Legend of Zelda: Breath of the Wild. Normally it is clear from context which is meant, however this shared abbreviation is often used in jokes.
=== BQ ===
- Beta Quest. A romhack which randomizes shuffles the entrance table completely randomly. Items remain in their vanilla areas, but those areas can be anywhere.
=== Burning Kak ===
- Alternative name for the Nocturne of Shadow [[#Check|check]], requiring the Forest, Fire, and Water Medallions and then walking into Kakariko Village.

= C =
=== Check ===
- A location in the game where you can receive a randomized item.
=== Co-op ===
- Often written as simply "coop", this can be referring to a couple things. "Local coop" is where multiple people play the same seed separately, but share information. "[[#Online|Online]] coop" refers to a separate emulator setup that allows multiple people to play in the same game as the same time.
=== Culling ===
- The act of moving the camera or Link far enough away from an actor so that it ceases updating every frame. This can be used glitchlessly to hold actors in place, most useful for Keese. If glitches are allowed, then it can be used to ignore some collision as well.

= D =
=== Damage ESS ===
- An alternative name for a [[#FESS|FESS]].
=== DC ===
- Dodongo's Cavern.
=== DDR ===
- [[Dungeon Door Requirement]]. A ruleset for racing which allows more glitches than [[#Standard|Standard]].

=== DMC ===
- Death Mountain Crater.
=== DMT ===
- Death Mountain Trail.
=== DoT ===
- The Door of Time. Openable with just the [[#SoT|Song of Time]]. One of the oldest glitches in Ocarina of Time is the DoT skip, allowing the player to become adult without first obtaining the Song of Time.
=== DT ===
- Deku Tree. An uncommon abbreviation.

= E =
=== Egg ===
- Can refer to either the [[#Pocket Egg|Pocket Egg]] or the [[#Weird Egg|Weird Egg]].
=== Entrance Randomizer ===
- A setting which shuffles the entrances in the world giving it an entirely new geography.
=== ER ===
- [[#Entrance Randomizer|Entrance Randomizer]].
=== ESS ===
- Extended Superslide. However, this acronym is most commonly used in reference to the region on the control stick in which the game recognizes minimal input. Link will turn in place at a constant angle per frame, which is exceedingly useful for setups. You will almost never see this written out.

=== ESS Turns ===
- Using [[#ESS|ESS]] position in small increments to turn specific angles. Often seen in discrete amounts such as "3 ess turns right" or "3 ess right."

= F =
=== FESS ===
- An abbreviation for Forward [[#Extended Superslide|Extended Superslide]]. Also known as a [[#Damage ESS|Damage ESS]], this is a method of failure when attempting a [[#HESS|HESS]]. This is almost never seen typed out fully.
=== Flame Storange ===
- A glitch which allows you to remotely light a Deku Stick on fire, allowing you to carry it a longer distance.
=== Foolish ===
- Used to describe a region of the game which is devoid of logically useful items. Hints will say that searching the area is a "[[Hints#Foolish Choice|Foolish Choice]]."

=== Freestanding ===
- This is used to describe [[#Check|checks]] which are not in a chest and instead just items on the ground to be picked up. In randomizer, they will take on the appearance of the item which you will receive as in vanilla they are all Heart Pieces, Heart Containers, and small keys. Be careful of ice traps!
=== Frog Song ===
- After playing the 6 white note songs for the frogs in Zora's River, you can prompt them to play a bug catching game. The goal of the game is to press the button of the corresponding frog when the bug is over their head. However, the order of this song never changes. It is always: A < > v < > v A v A v > < v

= G =
=== GBK ===
- Ganon's Boss Key.
=== GC ===
- A abbreviation for either Ganon's Castle or Goron City. This is used inconsistently, but is usually clear from context.
=== GF ===
- Gerudo Fortress.
=== GIM ===
- Get Item Manipulation. A glitch which allows the player to modify the item which is queued to be given to them.
=== GJ ===
- [[#Groundjump|Groundjump]].
=== GK ===
- Giant's Knife. This is a very uncommon abbreviation. Can refer to both the [[#Check|check]] and the item itself.
=== Glow Mode ===
- The point in a randomizer game when you only need to gather the Light Arrows to proceed to the end of the game.
=== Go Mode ===
- The point in a randomizer game when you either have or know the location of every item you require to beat the game.
=== Greg ===
- A nickname for the "Rupee (1)" item, standing for Green Rupee of Eternal Glory.
=== Groundjump ===
- A glitch that allows the player to cancel a backflip or sidehop, effectively giving Link the ability to jump slightly higher.
=== GS ===
- Gold Skulltula.
=== GT ===
- An abbreviation for Ganon's Tower. This is not very commonly used.
=== GTG ===
- Gerudo Training Grounds.
=== GV ===
- Gerudo Valley.
=== GY ===
- An uncommon abbreviation for the Graveyard.
=== GZ ===
- Our [https://practicerom.com/ practice tool], also known as the Practice ROM.

= H =
=== HBA ===
- Horseback Archery. Refers to both the 1000 and 1500 game in the Gerudo Fortress that in vanilla rewards a Heart Piece and Quiver upgrade, respectively.
=== HC ===
- Heart Container.
=== HESS ===
- Hyper [[#Extended Superslide|Extended Superslide]]. A glitch which allows the player to move backwards at the highest sustainable in-game speed. This is almost never seen typed out fully.
=== HF ===
- Hyrule Field.
=== Hookshot Extension ===
- A technique which allows the player to fire their hookshot, longshot, bow, or slingshot from slightly in front of where it would normally fire, allowing you to hook on to things a little bit easier and even shoot through some walls.
=== Hover ===
- In a glitchless context, refers to using the Hover boots to cross a gap. In glitch contexts, can also refer to using [[#ISG|ISG]] and a damage source to literally hover in midair.

= I =
=== IC ===
- Ice Cavern.
=== IM ===
- An umbrella term for the three glitches: [[#RBA|RBA]], [[#BA|BA]], and [[#GIM|GIM]].
=== ISG ===
- A glitch which results in your weapon being in a constant attack state.

= J =
=== Jabu ===
- Jabu Jabu's Belly. Sometimes referred to as JJB, although this is exceedingly rare.

= K =
=== Kak ===
- Short for Kakariko Village.
=== KD ===
- King Dodongo.
=== KF ===
- Kokiri Forest.
=== Know Mode ===
- Exclusive to restreams, this is a point in the randomizer whereby the audience knows the location of every item required to beat the game through the means of watching multiple players at once.
=== KZ ===
- King Zora.

= L =
=== LACS ===
- Light Arrow Cutscene. In randomizer, this mainly refers to the location where you would normally receive the Light Arrows in vanilla.
=== Ladder ===
- A type of randomizer race where a pool of racers are ranked on one leaderboard where rank is determined by a pairing of many 1-vs.-1 races. Please see their [https://ootrladder.com/ website] for more details.
=== Lensless Wasteland ===
- The act of crossing the Haunted Wasteland without the Lens of Truth. The path is always the same, so memorizing it removes the need for following the Poe.
=== LLR ===
- Lon Lon Ranch.

= M =
=== Megaflip ===
- A glitch which allows the player to backflip with maximum sustainable speed to extend its distance.
=== Megasidehop ===
- A glitch which allows the player to sidehop with maximum sustainable speed to extend its distance.
=== MoT ===
- Mask of Truth. Refers to both the item and the [[#Check|check]] from showing it in the Deku Theatre.

= N =
=== Naked Wasteland ===
- The act of crossing the Haunted Wasteland, although more specifically the quicksand on the Gerudo Fortress side of the Wasteland, without the use of any items. This can be achieved with a well-aimed backwalk.
=== No IM/WW ===
- A [[No IM/WW|ruleset]] for racing.
=== No Logic ===
- A setting that will place items into the world completely at random without checking that the game is beatable. Ocarina of Time has many glitches, so most seeds will still be beatable but often may require use of very advanced tech.

= O =
=== Ocarina Minigame ===
- The minigame in Lost Woods in which you repeat back a series of ocarina notes to two skull kids.
=== OGC ===
- Outside Ganon's Castle. Refers to the area where the Rainbow Bridge spawns, the Gold Skulltula there, as well as the Fairy Fountain reward.
=== Online ===
- Refers to the [https://discord.gg/UFVY9DE ModLoader64] emulator and setup which allows multiple people to play in the same game at the same time.
=== OoT ===
- The Legend of Zelda: Ocarina of Time. Also commonly used to refer to the Ocarina of Time item or location.
=== Out of Logic ===
- Obtaining an item or performing an activity outside of the intended order determined by the program's logic.

= P =
=== Path of Gold ===
- A type of [[Hints#Path of Gold|hint]] describing an area which contains an item logically required to collect every Triforce Piece in the seed. Appears only when [[#Triforce Hunt|Triforce Hunt]] is enabled.
=== PCS ===
- [[#Power Crouch Stab|Power Crouch Stab]]
=== PG ===
- Phantom Ganon.
=== Pocket Egg ===
- The first item in the adult trade sequence, ultimately resulting in the Biggoron's Sword.
=== PoG ===
- [[#Path of Gold|Path of Gold]].
=== PoH ===
- Piece of Heart. Also commonly referred to as HP or Heart Piece.
=== Potato ===
- A nickname for the Fairy Ocarina, due to its color and shape.
=== Power Crouch Stab ===
- The damage value used for crouch stabs is the last attack used with a sword/hammer/stick. Most often used in conjuction with a jumpslash to "store" a high damage attack in order to deal damage more quickly. This technique is known as ''Power Crouch Stabbing''. When no sword/hammer/stick has been used since entering the current area the crouch stab will take the damage value of a regular Kokiri Sword slash.

= Q =
=== QPA ===
- Quick Putaway. A glitch which allows the player to store a glitched [[#Power Crouch Stab|Power Crouch Stab]] value.

= R =
=== RA ===
- A common abbreviation for the emulator [[Retroarch]].
=== Reverse Wasteland ===
- The act of traveling the Haunted Wasteland from the Colossus side to the Fortress side. This is considered [[#Out of Logic|Out of Logic]] by default, though can be enabled via the Tricks menu.
=== RBA ===
- Reverse Bottle Adventure. A glitch which allows the player to write values into memory. It is extremely powerful, but very limited.

= S =
=== Skull Mask ===
- This refers to both the item itself which is part of the Child Trade Quest, as well as the [[#Check|check]] in which the mask is shown off in the Deku Theater.
=== SoS ===
- Song of Storms. Can refer to both the song itself and the location you would normally find it in vanilla.
=== SoT ===
- Song of Time. Can refer to both the song itself and the location you would normally find it in vanilla.
=== Spoiler Log ===
- A document created by the randomizer which lists all the settings, item locations, hints, etc. This will not open automatically or give you any extra information. It simply serves as a resource in case you get stuck or if you really wanted to know what was in that one chest you forgot.
=== SRM ===
- Stale Reference Manipulation. A glitch which allows the player to take advantage of free but uncleared memory to do a variety of things including but not limited to calling arbitrary functions, redirecting pointers, and [[#ACE|Arbitrary Code Execution]].
=== Standard ===
- The most common racing [[Standard|ruleset]].

= T =
=== TH ===
- [[#Triforce Hunt|Triforce Hunt]].
=== Three Song Route ===
- A common opener for the [[Standard]] weekly races that involves [[#Check|checking]] all 3 child song locations - Zelda's Lullaby, Epona's Song, Saria's Song - in quick succession.
=== Trials ===
- Another way to refer to entirety of Ganon's Castle and Ganon's Tower.
=== Triforce Hunt===
- An alternative game mode where pieces of the Triforce are spread throughout the world and you must collect a certain number to win.

= U =

= V =

= W =
=== Way of the Hero ===
- A [[Hints#Way of the Hero|hint]] which describes an area which contains an item that is logically required to beat the game.

=== Weird Egg ===
- The first item in the child trade series, ultimately resulting in the Mask of Truth.
=== Weirdshot ===
- A glitch which allows the player to fire first person weapons from underground.
=== WOTH ===
- [[#Way of the Hero|Way of the Hero]]

= X =

= Y =

= Z =
=== ZD ===
- Zora's Domain.
=== ZF ===
- Zora's Fountain.
=== ZL ===
- An abbreviation for either Zelda's Letter or Zelda's Lullaby. It is often clear from context which is meant. It can also refer to the vanilla location of Zelda's Lullaby to refer to it as a [[#Check|check]].
=== ZR ===
- Zora's River.