Archipelago/worlds/adventure/docs/setup_en.md

Setup Guide for Adventure: Archipelago

Important

As we are using Bizhawk, this guide is only applicable to Windows and Linux systems.

Required Software

• Bizhawk: Bizhawk Releases from TASVideos
  • Version 2.3.1 and later are supported. Version 2.7 is recommended for stability.
  • Detailed installation instructions for Bizhawk can be found at the above link.
  • Windows users must run the prereq installer first, which can also be found at the above link.
• The built-in Archipelago client, which can be installed here (select Adventure Client during installation).
• An Adventure NTSC ROM file. The Archipelago community cannot provide these.

Configuring Bizhawk

Once Bizhawk has been installed, open Bizhawk and change the following settings:

• Go to Config > Customize. Switch to the Advanced tab, then switch the Lua Core from "NLua+KopiLua" to "Lua+LuaInterface". Then restart Bizhawk. This is required for the Lua script to function correctly. NOTE: Even if "Lua+LuaInterface" is already selected, toggle between the two options and reselect it. Fresh installs of newer versions of Bizhawk have a tendency to show "Lua+LuaInterface" as the default selected option but still load "NLua+KopiLua" until this step is done.

• Under Config > Customize, check the "Run in background" box. This will prevent disconnecting from the client while BizHawk is running in the background.

• It is recommended that you provide a path to BizHawk in your host.yaml for Adventure so the client can start it automatically

• At the same time, you can set an option to automatically load the adventure_connector.lua script when launching BizHawk from AdventureClient. Default Windows install example: rom_args: "--lua=C:/ProgramData/Archipelago/data/lua/ADVENTURE/adventure_connector.lua"

Configuring your YAML file

What is a YAML file and why do I need one?

Your YAML file contains a set of configuration options which provide the generator with information about how it should generate your game. Each player of a multiworld will provide their own YAML file. This setup allows each player to enjoy an experience customized for their taste, and different players in the same multiworld can all have different options.

Where do I get a YAML file?

You can generate a yaml or download a template by visiting the Adventure Settings Page

What are recommended settings to tweak for beginners to the rando?

Setting difficulty_switch_a and lowering the dragons' speeds makes the dragons easier to avoid. Adding Chalice to local_items guarantees you'll visit at least one of the interesting castles, as it can only be placed in a castle or the credits room.

Joining a MultiWorld Game

Obtain your Adventure patch file

When you join a multiworld game, you will be asked to provide your YAML file to whoever is hosting. Once that is done, the host will provide you with either a link to download your data file, or with a zip file containing everyone's data files. Your data file should have a .apadvn extension.

Drag your patch file to the AdventureClient.exe to start your client and start the ROM patch process. Once the process is finished (this can take a while), the client and the emulator will be started automatically (if you set the emulator path as recommended).

Connect to the Multiserver

Once both the client and the emulator are started, you must connect them. 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/ADVENTURE/adventure_connector.lua, if it is not configured to do this automatically.

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

Press Reset and begin playing