No description
  • Python 94.8%
  • Assembly 1.7%
  • HTML 1.5%
  • Lua 0.8%
  • CSS 0.6%
  • Other 0.3%
Find a file
CodeGorilla 7df243b860
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
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
Utils: Improvements to visualize_regions for debugging GER usage (#4685)
* Improvements to visualize_regions for debugging GER usage

- allow the user to pass in a dict[int, int] to visualize_regions that maps Entrance.randomization_group to a color in RGB form. This allows for better visualization of which dangling entrances should match, or which matching groups are not being correctly respected.
- do full region visualization for unreached regions, so that entrances that could connect to new regions can be visualized.
- visualize unconnected entrances on regions, in addition to connected and unconnected exits, so that available ER targets can be visualized as well

* Add detail_disconnected_regions parameter to visualize_regions

* Rename detail_disconnected_regions to detail_other_regions for consistency

* Add auto_assign_colors param to visualize_regions

* Make auto assignment of entrance colors deterministic

* Assume show_other_regions is true if detail_other_regions is true

* Remove unused random import

* whitespace adjustments

* Move overflow check to prevent potential infinite loop

It wasn't exactly likely, as the user would have had to manually define all 4096 colors and then need an additional color on top of that, but accounting for that kind of nonsense is easy enough in this case.

* positive condition

---------

Co-authored-by: CodeGorilla <3672561+Ars-Ignis@users.noreply.github.com>
2026-02-08 18:39:49 +01:00
.github Core: Add rule builder (#5048) 2026-02-08 17:00:23 +01:00
.run
data
deploy
docs Core: Add rule builder (#5048) 2026-02-08 17:00:23 +01:00
rule_builder Core: Add rule builder (#5048) 2026-02-08 17:00:23 +01:00
test Core: Add rule builder (#5048) 2026-02-08 17:00:23 +01:00
typings
WebHostLib
worlds Core: Add rule builder (#5048) 2026-02-08 17:00:23 +01:00
.coveragerc
.dockerignore
.gitattributes
.gitignore
_speedups.pyx
_speedups.pyxbld
AdventureClient.py
AHITClient.py
BaseClasses.py Core: Add rule builder (#5048) 2026-02-08 17:00:23 +01:00
BizHawkClient.py
ChecksFinderClient.py
ci-requirements.txt
CommonClient.py
Dockerfile
entrance_rando.py
Fill.py
Generate.py
inno_setup.iss
intset.h
kvui.py
Launcher.py
LICENSE
LttPAdjuster.py
Main.py
meta.yaml
MMBN3Client.py
ModuleUpdate.py
MultiServer.py
mypy.ini
NetUtils.py
OoTAdjuster.py
OoTClient.py
Options.py Core: Throw OptionError for option type Toggle in certain scenarios (#5874) 2026-02-08 18:34:12 +01:00
OptionsCreator.py
Patch.py
pytest.ini
README.md
requirements.txt
ruff.toml
settings.py
setup.py
SNIClient.py
UndertaleClient.py
Utils.py Utils: Improvements to visualize_regions for debugging GER usage (#4685) 2026-02-08 18:39:49 +01:00
WebHost.py
Zelda1Client.py
ZillionClient.py

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
  • Donkey Kong Country 3
  • 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

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.