Setup - Revision history

DuskTheUmbreon: /* Emulators */ Add ares, tweak other sections

2026-02-23T21:43:03Z

Emulators: Add ares, tweak other sections

← Older revision		Revision as of 21:43, 23 February 2026
Line 125:		Line 125:
	The emulators we support are available for free and have been extensively tested to work well with OoTR, assuming proper setup.		The emulators we support are available for free and have been extensively tested to work well with OoTR, assuming proper setup.

	[[~~Project64\|Project64 v3.0+~~]] ~~(Windows) is the least resource-intensive emulator and the easiest to~~ setup. However, it is important that versions 3.0+ are used since these are currently the only ones that provide a stable game experience. Furthermore, '''<span style="color:red">please keep in mind that using Project64 v2.x for racing is against our community's racing rules</span>'''.		If you plan to join any official OoTR races, please see [[Racing#Emulator_Settings_Requirements]] for additional setup requirements. You may ignore those instructions if you do not plan to join any official races.

	[[Bizhawk]] (Windows) is ~~the most~~ resource-intensive, but easier to ~~setup~~ than RetroArch. Bizhawk is also the only ~~race-legal~~ emulator to support [[Multiworld]] currently.		[[Project64\|Project64 v3.0+]] (Windows) is the least resource-intensive emulator and the easiest to set up. However, it is important that versions 3.0+ are used since these are currently the only ones that provide a stable game experience. Furthermore, '''<span style="color:red">please keep in mind that using Project64 v2.x for racing is against our community's racing rules</span>'''.

			[[Bizhawk]] (Windows) is more resource-intensive, but easier to set up than RetroArch. Bizhawk is also the only emulator to support [[Multiworld]] currently.

	[[Retroarch]] (Windows, macOS, Linux, and more) isn't as resource-intensive as Bizhawk. However, setting up RetroArch can be a frustrating experience, and especially so for certain controllers.		[[Retroarch]] (Windows, macOS, Linux, and more) isn't as resource-intensive as Bizhawk. However, setting up RetroArch can be a frustrating experience, and especially so for certain controllers.

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

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

	=== Wii Virtual Console ===		=== Wii Virtual Console ===

Maplestar: /* Install Python */ 3.9 is minimum now

2026-01-01T03:32:35Z

Install Python: 3.9 is minimum now

DuskTheUmbreon: /* Emulators */ Fix to internal link

2024-08-03T21:32:29Z

Emulators: Fix to internal link

← Older revision		Revision as of 21:32, 3 August 2024
Line 125:		Line 125:
	The emulators we support are available for free and have been extensively tested to work well with OoTR, assuming proper setup.		The emulators we support are available for free and have been extensively tested to work well with OoTR, assuming proper setup.

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

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

Fenhl: Undo revision 3297 by Flagrama (talk) Partial undo: lack of support for Python 3.8 turned out to be a bug specific to a fork

2024-05-08T18:34:04Z

Undo revision 3297 by Flagrama (talk) Partial undo: lack of support for Python 3.8 turned out to be a bug specific to a fork

← Older revision		Revision as of 18:34, 8 May 2024
Line 76:		Line 76:

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

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

DuskTheUmbreon: Fix the retroarch link so that it's no longer treated as external

2024-04-29T02:15:26Z

Fix the retroarch link so that it's no longer treated as external

← Older revision		Revision as of 02:15, 29 April 2024
Line 129:		Line 129:
	[[Bizhawk]] (Windows) is the most resource-intensive, but easier to setup than RetroArch. Bizhawk is also the only race-legal emulator to support [[Multiworld]] currently.		[[Bizhawk]] (Windows) is the most resource-intensive, but easier to setup than RetroArch. Bizhawk is also the only race-legal emulator to support [[Multiworld]] currently.

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

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

TreZc0 at 22:05, 21 March 2024

2024-03-21T22:05:36Z

← Older revision		Revision as of 22:05, 21 March 2024
Line 18:		Line 18:

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

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

Flagrama: /* Online Generator */ fix link

2024-01-23T22:37:34Z

Online Generator: fix link

← Older revision		Revision as of 22:37, 23 January 2024
Line 15:		Line 15:
	== Online Generator ==		== Online Generator ==

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

	=== Video Tutorial ===		=== Video Tutorial ===

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

2024-01-15T16:35:10Z

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

← Older revision		Revision as of 16:35, 15 January 2024
Line 76:		Line 76:

	=== Install Python ===		=== Install Python ===
	~~{{TemporaryNotice\|Currently the latest release Python 12.0 does not work with the randomizer for Windows users. This will be fixed in Python 12.1 in December.}}~~		To run the randomizer on your computer you will need to install [https://www.python.org Python]. This is not needed when using the [https://ootrandomizer.com online generator] but in all other cases you '''must''' have Python installed. The randomizer requires at least <samp>Python 3.9.0</samp> installed, however we recommend installing the latest stable version of Python available when you install it.
	To run the randomizer on your computer you will need to install [https://www.python.org Python]. This is not needed when using the [https://ootrandomizer.com online generator] but in all other cases you '''must''' have Python installed. The randomizer requires at least <samp>Python 3.8.0</samp> installed, however we recommend installing the latest stable version of Python available when you install it.

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

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

2023-10-09T18:45:18Z

Install Node.js: remove incorrect version info

← Older revision		Revision as of 18:45, 9 October 2023
Line 71:		Line 71:

	<gallery>		<gallery>
	File:Setup-NodeJs-LTSButton.jpeg\|1. Choose the <samp>LTS</samp> version which was <samp>12.16.2</samp> here, but may be different for you~~. So long as it is v14.x or lower it will be compatible with OoTR. Do '''not''' click the <samp>Current version</samp> button, as that version isn't currently compatible~~.		File:Setup-NodeJs-LTSButton.jpeg\|1. Choose the <samp>LTS</samp> version which was <samp>12.16.2</samp> here, but may be different for you.
	File:Setup-NodeJs-NativeModulesUnchecked.jpeg\|2. Make sure the checkbox is unchecked before clicking <samp>Next</samp>.		File:Setup-NodeJs-NativeModulesUnchecked.jpeg\|2. Make sure the checkbox is unchecked before clicking <samp>Next</samp>.
	</gallery>		</gallery>

Flagrama: /* Generating a Seed */ mention downgrade site

2023-10-09T16:25:56Z

Generating a Seed: mention downgrade site

← Older revision		Revision as of 16:25, 9 October 2023
Line 25:		Line 25:
	The online randomizer does not require any downloads except for the final randomized rom, however you will be required to have one or more base files to create the randomized rom. Some of these are copyrighted files that you will need to have prior to receiving any help with setup in the {{discord\|text=randomizer discord}}. Please read all rules of the discord and peruse the resources channel before requesting assistance there.		The online randomizer does not require any downloads except for the final randomized rom, however you will be required to have one or more base files to create the randomized rom. Some of these are copyrighted files that you will need to have prior to receiving any help with setup in the {{discord\|text=randomizer discord}}. Please read all rules of the discord and peruse the resources channel before requesting assistance there.
	* '''Always Required'''		* '''Always Required'''
	** OoT v1.0 NTSC-U/NTSC-J ~~rom~~ - Copyrighted file		** OoT v1.0 NTSC-U/NTSC-J ROM - Copyrighted file
	** A device with a multicore CPU & at least 2GB of available ram		** A device with a multicore CPU & at least 2GB of available ram
	*** Even most modern mobile devices (i.e. 2019 or newer) meet these requirements		*** Even most modern mobile devices (i.e. 2019 or newer) meet these requirements
Line 54:		Line 54:
	Seed generation takes, on average, 15 seconds but may be longer depending on the current workload of the website. Now you will be on the seed page. The URL follows the naming convention of "https://ootrandomizer.com/seed/get?id=680574" where the 6 digit ID at the end is unique to your seed. This is particularly useful for sharing seeds with friends or sharing the spoiler log when asking for help. (Note that the seed ID at the end of the URL is also present in the default file name of randomized roms. We recommend not changing rom names to keep this piece of information always with the seed.)		Seed generation takes, on average, 15 seconds but may be longer depending on the current workload of the website. Now you will be on the seed page. The URL follows the naming convention of "https://ootrandomizer.com/seed/get?id=680574" where the 6 digit ID at the end is unique to your seed. This is particularly useful for sharing seeds with friends or sharing the spoiler log when asking for help. (Note that the seed ID at the end of the URL is also present in the default file name of randomized roms. We recommend not changing rom names to keep this piece of information always with the seed.)

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

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

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

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

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

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

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

	''We have compiled [https://wiki.ootrandomizer.com/index.php?title=Common_Softlocks_And_Crashes a list of known softlocks and crashes]. It is recommended to read it through to potentially save you from frustration later.''		''We have compiled [https://wiki.ootrandomizer.com/index.php?title=Common_Softlocks_And_Crashes a list of known softlocks and crashes]. It is recommended to read it through to potentially save you from frustration later.''
Line 20:		Line 20:
	<youtube dimensions="480x270">https://www.youtube.com/watch?v=7X0Le98C5Yc</youtube>		<youtube dimensions="480x270">https://www.youtube.com/watch?v=7X0Le98C5Yc</youtube>

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

	=== Generating a Seed ===		=== Generating a Seed ===
Line 29:		Line 29:
	*** Even most modern mobile devices (i.e. 2019 or newer) meet these requirements		*** Even most modern mobile devices (i.e. 2019 or newer) meet these requirements
	** A modern browser (2020 or later): Chrome, Firefox, Edge, Safari, or Opera		** A modern browser (2020 or later): Chrome, Firefox, Edge, Safari, or Opera
	** A method to play the game, which is covered later in the [[#Playing the Randomizer\|Playing the Randomizer]] section.		** A method to play the game, which is covered later in the [[Setup#Playing the Randomizer\|Playing the Randomizer]] section.
	* '''Only Required for WiiVC/vWii/Dolphin'''		* '''Only Required for WiiVC/vWii/Dolphin'''
	** OoT v1.2 NTSC WAD - Copyrighted file		** OoT v1.2 NTSC WAD - Copyrighted file
Line 60:		Line 60:
	[[File:Override_Cosmetics.PNG\|none\|thumb\|Disable if cosmetics were previously set, enable if cosmetics are set on this page.]]		[[File:Override_Cosmetics.PNG\|none\|thumb\|Disable if cosmetics were previously set, enable if cosmetics are set on this page.]]

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

	== Windows Setup ==		== Windows Setup ==
Line 76:		Line 76:

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

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

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

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

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

	==== Windows Troubleshooting ====		==== Windows Troubleshooting ====
Line 99:		Line 99:

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

	Head to the [https://ootrandomizer.com website] and in the navigation bar at the top, click on <samp><kbd>Resources</kbd></samp> and then choose the <samp><kbd>Dev Github</kbd></samp> option.<sup>1</sup> Next click on the <samp><kbd>releases</kbd></samp> button to reach the page with all of the randomizer releases.<sup>2</sup> Click on the <samp><kbd>zip</kbd></samp> button for the latest development version of the randomizer to download it.<sup>3</sup> ''The Dev branch of the randomizer is known to be unstable. The latest version may not work properly. If you run into issues you may want to join the {{discord\|text=Discord server}} and ask which Dev version of the randomizer you should download''.		Head to the [https://ootrandomizer.com website] and in the navigation bar at the top, click on <samp><kbd>Resources</kbd></samp> and then choose the <samp><kbd>Dev Github</kbd></samp> option.<sup>1</sup> Next click on the <samp><kbd>releases</kbd></samp> button to reach the page with all of the randomizer releases.<sup>2</sup> Click on the <samp><kbd>zip</kbd></samp> button for the latest development version of the randomizer to download it.<sup>3</sup> ''The Dev branch of the randomizer is known to be unstable. The latest version may not work properly. If you run into issues you may want to join the {{discord\|text=Discord server}} and ask which Dev version of the randomizer you should download''.
Line 105:		Line 105:
	Locate the <samp>zip</samp> file you just downloaded in your <samp>Downloads</samp> folder, or wherever you saved it. <kbd>Right-click</kbd> the file and click <samp><kbd>Extract All...</kbd></samp> and extract the files from the zip archive.<sup>4</sup> A new folder should appear which may contain another folder inside. Open the folders until you see a folder with many folders and files inside. Locate the <samp>Gui.py</samp> file inside and <kbd>Double-click</kbd> it to launch the randomizer.<sup>5</sup> The first time you run the randomizer many files need to be downloaded from the internet. Wait patiently as they download.<sup>6</sup> ''This process will be faster every time you run the randomizer after this since it will only have to download the files once. Even if you download a new version it will be slightly faster as most of the files will be located in the Node.js cache and most will simply be used from there''.		Locate the <samp>zip</samp> file you just downloaded in your <samp>Downloads</samp> folder, or wherever you saved it. <kbd>Right-click</kbd> the file and click <samp><kbd>Extract All...</kbd></samp> and extract the files from the zip archive.<sup>4</sup> A new folder should appear which may contain another folder inside. Open the folders until you see a folder with many folders and files inside. Locate the <samp>Gui.py</samp> file inside and <kbd>Double-click</kbd> it to launch the randomizer.<sup>5</sup> The first time you run the randomizer many files need to be downloaded from the internet. Wait patiently as they download.<sup>6</sup> ''This process will be faster every time you run the randomizer after this since it will only have to download the files once. Even if you download a new version it will be slightly faster as most of the files will be located in the Node.js cache and most will simply be used from there''.

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

	<gallery>		<gallery>
Line 117:		Line 117:

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

	== Playing the Randomizer ==		== Playing the Randomizer ==