LADX: Add Lua connector for BizHawk (#1579)

This is a Lua script for BizHawk that implements the relevant parts of
the RetroArch networking API used by the Archipelago LADX Client.

socket.lua and core.dll are exact copies of the same files in
data/lua/OOT and various other folders. There is a PR consolidating
these into the base folder, which this commit is anticipating.

LADX "just works"(tm) when this is loaded in Bizhawk.
This commit is contained in:
Wilhelm Schürmann
2023-03-30 15:55:38 +02:00
committed by GitHub
parent 59b78528a9
commit 20e80d06cf
4 changed files with 279 additions and 3 deletions

View File

@@ -4,8 +4,8 @@
- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). Make sure to check the box for `Links Awakening DX`
- Software capable of loading and playing GBC ROM files
- Currently only [RetroArch](https://retroarch.com?page=platforms) 1.10.3 or newer) is supported.
- Bizhawk support will come at a later date.
- [RetroArch](https://retroarch.com?page=platforms) 1.10.3 or newer.
- [BizHawk](https://tasvideos.org/BizHawk) 2.8 or newer.
- Your American 1.0 ROM file, probably named `Legend of Zelda, The - Link's Awakening DX (USA, Europe) (SGB Enhanced).gbc`
## Installation Procedures
@@ -65,7 +65,7 @@ client, and will also create your ROM in the same place as your patch file.
### Connect to the client
##### RetroArch 1.10.3 or newer
#### RetroArch 1.10.3 or newer
You only have to do these steps once. Note, RetroArch 1.9.x will not work as it is older than 1.10.3.
@@ -77,6 +77,13 @@ You only have to do these steps once. Note, RetroArch 1.9.x will not work as it
![Screenshot of Network Commands setting](/static/generated/docs/A%20Link%20to%20the%20Past/retroarch-network-commands-en.png)
4. Go to Main Menu --> Online Updater --> Core Downloader. Scroll down and select "Nintendo - Gameboy / Color (SameBoy)".
#### BizHawk 2.8 or newer (older versions untested)
1. With the ROM loaded, click on "Tools" --> "Lua Console"
2. In the new window, click on "Script" --> "Open Script..."
3. Navigate to the folder Archipelago is installed in, and choose data/lua/connector_ladx_bizhawk.lua
4. Keep the Lua Console open during gameplay (minimizing it is fine!)
### Connect to the Archipelago Server
The patch file which launched your client should have automatically connected you to the AP Server. There are a few