updated for EverDrive support, some corrections for Linux |
→Multiworld location: updated for emulator launch button feature |
||
| Line 36: | Line 36: | ||
== Multiworld location == | == 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. | 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 (though the multiworld app will have a button to launch Project64). | ||
On this page, you choose where to place the multiworld app. The default location is <code>%LOCALAPPDATA%\Programs\Mido's House Multiworld.exe</code> on Windows, or <code>~/bin/mhmw</code> on Linux. | On this page, you choose where to place the multiworld app. The default location is <code>%LOCALAPPDATA%\Programs\Mido's House Multiworld.exe</code> on Windows, or <code>~/bin/mhmw</code> on Linux. | ||
Revision as of 01:08, 11 November 2024
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.
Console/emulator selection
On this page, you choose whether you want to install multiworld for EverDrive, for BizHawk, or for Project64.
- For EverDrive, the installer will display a warning since EverDrive support is currently experimental and requires Fenhl's branch of the randomizer. Progress on stabilizing EverDrive support is tracked in this Mido's House Multiworld issue and this randomizer issue.
- For emulators, 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.
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.
On Linux, installing BizHawk requires root permissions. The installer will use Zenity to prompt for your password in order to use APT to install Mono. If Zenity and/or APT are not available, the installer will skip this step and you should install Mono manually.
Emulator location
This step is skipped for EverDrive.
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 EverDrive and 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. It is skipped for EverDrive.
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 (though the multiworld app will have a button to launch Project64).
On this page, you choose where to place the multiworld app. The default location is %LOCALAPPDATA%\Programs\Mido's House Multiworld.exe on Windows, or ~/bin/mhmw on Linux.
On Windows, 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:
- EverDrive: Open the “Mido's House Multiworld” app and follow its instructions.
- 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 multiworld app and the emulator (if any) right now.