Toggle menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Setup: Difference between revisions

From OoT Randomizer Wiki
→‎Install Python: temporary notice about python version 12
→‎Emulators: Fix to internal link
 
(8 intermediate revisions by 4 users not shown)
Line 9: Line 9:
''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 [[#Install Node.js|installing Node.js]].''


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


{{TOClimit|3}}
{{TOClimit|3}}
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 ===
<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]].
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.
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>


=== 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.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.8.0</samp> installed, however we recommend installing the latest stable version of Python available when you install it.


Line 126: 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.


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

Latest revision as of 21:32, 3 August 2024

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 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 Dev and 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 section.

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

If you want to run the standalone download version of the randomizer, you should skip to installing Python.

If you want to run the release source code or Dev source code version of randomizer, you should skip to installing Node.js.

We have compiled a list of known softlocks and crashes. It is recommended to read it through to potentially save you from frustration later.

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

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

Generating a Seed

The online randomizer does not require any downloads except for the final randomized rom, however you will be required to have one or more base files to create the randomized rom. Some of these are copyrighted files that you will need to have prior to receiving any help with setup in the randomizer discord. Please read all rules of the discord and peruse the resources channel before requesting assistance there.

  • Always Required
    • OoT v1.0 NTSC-U/NTSC-J ROM - Copyrighted file
    • A device with a multicore CPU & at least 2GB of available ram
      • Even most modern mobile devices (i.e. 2019 or newer) meet these requirements
    • A modern browser (2020 or later): Chrome, Firefox, Edge, Safari, or Opera
    • A method to play the game, which is covered later in the Playing the Randomizer section.
  • Only Required for WiiVC/vWii/Dolphin
    • OoT v1.2 NTSC WAD - Copyrighted file
    • Wii Common Key - Copyrighted file


Once prepared, go to https://ootrandomizer.com and click on the Play Now button for the latest stable version.

Click the Play Now button on the website to open the online generator.

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

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

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

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

Presets location on the ROM Options tab of the generator.

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

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

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

Now it is time to direct the website to your base rom (OoT v1.0 NTSC-U/NTSC-J). The version is important, Rev A/B and MQ roms will not work. However, you can convert those ROMs to the proper one with the Ocarina of Time Downgrader and Converter. For a normal N64 seed for use on everdrive or most emulators, leave the Output type toggle on .z64 (N64/Emulator) and browse to your rom file. For WiiVC/vWii/Dolphin, swap to WAD (WiiVC) 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.

Disable if cosmetics were previously set, enable if cosmetics are set on this page.

Once everything is set, simply click PATCH ROM! 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 section.

Windows Setup

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

Install Node.js

As of version 4.14 of the randomizer, the source code versions of the randomizer require Node.js to be installed. (Please skip this step for the executable version of the randomizer found on the website's download page.)

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

Install Python

To run the randomizer on your computer you will need to install Python. This is not needed when using the online generator but in all other cases you must have Python installed. The randomizer requires at least Python 3.8.0 installed, however we recommend installing the latest stable version of Python available when you install it.

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

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 version or the source code and Dev version of the randomizer.

Standalone Download

Download the current standalone download version of the randomzier by going to the 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 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.

Windows Troubleshooting

Click More info then Run anyway to run the installer.

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

Source Code

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

Head to the website and in the navigation bar at the top, click on Resources and then choose the Dev Github option.1 Next click on the releases button to reach the page with all of the randomizer releases.2 Click on the zip button for the latest development version of the randomizer to download it.3 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 server and ask which Dev version of the randomizer you should download.

Locate the zip file you just downloaded in your Downloads folder, or wherever you saved it. Right-click the file and click Extract All... and extract the files from the zip archive.4 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 Gui.py file inside and Double-click it to launch the randomizer.5 The first time you run the randomizer many files need to be downloaded from the internet. Wait patiently as they download.6 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.

Alternative Source Code Download Method

You can alternatively use 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 the other software mentioned above.

Playing the Randomizer

Emulators

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

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

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, please keep in mind that using Project64 v2.x for racing is against our community's racing rules.

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.

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

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

Wii Virtual Console

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

EverDrive

The Ocarina of Time Randomizer can be played on a N64 by using the EverDrive. Keep in mind that EverDrives are expensive and that the N64 is very laggy. The randomizer also requires the memory pak, even though base Ocarina of Time does not.

Patch Files

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