54 lines
		
	
	
		
			3.1 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
		
		
			
		
	
	
			54 lines
		
	
	
		
			3.1 KiB
		
	
	
	
		
			Markdown
		
	
	
	
	
	
| 
								 | 
							
								# Mega Man 2 Setup Guide
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								## Required Software
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases)
							 | 
						||
| 
								 | 
							
								- An English Mega Man 2 ROM. Alternatively, the [Mega Man Legacy Collection](https://store.steampowered.com/app/363440/Mega_Man_Legacy_Collection/) on Steam.
							 | 
						||
| 
								 | 
							
								- [BizHawk](https://tasvideos.org/BizHawk/ReleaseHistory) 2.7 or later
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								### 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.
							 | 
						||
| 
								 | 
							
								- Open a `.nes` file in EmuHawk and go to `Config > Controllers…` to configure your inputs. If you can't click
							 | 
						||
| 
								 | 
							
								`Controllers…`, load any `.nes` ROM first.
							 | 
						||
| 
								 | 
							
								- Consider clearing keybinds in `Config > Hotkeys…` if you don't intend to use them. Select the keybind and press Esc to
							 | 
						||
| 
								 | 
							
								clear it.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								## Generating and Patching a Game
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								1. Create your options file (YAML). You can make one on the
							 | 
						||
| 
								 | 
							
								[Mega Man 2 options page](../../../games/Mega%20Man%202/player-options).
							 | 
						||
| 
								 | 
							
								2. Follow the general Archipelago instructions for [generating a game](../../Archipelago/setup/en#generating-a-game).
							 | 
						||
| 
								 | 
							
								This will generate an output file for you. Your patch file will have the `.apmm2` file extension.
							 | 
						||
| 
								 | 
							
								3. Open `ArchipelagoLauncher.exe`
							 | 
						||
| 
								 | 
							
								4. Select "Open Patch" on the left side and select your patch file.
							 | 
						||
| 
								 | 
							
								5. If this is your first time patching, you will be prompted to locate your vanilla ROM. If you are using the Legacy 
							 | 
						||
| 
								 | 
							
								Collection, provide `Proteus.exe` in place of your rom.
							 | 
						||
| 
								 | 
							
								6. A patched `.nes` file will be created in the same place as the patch file.
							 | 
						||
| 
								 | 
							
								7. On your first time opening a patch with BizHawk Client, you will also be asked to locate `EmuHawk.exe` in your
							 | 
						||
| 
								 | 
							
								BizHawk install.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								## Connecting to a Server
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								By default, opening a patch file will do steps 1-5 below for you automatically. Even so, keep them in your memory just
							 | 
						||
| 
								 | 
							
								in case you have to close and reopen a window mid-game for some reason.
							 | 
						||
| 
								 | 
							
								
							 | 
						||
| 
								 | 
							
								1. Mega Man 2 uses Archipelago's BizHawk Client. If the client isn't still open from when you patched your game,
							 | 
						||
| 
								 | 
							
								you can re-open it from the launcher.
							 | 
						||
| 
								 | 
							
								2. Ensure EmuHawk is running the patched ROM.
							 | 
						||
| 
								 | 
							
								3. In EmuHawk, go to `Tools > Lua Console`. This window must stay open while playing.
							 | 
						||
| 
								 | 
							
								4. In the Lua Console window, go to `Script > Open Script…`.
							 | 
						||
| 
								 | 
							
								5. Navigate to your Archipelago install folder and open `data/lua/connector_bizhawk_generic.lua`.
							 | 
						||
| 
								 | 
							
								6. The emulator and client will eventually connect to each other. The BizHawk Client window should indicate that it
							 | 
						||
| 
								 | 
							
								connected and recognized Mega Man 2.
							 | 
						||
| 
								 | 
							
								7. 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. It is
							 | 
						||
| 
								 | 
							
								perfectly safe to make progress offline; everything will re-sync when you reconnect.
							 |