mirror of
https://github.com/MarioSpore/Grinch-AP.git
synced 2025-10-21 20:21:32 -06:00
Website Style Upgrade (#353)
* [WebHost] Update WebHost to include modular themes system, remove unused and outdated assets * Landing Page Updates * Markdown updates, colors coming later * Remove testing theme from FF1 * Color updates for markdown styles * Updates to generated pages, so many updates * [WebHost] Update WebHost to include modular themes system, remove unused and outdated assets * Landing Page Updates * Markdown updates, colors coming later * Remove testing theme from FF1 * Color updates for markdown styles * Updates to generated pages, so many updates * Seed download page improvements * Add styles to weighted-settings page * Minor adjustments to styles * Revert base theme to grass * Add more items to ArchipIDLE * [WebHost] Update WebHost to include modular themes system, remove unused and outdated assets * Landing Page Updates * Markdown updates, colors coming later * Remove testing theme from FF1 * Color updates for markdown styles * Updates to generated pages, so many updates * Seed download page improvements * [WebHost] Update WebHost to include modular themes system, remove unused and outdated assets * Landing Page Updates * Markdown updates, colors coming later * Remove testing theme from FF1 * Color updates for markdown styles * Updates to generated pages, so many updates * Add styles to weighted-settings page * Minor adjustments to styles * Revert base theme to grass * Add more items to ArchipIDLE * Improve Archipidle item name * [WebHost] Update background images, waiting on jungle.png, added partyTime theme * [WebHost] Fix tab ordering on landing page, remove islands on screen scale, fix tutorial page width scaling * [WebHost] Final touches to WebHost * Improve get_world_theme function, add partyTime theme to ArchipIDLE WebWorld * Remove sending_visible from AutoWorld * AP Ocarina of Time Client (#352) * Core: update jinja (#351) * some typing and cleaning, mostly in Fill.py (#349) * some typing and cleaning, mostly in Fill.py * address missing Option types * resolve a few TODOs discussed in pull request * SM: Optimize a bit (#350) * SM: Optimize a bit * SM: init bosses only once * New World Order (#355) * Core: update jinja * SM: Optimize a bit * AutoWorld: import worlds in alphabetical order, to be predictable rather than arbitrary Co-authored-by: Hussein Farran <hmfarran@gmail.com> * Remove references to Z5Client in English OoT setup guide * Prevent markdown code blocks from overflowing their container Co-authored-by: espeon65536 <81029175+espeon65536@users.noreply.github.com> Co-authored-by: Fabian Dill <Berserker66@users.noreply.github.com> Co-authored-by: Doug Hoskisson <beauxq@users.noreply.github.com> Co-authored-by: Hussein Farran <hmfarran@gmail.com>
This commit is contained in:
85
WebHostLib/static/assets/tutorial/Archipelago/setup_en.md
Normal file
85
WebHostLib/static/assets/tutorial/Archipelago/setup_en.md
Normal file
@@ -0,0 +1,85 @@
|
||||
# Archipelago Setup Guide
|
||||
|
||||
This guide is intended to provide an overview of how to install, set up, and run the Archipelago multiworld software.
|
||||
This guide should take about 5 minutes to read.
|
||||
|
||||
## Installing the Archipelago software
|
||||
|
||||
The most recent public release of Archipelago can be found on the GitHub Releases page. GitHub Releases
|
||||
page: [Archipelago Releases Page](https://github.com/ArchipelagoMW/Archipelago/releases).
|
||||
|
||||
Run the exe file, and after accepting the license agreement you will be prompted on 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.
|
||||
|
||||
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/games you plan to play are available
|
||||
here go ahead and install these 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.
|
||||
|
||||
## Generating a game
|
||||
|
||||
### What is a YAML?
|
||||
|
||||
YAML is the file format which Archipelago uses in order to configure a player's world. It allows you to dictate which
|
||||
game you will be playing as well as the settings you would like for that game.
|
||||
|
||||
YAML is a format very similar to JSON however it is made to be more human-readable. If you are ever unsure of the
|
||||
validity of your YAML file you may check the file by uploading it to the check page on the Archipelago website. Check
|
||||
page: [YAML Validation Page](/mysterycheck)
|
||||
|
||||
### Creating a YAML
|
||||
|
||||
YAML files may be generated on the Archipelago website by visiting the games page and clicking the "Settings Page" link
|
||||
under any game. Clicking "Export Settings" in a game's settings page will download the YAML to your system. Games
|
||||
page: [Archipelago Games List](/games)
|
||||
|
||||
In a multiworld there must be one YAML per world. Any number of players can play on each world using either the game's
|
||||
native coop system or using Archipelago's coop support. Each world will hold one slot in the multiworld and will have a
|
||||
slot name and, if the relevant game requires it, files to associate it with that multiworld.
|
||||
|
||||
If multiple people plan to play in one world cooperatively then they will only need one YAML for their coop world. If
|
||||
each player is planning on playing their own game then they will each need a YAML.
|
||||
|
||||
### Gather All Player YAMLs
|
||||
|
||||
All players that wish to play in the generated multiworld must have a YAML file which contains the settings that they
|
||||
wish to play with.
|
||||
|
||||
Typically, a single participant of the multiworld will gather the YAML files from all other players. After getting the
|
||||
YAML files of each participant for your multiworld game they can be compressed into a ZIP folder to then be uploaded to
|
||||
the multiworld generator page. Multiworld generator
|
||||
page: [Archipelago Seed Generator Page](https://archipelago.gg/generate)
|
||||
|
||||
#### Rolling a YAML Locally
|
||||
|
||||
It is possible to roll the multiworld locally, using a local Archipelago installation. This is done by entering the
|
||||
installation directory of the Archipelago installation and placing each YAML file in the `Players` folder. If the folder
|
||||
does not exist then it can be created manually.
|
||||
|
||||
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.
|
||||
|
||||
#### Changing local host settings for generation
|
||||
|
||||
Sometimes there are various settings that you may want to change before rolling a seed such as enabling race mode,
|
||||
auto-forfeit, plando support, or setting a password.
|
||||
|
||||
All of these settings plus other options are able to 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 rolling locally ensure this file is edited to your liking *before* rolling the seed.
|
||||
|
||||
## Hosting an Archipelago Server
|
||||
|
||||
The output of rolling a YAML will be a `.archipelago` file which can be subsequently uploaded to the Archipelago host
|
||||
game page. Archipelago host game page: [Archipelago Seed Upload Page](https://archipelago.gg/uploads)
|
||||
|
||||
The `.archipelago` file may be run locally in order to host the multiworld on the local machine. This is done by
|
||||
running `ArchipelagoServer.exe` and pointing the resulting file selection prompt to the `.archipelago` file that was
|
||||
generated.
|
Reference in New Issue
Block a user