Ape Escape - Setup Guide
Required Software
- MultiworldGG. Please use version 0.7.70 or later for integrated BizHawk support.
- Ape Escape (USA) ISO or BIN/CUE. Either an original black label version or the Greatest Hits version should work.
- BizHawk 2.7 to 2.9.1. Bizhawk version 2.10 or other emulators are not supported.
- (Only if you are not using the MWGG client:) The latest
apeescape.apworld
file. You can find this on the Releases page. Put this in yourMultiworldGG/custom_worlds
folder.
Configuring BizHawk
Once you have installed BizHawk, open EmuHawk.exe
and change the following settings:
- If you're using BizHawk 2.7 or 2.8, go to
Config > Customize
. On the Advanced tab, switch the Lua Core fromNLua+KopiLua
toLua+LuaInterface
, then restart EmuHawk. (If you're using BizHawk 2.9, you can skip this step.) - Under
Config > Customize
, check the "Run in background" option to prevent disconnecting from the client while you're tabbed out of EmuHawk. - Under
Config > Preferred Cores > PSX
, select NymaShock. - Open any PlayStation game in EmuHawk and go to
Config > Controllers…
to configure your inputs. If you can't clickControllers…
, it's because you need to load a game first. - Ape Escape is very particular about its analog setup: go to
PSX > Settings
and selectSync Settings
. Change Virtual Port 1 to Dual Analog to help prevent deadzone issues. You may need to invert Sensitivity for the up/down axis to -100%. This can be found under Analog Controls throughConfig > Controllers…
. Depending on your controller, you may also want to tweak the Deadzone. Something like 6% is recommended for a DualShock 4. - Consider clearing keybinds in
Config > Hotkeys…
if you don't intend to use them. Select the keybind and press Esc to clear it.
Generating a Game
- Create your options file (YAML). After installing the
apeescape.apworld
file (or using MWGG), you can generate a template within the MultiworldGG Launcher by clickingGenerate Template Settings
. - Follow the general MultiworldGG instructions for generating a game.
- Open
MultiworldGGLauncher.exe
- Select "BizHawk Client" in the right-side column. On your first time opening BizHawk Client, you will also be asked to
locate
EmuHawk.exe
in your BizHawk install.
Connecting to a Server
- If EmuHawk didn't launch automatically, open it manually.
- Open your Ape Escape (USA) ISO or CUE file in EmuHawk.
- In EmuHawk, go to
Tools > Lua Console
. This window must stay open while playing. Be careful to avoid clicking "TAStudio" below it in the menu, as this is known to delete your savefile. - In the Lua Console window, go to
Script > Open Script…
. - Navigate to your Archipelago install folder and open
data/lua/connector_bizhawk_generic.lua
. - The emulator and client will eventually connect to each other. The BizHawk Client window should indicate that it connected and recognized Ape Escape.
- To connect the client to the server, enter your room's address and port (e.g.
archipelago.gg:38281
) into the top text field of the client and click Connect.
You should now be able to receive and send items. You'll need to do these steps every time you want to reconnect.
Ending a session
- Ape Escape does not automatically save your progress. When you're done playing, either save your game to a virtual memory card in the save station (recommended) or make a savestate to resume later. When reconnecting later, Archipelago will send you any items you received while disconnected.