No description
  • Python 95%
  • Assembly 1.7%
  • HTML 1.5%
  • Lua 0.7%
  • CSS 0.6%
  • Other 0.2%
Find a file
lepideble 9b64e83287
Some checks failed
Analyze modified files / flake8 (push) Has been cancelled
Analyze modified files / mypy (push) Has been cancelled
CodeQL / Analyze (push) Has been cancelled
CodeQL / Analyze-1 (push) Has been cancelled
CodeQL / Analyze-2 (push) Has been cancelled
Build and Publish Docker Images / prepare (push) Has been cancelled
type check / pyright (push) Has been cancelled
unittests / Test Python 3.13 macos-latest (push) Has been cancelled
unittests / Test Python 3.11.2 ubuntu-latest (push) Has been cancelled
unittests / Test Python 3.12 ubuntu-latest (push) Has been cancelled
unittests / Test Python 3.13 ubuntu-latest (push) Has been cancelled
unittests / Test Python 3.11 windows-latest (push) Has been cancelled
unittests / Test Python 3.13 windows-latest (push) Has been cancelled
unittests / Test hosting with 3.13 on ubuntu-latest (push) Has been cancelled
Build and Publish Docker Images / build (amd64, amd64, ubuntu-latest, amd64) (push) Has been cancelled
Build and Publish Docker Images / build (arm64, arm64, ubuntu-24.04-arm, arm64) (push) Has been cancelled
Build and Publish Docker Images / manifest (push) Has been cancelled
Factorio: Fix read path on linux (#6483)
On linux __PATH__system-read-data__ always point /usr/share/factorio
when using the version downloaded from the website. This replace it with
__PATH__executable__/../../data/ which works for both standalone
installs and the steam version.
2026-10-05 13:36:27 +02:00
.github CI: update softprops/action-gh-release to v3.0.0 (#6162) 2026-04-26 00:44:48 +02:00
.run Core: Allow running unit tests scoped to specific worlds (#6290) 2026-07-17 20:01:28 +02:00
apmw MultiServer, customserver: move data package handling, optimize RAM usage (#5981) 2026-09-24 23:33:30 +02:00
data Core: Add common rom extensions to global.apignore (#6207) 2026-09-29 16:04:13 +02:00
deploy Fix missing } in example_nginx.conf (#6027) 2026-03-10 10:38:02 +00:00
docs Docs: Fix typo in "adding games" doc (#6466) 2026-09-29 22:44:48 +02:00
rule_builder Rule Builder : Made AtLeast a dataclass (#6421) 2026-09-22 15:33:55 +02:00
test Options: add function to validate custom text in TextChoice during from_text (#6205) 2026-09-28 01:28:55 +02:00
typings Fix, OptionsCreator: export options on Linux (#5774) 2026-02-01 22:23:14 +01:00
WebHostLib MultiServer, customserver: move data package handling, optimize RAM usage (#5981) 2026-09-24 23:33:30 +02:00
worlds Factorio: Fix read path on linux (#6483) 2026-10-05 13:36:27 +02:00
.coveragerc Tests: create sane cov defaults (#2728) 2024-01-16 17:10:19 +01:00
.dockerignore Jak1: use Utils.user_path for consistant user data (#6150) 2026-09-28 01:24:28 +02:00
.gitattributes Yacht Dice: Mark YachtWeights.py as "linguist-generated" (#3898) 2024-11-29 20:45:10 +01:00
.gitignore Core: Add common rom extensions to global.apignore (#6207) 2026-09-29 16:04:13 +02:00
_speedups.pyx Core: limit depth of received JSON to 16 (#6378) 2026-08-10 11:03:01 +02:00
_speedups.pyxbld Core: fix exceptions coming from LocationStore (#4358) 2024-12-10 20:09:36 +01:00
AdventureClient.py Various: Make clients wait a second between connects (#5061) 2025-08-01 14:01:18 -04:00
AHITClient.py AHiT: Fix Client Argument Handling (#4992) 2025-05-14 07:18:36 -04:00
BaseClasses.py Core: remove per_slot_randoms and DeprecateDict (#6186) 2026-08-03 17:16:25 +02:00
BizHawkClient.py BizHawkClient: Avoid error launching BizHawkClient via Launcher CLI (#3554) 2024-09-18 20:42:22 +02:00
ChecksFinderClient.py ChecksFinder: Linux support via wine (#795) 2022-07-19 07:44:04 +02:00
ci-requirements.txt CI: update pytest to 9.0.1 (#5637) 2025-11-14 08:26:34 +00:00
CommonClient.py Docs: Update docs and typing for items_handling to not allow None (#6257) 2026-09-28 01:37:08 +02:00
conftest.py Core: Allow running unit tests scoped to specific worlds (#6290) 2026-07-17 20:01:28 +02:00
Dockerfile A Link to the Past: We Have Enemizer at Home (#6153) 2026-05-09 17:07:46 +02:00
entrance_rando.py Core: Make Generic ER only consider the current world in isolation (#4680) 2026-03-10 20:08:20 +01:00
Fill.py Fill: make non prog start inventory panic actually use the new filler items (#6246) 2026-09-28 01:35:03 +02:00
Generate.py Core: Adjust YAML error message to clarify the name is not the cause of the error (#6267) 2026-07-17 20:03:52 +02:00
inno_setup.iss Gauntlet Legends: Implement New Game (#3499) 2026-07-11 19:26:27 +02:00
intset.h Speedups: remove dependency on c++ (#2796) 2024-06-12 18:54:59 +02:00
kvui.py CommonClient: Match ServerLabel's team to other UIs (#5875) 2026-08-16 09:38:37 +02:00
Launcher.py Launcher: Fix failed world display (#6468) 2026-09-29 22:46:10 +02:00
LICENSE Core: it's 2025 (#4417) 2025-01-01 02:02:18 +01:00
LttPAdjuster.py LttP: remove sprite download from setup flow & make sprite repo dynamic (#4830) 2025-08-02 01:26:50 +02:00
Main.py Core: Pre Output Steps Log (#6047) 2026-07-17 20:07:07 +02:00
meta.yaml meta.yaml: update progression balancing (#1283) 2022-12-05 22:26:44 +01:00
MMBN3Client.py MMBN3: Handle timeouts on dual stack networks by catching OSError (#6301) 2026-09-12 10:20:40 +02:00
ModuleUpdate.py ModuleUpdate: Add core requirements.txt as a constraint file to pip calls (#6309) 2026-07-11 18:27:58 +02:00
MultiServer.py MultiServer, customserver: move data package handling, optimize RAM usage (#5981) 2026-09-24 23:33:30 +02:00
mypy.ini Fix, OptionsCreator: export options on Linux (#5774) 2026-02-01 22:23:14 +01:00
NetUtils.py Core: limit depth of received JSON to 16 (#6378) 2026-08-10 11:03:01 +02:00
OoTAdjuster.py OoT Adjuster: Remove per_slot_randoms (#4264) 2025-01-19 18:17:31 -05:00
OoTClient.py Various: Make clients wait a second between connects (#5061) 2025-08-01 14:01:18 -04:00
Options.py Options: add function to validate custom text in TextChoice during from_text (#6205) 2026-09-28 01:28:55 +02:00
OptionsCreator.py Options Creator: bind free text set_value to text instead of on_text_validate (#5915) 2026-03-30 17:25:25 +02:00
Patch.py Core: add layer for patches that don't use Patch.py (#2889) 2024-03-14 22:29:29 +01:00
pytest.ini Core: Allow running unit tests scoped to specific worlds (#6290) 2026-07-17 20:01:28 +02:00
README.md Gauntlet Legends: Implement New Game (#3499) 2026-07-11 19:26:27 +02:00
requirements.txt Core: update platformdirs (#6328) 2026-07-30 15:18:21 +02:00
ruff.toml Core: Add a ruff.toml to the root directory (#5259) 2025-10-25 00:19:42 +02:00
settings.py Settings: validate FilePath hash on use (#5854) 2026-05-17 23:40:08 +02:00
setup.py Setup: bump cx-Freeze to fix frozen linux shortcuts (#6365) 2026-08-05 00:18:52 +02:00
setup_constraints.txt Setup: bump cx-Freeze to fix frozen linux shortcuts (#6365) 2026-08-05 00:18:52 +02:00
SNIClient.py SNI Client: fix that it isnt using host.yaml settings (#5533) 2025-10-11 11:16:47 +02:00
UndertaleClient.py Undertale: Handle zero arg /auto_patch (#5130) 2026-04-29 22:29:41 +02:00
Utils.py Core: Bump version from 0.6.8 to 0.6.9 (#6491) 2026-10-05 13:16:13 +02:00
WebHost.py WebHost: Fix hosting with invalid worlds installed (#5648) 2026-04-04 07:52:27 +02:00
Zelda1Client.py TLOZ: Add space in concatenated string #5690 2025-11-29 18:47:17 +01:00
ZillionClient.py Zillion: move client to worlds/zillion (#2649) 2024-01-01 13:42:41 -06:00

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
  • Subnautica
  • Risk of Rain 2
  • The Legend of Zelda: Ocarina of Time
  • Timespinner
  • Super Metroid
  • Secret of Evermore
  • Final Fantasy
  • VVVVVV
  • Raft
  • Super Mario 64
  • Meritous
  • Super Metroid/Link to the Past combo randomizer (SMZ3)
  • ChecksFinder
  • Hollow Knight
  • The Witness
  • Sonic Adventure 2: Battle
  • Starcraft 2
  • Dark Souls 3
  • Super Mario World
  • Pokémon Red and Blue
  • Hylics 2
  • Overcooked! 2
  • Zillion
  • Lufia II Ancient Cave
  • Blasphemous
  • Wargroove
  • Stardew Valley
  • The Legend of Zelda
  • The Messenger
  • Kingdom Hearts 2
  • The Legend of Zelda: Link's Awakening DX
  • Adventure
  • DLC Quest
  • Noita
  • Undertale
  • Bumper Stickers
  • Mega Man Battle Network 3: Blue Version
  • Muse Dash
  • DOOM 1993
  • Terraria
  • Lingo
  • Pokémon Emerald
  • DOOM II
  • Shivers
  • Heretic
  • Landstalker: The Treasures of King Nole
  • Final Fantasy Mystic Quest
  • TUNIC
  • Kirby's Dream Land 3
  • Celeste 64
  • Castlevania 64
  • A Short Hike
  • Yoshi's Island
  • Mario & Luigi: Superstar Saga
  • Bomb Rush Cyberfunk
  • Aquaria
  • Yu-Gi-Oh! Ultimate Masters: World Championship Tournament 2006
  • A Hat in Time
  • Old School Runescape
  • Kingdom Hearts 1
  • Mega Man 2
  • Yacht Dice
  • Faxanadu
  • Saving Princess
  • Castlevania: Circle of the Moon
  • Inscryption
  • Civilization VI
  • The Legend of Zelda: The Wind Waker
  • Jak and Daxter: The Precursor Legacy
  • Super Mario Land 2: 6 Golden Coins
  • shapez
  • Paint
  • Celeste (Open World)
  • Choo-Choo Charles
  • APQuest
  • Satisfactory
  • EarthBound
  • Mega Man 3
  • Gauntlet Legends

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, or AppImage for Linux-based systems.

If you are a developer or are running on a platform with no compiled releases available, please see our doc 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

To contribute to Archipelago, including the WebHost, core program, or by adding a new game, see our Contributing guidelines.

FAQ

For Frequently asked questions, please see the website's FAQ Page.

Code of Conduct

Please refer to our code of conduct.