CupheadArchipelago randomizer mod

Playing with others

Solo or native local two-player co-op within one Cuphead game and Archipelago slot. Separate games can exchange items through the room; this mod does not add native online co-op.

Known scope and limitations

• This remains an alpha. The reviewed pair is mod alpha04a.3 with APWorld alpha03l and Archipelago 0.6.7 or newer. These mod and World version labels deliberately differ; older pre-alpha03 Worlds are incompatible.
• The versioned guide offers Gale installation and manual BepInEx 5 setup. To reproduce this review, select the exact releases linked here rather than assuming the latest manager package is identical. Start with an empty save slot, press the displayed setup controls (C+Z on keyboard), enable Archipelago and enter the room and slot.
• Windows and macOS packages are published. Linux and Steam Deck use the Windows build through Proton with the documented winhttp override. The maintainer reports these OS routes as tested; Panludia has not run them. Back up saves and verify the actual save location, especially on macOS.
• Back up both Cuphead and Archipelago save files before upgrading an existing run. Alpha04 introduces save-data migration, but review found a mismatch between selected-save and session state in that migration. Save writes are also direct overwrites; successful recovery after interruption is not guaranteed.
• Check important progress after connection loss. Completed checks are kept locally and resent on a fresh session, but ordinary automatic reconnect does not always flush that backlog. Restart and reconnect to the same room and slot before resuming if progress is missing.
• Music shuffle, traps and several advanced check options remain unfinished. The per-player DeathLink mode is not applied by this client. Their presence in options or source does not establish released support.
• Normal logic is the conservative starting point. Hard logic is incomplete; high-grade, pacifist and all-boss Chalice checks can require considerable skill or repetition. Combining level shuffle with plando can break generation.
• Enable DLC content only when you own The Delicious Last Course. Keep each local Archipelago save tied to its original room and slot; the seed check does not establish full isolation between different slots in one room.
• Connection settings include a saved room password. Keep save/config files private and redact logs before sharing them. Prefer an explicit wss:// address where the server supports it, since an address without a scheme can fall back to an unencrypted connection.