View source for Fabric Archipelago Mod

{{Infobox mod
|title=Fabric Archipelago Mod
|author=Deadlydiamond98
|latest_release=1.0.2-alpha (1.20.1) (2026-01-21)
|initial_release=1.0.0-alpha (1.20.1) (2026-01-17)
|sources=[https://github.com/Deadlydiamond98/MinecraftFabricAPWorld Mod Source]

[https://github.com/Deadlydiamond98/MinecraftFabricAPWorld AP World Source]
|discord=https://discord.com/invite/yArvXz9tSq
|modrinth=https://modrinth.com/mod/archipelago-mod
|minecraft_version=1.20.1
|modloader={{Fabric}}
|image=Archipelago Icon.png}}

{{Message box|title=⚠️ Warning ⚠️|text=Right now '''Fabric Archipelago''' is still in a very early stage, so do keep in mind that it could generate a Randomized Game that is unbeatable!}}

'''Fabric Archipelago''' is a mod that allows users to connect their Minecraft Game to [https://archipelago.gg/ Archipelago] in order to play Randomizes with multiple games, and/or multiple people!

The mod is inspired by the [https://github.com/jacobmix/Minecraft_AP_Randomizer Minecraft_AP_Randomizer], however was rewritten from scratch for [https://fabricmc.net/ Fabric] instead of [https://forums.minecraftforge.net/ Forge]. It includes many of the features from the original mod, but also includes additional features such as easier setup, and the ability to play in Single Player.

== What is Archipelago? ==

"Archipelago is a cross-game modification system which randomizes different games, then uses the result to build a single unified multi-player game. Items from one game may be present in another, and you will need your fellow players to find items you need in their games to help you complete your own."<ref>https://www.igdb.com/games/archipelago--6</ref>
[[File:Archipelago ArchipelagoWebsiteScreenshot.png|none|thumb|Screenshot of Official [https://archipelago.gg/ Archipelago] Website]]
For more information on how Archipelago works, or things that it does (information that is useful to know when using this mod), you can check out Archipelago's official [https://archipelago.gg/faq/en/#frequently-asked-questions FAQ].

== How does the Randomizer affect Minecraft ==
In order to randomize Minecraft, this mod locks various abilities and recipes behind Archipelago Items, with the completion of locations being the only way to get them back. There are options that the player can check that enable/disable Archipelago Items in order to change the difficulty of the game.

=== Locations ===
Currently the mod only adds one type of location, being [[minecraft:advancement|advancements]]. Every time the player unlocks an advancement, an item will be sent out to Archipelago. Some additional advancements are also added to the game to add more for the player to do to get checks, all of which are pulled directly from [[minecraft:Achievement/Java Edition|old advancements]] and [[minecraft:Achievement|Bedrock achievements]].

Modded Advancements aren't currently supported, but are planned to be added in the near future.

=== Items ===
There are multiple things that are added by the mod as Archipelago Items. Some items unlock things needed for progression, while others just give the player things that may or may not be helpful. 

The list of items includes:

*'''[[minecraft:Crafting|Recipes]]''' - Recipes for various items required for progression, such as tools and weapons.
*'''Abilities''' - Abilities that the player normally has, such as Jumping, Sprinting, and Swimming
*'''[[minecraft:Experience|Experience]]''' - Grants the player an amount of levels or experience points
*'''[[minecraft:Item|Items]]''' - Grants the player a random amount of an Item, such as [[minecraft:Planks|planks]] or [[minecraft:Ore|ore]].
*'''Traps''' - Unwanted items that can optionally be added to the game. They do things such as reversing controls, enabling ice physics, or spawning lit [[minecraft:TNT|TNT]].


The Randomizer currently adds Archipelago Items for Vanilla Minecraft, but Modded Archipelago Items are planned for the near future.

== How Do I Setup This Mod? ==
[[File:Archipelago CreateWorldScreenshot.png|thumb|600x600px|Screenshot of the Create World Screen, with the new fields used for Connecting to an Archipelago Server]]
There are a few steps that players need to do in order to get this mod working properly:

# Follow the [https://archipelago.gg/tutorial/Archipelago/setup_en Archipelago Setup Guide] to install the launcher needed to generate the files for the Randomizer
# Download the latest [https://github.com/Deadlydiamond98/MinecraftFabricAPWorld/releases AP World] for this mod
# Place the <code>minecraft_fabric.apworld</code> into the worlds folder in the Archipelago Application
# Open the Archipelago Application, and use the Options Creator to generate your YAML config
# Using your YAML (and the YAMLs of other people's games), create a server for playing by following this [https://archipelago.gg/tutorial/Archipelago/setup_en#generating-a-game Guide]

The Next Instructions will differ Slightly depending on whether you want to play the Minecraft Randomizer in a Single Player world, or a Multiplayer world.

=== Single Player ===

# Install [https://prismlauncher.org/ Prism Launcher] (or your preferred MC launcher if you haven't already)
# Create a new instance of '''1.20.1''' running the latest version of Fabric ''('''0.18.4''' at the time of writing this)''
# Install the '''Archipelago Mod''', along with its dependencies [https://modrinth.com/mod/koala_lib Koala Lib] and [https://modrinth.com/mod/fabric-api Fabric API]
# Boot up Minecraft and Create a new world, filling in Archipelago server address, port, and password (if needed)
Whenever the Single Player world created via this method is opened, it will automatically rejoin the server it was connected to.

In the event that an incorrect AP Server, Slot Name, or Password is entered, or your single player game fails to connect to an Archipelago Server, you can either generate a new world, or you can follow the instructions for Multiplayer.

=== Multiplayer ===
The instructions for playing on a Server are the same as normal Minecraft up until you join the server. Once you're in the world, you can run the command <code>/connect</code> or <code>/archipelago connect</code>, and fill in the necessary information.
[[File:Archipelago ConnectCommand.png|none|thumb|494x494px|Screenshot of the /connect command]]
If the world was generated in Single Player and the Archipelago Server information supplied is valid, the Server should connect automatically when the world starts.

Whenever the server starts, it will also automatically reconnect to the Archipelago Server the same way as a Single Player World.

== Gallery ==
<gallery widths="300" heights="300">
File:Archipelago GameplayScreenshot.png|In Game Screenshot of a Game being Played
File:Archipelago GameTrackerScreenshot.png|Screenshot of the Item Tracker
</gallery>

== References ==

[[Category:Mods|Fabric Archipelago Mod]]