Grinch-AP/worlds/grinch/docs/setup_en.md

The Grinch (PS1) - Setup Guide

Required Software

• Archipelago. Please use version 0.6.3 or later for integrated BizHawk support.
• Legally obtained NTSC Bin ROM file, probably named something like Grinch, The (USA) (En,Fr,Es).bin. The game's CUE file should also work aswell along side the BIN file if you have troubles opening the BIN file.
• BizHawk Versions 2.9.1 & 2.10 is supported, but I can't promise if any version is stable or not. As of September 2025, the Grinch may not be compatible with 2.11 yet.
• The latest grinch.apworld file. You can find this on the Releases page. Put this in your Archipelago/custom_worlds folder.
• PSX BIOS Firmware bin file, which is required to run the game through Bizhawk. The file you need should be named something like SCPH-5501.BIN.

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 from NLua+KopiLua to Lua+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 click Controllers…, it's because you need to load a game first. You may need to invert Sensitivity for the up/down axis to -100%. This can be found under Analog Controls through Config > 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.
• You are required to legally obtain a PSX Bios BIN firmware file for the game to be opened. To import this, you go to Config > Firmware... > Tools and scrolling until you see the PlayStation tab. You might right click on the bios region and click Set Customization or Import on the top of the window. Then a window should open, telling you what file to import, which is the BIN file required. The bios should be recognized if Bizhawk displays a checkmark beside it, saying the bios version you have is stable and should run without issues. If a bios is already been imported and the game runs fine by itself, you may skip this step.

Generating a Game

1. Create your options file (YAML). After installing the grinch.apworld file, you can generate a template within the Archipelago Launcher by clicking Generate Template Settings.
2. Follow the general Archipelago instructions for generating a game.
3. Open ArchipelagoLauncher.exe
4. 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.

Connect to the Multiserver

Once both the client and the emulator are started, they must be connected. This should happen automatically. However, if the lua script window doesn't appear, then within the emulator click on the "Tools" menu and select "Lua Console". Click the folder button or press Ctrl+O to open a Lua script. Navigate to your Archipelago install folder and open data/lua/connector_bizhawk_generic.lua.

To connect the client to the multiserver simply put <address>:<port> on the text field on top and press enter (if the server uses a password, type in the bottom text field /connect <address>:<port> [password])