Dig apworld 0.0.10 (MC1.19.4)

Instructions:
https://github.com/jacobmix/Minecraft_AP_Randomizer/blob/master/README.md

Full Changelog:
0.0.9_dig...0.0.10_dig

What's changed: APWorld v0.0.10

• The Item Shop is now locked behind 3 Progressive Shop items. Each one unlocks a new row of 9 items. This improves multiworld balancing by spreading shop items across multiple logic spheres
• Fossil generation now automatically scales based on chunk count and total shop costs, so there are always enough fossils to buy everything regardless of settings
• When all layers are dug, a victory title and sound play on screen. After goal completion, no more Archipelago items are received
• Explosive Bow now correctly lasts 16 shots instead of 8
• Earthquake trap has been fully removed
• Fixed gravity trap spamming chat multiple times per activation
• Fake Wither now affects all online players instead of just one
• True Golden Pick no longer triggers excavation on adjacent blocks
• Fixed excavation cross pattern when mining from above
• Fossils in blocks destroyed by fire or natural leaf dacay are now auto-collected
• Increased delay between meteor spawns to reduce server load
• Fixed filler item generation crashing when called without trap weights #3

Dig apworld 0.0.9 (MC1.19.4)

Instructions:
https://github.com/jacobmix/Minecraft_AP_Randomizer/blob/master/README.md

Full Changelog:
0.0.8_dig...0.0.9_dig

What's changed: APWorld v0.0.9

• Fixed a glitch that allowed players to break bedrock.
• Fixed a glitch that caused the server to forget players after a restart, resulting in the loss of all items obtained while they were offline.
• Fossils have been introduced, discover them in game!
• Added 2 new traps.
• Reworked the progression system. It is now integrated with the shop.
• Yes, we now have a shop now! Fossils can be spent to upgrade tools or to buy items (or traps) from other players.
• Fixed a bug in the Excavation II rework.
• Added an explosive bow, along with a new advancement.

Special thanks to everyone who participated in the beta test!

Dig apworld 0.0.8 (MC1.19.4)

Instructions:
https://github.com/jacobmix/Minecraft_AP_Randomizer/blob/apworld_dig/README.md

Full Changelog:
0.0.7_dig...0.0.8_dig

What's changed: APWorld v0.0.8

Chunk Progression

• Fixed: Chat message now correctly shows the actual number of accessible chunks (e.g., "2/4 chunks")

Chunk Indicator

• Fixed: Chunk index display in action bar was showing incorrect numbers due to formula mismatch

Excavation & Mining

• Fixed: Gold pickaxe now correctly loses durability
• Fixed: Insta-mining (breaking blocks instantly) now properly counts towards "Blocks Broken" scoreboard
• Fixed: Insta-mining now correctly triggers Excavation power on surrounding blocks

Softlock Prevention

• Fixed: Players falling into empty chunk areas are now teleported to a safe position instead of respawning in a death loop

Offline Player Items

• Added: Items received while a player is offline are now queued and given when they rejoin
• Players are registered on first join and receive any pending items on subsequent logins

New Features

Auto-Connect

• Added: Server automatically attempts to connect to Archipelago using the address from archipelago.json
• Works when downloading .apmcdig from a remote Archipelago server
• Note: For locally hosted lobbies, the server address is not populated - use /connect localhost:38281 manually

Dig apworld 0.0.7 (MC1.19.4)

Testing new release workflow.

Instructions:
https://github.com/jacobmix/Minecraft_AP_Randomizer/blob/master/README.md

What's changed: APWorld v0.0.7

• Trap weights option slider (set 0 to disable)
• Temporary Haste and Excavation boost
• Added Progressive Chunks option to the Yaml (active by default)
• Fixed a few minor bugs

Jar Changelogs

• Broken blocks are now counted to the sidebar (its a bit buggy)
• Sounds when a layer is dug
• Particles when an item is received
• The spawn platform is extended and is now cleared from sand and anvils
• Block break progression is now persistent and shared, you can also mine the same block together and it will break much faster (coolest feature btw)
• The current chunk number is now displayed on the hotbar
• Automatic reconnection to the Archipelago server on server restart
• Progressive Excavation tier 2 reworked
• (I hope) Fixed scaffolding glitch
• Fixed wrong chunk number generation

MC Jar Dig 0.1

What's changed: v0.1

• Broken blocks are now counted to the sidebar (its a bit buggy)
• Sounds when a layer is dug
• Particles when an item is received
• The spawn platform is extended and is now cleared from sand and anvils
• Block break progression is now persistent and shared, you can also mine the same block together and it will break much faster (coolest feature btw)
• The current chunk number is now displayed on the hotbar
• Automatic reconnection to the Archipelago server on server restart
• Progressive Excavation tier 2 reworked
• (I hope) Fixed scaffolding glitch
• Fixed wrong chunk number generation

APWorld Dig 0.0.6

What's changed: APWorld v0.0.6

• Trap weights option slider (set 0 to disable)
• Temporary Haste and Excavation boost
• Added Progressive Chunks option to the Yaml (active by default)
• Fixed a few minor bugs

Jar Changelogs

• Broken blocks are now counted to the sidebar (its a bit buggy)
• Sounds when a layer is dug
• Particles when an item is received
• The spawn platform is extended and is now cleared from sand and anvils
• Block break progression is now persistent and shared, you can also mine the same block together and it will break much faster (coolest feature btw)
• The current chunk number is now displayed on the hotbar
• Automatic reconnection to the Archipelago server on server restart
• Progressive Excavation tier 2 reworked
• (I hope) Fixed scaffolding glitch
• Fixed wrong chunk number generation

Dig apworld 0.0.5 (MC1.19.4)

Instructions: https://github.com/jacobmix/Minecraft_AP_Randomizer/blob/master/README.md

Changelog:

• New dig apworld options by @MK-404 in #1

Full Changelog: 0.1.7_hotfix...0.0.5_dig

Main apworld 0.1.7 (MC1.20.4) + Dig apworld 0.0.4 (MC1.19.4)

Instructions: https://github.com/jacobmix/Minecraft_AP_Randomizer/blob/master/README.md

Changelog:

Now got popups for installing Java, Forge server, ect.
Specific Java popup for Mac/Linux.
Dig now more in sync with normal apworld.
Added Herobrine.

Main apworld 0.1.6 (MC1.20.4) + Dig apworld 0.0.3 (MC1.19.4)

Minecraft Apworld hotfix for AP 0.6.2+ now including Dig!

Download minecraft.apworld from from "Assets" at the bottom or click here for direct download of latest.
Also added Minecraft Dig. (Needs Minecraft 1.19.4 instead of 1.20.4) as a separate apworld. Thanks to Ashindigo for updating the mod.

• (NEW!) Added Minecraft Dig.
• (NEW!) Replaced deprecated Utils.get_options() to hopefully still work in AP 0.7.0 (final version I plan to support)
• Fixes patch files uploaded to the site.
• Works with old patch files too. (Clients need to update if host is using this)
• Added host.yaml option to auto boot Minecraft when server is ready.

minecraft_options:
  forge_directory: "Minecraft Forge server"
  max_heap_size: "2G"
  # release channel, currently "release", or "beta"
  release_channel: "release"
  # Path + arguments to auto-launch Minecraft.
  # Example: '"C:/Users/<USER>/AppData/Local/Programs/MultiMC/MultiMC.exe" -d "C:/Users/<USER/AppData/Local/Programs/MultiMC" -l "1.20.4" -s "localhost" -a "<USER>"'
  mc_launch: '"C:/Users/JacobMIX/AppData/Local/Programs/MultiMC/MultiMC.exe" -d "C:/Users/JacobMIX/AppData/Local/Programs/MultiMC" -l "1.20.4" -s "localhost" -a "jacobmix"'

• Added archipelago.json manifest (did not add proper authors).

{
  "compatible_version": 7,
  "version": 7,
  "game": "Minecraft",
  "world_version": "0.1.5",
  "minimum_ap_version": "0.5.0",
  "authors": [
    ""
  ]
}

Mod by cjmang here: https://github.com/cjmang/Minecraft_AP_Randomizer/releases/tag/0.1.3_hotfix

Instructions:

0. Would recommend installing the latest stable Archipelago version (0.6.5) with "clean libs" ticked on.
1. Install the minecraft.apworld hotfix (double click it), restart AP, and 'Generate Template Options' in the launcher.
2. Use 'Option Creator' in the launcher to create your Minecraft player yaml (or edit it manually with a text editor like Notepad++)
   • Give yaml to host or put yaml(s) in the Players folder, and press "Generate" to get a multiworld .zip in the output folder (Terminal window will close if gen successful)
   • Host by uploading to the multiworld zip to the site.
     • Only need one Minecraft yaml. Multiple players can join the same mc server/slot. Can have more Minecraft yamls/slots but they won't run on the same server.
3. Get .apmc patch file from either the room on the site/host themselves/extracted multiworld zip.
4. Launch specifically ArchipelagoLauncherDebug.exe from the Archipelago directory. (Don't worry about the command terminal yet)
   • Linux: To run "Debug" open terminal in Archipelago folder, run ./ArchipelagoLauncher (or the appimage)
5. Open the Minecraft client (from the normal Archipelago window from launching debug)
6. Client should ask for .apmc file. Point it to the one received from room/host/zip.
7. In the terminal that opened when you ran the ArchipelagoLauncherDebug.exe, there will be prompts to install Java, Forge, and the randomizer mod (if none are installed). Say yes to all.
8. Manually open Minecraft Java Edition (v1.20.4), go to Multiplayer > Direct Connection, type (literally): localhost in the server address, and join. (Or IP of player running the Forge Server with .apmc)

• if you want other players to join your slot. You need to port forward the port, and allow the forge sever through your firewall. Minecraft Forge Server port by default is 25565

9. When in-game, you will need to connect manually using /connect <IP> <PORT> <PASS> Example: /connect archipelago.gg 38281 GoodPassword

• You don't need to set pass if not used. Also do: /start

Original setup doc: https://github.com/ArchipelagoMW/Archipelago/blob/0.6.1/worlds/minecraft/docs/minecraft_en.md
How the rando works: https://github.com/ArchipelagoMW/Archipelago/blob/0.6.1/worlds/minecraft/docs/en_Minecraft.md
You can check unlocks in the advancement "received items" menu
Tracker: https://github.com/Cyb3RGER/minecraft_rando_tracker

Bonus apworlds (require ap restart):

• Update apworlds: https://github.com/silasary/Archipelago/releases?q=Manager
• Track what is in-logic: https://github.com/FarisTheAncient/Archipelago/releases?q=Tracker
  Show file extensions: https://www.howtogeek.com/205086/beginner-how-to-make-windows-show-file-extensions/

Tip: You can connect with just one string in the top of any text based client by putting your info in the top bar like this, and pressing enter:

<SLOT_NAME>:None@<IP/URL>:<PORT>
Example: CoolPlayer:CoolerPassword@archipelago.gg:38281
None just works with no pass set. But you can also leave it empty: CoolPlayer:@, either works.
Hosting locally on the same machine just use localhost for the IP. Localhost also doesn't need a port.

Firewall/port:

• Allow Forge Server through firewall
  • Open: control.exe (Searching in Windows)
  • Control Panel\All Control Panel Items\Windows Defender Firewall\Allowed apps>Change Settings (Admin)>Allow another app...>Browse...>Forge-x.jar >Add>Allow apps
• Can PortForward with this

Tip: Can use MultiMC to create a shortcut for Minecraft v1.20.4. Even set it to auto connect to localhost
You can also set .apmc file to be opened with Archipelago, and if you double click it then it'll instantly start the forge server for you.
Check host.yaml (in the Archipelago install directory) for mc_launch to auto start Minecraft after the Forge Server.

To host a multiworld without auto collect enabled, open host.yaml with a text editor like Notepad++
Change collect_mode setting from auto to disabled. Or goal to allow manual collect. Then generate a multiworld.
Other settings too. Like release mode, hint options, server password for remote admin commands, ect.
Plando players might also want host to edit plando_options to bosses, items, texts, connections

Note:

It is highly recommended to use the Archipelago installer to handle the installation of the forge server for you. Support will not be given for those wishing to manually install forge.
Will also not help with using other mods besides AP. Tho will say both client & server probably needs the same mods. Server mods usually at: C:\ProgramData\Archipelago\Minecraft Forge server\mods

Troubleshooting:

If an item didn't get sent. Check if it's location is collected on the sever end, by looking at the room tracker page.
Could have been collected from another game goaling, and collecting it's items from other games.
Else host can manually send the location with this command: /send_location <player name> <location name>
Or you type: /op <Minecraft Username> in forge server terminal. Then in-game: /advancement (grant|revoke) @a only <advancement>
Example: /advancement grant @a only aprandomizer:archipelago/get_wood
Also: https://discord.com/channels/731205301247803413/1331798503898222662

No dataPackage found that's fine. It's an expected message, and you won't get a message when one has been made.

Connect command don't work: You need to be on the server. Direct connect to localhost.

IncompatibleVersion check you're on Minecraft version 1.20.4.

Linux: IllegalArgumentException
Install Java 17 https://github.com/corretto/corretto-17/releases/latest
Add to host.yaml:

minecraft_options:
  java: "/home/<user>/.local/share/Archipelago/jdk17.0.17_10/bin/java"

missing/not found win_args, wrong/no .apmc, UnicodeDecodeError, getsockopt, Module 'world.minecraft' has no attribute or forge server crashing: Delete Minecraft Forge server and redo setup.
Update Archipelago launcher, get latest hotfix apworld from pins, restart AP, Generate Template Options, install forge server with debug, and run the proper .apmc file with Archipelago/Client.
Backup APData & Archipelago-#-X.

If you see in your forge server logs: java.io.IOException: The process cannot access the file
Something might be blocking files. If you're syncing the Archipelago folder with OneDrive disable that.
May also be you're running a forge server already. Close it. Else it could be your anti-virus:

• Windows default anti-virus: Search (Windows Key+S): "Windows Security", and open it.
  • Virus & threat protection>Protection history>Click newest top one>ADMIN prompt: Yes>See if "Affected items" is anything Archipelago/Minecraft related. If so follow this next step:
  • Virus/protection>Manage settings>Add or remove exclusions>ADMIN prompt: Yes>Add an exclusion>Folder>"Archipelago, Minecraft, and patch location directories"

Also check files aren't encrypted:

You can right click folder>properties to check if it's being encrypted. (It might say some files are ready on...

Main MC1.20.4 AP 0.1.5 hotfix

Minecraft Apworld hotfix for AP 0.6.2+ with some QoL. + Dig 0.0.2

Download minecraft.apworld from from "Assets" at the bottom or click here for direct download of latest.

• Added archipelago.json manifest (did not add proper authors).

{
  "compatible_version": 7,
  "version": 7,
  "game": "Minecraft",
  "world_version": "0.1.5",
  "minimum_ap_version": "0.5.0",
  "authors": [
    ""
  ]
}

• Added host.yaml option to auto boot Minecraft when server is ready.

minecraft_options:
  forge_directory: "Minecraft Forge server"
  max_heap_size: "2G"
  # release channel, currently "release", or "beta"
  release_channel: "release"
  # Path + arguments to auto-launch Minecraft.
  # Example: '"C:/Users/<USER>/AppData/Local/Programs/MultiMC/MultiMC.exe" -d "C:/Users/<USER/AppData/Local/Programs/MultiMC" -l "1.20.4" -s "localhost" -a "<USER>"'
  mc_launch: '"C:/Users/JacobMIX/AppData/Local/Programs/MultiMC/MultiMC.exe" -d "C:/Users/JacobMIX/AppData/Local/Programs/MultiMC" -l "1.20.4" -s "localhost" -a "jacobmix"'

• Does fix patch files uploaded to the site.
• Works with old patch files too. (Clients need to update if host is using this)

Original here: https://github.com/cjmang/Minecraft_AP_Randomizer/releases/tag/0.1.3_hotfix

Edit: Also added an early build of the new Minecraft Dig hotfix apworld. (Needs Minecraft 1.19.4 instead of 1.20.4).
Thanks to Ashindigo for updating the mod.

MinecraftAP step by step:

0. If you're on an old Archipelago install, would recommend installing the latest stable version (0.6.5) with "clean libs" ticked on.
1. Install the minecraft.apworld hotfix (double click it), restart AP, and Generate Template Options.
2. Use Option Creator in the launcher to create your Minecraft player yaml (or edit it manually with a text editor like Notepad++)

• Give yaml to host or put yaml(s) in the Players folder, and press "Generate" to get a multiworld .zip in the output folder (Terminal window will close if gen successful)
• Host by uploading to the site.
  • Only need one Minecraft yaml. Multiple players can join the same mc server/slot. Can have more Minecraft yamls/slots but they won't run on the same server.

3. Get .apmc patch file from room/host/extracted multiworld zip.
4. Launch specifically ArchipelagoLauncherDebug.exe from the Archipelago directory. (Don't worry about the command terminal yet)

• Linux: To run "Debug" open terminal in Archipelago folder, run ./ArchipelagoLauncher (or the appimage)

5. Open the Minecraft client (from the normal Archipelago window from launching debug)
6. Client should ask for .apmc file. Point it to the one received from host/room/zip.
7. In the terminal that opened when you ran the ArchipelagoLauncherDebug.exe, there will be prompts to install Java, Forge, and the randomizer hotfix (assuming none were installed). Say yes to all three.
8. Manually open Minecraft Java Edition (v1.20.4), go to Multiplayer > Direct Connection, and join localhost server address. (Or IP of player running Minecraft Forge Server with .apmc)

• if you want other players to join your slot. You need to port forward the port, and allow the forge sever through your firewall. Minecraft Forge Server port by default is 25565

9. When in-game, you will need to connect manually using /connect <IP> <PORT> <PASS> Example: /connect archipelago.gg 38281 CoolestPassword

• You don't need to set pass if not used. Also do: /start
  More info in original setup doc
  How the rando works: https://github.com/ArchipelagoMW/Archipelago/blob/d8576e72eb609cb9d779fe59f4243e3dd8afb9aa/worlds/minecraft/docs/en_Minecraft.md
  You can check unlocks in the advancement "received items" menu.
  Tracker: https://github.com/Cyb3RGER/minecraft_rando_tracker

Bonus apworlds (require ap restart):

• Update apworlds: https://github.com/silasary/Archipelago/releases?q=Manager
• Track what is in-logic: https://github.com/FarisTheAncient/Archipelago/releases?q=Tracker
  Show file extensions: https://www.howtogeek.com/205086/beginner-how-to-make-windows-show-file-extensions/

Tip: You can connect with just one string in the top of any text based client by putting your info in the top bar like this, and pressing enter:

<SLOT_NAME>:None@<IP/URL>:<PORT>
Example: CoolPlayer:CoolerPassword@archipelago.gg:38281
None just works with no pass set. But you can also leave it empty: CoolPlayer:@, either works.
Hosting locally on the same machine just use localhost for the IP. Localhost also doesn't need a port.

Firewall/port:

• Allow Forge Server through firewall
  • Open: control.exe (Searching in Windows)
  • Control Panel\All Control Panel Items\Windows Defender Firewall\Allowed apps>Change Settings (Admin)>Allow another app...>Browse...>Forge-x.jar >Add>Allow apps
• Can PortForward with this

Tip: Can use MultiMC to create a shortcut for Minecraft v1.20.4. Even set it to auto connect to localhost
You can also set .apmc file to be opened with Archipelago, and if you double click it then it'll instantly start the forge server for you.
Check host.yaml (in the Archipelago install directory) for mc_launch to auto start Minecraft after the Forge Server.

To host a multiworld without auto collect enabled, open host.yaml with a text editor like Notepad++
Change collect_mode setting from auto to disabled. Or goal to allow manual collect. Then generate a multiworld.
Other settings too. Like release mode, hint options, server password for remote admin commands, ect.
Plando players might also want host to edit plando_options to bosses, items, texts, connections

Note:

It is highly recommended to use the Archipelago installer to handle the installation of the forge server for you. Support will not be given for those wishing to manually install forge.
Will also not help with using other mods besides AP. Tho will say both client & server probably needs the same mods. Server mods usually at: C:\ProgramData\Archipelago\Minecraft Forge server\mods

Troubleshooting:

If an item didn't get sent. Check if it's location is collected on the sever end, by looking at the room tracker page.
Could have been collected from another game goaling, and collecting it's items from other games.
Else host can manually send the location with this command: /send_location <player name> <location name>
Or you type: /op <Minecraft Username> in forge server terminal. Then in-game: /advancement (grant|revoke) @a only <advancement>
Example: /advancement grant @a only aprandomizer:archipelago/get_wood
Also: https://discord.com/channels/731205301247803413/1331798503898222662

No dataPackage found that's fine. It's an expected message, and you won't get a message when one has been made.

Connect command don't work: You need to be on the server. Direct connect to localhost.

IncompatibleVersion check you're on Minecraft version 1.20.4.

Linux: IllegalArgumentException
Install Java 17 https://github.com/corretto/corretto-17/releases/latest
Add to host.yaml:

minecraft_options:
  java: "/home/<user>/.local/share/Archipelago/jdk17.0.17_10/bin/java"

missing/not found win_args, wrong/no .apmc, UnicodeDecodeError, getsockopt, Module 'world.minecraft' has no attribute or forge server crashing: Delete Minecraft Forge server and redo setup.
Update Archipelago launcher, get latest hotfix apworld from pins, restart AP, Generate Template Options, install forge server with debug, and run the proper .apmc file with Archipelago/Client.
Backup APData & Archipelago-#-X.

If you see in your forge server logs: java.io.IOException: The process cannot access the file
Something might be blocking files. If you're syncing the Archipelago folder with OneDrive disable that.
May also be you're running a forge server already. Close it. Else it could be your anti-virus:

• Windows default anti-virus: Search (Windows Key+S): "Windows Security", and open it.
  • Virus & threat protection>Protection history>Click newest top one>ADMIN prompt: Yes>See if "Affected items" is anything Archipelago/Minecraft related. If so follow this next step:
  • Virus/protection>Manage settings>Add or remove exclusions>ADMIN prompt: Yes>Add an exclusion>Folder>"Archipelago, Minecraft, and patch location directories"

Also check files aren't encrypted:

You can right click folder>properties to check if it's being encrypted. (It might say some files are ready only -, and they will be reset later anyway)
https://media.discordapp.net/attachments/1188152412498829352/1432561108165857310/explorer_2025-10-28_03-45-50_KZ8u9WH4Si.png