From 064a7bf01bd85d8f4c695a27a7db3ffe9d02eedc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Dana=C3=ABl=20V?= <104455676+ReverM@users.noreply.github.com> Date: Thu, 4 Jan 2024 22:03:39 -0500 Subject: [PATCH] Docs: Update regarding new launcher (#2627) Co-authored-by: Scipio Wright --- worlds/adventure/docs/setup_en.md | 3 +- worlds/alttp/docs/multiworld_en.md | 12 +++--- worlds/checksfinder/docs/setup_en.md | 1 - worlds/dkc3/docs/setup_en.md | 9 ++-- worlds/ffmq/docs/setup_en.md | 6 +-- worlds/generic/docs/setup_en.md | 61 +++++++++++++++------------ worlds/ladx/docs/setup_en.md | 11 ++--- worlds/lufia2ac/docs/setup_en.md | 11 ++--- worlds/minecraft/docs/minecraft_en.md | 1 - worlds/mmbn3/docs/setup_en.md | 3 +- worlds/oot/docs/setup_en.md | 3 +- worlds/sm/docs/multiworld_en.md | 9 ++-- worlds/smw/docs/setup_en.md | 10 ++--- worlds/smz3/docs/multiworld_en.md | 10 ++--- worlds/undertale/docs/setup_en.md | 1 - worlds/zillion/docs/setup_en.md | 9 ++-- 16 files changed, 84 insertions(+), 76 deletions(-) diff --git a/worlds/adventure/docs/setup_en.md b/worlds/adventure/docs/setup_en.md index 10fc564aba51..7378a018c7c1 100644 --- a/worlds/adventure/docs/setup_en.md +++ b/worlds/adventure/docs/setup_en.md @@ -10,8 +10,7 @@ As we are using BizHawk, this guide is only applicable to Windows and Linux syst - 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](https://github.com/ArchipelagoMW/Archipelago/releases) - (select `Adventure Client` during installation). +- The built-in Archipelago client, which can be installed [here](https://github.com/ArchipelagoMW/Archipelago/releases). - An Adventure NTSC ROM file. The Archipelago community cannot provide these. ## Configuring BizHawk diff --git a/worlds/alttp/docs/multiworld_en.md b/worlds/alttp/docs/multiworld_en.md index 3d27a7f7ffe0..7521def36ea1 100644 --- a/worlds/alttp/docs/multiworld_en.md +++ b/worlds/alttp/docs/multiworld_en.md @@ -2,8 +2,7 @@ ## Required Software -- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). Make sure to check the box for -`SNI Client - A Link to the Past Patch Setup` +- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). - [SNI](https://github.com/alttpo/sni/releases). This is automatically included with your Archipelago installation above. - SNI is not compatible with (Q)Usb2Snes. - Hardware or software capable of loading and playing SNES ROM files @@ -18,11 +17,12 @@ but it is not supported.** ## Installation Procedures -1. Download and install SNIClient from the link above, making sure to install the most recent version. - **The installer file is located in the assets section at the bottom of the version information**. - - During setup, you will be asked to locate your base ROM file. This is your Japanese Link to the Past ROM file. +1. Download and install [Archipelago](). **The installer + file is located in the assets section at the bottom of the version information.** +2. The first time you do local generation or patch your game, you will be asked to locate your base ROM file. + This is your Japanese Link to the Past ROM file. This only needs to be done once. -2. If you are using an emulator, you should assign your Lua capable emulator as your default program for launching ROM +3. If you are using an emulator, you should assign your Lua capable emulator as your default program for launching ROM files. 1. Extract your emulator's folder to your Desktop, or somewhere you will remember. 2. Right-click on a ROM file and select **Open with...** diff --git a/worlds/checksfinder/docs/setup_en.md b/worlds/checksfinder/docs/setup_en.md index 28c7c32580c3..77eca6f71b34 100644 --- a/worlds/checksfinder/docs/setup_en.md +++ b/worlds/checksfinder/docs/setup_en.md @@ -5,7 +5,6 @@ - ChecksFinder from the [Github releases Page for the game](https://github.com/jonloveslegos/ChecksFinder/releases) (latest version) - Archipelago from the [Archipelago Releases Page](https://github.com/ArchipelagoMW/Archipelago/releases) - - (select `ChecksFinder Client` during installation.) ## Configuring your YAML file diff --git a/worlds/dkc3/docs/setup_en.md b/worlds/dkc3/docs/setup_en.md index 9c4197286eb9..236d1cb8ad32 100644 --- a/worlds/dkc3/docs/setup_en.md +++ b/worlds/dkc3/docs/setup_en.md @@ -2,7 +2,7 @@ ## Required Software -- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). Make sure to check the box for `SNI Client - Donkey Kong Country 3 Patch Setup` +- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). - Hardware or software capable of loading and playing SNES ROM files @@ -23,9 +23,10 @@ ### Windows Setup -1. During the installation of Archipelago, you will have been asked to install the SNI Client. If you did not do this, - or you are on an older version, you may run the installer again to install the SNI Client. -2. During setup, you will be asked to locate your base ROM file. This is your Donkey Kong Country 3 ROM file. +1. Download and install [Archipelago](). **The installer + file is located in the assets section at the bottom of the version information.** +2. The first time you do local generation or patch your game, you will be asked to locate your base ROM file. + This is your Donkey Kong Country 3 ROM file. This only needs to be done once. 3. If you are using an emulator, you should assign your Lua capable emulator as your default program for launching ROM files. 1. Extract your emulator's folder to your Desktop, or somewhere you will remember. diff --git a/worlds/ffmq/docs/setup_en.md b/worlds/ffmq/docs/setup_en.md index 9d9088dbc232..61b8d7e306bf 100644 --- a/worlds/ffmq/docs/setup_en.md +++ b/worlds/ffmq/docs/setup_en.md @@ -2,7 +2,7 @@ ## Required Software -- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). Make sure to check the box for `SNI Client` +- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). - Hardware or software capable of loading and playing SNES ROM files - An emulator capable of connecting to SNI such as: @@ -19,8 +19,8 @@ The Archipelago community cannot supply you with this. ### Windows Setup -1. During the installation of Archipelago, you will have been asked to install the SNI Client. If you did not do this, - or you are on an older version, you may run the installer again to install the SNI Client. +1. Download and install [Archipelago](). **The installer + file is located in the assets section at the bottom of the version information.** 2. If you are using an emulator, you should assign your Lua capable emulator as your default program for launching ROM files. 1. Extract your emulator's folder to your Desktop, or somewhere you will remember. diff --git a/worlds/generic/docs/setup_en.md b/worlds/generic/docs/setup_en.md index 93ae217e0d33..b99cdbc0fe54 100644 --- a/worlds/generic/docs/setup_en.md +++ b/worlds/generic/docs/setup_en.md @@ -17,19 +17,22 @@ The most recent public release of Archipelago can be found on the GitHub Release Run the exe file, and after accepting the license agreement you will be asked which components you would like to install. -The generator allows you to generate multiworld games on your computer. The ROM setups are required if anyone in the -game that you generate wants to play any of those games as they are needed to generate the relevant patch files. If you -do not own the game, uncheck the relevant box. If you gain the game later, the installer can be run again to install and -set up new components. +Archipelago installations are automatically bundled with some programs. These include a launcher, a generator, a +server and some clients. -The server will allow you to host the multiworld on your machine. Hosting on your machine requires forwarding the port +- The launcher lets you quickly access Archipelago's different components and programs. It is found under the name + `ArchipelagoLauncher` and can be found in the main directory of your Archipelago installation. + +- The generator allows you to generate multiworld games on your computer. Please refer to the 'Generating a game' + section of this guide for more information about it. + +- The server will allow you to host the multiworld on your machine. Hosting on your machine requires forwarding the port you are hosting on. The default port for Archipelago is `38281`. If you are unsure how to do this there are plenty of other guides on the internet that will be more suited to your hardware. -The `Clients` are what are used to connect your game to the multiworld. If the game you plan to play is available -here, go ahead and install its client as well. If the game you choose to play is supported by Archipelago but not listed -in the installation, check the setup guide for that game. Installing a client for a ROM based game requires you to have -a legally obtained ROM for that game as well. +- The clients are what are used to connect your game to the multiworld. Some games use a client that is automatically +installed with an Archipelago installation. You can access those clients via the launcher or by navigating +to your Archipelago installation. ## Generating a game @@ -72,14 +75,18 @@ If you have downloaded the settings, or have created a settings file manually, t #### On your local installation -To generate a game on your local machine, make sure to install the Archipelago software, and ensure to select the -`Generator` component, as well as the `ROM setup` for any games you will want to play. Navigate to your Archipelago +To generate a game on your local machine, make sure to install the Archipelago software. Navigate to your Archipelago installation (usually C:\ProgramData\Archipelago), and place the settings file you have either created or downloaded from the website in the `Players` folder. -Run `ArchipelagoGenerate.exe`, and it will inform you whether the generation was successful or not. If successful, there -will be an output zip in the `output` folder (usually named something like `AP_XXXXX.zip`). This will contain all -relevant information to the session, including the spoiler log, if one was generated. +Run `ArchipelagoGenerate.exe`, or click on `Generate` in the launcher, and it will inform you whether the generation +was successful or not. If successful, there will be an output zip in the `output` folder +(usually named something like `AP_XXXXX.zip`). This will contain all relevant information to the session, including the +spoiler log, if one was generated. + +Please note that some games require you to own their ROM files to generate with them as they are needed to generate the +relevant patch files. When you generate with a ROM game for the first time, you will be asked to locate its base ROM file. +This step only needs to be done once. ### Generating a multiplayer game @@ -97,12 +104,9 @@ player name. #### On the website -Gather all player YAML files into a single place, and compress them into a zip file. This can be done by pressing -ctrl/cmd + clicking on each file until all are selected, right-clicking one of the files, and clicking -`compress to ZIP file` or `send to > compressed folder`. - -Navigate to the [Generate Page](/generate), select the host settings you would like, click on `Upload File`, and -select the newly created zip from the opened window. +Gather all player YAML files into a single place, then navigate to the [Generate Page](/generate). Select the host settings +you would like, click on `Upload File(s)`, and select all player YAML files. The site also accepts `zip` archives containing YAML +files. After some time, you will be redirected to a seed info page that will display the generated seed, the time it was created, the number of players, the spoiler (if one was created) and all rooms created from this seed. @@ -114,8 +118,11 @@ It is possible to generate the multiworld locally, using a local Archipelago ins Archipelago installation folder (usually C:\ProgramData\Archipelago) and placing each YAML file in the `Players` folder. If the folder does not exist then it must be created manually. The files here should not be compressed. -After filling the `Players` folder, the `ArchipelagoGenerate.exe` program should be run in order to generate a -multiworld. The output of this process is placed in the `output` folder (usually named something like `AP_XXXXX.zip`). +After filling the `Players` folder, run`ArchipelagoGenerate.exe` or click `Generate` in the launcher. The output of +the generation is placed in the `output` folder (usually named something like `AP_XXXXX.zip`). + +Please note that if any player in the game you want to generate plays a game that needs a ROM file to generate, you will +need the corresponding ROM files. ##### Changing local host settings for generation @@ -123,10 +130,12 @@ Sometimes there are various settings that you may want to change before rolling auto-release, plando support, or setting a password. All of these settings, plus other options, may be changed by modifying the `host.yaml` file in the Archipelago -installation folder. The settings chosen here are baked into the `.archipelago` file that gets output with the other -files after generation, so if you are rolling locally, ensure this file is edited to your liking **before** rolling the -seed. This file is overwritten when running the Archipelago Installation software. If you have changed settings in this -file, and would like to retain them, you may rename the file to `options.yaml`. +installation folder. You can quickly access this file by clicking on `Open host.yaml` in the launcher. The settings +chosen here are baked into the `.archipelago` file that gets output with the other files after generation, so if you +are rolling locally, ensure this file is edited to your liking **before** rolling the seed. This file is overwritten +when running the Archipelago Installation software. If you have changed settings in this file, and would like to retain +them, you may rename the file to `options.yaml`. + ## Hosting an Archipelago Server diff --git a/worlds/ladx/docs/setup_en.md b/worlds/ladx/docs/setup_en.md index e21c5bddc489..aad077d73037 100644 --- a/worlds/ladx/docs/setup_en.md +++ b/worlds/ladx/docs/setup_en.md @@ -2,7 +2,7 @@ ## Required Software -- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). Make sure to check the box for `Links Awakening DX` +- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). - Software capable of loading and playing GBC ROM files - [RetroArch](https://retroarch.com?page=platforms) 1.10.3 or newer. - [BizHawk](https://tasvideos.org/BizHawk) 2.8 or newer. @@ -10,11 +10,12 @@ ## Installation Procedures -1. Download and install LinksAwakeningClient from the link above, making sure to install the most recent version. - **The installer file is located in the assets section at the bottom of the version information**. - - During setup, you will be asked to locate your base ROM file. This is your Links Awakening DX ROM file. +1. Download and install [Archipelago](). **The installer + file is located in the assets section at the bottom of the version information.** +2. The first time you do local generation or patch your game, you will be asked to locate your base ROM file. + This is your Links Awakening DX ROM file. This only needs to be done once.. -2. You should assign your emulator as your default program for launching ROM +3. You should assign your emulator as your default program for launching ROM files. 1. Extract your emulator's folder to your Desktop, or somewhere you will remember. 2. Right-click on a ROM file and select **Open with...** diff --git a/worlds/lufia2ac/docs/setup_en.md b/worlds/lufia2ac/docs/setup_en.md index 3762f32fb4a8..4d4ea811abcf 100644 --- a/worlds/lufia2ac/docs/setup_en.md +++ b/worlds/lufia2ac/docs/setup_en.md @@ -2,7 +2,7 @@ ## Required Software -- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). Make sure to check the box for `SNI Client - Lufia II Ancient Cave Patch Setup` +- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). - Hardware or software capable of loading and playing SNES ROM files - An emulator capable of connecting to SNI ([snes9x rr](https://github.com/gocha/snes9x-rr/releases), @@ -14,11 +14,12 @@ modded SNES minis are currently not supported by SNI** ## Installation Procedures -1. Download and install SNIClient from the link above, making sure to install the most recent version. - **The installer file is located in the assets section at the bottom of the version information**. - - During setup, you will be asked to locate your base ROM file. This is your American Lufia II - Rise of the Sinistrals ROM file. +1. Download and install [Archipelago](). **The installer + file is located in the assets section at the bottom of the version information.** +2. The first time you do local generation or patch your game, you will be asked to locate your base ROM file. + This is your American Lufia II - Rise of the Sinistrals ROM file. This only needs to be done once. -2. If you are using an emulator, you should assign your Lua capable emulator as your default program for launching ROM +3. If you are using an emulator, you should assign your Lua capable emulator as your default program for launching ROM files. 1. Extract your emulator's folder to your Desktop, or somewhere you will remember. 2. Right-click on a ROM file and select **Open with...** diff --git a/worlds/minecraft/docs/minecraft_en.md b/worlds/minecraft/docs/minecraft_en.md index e8b1a3642ee0..b71ed930a5d8 100644 --- a/worlds/minecraft/docs/minecraft_en.md +++ b/worlds/minecraft/docs/minecraft_en.md @@ -5,7 +5,6 @@ - Minecraft Java Edition from the [Minecraft Java Edition Store Page](https://www.minecraft.net/en-us/store/minecraft-java-edition) - Archipelago from the [Archipelago Releases Page](https://github.com/ArchipelagoMW/Archipelago/releases) - - (select `Minecraft Client` during installation.) ## Configuring your YAML file diff --git a/worlds/mmbn3/docs/setup_en.md b/worlds/mmbn3/docs/setup_en.md index b5ff1625c819..e9181ea54881 100644 --- a/worlds/mmbn3/docs/setup_en.md +++ b/worlds/mmbn3/docs/setup_en.md @@ -10,8 +10,7 @@ As we are using Bizhawk, this guide is only applicable to Windows and Linux syst - Version 2.7.0 and later are supported. - 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](https://github.com/ArchipelagoMW/Archipelago/releases) - (select `MegaMan Battle Network 3 Client` during installation). +- The built-in Archipelago client, which can be installed [here](https://github.com/ArchipelagoMW/Archipelago/releases). - A US MegaMan Battle Network 3 Blue Rom. If you have the [MegaMan Battle Network Legacy Collection Vol. 1](https://store.steampowered.com/app/1798010/Mega_Man_Battle_Network_Legacy_Collection_Vol_1/) on Steam, you can obtain a copy of this ROM from the game's files, see instructions below. diff --git a/worlds/oot/docs/setup_en.md b/worlds/oot/docs/setup_en.md index 72f15fa6c768..4d27019fa771 100644 --- a/worlds/oot/docs/setup_en.md +++ b/worlds/oot/docs/setup_en.md @@ -10,8 +10,7 @@ As we are using BizHawk, this guide is only applicable to Windows and Linux syst - 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](https://github.com/ArchipelagoMW/Archipelago/releases) - (select `Ocarina of Time Client` during installation). +- The built-in Archipelago client, which can be installed [here](https://github.com/ArchipelagoMW/Archipelago/releases). - An Ocarina of Time v1.0 ROM. ## Configuring BizHawk diff --git a/worlds/sm/docs/multiworld_en.md b/worlds/sm/docs/multiworld_en.md index 129150774341..0e82be769571 100644 --- a/worlds/sm/docs/multiworld_en.md +++ b/worlds/sm/docs/multiworld_en.md @@ -2,7 +2,7 @@ ## Required Software -- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). Make sure to check the box for `SNI Client - Super Metroid Patch Setup` +- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). - Hardware or software capable of loading and playing SNES ROM files @@ -18,9 +18,10 @@ ### Windows Setup -1. During the installation of Archipelago, you will have been asked to install the SNI Client. If you did not do this, - or you are on an older version, you may run the installer again to install the SNI Client. -2. During setup, you will be asked to locate your base ROM file. This is your Super Metroid ROM file. +1. Download and install [Archipelago](). **The installer + file is located in the assets section at the bottom of the version information.** +2. The first time you do local generation or patch your game, you will be asked to locate your base ROM file. + This is your Super Metroid ROM file. This only needs to be done once. 3. If you are using an emulator, you should assign your Lua capable emulator as your default program for launching ROM files. 1. Extract your emulator's folder to your Desktop, or somewhere you will remember. diff --git a/worlds/smw/docs/setup_en.md b/worlds/smw/docs/setup_en.md index 3967f544a056..c8f408d6e256 100644 --- a/worlds/smw/docs/setup_en.md +++ b/worlds/smw/docs/setup_en.md @@ -2,8 +2,7 @@ ## Required Software -- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). Make sure to check the box for `SNI Client - Super Mario World Patch Setup` - +- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). - Hardware or software capable of loading and playing SNES ROM files - An emulator capable of connecting to SNI such as: @@ -23,9 +22,10 @@ ### Windows Setup -1. During the installation of Archipelago, you will have been asked to install the SNI Client. If you did not do this, - or you are on an older version, you may run the installer again to install the SNI Client. -2. During setup, you will be asked to locate your base ROM file. This is your Super Mario World ROM file. +1. Download and install [Archipelago](). **The installer + file is located in the assets section at the bottom of the version information.** +2. The first time you do local generation or patch your game, you will be asked to locate your base ROM file. + This is your Super Mario World ROM file. This only needs to be done once. 3. If you are using an emulator, you should assign your Lua capable emulator as your default program for launching ROM files. 1. Extract your emulator's folder to your Desktop, or somewhere you will remember. diff --git a/worlds/smz3/docs/multiworld_en.md b/worlds/smz3/docs/multiworld_en.md index 53842a3c6fa4..fadd55028fe1 100644 --- a/worlds/smz3/docs/multiworld_en.md +++ b/worlds/smz3/docs/multiworld_en.md @@ -4,8 +4,7 @@ - One of the client programs: - [SNIClient](https://github.com/ArchipelagoMW/Archipelago/releases), included with the main - Archipelago install. Make sure to check the box for `SNI Client - Super Metroid Patch Setup` and - `SNI Client - A Link to the Past Patch Setup` + Archipelago install. - Hardware or software capable of loading and playing SNES ROM files - An emulator capable of connecting to SNI such as: - snes9x-rr from: [snes9x rr](https://github.com/gocha/snes9x-rr/releases), @@ -20,9 +19,10 @@ ### Windows Setup -1. During the installation of Archipelago, you will have been asked to install the SNI Client. If you did not do this, - or you are on an older version, you may run the installer again to install the SNI Client. -2. During setup, you will be asked to locate your base ROM files. This is your Super Metroid and Zelda3 ROM files. +1. Download and install [Archipelago](). **The installer + file is located in the assets section at the bottom of the version information.** +2. The first time you do local generation or patch your game, you will be asked to locate your base ROM file. + This is your Super Metroid and Zelda3 ROM files. This only needs to be done once. 3. If you are using an emulator, you should assign your Lua capable emulator as your default program for launching ROM files. 1. Extract your emulator's folder to your Desktop, or somewhere you will remember. diff --git a/worlds/undertale/docs/setup_en.md b/worlds/undertale/docs/setup_en.md index f82105c26916..3c20b614d3fa 100644 --- a/worlds/undertale/docs/setup_en.md +++ b/worlds/undertale/docs/setup_en.md @@ -4,7 +4,6 @@ - Undertale from the [Steam page](https://store.steampowered.com/app/391540) - Archipelago from the [Archipelago Releases Page](https://github.com/ArchipelagoMW/Archipelago/releases) - - (select `Undertale Client` during installation.) ### First time setup diff --git a/worlds/zillion/docs/setup_en.md b/worlds/zillion/docs/setup_en.md index 22dee5ee55e6..79f7912dd4fd 100644 --- a/worlds/zillion/docs/setup_en.md +++ b/worlds/zillion/docs/setup_en.md @@ -2,7 +2,7 @@ ## Required Software -- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). Make sure to check the box for `Zillion Client - Zillion Patch Setup` +- [Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases). - RetroArch 1.10.3 or newer from: [RetroArch Website](https://retroarch.com?page=platforms). @@ -30,9 +30,10 @@ Put your Zillion ROM file in the Archipelago directory in your home directory. ### Windows Setup -1. During the installation of Archipelago, install the Zillion Client. If you did not do this, - or you are on an older version, you may run the installer again to install the Zillion Client. -2. During setup, you will be asked to locate your base ROM file. This is the Zillion ROM file mentioned above in Required Software. +1. Download and install [Archipelago](). **The installer + file is located in the assets section at the bottom of the version information.** +2. The first time you do local generation or patch your game, you will be asked to locate your base ROM file. + This is the Zillion ROM file mentioned above in Required Software. This only needs to be done once. --- # Play