Multiworld

Getting Multiworld Set Up

by Raikaru13

 

Instructions

Step 0: Installing The Randomizer

Going to start this off by saying you should already know at this point how to set up the TestRunner Dev Branch. If you do not, the OoTR Discord has directions for that. This guide will primarily address setting up Multiworld games using the Dev Branch. Legacy support for 3.0-generated Multiworlds will be addressed at the end, and instructions for the 4.0 Web Patcher will be added once it exists.

Multiworld is playable only on Bizhawk. This guide will help you through the custom install needed to set up Bizhawk to run Multiworld.

 

Step 1: Download the Custom Bizhawk Installer

The very first thing that you must do is download the Multiworld script from TestRunner's GitHub page. When you download this, extract its contents to its own folder - it will be creating a new Bizhawk install for you to use, so you must keep it separate. Note: Whenever there is an update to the Multiworld script, everybody playing must update to the latest version.

 

Step 2: Running the Custom Bizhawk Installer

Once you have the contents extracted to its own folder, locate the bizhawk-co-op.ps1 file. Right Click and select Run with PowerShell.

 
 

If Powershell prompts you for permissions, say yes to all. From here, the Powershell is getting you 99% of the way done: it will create a new Bizhawk 2.3 install and place everything for you. Once Powershell is done, open up the Bizhawk 2.3 folder it created and launch EmuHawk.exe. Note: It is recommended you delete everything outside of the Bizhawk 2.3 folder that was created. These files are no longer needed and only add confusion.

 

Step 3: Configuring Bizhawk for Multiworld

3.1 - There are a few things you need to do once you've got the emulator running. The very first thing is go to Config -> Customize and navigate to the Advanced tab. At the bottom, there is an option for Lua Core; select Lua+LuaInterface and hit OK.

 
 

In the General tab of the Customize menu, check the box to enable Accept background input – this will allow Bizhawk to keep accepting controller inputs when you tab over to your tracker or notes. Clear your hotkeys by going to Config -> Hotkeys, and at the bottom click Misc and Clear All. Once you have these steps done, you MUST close your emulator and reopen it for this change to take effect.

3.2 - The next step is to set your controller up. Your controller configuration will vary based on what controller you are using. For a smooth controller experience, you must unbind the first 4 binds in Config -> Controller such that it looks like this:

 
 

You'll then have to bind your analog stick in the Analog tab of your controller config and adjust your sensitivity and deadzones to your preference. Additional info on controller setup can be found in Step 6 of the Bizhawk Guide.

3.3 - You can fix how your game looks by going to Config -> Cores -> N64 Video Plugin Settings. In here, change your resolution so that it runs smooth. Multiworld will drop your performance, so keep that in mind. The recommended video plugin is GLideN64. (This is not the same plugin as Glide64!)

 

Step 4: Opening the Lua Console

Once you have your emulator set up to run how you are comfortable with, its time to move to the Lua console. Go to Tools -> Lua Console, and a separate window will open up. This window must remain open at all times during a Multiworld. In the Lua Console, go to Settings and checkmark the Disable Scripts on loads.

 
 

This is the last of the settings changes you have to do. If you want Bizhawk to retain these settings changes for the next time, go to Config -> Save Config, close out of Bizhawk, and then reopen it and the Lua Console. If for some reason you do not have your Multiworld ROM open, you must do so now.

From here in the Lua Console, Open Script and locate the bizhawk co-op.lua file in the Bizhawk 2.3 folder. Once you have that done, a red square will appear in the console; double click it and a new window will open up.

 
 

This window must also stay open at all times.

 

Step 5: Rooms

The Lua Console Script is where you set up a room and join rooms.

If you are the Host: You must port forward. How you do this varies on what brand your router is. Instructions on how to do this can be found by Googling your brand/model of router. Once that is done, in the Bizhawk Co-op window the Host must set their name, password, and the port that was forwarded, along with setting the game script to Ocarina of Time. Hit Create Room and tell the people joining the Room Name, password, and port. (It is not recommended to use your own personal password here, as it is shared with the group. Use something that will prevent random people from joining your room, but not something that will compromise your own security.)

If you are Joining and the Host has set up the room: hit Refresh in the Bizhawk Co-op window and select the Host's Room from the dropdown bar. When you input your username, keep in mind the game will use this to display who got what item for everyone playing. It will max out at 8 characters, even if you input more. Fill in the password and port number the Host gave you and select the Ocarina of Time Game Script and hit Join Room.

 

Step 6: Play Some Multiworld!

Go and have fun with new or old friends! If you are part of the Ocarina of Time Randomizer Discord, you can assign the Multiworld role to yourself by going to the #chat-bot channel (under Misc) and typing !role Multiworld - this will allow you to receive pings in the server where there are announcements from the Devs or folks are looking for players. You can also visit #multiworld-planning (under Races) to look for additional players. It is highly recommended that you use a Tracker so that you don't accidentally leave those new friends out to dry if you miss a check. Additional info about Trackers can be found here. Map Trackers such as 2deep4real's Web Tracker or Hamsda's Map and Item Tracker package for EmoTracker are highly recommended.

 

Special Circumstances

Manual Setup

This will be helpful to those who can not run PowerShell for some reason. First download, extract, and run the Bizhawk prerequisite found here. (Yes, this step is absolutely required.) Next, download the following zip file and extract it to its own folder. This will contain an archived version of the co-op build from 12/27/18. https://www.dropbox.com/s/t9ia81ao993rhtv/BizHawk-2.3.zip?dl=0 This archival copy will need to be updated a bit; you will need to download the latest build of co-op and replace the ram controller files in /bizhawk-co-op/ramcontroller/. The latest version of this file can be found at https://github.com/TestRunnerSRL/bizhawk-co-op/tree/master/bizhawk-co-op/ramcontroller.

 

3.0 Legacy

The Bizhawk co-op script available from GitHub is intended for use with TestRunner's 3.x.x Dev Branch. (4.0+ support will be implemented once Web Patcher 4.0 and Dev versions 4.0+ exist. At time of writing, they do not.) If a Multiworld seed was generated using 3.0, then all players must replace the file found at /bizhawk-co-op/ramcontroller/Ocarina of Time.lua with the 3.0-compatible version of the file available here: https://www.dropbox.com/s/odwjtm34827tyun/Ocarina%20of%20Time.lua?dl=0. If Bizhawk is running when you replace this file, you must close and restart Bizhawk for it to use this legacy file.