Skip to content

Main MC1.20.4 AP 0.1.4 hotfix

Choose a tag to compare

View all tags
@jacobmix jacobmix released this 07 Dec 02:51
· 69 commits to master since this release
0.1.4_hotfix
27c8c92
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.
  • Added archipelago.json manifest (did not add proper authors).
{
  "compatible_version": 7,
  "version": 7,
  "game": "Minecraft",
  "world_version": "0.1.4",
  "minimum_ap_version": "0.5.0"
}
  • 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 NOT fix patch files uploaded to the site.

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

MinecraftAP step by step:

  1. If you're on an old Archipelago install, would recommend installing the latest stable version (0.6.4) with "clean libs" ticked on.
  2. Install the minecraft.apworld hotfix (double click it) from here, restart AP, and Generate Template Options.
  3. Generate a multiworld after putting your player yaml(s) in the Players folder. (Recommend using option creator) Host by uploading multiworld .zip from Output to the site. (Terminal window will close if gen successful)
    • 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 (.apmc)
  4. Get.apmc patch file from room/host/extracted multiworld .zip
  5. Launch specifically ArchipelagoLauncherDebug.exe from the Archipelago directory. (Don't worry about the command terminal yet)
  6. Open the Minecraft client (from the normal Archipelago window from launching debug)
  7. Client should ask for .apmc file. Point it to the one received from host/room/zip.
  8. 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.
  9. 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
  10. When in-game, you will need to connect manually using /connect <IP> <PORT> <PASS> Example: /connect archipelago.gg 38281 CoolestPassword

Some recommended 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.
If hosting locally on the same machine you can 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
  • You can PortForward with this

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

How the Minecraft Archipelago works: https://github.com/ArchipelagoMW/Archipelago/blob/d8576e72eb609cb9d779fe59f4243e3dd8afb9aa/worlds/minecraft/docs/en_Minecraft.md

Tip: You 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.

To host a multiworld without auto collect enabled, open host.yaml (in the Archipelago install directory) 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. Seen here (more info on options in the real host.yaml):

# Allows for clients to log on and manage the server.  If this is null, no remote administration is possible.
server_password: ""
# Disallow !getitem
disable_item_cheat: false
# Client hint system
# Points given to a player for each acquired item in their world
location_check_points: 1
# Relative point cost to receive a hint via !hint for players
# so for example hint_cost: 20 would mean that for every 20% of available checks, you get the ability to hint,
# for a total of 5
hint_cost: 5
# Release modes
# A Release sends out the remaining items *from* a world that releases
release_mode: "auto"
# Collect modes
# A Collect sends the remaining items *to* a world that collects
collect_mode: "auto"
# Remaining modes
# !remaining handling, that tells a client which items remain in their pool
remaining_mode: "goal"

Plando players might also want host to edit plando_options to bosses, items, texts, connections

If you don't know how to make a player yaml just use the default with a name set. (Or use the yaml creator apworld linked above)

Troubleshooting:

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

Wrong .apmc file found Stop the server, use the correct .apmc file, delete the world folder, then relaunch the server.

IncompatibleVersion check you're on Minecraft version 1.20.4.

getsockopt or Module 'world.minecraft' has no attribute Follow setup. Update Archipelago launcher, get hotfix apworld, restart, Generate Template Options, and install forge server with debug.

If forge server is crashing or you get missing/not found win_args try deleting the Minecraft Forge server folder in the Archipelago folder.
Then redo the debug step to reinstall the forge server. (Backup APData & Archipelago-#-X saves if you wanna keep them)

If you see in your forge server logs: java.io.IOException: The process cannot access the file because another process has locked a portion of 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:

  • Always check that your anti-virus isn't deleting anything it shouldn't.
    • For 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 & threat protection>Manage settings>Add or remove exclusions>ADMIN prompt: Yes>Add an exclusion>Folder>"Archipelago, Minecraft, and patch location directories".
      Could also check if windows is encrypting the files. But i doubt that's it:
      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 3
Loading