Skip to content

Main MC1.20.4 AP 0.1.5 hotfix

Choose a tag to compare

View all tags
@jacobmix jacobmix released this 08 Dec 16:37
· 13 commits to MixCraft since this release
0.1.5_hotfix
7e91a05
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

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:

  1. If you're on an old Archipelago install, would recommend installing the latest stable version (0.6.5) with "clean libs" ticked on.
  2. Install the minecraft.apworld hotfix (double click it), restart AP, and Generate Template Options.
  3. 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.
  1. Get .apmc patch file from room/host/extracted multiworld zip.
  2. 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)
  1. Open the Minecraft client (from the normal Archipelago window from launching debug)
  2. Client should ask for .apmc file. Point it to the one received from host/room/zip.
  3. 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.
  4. 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
  1. When in-game, you will need to connect manually using /connect <IP> <PORT> <PASS> Example: /connect archipelago.gg 38281 CoolestPassword

Bonus apworlds (require ap restart):

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

Assets 4
Loading