WebHost: Continue hyperlink fixes and consolidate website usage info to website user guide.
This commit is contained in:
parent
df29934968
commit
b9c2e7636c
|
@ -23,14 +23,14 @@ While a multi-world game traditionally requires all players to be playing the sa
|
||||||
Yes. All our supported games can be generated as single-player experiences, and so long as you download the software, the website is not required to generate them.
|
Yes. All our supported games can be generated as single-player experiences, and so long as you download the software, the website is not required to generate them.
|
||||||
|
|
||||||
## How do I get started?
|
## How do I get started?
|
||||||
If you are ready to start randomizing games, or want to start playing your favorite randomizer with others, please join our discord server at https://discord.gg/archipelago. There are always people ready to answer any questions
|
If you are ready to start randomizing games, or want to start playing your favorite randomizer with others, please join our discord server at the [Archipelago Discord](https://discord.gg/archipelago). There are always people ready to answer any questions
|
||||||
you might have.
|
you might have.
|
||||||
|
|
||||||
## I want to add a game to the Archipelago randomizer. How do I do that?
|
## I want to add a game to the Archipelago randomizer. How do I do that?
|
||||||
The best way to get started is to take a look at our code on GitHub at [https://github.com/ArchipelagoMW/Archipelago](https://github.com/ArchipelagoMW/Archipelago).
|
The best way to get started is to take a look at our code on GitHub at [Archipelago GitHub Page](https://github.com/ArchipelagoMW/Archipelago).
|
||||||
|
|
||||||
There you will find examples of games in the worlds folder at [https://github.com/ArchipelagoMW/Archipelago/tree/main/worlds](https://github.com/ArchipelagoMW/Archipelago/tree/main/worlds).
|
There you will find examples of games in the worlds folder at [/worlds Folder in Archipelago Code](https://github.com/ArchipelagoMW/Archipelago/tree/main/worlds).
|
||||||
|
|
||||||
You may also find developer documentation in the docs folder at [https://github.com/ArchipelagoMW/Archipelago/tree/main/docs](https://github.com/ArchipelagoMW/Archipelago/tree/main/docs).
|
You may also find developer documentation in the docs folder at [/docs Folder in Archipelago Code](https://github.com/ArchipelagoMW/Archipelago/tree/main/docs).
|
||||||
|
|
||||||
If you have more questions, feel free to ask in the **#archipelago-dev** channel on our Discord.
|
If you have more questions, feel free to ask in the **#archipelago-dev** channel on our Discord.
|
||||||
|
|
|
@ -107,6 +107,7 @@ This is only required if you wish to set up a forge install yourself, it's recom
|
||||||
- Minecraft Forge from: [Minecraft Forge Download Page](https://files.minecraftforge.net/net/minecraftforge/forge/index_1.16.5.html)
|
- Minecraft Forge from: [Minecraft Forge Download Page](https://files.minecraftforge.net/net/minecraftforge/forge/index_1.16.5.html)
|
||||||
- Minecraft Archipelago Randomizer Mod from: [AP Randomizer Forge Server Mod Releases Page](https://github.com/KonoTyran/Minecraft_AP_Randomizer/releases)
|
- Minecraft Archipelago Randomizer Mod from: [AP Randomizer Forge Server Mod Releases Page](https://github.com/KonoTyran/Minecraft_AP_Randomizer/releases)
|
||||||
- **DO NOT INSTALL THIS ON YOUR CLIENT**
|
- **DO NOT INSTALL THIS ON YOUR CLIENT**
|
||||||
|
|
||||||
### Dedicated Server Setup
|
### Dedicated Server Setup
|
||||||
Only one person has to do this setup and host a dedicated server for everyone else playing to connect to.
|
Only one person has to do this setup and host a dedicated server for everyone else playing to connect to.
|
||||||
1. Download the 1.16.5 **Minecraft Forge** installer from the link above, making sure to download the most recent recommended version.
|
1. Download the 1.16.5 **Minecraft Forge** installer from the link above, making sure to download the most recent recommended version.
|
||||||
|
|
|
@ -93,16 +93,4 @@ Enter `/connect server:port` in the client's command prompt and press enter. You
|
||||||
When the game is loaded but not yet past the intro cutscene, the "Game" status is yellow. When the client shows "AP" as green and "Game" as yellow, you're ready to play. The intro can be skipped pressing the START button and "Game" should change to green. Congratulations on successfully joining a multiworld game!
|
When the game is loaded but not yet past the intro cutscene, the "Game" status is yellow. When the client shows "AP" as green and "Game" as yellow, you're ready to play. The intro can be skipped pressing the START button and "Game" should change to green. Congratulations on successfully joining a multiworld game!
|
||||||
|
|
||||||
## Hosting a MultiWorld game
|
## Hosting a MultiWorld game
|
||||||
The recommended way to host a game is to use our hosting service. The process is relatively simple:
|
The recommended way to host a game is to use our hosting service on the [seed generation page](/generate). Or check out the Archipelago website guide for more information: [Archipelago Website Guide](/tutorial/archipelago/using_website/en)
|
||||||
|
|
||||||
1. Collect config files from your players.
|
|
||||||
2. Create a zip file containing your players' config files.
|
|
||||||
3. Upload that zip file to the generate page.
|
|
||||||
- Generate page: [WebHost Seed Generation Page](/generate)
|
|
||||||
4. Wait a moment while the seed is generated.
|
|
||||||
5. When the seed is generated, you will be redirected to a "Seed Info" page.
|
|
||||||
6. Click "Create New Room". This will take you to the server page. Provide the link to this page to your players,
|
|
||||||
so they may download their patch files from there.
|
|
||||||
7. Note that a link to a MultiWorld Tracker is at the top of the room page. The tracker shows the progress of all
|
|
||||||
players in the game. Any observers may also be given the link to this page.
|
|
||||||
8. Once all players have joined, you may begin playing.
|
|
||||||
|
|
|
@ -1,15 +1,18 @@
|
||||||
# A Link to the Past Randomizer Setup Guide
|
# A Link to the Past Randomizer Setup Guide
|
||||||
|
|
||||||
## Required Software
|
## Required Software
|
||||||
- [Z3Client](https://github.com/ArchipelagoMW/Z3Client/releases) or the SNIClient included with
|
- A client, one of:
|
||||||
[Archipelago](https://github.com/ArchipelagoMW/Archipelago/releases)
|
- Z3Client: [Z3Client Releases Page](https://github.com/ArchipelagoMW/Z3Client/releases)
|
||||||
|
- SNIClient included with Archipelago:
|
||||||
|
[Archipelago Releases Page](https://github.com/ArchipelagoMW/Archipelago/releases)
|
||||||
- If installing Archipelago, make sure to check the box for SNIClient -> A Link to the Past Patch Setup during install, or SNI will not be included
|
- If installing Archipelago, make sure to check the box for SNIClient -> A Link to the Past Patch Setup during install, or SNI will not be included
|
||||||
- [SNI](https://github.com/alttpo/sni/releases) (Included in both Z3Client and SNIClient)
|
- Super Nintendo Interface (SNI): [SNI Releases Page](https://github.com/alttpo/sni/releases)
|
||||||
|
- (Included in both Z3Client and SNIClient)
|
||||||
- Hardware or software capable of loading and playing SNES ROM files
|
- Hardware or software capable of loading and playing SNES ROM files
|
||||||
- An emulator capable of connecting to SNI
|
- An emulator capable of connecting to SNI, one of:
|
||||||
([snes9x Multitroid](https://drive.google.com/drive/folders/1_ej-pwWtCAHYXIrvs5Hro16A1s9Hi3Jz),
|
- snes9x_Multitroid: [snes9x Multitroid Download in Google Drive](https://drive.google.com/drive/folders/1_ej-pwWtCAHYXIrvs5Hro16A1s9Hi3Jz)
|
||||||
[BizHawk](http://tasvideos.org/BizHawk.html))
|
- BizHawk: [BizHawk Official Website](http://tasvideos.org/BizHawk.html)
|
||||||
- An SD2SNES, [FXPak Pro](https://krikzz.com/store/home/54-fxpak-pro.html), or other compatible hardware
|
- An SD2SNES, FXPak Pro ([FXPak Pro Store page](https://krikzz.com/store/home/54-fxpak-pro.html)), or other compatible hardware
|
||||||
- Your Japanese v1.0 ROM file, probably named `Zelda no Densetsu - Kamigami no Triforce (Japan).sfc`
|
- Your Japanese v1.0 ROM file, probably named `Zelda no Densetsu - Kamigami no Triforce (Japan).sfc`
|
||||||
|
|
||||||
## Installation Procedures
|
## Installation Procedures
|
||||||
|
@ -29,45 +32,33 @@ for launching ROM files.
|
||||||
## Create a Config (.yaml) File
|
## Create a Config (.yaml) File
|
||||||
|
|
||||||
### What is a config file and why do I need one?
|
### What is a config file and why do I need one?
|
||||||
Your config file contains a set of configuration options which provide the generator with information about how
|
Your config 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 config 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.
|
||||||
it should generate your game. Each player of a multiworld will provide their own config 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 config file?
|
### Where do I get a config file?
|
||||||
The [Player Settings](/games/A%20Link%20to%20the%20Past/player-settings) page on the website allows you to configure
|
The Player Settings page on the website allows you to configure your personal settings and export a config file from them. ([Player Settings Page for A Link to the Past](/games/A%20Link%20to%20the%20Past/player-settings))
|
||||||
your personal settings and export a config file from them.
|
|
||||||
|
|
||||||
### Verifying your config file
|
### Verifying your config file
|
||||||
If you would like to validate your config file to make sure it works, you may do so on the
|
If you would like to validate your config file to make sure it works, you may do so on the YAML Validation page. ([YAML Validation Page](/mysterycheck))
|
||||||
[YAML Validator](/mysterycheck) page.
|
|
||||||
|
|
||||||
## Generating a Single-Player Game
|
## Generating a Single-Player Game
|
||||||
1. Navigate to the [Player Settings](/games/A%20Link%20to%20the%20Past/player-settings) page, configure your options,
|
1. Navigate to the Player Settings page, configure your options, and click the "Generate Game" button. ([Player Settings for A Link to the Past](/games/A%20Link%20to%20the%20Past/player-settings))
|
||||||
and click the "Generate Game" button.
|
|
||||||
2. You will be presented with a "Seed Info" page.
|
2. You will be presented with a "Seed Info" page.
|
||||||
3. Click the "Create New Room" link.
|
3. Click the "Create New Room" link.
|
||||||
4. You will be presented with a server page, from which you can download your patch file.
|
4. You will be presented with a server page, from which you can download your patch file.
|
||||||
5. Double-click on your patch file, and the Z3Client will launch automatically, create your ROM from
|
5. Double-click on your patch file, and the Z3Client will launch automatically, create your ROM from the patch file, and open your emulator for you.
|
||||||
the patch file, and open your emulator for you.
|
|
||||||
6. Since this is a single-player game, you will no longer need the client, so feel free to close it.
|
6. Since this is a single-player game, you will no longer need the client, so feel free to close it.
|
||||||
|
|
||||||
## Joining a MultiWorld Game
|
## Joining a MultiWorld Game
|
||||||
|
|
||||||
### Obtain your patch file and create your ROM
|
### Obtain your patch file and create your ROM
|
||||||
When you join a multiworld game, you will be asked to provide your config file to whoever is hosting. Once that
|
When you join a multiworld game, you will be asked to provide your config file to whoever is hosting. Once that is done, the host will provide you with either a link to download your patch file, or with a zip file containing everyone's patch files. Your patch file should have a `.apbp` extension.
|
||||||
is done, the host will provide you with either a link to download your patch file, or with a zip file containing
|
|
||||||
everyone's patch files. Your patch file should have a `.apbp` extension.
|
|
||||||
|
|
||||||
Put your patch file on your desktop or somewhere convenient, and double click it. This should automatically
|
Put your patch file on your desktop or somewhere convenient, and double click it. This should automatically launch the client, and will also create your ROM in the same place as your patch file.
|
||||||
launch the client, and will also create your ROM in the same place as your patch file.
|
|
||||||
|
|
||||||
### Connect to the client
|
### Connect to the client
|
||||||
|
|
||||||
#### With an emulator
|
#### With an emulator
|
||||||
When the client launched automatically, SNI should have also automatically launched in the background.
|
When the client launched automatically, SNI should have also automatically launched in the background. If this is its first time launching, you may be prompted to allow it to communicate through the Windows Firewall.
|
||||||
If this is its first time launching, you may be prompted to allow it to communicate through the Windows
|
|
||||||
Firewall.
|
|
||||||
|
|
||||||
##### snes9x Multitroid
|
##### snes9x Multitroid
|
||||||
1. Load your ROM file if it hasn't already been loaded.
|
1. Load your ROM file if it hasn't already been loaded.
|
||||||
|
@ -91,37 +82,18 @@ Firewall.
|
||||||
- SNIClient users should look in their Archipelago folder for `/sni/Connector.lua`
|
- SNIClient users should look in their Archipelago folder for `/sni/Connector.lua`
|
||||||
|
|
||||||
#### With hardware
|
#### With hardware
|
||||||
This guide assumes you have downloaded the correct firmware for your device. If you have not
|
This guide assumes you have downloaded the correct firmware for your device. If you have not done so already, please do this now. SD2SNES and FXPak Pro users may download the appropriate firmware [from the sd2snes releases page](https://github.com/RedGuyyyy/sd2snes/releases). Other hardware may find helpful information [on the usb2snes supported platforms page](http://usb2snes.com/#supported-platforms).
|
||||||
done so already, please do this now. SD2SNES and FXPak Pro users may download the appropriate firmware
|
|
||||||
[here](https://github.com/RedGuyyyy/sd2snes/releases). Other hardware may find helpful information
|
|
||||||
[on this page](http://usb2snes.com/#supported-platforms).
|
|
||||||
|
|
||||||
1. Close your emulator, which may have auto-launched.
|
1. Close your emulator, which may have auto-launched.
|
||||||
2. Power on your device and load the ROM.
|
2. Power on your device and load the ROM.
|
||||||
|
|
||||||
### Connect to the Archipelago Server
|
### Connect to the Archipelago Server
|
||||||
The patch file which launched your client should have automatically connected you to the AP Server.
|
The patch file which launched your client should have automatically connected you to the AP Server. There are a few reasons this may not happen however, including if the game is hosted on the website but was generated elsewhere. If the client window shows "Server Status: Not Connected", simply ask the host for the address of the server, and copy/paste it into the "Server" input field then press enter.
|
||||||
There are a few reasons this may not happen however, including if the game is hosted on the website but
|
|
||||||
was generated elsewhere. If the client window shows "Server Status: Not Connected", simply ask the host
|
|
||||||
for the address of the server, and copy/paste it into the "Server" input field then press enter.
|
|
||||||
|
|
||||||
The client will attempt to reconnect to the new server address, and should momentarily show "Server
|
The client will attempt to reconnect to the new server address, and should momentarily show "Server Status: Connected".
|
||||||
Status: Connected".
|
|
||||||
|
|
||||||
### Play the game
|
### Play the game
|
||||||
When the client shows both SNES Device and Server as connected, you're ready to begin playing. Congratulations
|
When the client shows both SNES Device and Server as connected, you're ready to begin playing. Congratulations on successfully joining a multiworld game!
|
||||||
on successfully joining a multiworld game!
|
|
||||||
|
|
||||||
## Hosting a MultiWorld game
|
## Hosting a MultiWorld game
|
||||||
The recommended way to host a game is to use our [hosting service](/generate). The process is relatively simple:
|
The recommended way to host a game is to use our hosting service on the [seed generation page](/generate). Or check out the Archipelago website guide for more information: [Archipelago Website Guide](/tutorial/archipelago/using_website/en)
|
||||||
|
|
||||||
1. Collect config files from your players.
|
|
||||||
2. Create a zip file containing your players' config files.
|
|
||||||
3. Upload that zip file to the website linked above.
|
|
||||||
4. Wait a moment while the seed is generated.
|
|
||||||
5. When the seed is generated, you will be redirected to a "Seed Info" page.
|
|
||||||
6. Click "Create New Room". This will take you to the server page. Provide the link to this page to your players,
|
|
||||||
so they may download their patch files from there.
|
|
||||||
7. Note that a link to a MultiWorld Tracker is at the top of the room page. The tracker shows the progress of all
|
|
||||||
players in the game. Any observers may also be given the link to this page.
|
|
||||||
8. Once all players have joined, you may begin playing.
|
|
Loading…
Reference in New Issue