CupheadArchipelago
The Cuphead Archipelago Mod
About this mod Author’s original text
CupheadArchipelago
Mod Created by JKLeckr
A mod for Cuphead!
Intro
This mod is designed to work with Archipelago, but it also adds extra features to the game as well. Parts can be enabled or disabled in the config.
This mod is currently in the alpha phase which means it is still missing things. So, do not expect a dreamy vacation on Inkwell Isle while immersing yourself in the mod. Caveat Emptor!
Links
Cuphead Game: Steam
Archipelago: GitHub
APWorld: Archipelago-cuphead
Client Mod: CupheadArchipelagoMod (This project)
Installing
_For other methods of installing the mod, see the CupheadArchipelago Mod GitHub Page_
You can install it through using a supported mod manager of your choice.
Setting up Archipelago
- Launch Cuphead with CupheadArchipelago installed. It will create the config files.
- Select an empty save slot. (Note the save slot must be empty to enable or disable Archipelago on it.)
- Press the button combination shown in game to show the Archiepalago setup menu (if you are using a keyboard, it's C+Z by default). \_[Screenshot_\]
- Set it to enabled (use left/right to toggle enabled), and set all the required settings for connecting to Archipelago.
- Once you are done, close the Archipelago setup menu and start the save slot. (Note it says "AP" in the corner of the save slot if Archipelago is enabled).
- Have fun, and watch out for bugs!
Logs
If you want to see what is going on behind the scenes (useful for diagnosing problems), you should check the logs.
The logs are located in the BepInEx folder in the game directory. Logging can be configured in the config (See Configuring).
Configuring
The config files are in the game directory's BepInEx/config folder. The mod config file is called com.JKLeckr.CupheadArchipelago.cfg. It might be useful for debugging to add more verbose logging flags in the config. The game must be launched at least once for this to appear.
Logging
Logging can be configured in the config.
The BepInEx console allows you to see what's going on in real time. By default, the BepInEx console is disabled.
These are notable config files and their settings for logging:
- BepInEx.cfg
- Under [Logging.Console], set Enabled to true to see the logging console window. Useful for seeing what's going on in real time. The log file might update regularly too, but it isn't as real time.
- Under [Logging], setting UnityLogListening to true helps with logging what Cuphead itself is logging.
- com.JKLeckr.CupheadArchipelago.cfg
- Adding Network to Logging will show more verbose network action logging.
- Debug is probably too verbose to be useful for most people currently. Logging is pretty verbose, even without Debug currently while the mod is in heavy development.
Install & use Install: follow the bundled instructions
- Unzip the archive from playbuff and read the bundled readme / instructions first.
- Most mods rely on the game's mod loader — the usual route is a community mod manager (such as r2modman): pick this game, install, and it handles the loader and dependencies.
- For a manual install, put the mod files into the matching Mod / plugins folder inside the game directory.
- Launch the game to confirm it loaded; mods with listed dependencies need those installed as well.
Install locations vary a lot between mods — the bundled readme is the most reliable guide.
Install these first, or the mod will not work: