This article documents the behavior of the installer for Mido's House Multiworld. The installer can be downloaded from the Mido's House Multiworld website. It is currently available for Windows and Linux.
Emulator selection
On this page, you choose whether you want to install multiworld for BizHawk or for Project64. The installer supports both installing multiworld for an existing copy of the selected emulator, as well as installing a new copy of the emulator itself. The choice between these two modes is made on the next page.
If there is only one supported emulator (which is currently the case on Linux, where only BizHawk is supported), this page is skipped and the supported emulator is selected automatically.
Admin permissions
On Windows, installing multiworld for Project64 requires administrator permissions. The installer will display a User Account Control prompt to reopen itself as administrator. The original installer window will remain open and display a message asking you to use the new instance instead.
Emulator location
On this page, you choose whether to install multiworld for an existing copy of the selected emulator or to install the emulator as well. You can select the emulator installation folder, either to locate an existing emulator installed at an unusual location or to customize where to install it. The selected path should be the folder containing the emulator, not the emulator executable itself.
Emulator update
This step is currently only implemented for BizHawk, it is skipped for Project64. You can check the Project64 website for updates if you'd like.
Each version of Mido's House Multiworld only works with exactly one version of BizHawk. If the installer detects an older version of BizHawk, it will offer to automatically update it. Note that updating BizHawk can sometimes break the emulator settings. In this case, the new BizHawk version will display an error message saying “It appears your config file (config.ini) is corrupted” when it's opened. DO NOT close or click OK on the error message! Make a backup of the file config.ini in your BizHawk folder first. It can be used with a “diff” tool to salvage your settings. See BizHawk issue #2094 for details.
Emulator installation
This step is completely automated for Project64.
If BizHawk is being installed on Windows, there will be a User Account Control prompt, and then the BizHawk-Prereqs installer will pop up and you will need to click through it.
If BizHawk is being installed on Linux, the multiworld installer will attempt to use zenity and apt to install Mono. On Ubuntu, both of these programs are installed by default. If you're on a different distribution, you may have to manually install mono-complete or similar.
Multiworld location
This step is skipped for Project64 version 4 and for BizHawk, for which the multiworld app is automatically placed in a hidden folder and automatically opened when the emulator plugin is started. For Project64 version 3, both the emulator itself and the multiworld app must be launched manually at the start of each play session.
On this page, you choose where to place the multiworld app. The default location is %LOCALAPPDATA%\Programs.
There is also an option to create a desktop shortcut. Regardless of whether this is selected, the app will be added to the program list in the Start menu (this is not the same as a Start menu shortcut, which must be created manually if desired).
Summary
Once everything has been installed, there's a quick explanation of how to play multiworld. In case you skipped over it, here it is again:
- BizHawk: In BizHawk, select Tools → External Tool → Mido's House Multiworld.
- Project64 version 3: Open the “Mido's House Multiworld” app and follow its instructions.
- Project64 version 4: In Project64, select Debugger → Scripts → ootrmw.js and click Run.
Finally, the installer will offer to open the emulator right now.