53 lines
		
	
	
		
			3.9 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
			
		
		
	
	
			53 lines
		
	
	
		
			3.9 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| # The Grinch (PS1) - Setup Guide
 | |
| 
 | |
| ## Required Software
 | |
| - [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). 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](https://tasvideos.org/BizHawk/ReleaseHistory) Version 2.9.1 is required to play. Any version is NOT compatible and may have unintended behavior in 
 | |
| the game as well as not being able to connect to the client through the LUA Console.
 | |
| - The latest `grinch.apworld` file. You can find this on the [Releases page](https://github.com/MarioSpore/Grinch-AP/releases/latest). 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](https://archipelago.gg/tutorial/Archipelago/setup/en#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]`) | 
