Cuphead

From PCGamingWiki, the wiki about fixing PC games
Cuphead
Cuphead cover
Developers
Studio MDHR
Engines
Unity 5[Note 1]
Release dates
Windows September 29, 2017
macOS (OS X) October 19, 2018[2]
Cuphead at Wikipedia

Key points

Chromatic aberration cannot be fully disabled in-game. See Chromatic aberration to fix.

General information

Official website
GOG.com Community Discussions
GOG.com Support Page
Steam Community Discussions

Availability[edit]

Source DRM Notes Keys OS
Amazon.com
Icon overlay.png
Windows
GOG.com
DRM-free
Windows
macOS (OS X)
Humble Store
Icon overlay.png
Windows
macOS (OS X)
Microsoft Store
Microsoft Store
Xbox Play Anywhere
Windows
Steam
Icon overlay.png
Windows
macOS (OS X)
Twitch Twitch Desktop App
Windows

Downloadable content (DLC) and expansions

Name Notes
The Delicious Last Course
Windows

Essential improvements[edit]

Remove blur filter[edit]

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

Game data[edit]

Configuration file(s) location[edit]

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

Save game data location[edit]

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

Save game cloud syncing[edit]

System Native Notes
GOG Galaxy
Steam Cloud

Video settings[edit]

In-game video settings
In-game video settings

Ultra-widescreen[edit]

Enable ultra-widescreen support[4]
  1. Go to <path-to-game>\Cuphead_Data\Managed\.
  2. Open Assembly-CSharp.dll with a hex editor such as HxD.
  3. Change every instance of 39 8E E3 3F to 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[edit]

Enable borderless fullscreen[3]

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

Exclusive fullscreen[edit]

Enable exclusive fullscreen[3]

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

Chromatic aberration[edit]

The color bleed option in the menu only increases/decreases chromatic aberration, but does not fully disable it.
Disable with 3D Vision Fix[3]
  1. Download Cuphead 3D Vision Fix.
  2. Extract the fix to the installation folder.
  3. Open d3dx.ini.
  4. Change z3=0 to z3=1 under the [Constants] section.

Film grain[edit]

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

Input settings[edit]

In-game control settings
In-game control settings
Keyboard and mouse Native Notes
Remapping
Mouse acceleration
Mouse sensitivity
Mouse input in menus
Mouse is not supported at all.
Mouse Y-axis inversion
Controller
Controller support
Full controller support
Controller remapping
Controller sensitivity
Controller Y-axis inversion
Enable the 🔄 symbol.
Additional information
Button prompts
This game does support the DualShock 4 controller natively, however, the button prompts are spelled out instead of using proper button prompts (X button is Cross, for example)
Controller hotplugging
Controller has to be assigned in the control settings, otherwise co-op mode is enabled.
Haptic feedback
Always enabled. See Haptic feedback.
Simultaneous controller+KB/M
Controller has to be assigned in the control settings, otherwise co-op mode is enabled.

Haptic feedback[edit]

Disable vibration via 3rd party mod[3]
  1. Install Special K by following the Unofficial Special K Guide.
  2. Start the game and press Ctrl+ Shift+← Backspace to open Special K's control panel.
  3. Expand the Direct3D 11 SettingsTexture Management section.
  4. Turn on Ignore Textures Without Mipmaps.
  5. Expand the Input ManagementGamepad section.
  6. Turn on Disable ALL Rumble to turn off vibration.
  7. Restart the game to apply changes.

Audio settings[edit]

In-game audio settings
In-game audio settings
Audio options Native Notes
Separate volume controls
Master, effects, and music.
Surround sound
Subtitles
Closed captions
Mute on focus lost
See Mute on focus lost.

Localizations

Language UI Audio Sub Notes
English
Traditional Chinese
French
German
Italian
Japanese
Korean
Brazilian Portuguese
Spanish
Russian
Fan translation, available here.

Mute on focus lost[edit]

Set mute in background[3]
  1. Install Special K by following the Unofficial Special K Guide.
  2. Start the game and press Ctrl+ Shift+← Backspace to open Special K's control panel.
  3. Expand the Direct3D 11 SettingsTexture Management section.
  4. Turn on Ignore Textures Without Mipmaps.
  5. Expand the Window ManagementInput/Output Behavior section.
  6. Turn on Mute Game under Background Behavior.
  7. Restart the game to apply changes.

Network[edit]

Multiplayer types

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

VR support[edit]

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

Other information[edit]

API[edit]

Technical specs Supported Notes
Direct3D 9, 11 Use -force-d3d9 parameter for Direct3D 9.
64-bit executable

Disable flashing effect from text[edit]

Removes the flashing effect from the Run 'n Gun and Wallop text.
Disable with 3D Vision Fix[3]
  1. Download Cuphead 3D Vision Fix.
  2. Extract the fix to the installation folder.
  3. Open d3dx.ini.
  4. 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[edit]

Filters such as the black-and-white and vintage modes can be unlocked manually.
Unlock optional filters manually[3]
  1. Go to the save game data location.
  2. Locate the file for your save slot and open it with a text editor.
  3. Edit the following parameters from false to true to unlock them.
    • "unlockedBlackAndWhite":false,
    • "unlocked2Strip":false,
    • "vintageAudioEnabled":false,
    • "pianoAudioEnabled":false,
  4. Load your in-game save slot and enable the new modes in the options menu.

Unlock expert difficulty at start[edit]

Expert difficulty can be unlocked from the start without completing the game first.
Unlock expert difficulty manually[3]
  1. Go to the save game data location.
  2. Locate the file for your save slot and open it with a text editor.
  3. Change "_isHardModeAvailable":false, to "_isHardModeAvailable":true,.

Modifications[edit]

  • Simple DebugInfo - Adds a debug GUI, HP bar for bosses, quick restart, camera zoom, and more.
  • 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[edit]

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) 2 GB
Hard disk drive (HDD) 20 GB
Video card (GPU) Nvidia GeForce 9600 GT
ATI Radeon HD 3870
512 MB of VRAM
DirectX 9.0 compatible
macOS (OS X)
Minimum
Operating system (OS) 10.9
Processor (CPU) Intel Core i5
System memory (RAM) 4 GB
Hard disk drive (HDD) 20 GB
Video card (GPU) Intel HD Graphics 4000

Notes

  1. Unity engine build: 5.6.2p1[1]
  2. 2.0 2.1 File/folder structure within this directory reflects the path(s) listed for Windows and/or Steam game data (use Wine regedit to access Windows registry paths). Games with Steam Cloud support may store data in ~/.steam/steam/userdata/<user-id>/268910/ in addition to or instead of this directory. The app ID (268910) may differ in some cases. Treat backslashes as forward slashes. See the glossary page for details.

References

  1. Verified by User:Vetle on 2018-05-11
  2. Cuphead :: Cuphead Available Now on Macintosh! - last accessed on 2018-10-22
  3. 3.0 3.1 3.2 3.3 3.4 3.5 3.6 3.7 3.8 3.9 Verified by User:Keith on 2017-09-29
  4. View topic - CUPHEAD | WSGF