Skip to content
This repository has been archived by the owner on Nov 23, 2021. It is now read-only.

A client for the Archipelago implementation of Super Metroid

License

Notifications You must be signed in to change notification settings

ArchipelagoMW/SuperMetroidClient

Repository files navigation

Super Metroid Client

A Super Metroid client designed for use with the Archipelago MultiWorld ecosystem. This is a Node.js program, and uses Electron.

Installation

Installation of this client is optional, but recommended. Installing using the provided executable will allow users to launch the client by double-clicking on an .apm3 file. To install the program, simply run the executable file found on the releases page, and the software will install to your AppData folder.

You may also run the client as a standalone program, which is available as a .zip file on the releases page linked above. Doing so will still save some configuration data to your AppData folder, and will require you to drag the .apm3 file onto the executable in order to patch your game.

Using the Super Metroid Client

Emulators

  1. Double-click on an .apm3 file generated by Archipelago.
  2. If prompted, select your base ROM file for LttP.
  3. A patched ROM is created automatically in the same location as the patch file.
  4. Your emulator is launched automatically, and the ROM file is loaded.
  5. Run the appropriate LUA file, called sniConnector.lua, which is available on the releases page.
  6. Observe the client will automatically find and select your device.
  7. Enter the address of the Archipelago server into the Server box on the client, and press Enter.
  8. Play the game.

SD2SNES / FXPak

  1. Double-click on an .apm3 file generated by Archipelago.
  2. If prompted, select your base ROM file for LttP.
  3. A patched ROM is created automatically in the same location as the patch file.
  4. Move the ROM file to your FXPak.
  5. Ensure QUsb2SNES is not running, if it is present on your system.
  6. Observe the client will automatically find and select your device.
  7. Enter the address of the Archipelago server into the Server box on the client, and press Enter.
  8. Play the game.

Run it from source:

I am writing this using the latest version of Node.js, but you might be able to get away with using the current LTS version.

git clone https://github.com/ArchipelagoMW/SuperMetroidClient
cd SuperMetroidClient
npm install
npm run electron-rebuild
npm start