Fork of Archipelago Multi-Game Randomizer and Server that runs on https://ap.hollymcfarland.com
Go to file
Daniel Grace e5a1052089
Hollow Knight updates (goals, WP/POP, etc.) (#438)
* Hollow Knight updates:

- Add configurable goals (Any, THK, Siblings, Radiance)
  - Change base logic to require Opened_Black_Egg_Temple instead of
    requiring 3 dreamers.  This is future-proof for transition rando,
    where Black Egg might not have been located yet.
  - Add combat logic for THK and Radiance on par with Rando4's boss logic,
    so itemless HK shouldn't be required.
- Existing completion logic now uses Black_Egg_te

- Add White Palace options
  (Exclude, King Fragment Only, No Path of Pain, Include)
  - Excluded WP may still be required for King Fragment if Charms are
    not randomized
  - Simply don't place WP locations that are excluded
  - Distinguish between POP locations (required for POP), WP checks (
    actual item locations), WP transitions (relevant for future transition
    rando), and WP events (logically required to reach King Fragment)
  - Many transitions were listed twice.  Remove duplicates.
  - Sort transitions by scene

- For randomizable locations that have no logical significance when not
    randomized, simply skip adding them to the pool entirely for
    theoretically faster generation.

* Hollow Knight updates

  - Support random starting geo up to 1000 geo.
  - Always include locations rather than dropping unrandomized "logicless"
    ones, as it is required to best support same-slot coop.
2022-06-13 08:23:03 +02:00
.github CI: build release AppImage on ubuntu-18.04 2022-05-14 11:56:13 +02:00
WebHostLib WebHost: update Flask-Limiter 2022-06-13 08:20:17 +02:00
data OoT: big poe count option returns 2022-05-26 19:26:07 +02:00
docs Doc: deprecate datapackage_version 2022-05-30 09:52:12 +02:00
test Tests: add test to check for typo'd item name group definitions (#594) 2022-06-01 08:25:40 -07:00
worlds Hollow Knight updates (goals, WP/POP, etc.) (#438) 2022-06-13 08:23:03 +02:00
.gitignore Minecraft Version support (#458) 2022-05-10 21:00:53 -07:00
BaseClasses.py LttP: split Retro into Retro Bows and Retro Caves (#588) 2022-06-01 08:29:21 -07:00
ChecksFinderClient.py Fixed checksfinder client failing when getting an item before sending one, and fixed checksfinder client not appearing in the installer (#383) 2022-04-01 07:55:06 +02:00
CommonClient.py SC2: send ItemLink messages to ingame as well 2022-06-09 00:20:36 +02:00
FF1Client.py Clients: now featuring tooltips and some general cleanup (#564) 2022-05-23 15:20:02 -07:00
FactorioClient.py Clients: UX improvements (#615) 2022-06-07 00:15:08 +02:00
Fill.py Fill: fix type-crash on unfilled having either str or Location 2022-05-18 22:40:40 +02:00
Generate.py Generate: sort input files, preventing arbitrary order from OS layer. 2022-06-08 00:36:13 +02:00
LICENSE update Copyright 2022-02-17 19:03:11 -08:00
Launcher.py Ui: add open_filename helper 2022-06-04 21:12:45 +02:00
LttPAdjuster.py LttP: fix adjuster partial settings store crash 2022-05-22 15:07:12 -07:00
Main.py LttP: split Retro into Retro Bows and Retro Caves (#588) 2022-06-01 08:29:21 -07:00
MinecraftClient.py Core: move is_linux, _macos, _windows to Utils.py 2022-06-04 21:12:45 +02:00
ModuleUpdate.py Test: introduce test for every game has a tutorial (#478) 2022-05-03 22:14:03 +02:00
MultiServer.py WebHost: some updates (#603) 2022-06-08 00:35:35 +02:00
NetUtils.py Clients: now featuring tooltips and some general cleanup (#564) 2022-05-23 15:20:02 -07:00
OoTAdjuster.py Options: change displayname to display_name 2022-02-02 16:29:29 +01:00
OoTClient.py OoT Client: deathlink toggle 2022-05-26 19:26:07 +02:00
Options.py Options: introduce SpecialRange (#630) 2022-06-12 17:33:14 -04:00
Patch.py ModuleUpdate: add it to a few more common entry points 2022-04-07 15:21:47 +02:00
README.md Starcraft 2 Wings of Liberty AP Implementation (#528) 2022-05-18 23:27:38 +02:00
SNIClient.py SNIClient: prevent hang on exit if waiting on devices from SNI 2022-06-13 08:18:52 +02:00
Starcraft2Client.py SC2: send ItemLink messages to ingame as well 2022-06-09 00:20:36 +02:00
Utils.py Clients: some improvements (#602) 2022-06-08 00:34:45 +02:00
WebHost.py Tutorials: hide ArchipIDLE (#622) 2022-06-10 19:49:12 -04:00
host.yaml config: Use valid default enemizer_path on Linux (and Windows) 2022-06-02 02:15:05 +02:00
inno_setup.iss Setup: "ParseVersion" gives Deprecated Warning, fixing the warning. 2022-05-26 20:17:44 -07:00
kvui.py Clients: UX improvements (#615) 2022-06-07 00:15:08 +02:00
meta.yaml Generate: return of the meta mystery 2021-11-21 18:09:06 +01:00
playerSettings.yaml variable-progression-balancing (#356) 2022-05-11 09:13:21 +02:00
pytest.ini use pytest for github unittests 2020-04-29 18:44:03 +02:00
requirements.txt Fuzzy: replace thefuzz with jellyfish 2022-05-10 19:09:07 -07:00
setup.py Appimage: include libssl (#613) 2022-06-05 22:52:16 +02:00

README.md

Archipelago Discord Shield | Install

Archipelago provides a generic framework for developing multiworld capability for game randomizers. In all cases, presently, Archipelago is also the randomizer itself.

Currently, the following games are supported:

  • The Legend of Zelda: A Link to the Past
  • Factorio
  • Minecraft
  • Subnautica
  • Slay the Spire
  • Risk of Rain 2
  • The Legend of Zelda: Ocarina of Time
  • Timespinner
  • Super Metroid
  • Secret of Evermore
  • Final Fantasy
  • Rogue Legacy
  • VVVVVV
  • Raft
  • Super Mario 64
  • Meritous
  • Super Metroid/Link to the Past combo randomizer (SMZ3)
  • ChecksFinder
  • ArchipIDLE
  • Hollow Knight
  • The Witness
  • Sonic Adventure 2: Battle
  • Starcraft 2: Wings of Liberty

For setup and instructions check out our tutorials page. Downloads can be found at Releases, including compiled windows binaries.

History

Archipelago is built upon a strong legacy of brilliant hobbyists. We want to honor that legacy by showing it here. The repositories which Archipelago is built upon, inspired by, or otherwise owes its gratitude to are:

We recognize that there is a strong community of incredibly smart people that have come before us and helped pave the path. Just because one person's name may be in a repository title does not mean that only one person made that project happen. We can't hope to perfectly cover every single contribution that lead up to Archipelago but we hope to honor them fairly.

Path to the Archipelago

Archipelago was directly forked from bonta0's multiworld_31 branch of ALttPEntranceRandomizer (this project has a long legacy of its own, please check it out linked above) on January 12, 2020. The repository was then named to MultiWorld-Utilities to better encompass its intended function. As Archipelago matured, then known as "Berserker's MultiWorld" by some, we found it necessary to transform our repository into a root level repository (as opposed to a 'forked repo') and change the name (which came later) to better reflect our project.

Running Archipelago

For most people all you need to do is head over to the releases page then download and run the appropriate installer. The installers function on Windows only.

If you are running Archipelago from a non-Windows system then the likely scenario is that you are comfortable running source code directly. Please see our wiki page on running Archipelago from source.

This project makes use of multiple other projects. We wouldn't be here without these other repositories and the contributions of their developers, past and present.

Contributing

Contributions are welcome. We have a few asks of any new contributors.

  • Ensure that all changes which affect logic are covered by unit tests.
  • Do not introduce any unit test failures/regressions.

Otherwise, we tend to judge code on a case to case basis. It is a generally good idea to stick to PEP-8 guidelines to ensure consistency with existing code. (And to make the linter happy.)

For adding a new game to Archipelago please see the docs folder for the relevant information and feel free to ask any questions in the #archipelago-dev channel in our discord.

Code of Conduct

We conduct ourselves openly and inclusively here. Please do not contribute to an environment which makes other people uncomfortable. This means that we expect all contributors or participants here to:

  • Be welcoming and inclusive in tone and language.
  • Be respectful of others and their abilities.
  • Show empathy when speaking with others.
  • Be gracious and accept feedback and constructive criticism.

These guidelines apply to all channels of communication within this GitHub repository. Please be respectful in both public channels, such as issues, and private, such as private messaging or emails.

Any incidents of abuse may be reported directly to Ijwu at hmfarran@gmail.com.