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.

Credits

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