This is karafruit's unofficial fork of the main ALttPR project.

If you encounter any problems, please report them in the Discord in the #bug-reports channel, and add the Web tag.

You can find the official site at

Multiworld Setup

There are many ways to play ALttP:Randomizer with friends!

0. Setup Software Requirements

Each player should ensure that they have an emulator capable of running Lua Scripts (Bizhawk or Snes9x-rr) or the sd2snes/fkpakpro cartridge connected to their computer.

Each player will need to download and extract the compressed .7z file from the latest release of QUsb2snes.

Each player will need to download MultiClient.exe here.

If needed, a program capable of extracting .7z files can be found at

1. Generate the Multiworld

Head on over to Multiworld Generator and select the options for each player who will be participating in the multiworld. Then click “Generate Multiworld” and you’ll be given a randomized multiworld!

Please note that multiworld generation can take upwards of several minutes, depending on the settings chosen; please be patient.

2. Host the Multidata on a Server

Handling hosting multiworld servers on this website is still a work in progress, and subject to change.

On the multiworld seed page generated from step 1, click “Host Multiworld”; this will give you a game token and a server address, and open a server management page. Make a note of the server address for later.

The server management page can be used to kick a connection if you encounter any errors around a seat already being filled.

3. Download the ROMs

Whoever generated the multiworld seed should share the link to the multiworld generated in step 1 with everyone taking part in the game.

Each player should click on the link next to their name to be taken to a page for their individual ROM, which they can customize (choosing their sprite, heart color, etc) and download.

4. Load the ROMs and connect to QUsb2Snes

Each player should run QUsb2Snes.exe from the extracted download from step 0.

The first time QUsb2Snes is run on a computer, it should prompt for how to connect to your game. If you are using Bizhawk or Snes9x-rr, choose the Lua Bridge option. If you are using sd2snes/fxpakpro, choose the sd2snes option.

Players using Bizhawk should check that their SNES core is set to BSNES and their Lua Core is set to Lua+LuaInterface. If you encounter errors later that reference NLua, try changing the Lua Core to NLua, closing the settings window, and reopening it and changing it back. Some people have observed issues with Bizhawk incorrectly being set to NLua despite showing Lua+LuaInterface.

Each player should open their ROM.

Players using Bizhawk or Snes9x-rr should load the “luabridge.lua” script from the LuaBridge of the QUsb2Snes download. Players running on console do not need to take this step.

5. Connect to the Server

Each player should run MultiClient.exe (downloaded in step 0), which should automatically connect to QUsb2Snes. If it indicates a problem connecting to your game, check that QUsb2Snes is running properly and connected by right-clicking on its icon in the taskbar, and ensure that the lua script (if applicable) is running correctly.

MultiClient.exe will prompt for a server address to connect to; each player should enter the server address created when “Host Multiworld” was clicked in step 2. If successful, it should show a message indicating you have successfully connected to the game.

6. Play the Game!

At this point, everything should be set up and no further configuration should be necessary.

If for some reason your MultiClient loses connection to your ROM, you can type “/snes” into MultiClient to reconnect.

If your MultiClient loses connection to the server, you can type “/connect” into MultiClient to reconnect.

To forfeit your seat and give all players all remaining items from your world, you can type “!forfeit” into MultiClient.