Cuphead.DebugMod

Cuphead.DebugMod is a BepInEx plugin for practicing Cuphead, ported from the Cuphead Speedruning discord's DebugMod and fixed some minor bugs, thanks to the original authors.

The original DebugMod is implemented by modifying Assembly-CSharp.dll, which does not work with different versions and is not easy to maintain. Porting to BepInEx avoids modifying the game files, and benefits from the built-in config manager it is easy to change hotkeys and settings via the GUI

Features

• Level Selector
• Quick Retry
• Info HUD
• Show Hitboxes
• Mute in Background
• Run in Background
• Tweak Game Speed
• Camera Zoom in/out
• etc...

How to use

1. Download the zip then unzip all files into the game folder (the folder where Cuphead.exe/Cuphead.app is located).
2. (Windows) Run Cuphead.exe start the game with plugin. Run Cuphead_Vanilla.bat start the game without plugin.
3. (macOS) Launch Terminal, run chmod +x run_bepinex.sh (only once), then run ./run_bepinex.sh start the game with plugin.
4. Press F1 show settings.
5. (Windows) If the game seemingly launches without the plugin active, try downloading this text file, place it in the same directory where Cuphead.exe is located, then try starting the game again.

Credits

• BepInEx
• BepInEx.ConfigurationManager
• BepInEx.ScriptEngine
• BepInEx.NStrip
• UnityExplorer