Cuphead

Cuphead

Developers
	Studio MDHR
Engines
Former	Unity 5
	Unity 2017
Release dates
Windows	September 29, 2017
macOS (OS X)	October 19, 2018

Key points

Chromatic aberration cannot be fully disabled in-game. See Chromatic aberration for a workaround.

General information

Official website

GOG.com Community Discussions

GOG.com Support Page

Steam Community Discussions

Availability

Source	DRM	Notes	Keys	OS
Amazon.com
GOG.com
Humble Store
Microsoft Store		Xbox Play Anywhere
Steam		Game does not require Steam to run.

Steam DRM check is only on first launch, the game can be run in DRM-free mode afterwards by launching it from the Cuphead.exe executable.

DLC and expansion packs

Name	Notes
The Delicious Last Course

Game data

Configuration file(s) location

System	Location
Windows	HKEY_CURRENT_USER\Software\Studio MDHR\Cuphead\
Microsoft Store
macOS (OS X)
Steam Play (Linux)	<Steam-folder>/steamapps/compatdata/268910/pfx/

Save game data location

System	Location
Windows	%APPDATA%\Cuphead\
Microsoft Store
macOS (OS X)
Steam Play (Linux)	<Steam-folder>/steamapps/compatdata/268910/pfx/

Save game cloud syncing

System	Native	Notes
GOG Galaxy
Steam Cloud
Xbox Cloud

Video settings

In-game video settings

Ultra-widescreen

Enable ultra-widescreen support
Go to <path-to-game>\Cuphead_Data\Managed\. Open Assembly-CSharp.dll with a hex editor such as HxD. Find and replace every instance of 39 8E E3 3F with 60 E5 18 40. Notes Assets render in 16:9 aspect ratio so you'll get black bars on boss stages and tutorial.

Borderless fullscreen windowed

Enable borderless fullscreen
Use the -screen-fullscreen 0 -popupwindow command line arguments.

Exclusive fullscreen

Enable exclusive fullscreen
Use the -screen-fullscreen 1 -window-mode exclusive command line arguments.

Remove blur filter

Disable with 3D Vision Fix
Download Cuphead 3D Vision Fix. Extract the fix to the installation folder. Open d3dx.ini. Change x3=0 to x3=1 under the [Constants] section.

Chromatic aberration

The color bleed option in the menu only increases/decreases chromatic aberration, but does not fully disable it.

Disable with 3D Vision Fix
Download Cuphead 3D Vision Fix. Extract the fix to the installation folder. Open d3dx.ini. Change z3=0 to z3=1 under the [Constants] section.

Film grain

Disable with 3D Vision Fix
Download Cuphead 3D Vision Fix. Extract the fix to the installation folder. Open d3dx.ini. Change y3=0 to y3=1 under the [Constants] section.

Input settings

In-game control settings

Haptic feedback

Disable vibration via 3rd party mod
Install Special K by following the Unofficial Special K Guide. Start the game and press Ctrl+⇧ Shift+← Backspace to open Special K's control panel. Expand the Direct3D 11 Settings → Texture Management section. Turn on Ignore Textures Without Mipmaps. Expand the Input Management → Gamepad section. Turn on Disable ALL Rumble to turn off vibration. Restart the game to apply changes.

Audio settings

In-game audio settings

Localizations

Language	UI	Audio	Sub	Notes
English
Simplified Chinese
French
German
Italian
Japanese
Korean
Polish
Brazilian Portuguese
Russian
Spanish
Latin American Spanish

Mute on focus lost

Set mute in background
Install Special K by following the Unofficial Special K Guide. Start the game and press Ctrl+⇧ Shift+← Backspace to open Special K's control panel. Expand the Direct3D 11 Settings → Texture Management section. Turn on Ignore Textures Without Mipmaps. Expand the Window Management → Input/Output Behavior section. Turn on Mute Game under Background Behavior. Restart the game to apply changes.

Network

Multiplayer types

Type	Native	Players	Notes
Local play		2	Co-op
LAN play
Online play

VR support

3D modes	State	Notes
Nvidia 3D Vision		See Helix Mod: Cuphead.

Other information

API

Technical specs	Supported	Notes
Direct3D	9, 11	DX9 is only supported in the "legacy- 1.1.5 DX9" build, available from the "Betas" tab in the Steam client. It will not receive further updates/DLC.

Executable	32-bit	64-bit	Notes
Windows
macOS (OS X)

Disable flashing effect from text

Removes the flashing effect from the Run 'n Gun and Wallop text.

Disable with 3D Vision Fix

Download Cuphead 3D Vision Fix. Extract the fix to the installation folder. Open d3dx.ini. Go to line 1062 and remove all semicolons from this block of text: ;[TextureOverrideFlash_1] ;Hash = f735b9a3 ;ps-t0 = ResourceReplaceTexture1 ;[TextureOverrideFlash_2] ;Hash = a27c9df9 ;ps-t0 = ResourceReplaceTexture2 ;[TextureOverrideFlash_3] ;Hash = 42cd867e ;ps-t0 = ResourceReplaceTexture3 ;[TextureOverrideFlash_4] ;Hash = cacd7bdb ;ps-t0 = ResourceReplaceTexture4 ;[TextureOverrideFlash_5] ;Hash = 423cf558 ;ps-t0 = ResourceReplaceTexture5

Unlock visual and audio filters

Filters such as the black-and-white and vintage modes can be unlocked manually.

Unlock optional filters manually
Go to the save game data location. Locate the file for your save slot and open it with a text editor. Edit the following parameters from false to true to unlock them. "unlockedBlackAndWhite":false, "unlocked2Strip":false, "vintageAudioEnabled":false, "pianoAudioEnabled":false, Load your in-game save slot and enable the new modes in the options menu.

Unlock expert difficulty at start

Expert difficulty can be unlocked from the start without completing the game first.

Unlock expert difficulty manually
Go to the save game data location. Locate the file for your save slot and open it with a text editor. Change "_isHardModeAvailable":false, to "_isHardModeAvailable":true,.

Modifications

• Simple DebugInfo - Adds a debug GUI, HP bar for bosses, quick restart, camera zoom, and more.

• Simple Boss HP Bars - Displays an HP bar for bosses when playing the boss stages.

• Cuphead/Mugman Color Correction - Changes all the discolored glove/shoes for Cuphead/Mugman to be the correct colors.

• Debug Console Enabler - Enables the game's debug console, allowing access to a wide variety of features such as viewing scenes from the game, a level select, invincibility and more.

• SmoothParry (Steam only) - Removes the time-freeze that normally happens when you parry an object or enemy. This small change makes the game feel much smoother, especially in co-op.

System requirements

Windows

macOS (OS X)

Windows
	Minimum
Operating system (OS)	7
Processor (CPU)	Intel Core 2 Duo E8400 3.0 GHz AMD Athlon 64 X2 6000+ 3.0 GHz
System memory (RAM)	3 GB
Hard disk drive (HDD)	4 GB
Video card (GPU)	Nvidia GeForce 9600 GT ATI Radeon HD 3870 512 MB of VRAM DirectX 11 compatible

macOS (OS X)
	Minimum
Operating system (OS)	10.11
Processor (CPU)	Intel Core i5
System memory (RAM)	4 GB
Hard disk drive (HDD)	4 GB
Video card (GPU)	Intel HD Graphics 4000