ArchipelagoEX

What It Is

• frontend/UI/wrapper for Archipelago functionality
• run/YAML organizer

What It Is Not

• A game
• YAML file editor (please use a capable editor for that, e.g., VS Code)
• AP world
• A new game-generation feature

Concept

This tool is designed to be installed alongside your Archipelago installation. It helps you store YAML files and configure runs, making it easier to manage complex setups and reuse YAML files without manually copying them. It also automates moving YAML files around.
Think of it like LaunchBox/RetroArch for emulators or a Git client for Git, but for Archipelago. For example, you can configure your YAMLs, press "Run," and the tool will:

• Merge the YAML files together
• Move them to the correct directory
• Start the local generation process
• Clean up your "players" directory, so no manual copy-pasting is needed

That's the initial idea. Possible future features include:

• Apworld manager
  
• A game launcher to start your game with a tracker alongside it
• A YAML merger to update YAML files with new versions
• A YAML snippet store for things like:
  • Priority locations for a game
  • Plando blocks

Icon by: Kass(𝓪𝓷𝓭𝓻𝓪)

Please post your feedback: https://discord.com/channels/731205301247803413/1344564135656030278

FAQ

Reset your installation

• Open your AEX directory in cmd/powershell/any shell
  • in windows: type cmd in the address bar of your explorer window
• Run the AEXTui executable with --reset
  • Windows: AEXTui.exe --reset
  • Linux: ./AEXTui --reset

Can't find my game

• make sure it's installed in, and only in, custom_worlds
• run the Reload games action in AEX
• if it's still not there run Generate Template Options from the ArchipelagoLauncher and see if a template gets generated

Imports

1. (singular) Multiworld import That's probably the most common use-case. Reads and splits all .yaml files in a directory, everything will be linked to one single new MW. That's the async planer one. You can basically prepare the Players folder anywhere and load it in as a MW.
2. Multiworlds import Also searches a directory for yamls, but this links everything to independent multiworlds, if it finds a multigame .yaml the configs will be split and they get linked to one MW.
3. Configs only Searches a directory for .yaml files and imports everything as a config. When it finds a multigame config (multiple games, not randomized game) it splits them into individual configs. A big bulk import of configs, useful when you have a big directory and just want to load everything in.