Anonymous edits have been disabled on the wiki. If you want to contribute please login or create an account.

Cuphead

From PCGamingWiki, the wiki about fixing PC games
Cuphead
Cuphead cover
Developers
Studio MDHR
Engines
Former Unity 5[Note 1]
Unity 2017[Note 2]
Release dates
Windows September 29, 2017
macOS (OS X) October 19, 2018[3]
Reception
Metacritic 88
OpenCritic 88
IGDB 87
Taxonomy
Monetization One-time game purchase, DLC
Microtransactions None
Modes Singleplayer, Multiplayer
Pacing Real-time
Perspectives Side view, Scrolling
Controls Direct control
Genres Action, Platform, Shooter
Vehicles Flight
Art styles Cartoon
Themes Fantasy
Cuphead on HowLongToBeat
Cuphead on IGDB
Cuphead guide on StrategyWiki
Cuphead on MobyGames
Cuphead on Wikipedia

Key points

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

General information

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

Availability

Source DRM Notes Keys OS
Amazon.com
Icon overlay.png
Windows
macOS (OS X)
Green Man Gaming
Icon overlay.png
Windows
macOS (OS X)
GOG.com
DRM-free
Windows
macOS (OS X)
Humble Store
Icon overlay.png
Deluxe Edition also available.
Windows
macOS (OS X)
Microsoft Store
Microsoft Store
Xbox Play Anywhere
Windows
Steam
DRM-free after installation through Steam client (notes may include more details)
DRM-free if Steam is not installed or by creating a steam_appid.txt file containing its Steam App ID number 268910 in <path-to-game>.[4]
Deluxe Edition also available.
Windows
macOS (OS X)
Gamesplanet logo.svg (unavailable)
Icon overlay.png
Windows
macOS (OS X)

Monetization

Type Notes
DLC The DLC includes new weapons, charms, characters, bosses and quests.
One-time game purchase The game requires an upfront purchase to access.

Microtransactions

Type Notes
No microtransactions Game does not contain any microtransactions.

Monetization

DLC and expansion packs

Name Notes
The Delicious Last Course Contains a whole new island.
Windows
macOS (OS X)

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/[Note 3]

Save game data location

System Location
Windows %APPDATA%\Cuphead\
Microsoft Store %LOCALAPPDATA%\Packages\StudioMDHR.20872A364DAA1_tm1s6a95559gt\SystemAppData\wgs\
macOS (OS X)
Steam Play (Linux) <Steam-folder>/steamapps/compatdata/268910/pfx/[Note 3]

Save game cloud syncing

System Native Notes
GOG Galaxy
Steam Cloud
Xbox Cloud

Video

In-game video settings
In-game video settings

Graphics feature State Notes
Widescreen resolution
Multi-monitor
See Multi-monitor.
Ultra-widescreen
See Ultra-widescreen.
4K Ultra HD
Artwork scaled from 1280x720
Field of view (FOV)
Windowed
Borderless fullscreen windowed
On by default but minimizes with Alt+Tab . See Borderless fullscreen windowed.
Anisotropic filtering (AF)
Anti-aliasing (AA)
Unity 2D game.
The game utilizes vector images for its sprites, which are not anti-aliased by default. Certain backgrounds are 3D, however.
Vertical sync (Vsync)
Some animations behave improperly if Vsync is turned on.
60 FPS and 120+ FPS
Disabling in-game Vsync caps the frame rate at 60 FPS. Player movement is capped at 60 FPS, as are most objects in the game.
High dynamic range display (HDR)
[5]
Color blind mode
The game engine may allow for manual configuration of the game via its variables. See the Unity page for more details.

Multi-monitor

Use Cuphead 3D Vision Fix[citation needed]
  1. This requires the 32-bit version of the game. Steam users can roll back to the legacy-1.2.4 - Pre-DLC build, available from the "Betas" tab in the Steam client.
  2. Download Cuphead 3D Vision Fix.
  3. Extract the fix to the installation folder.

Ultra-widescreen

Modify a game file for ultra-widescreen support[6]
  1. Go to <path-to-game>\Cuphead_Data\Managed\.
  2. Open Assembly-CSharp.dll with a hex editor such as HxD.
  • For 21:9, find and replace every instance of 39 8E E3 3F with 60 E5 18 40
  • For 32:9, find and replace every instance of 39 8E E3 3F with 39 8E 63 40

Notes

Assets render in 16:9 aspect ratio, resulting in black bars on boss stages and tutorial.

Borderless fullscreen windowed

Enable borderless fullscreen[7]

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

Exclusive fullscreen

Enable exclusive fullscreen[7]

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

Remove blur filter

Disable with 3D Vision Fix[7]
  1. This requires the 32-bit version of the game. Steam users can roll back to the legacy-1.2.4 - Pre-DLC build, available from the "Betas" tab in the Steam client.
  2. Download Cuphead 3D Vision Fix.
  3. Extract the fix to the installation folder.
  4. Open d3dx.ini.
  5. 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[7]
  1. This requires the 32-bit version of the game. Steam users can roll back to the legacy-1.2.4 - Pre-DLC build, available from the "Betas" tab in the Steam client.
  2. Download Cuphead 3D Vision Fix.
  3. Extract the fix to the installation folder.
  4. Open d3dx.ini.
  5. Change z3=0 to z3=1 under the [Constants] section.

Film grain

Disable with 3D Vision Fix[7]
  1. This requires the 32-bit version of the game. Steam users can roll back to the legacy-1.2.4 - Pre-DLC build, available from the "Betas" tab in the Steam client.
  2. Download Cuphead 3D Vision Fix.
  3. Extract the fix to the installation folder.
  4. Open d3dx.ini.
  5. Change y3=0 to y3=1 under the [Constants] section.

Input

In-game control settings
In-game control settings

Keyboard and mouse State 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.
Controller types
XInput-compatible controllers
Xbox button prompts
Impulse Trigger vibration
PlayStation controllers
PlayStation button prompts
Light bar support
Adaptive trigger support
DualSense haptic feedback support
Connection modes

Generic/other controllers
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 (the X button is Cross, for example).
Controller hotplugging
The controller has to be assigned in the control settings; otherwise, co-op mode is enabled.
Haptic feedback
See Haptic feedback.
Digital movement supported
Simultaneous controller+KB/M
Controller has to be assigned in the control settings, otherwise co-op mode is enabled.
Steam Input
Steam Input API support
Hook input (legacy mode)
Official controller preset(s)
Steam Controller button prompts
Cursor detection

Haptic feedback

Disable vibration via 3rd party mod[7]
  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

In-game audio settings
In-game audio settings

Audio feature State Notes
Separate volume controls
Master, Effects, Music
Surround sound
Subtitles
Closed captions
Mute on focus lost
See Mute on focus lost.
Royalty free audio

Localizations

Language UI Audio Sub Notes
English
Simplified Chinese
French
German
Indonesian
Fan translation by IGTC Team (Indonesia Game Translator Community)
Italian
Japanese
Korean
Polish
Brazilian Portuguese
Russian
Spanish
Latin American Spanish
Turkish
Fan translation, download.

Mute on focus lost

Set mute in background[7]
  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

Multiplayer types

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

VR support

3D modes State Notes
Nvidia 3D Vision
Use Helix Mod: Cuphead, although this requires the 32-bit version of the game. Steam users can roll back to the legacy-1.2.4 - Pre-DLC build, available from the "Betas" tab in the Steam client.

Other information

API

Technical specs Supported Notes
Direct3D 9.0c, 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/DLCs.
Executable 32-bit 64-bit Notes
Windows
32-bit is only supported in the legacy-1.2.4 - Pre-DLC build, available from the "Betas" tab in the Steam client. It will not receive further updates/DLCs.
macOS (OS X)

Disable flashing effect from text

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

Note: As the newest Cuphead update broke this mod, roll back to a previous version of Cuphead before installing it in order for it to work. On Steam, go to Properties, Betas, and use the drop down menu to select a previous version.

Disable with 3D Vision Fix[7]
  1. This requires the 32-bit version of the game. Steam users can roll back to the legacy-1.2.4 - Pre-DLC build, available from the "Betas" tab in the Steam client.
  2. Download Cuphead 3D Vision Fix.
  3. Extract the fix to the installation folder.
  4. Open d3dx.ini.
  5. 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[7]
  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

Expert difficulty can be unlocked from the start without completing the game first.
Unlock expert difficulty manually[7]
  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

  • Simple DebugInfo - Adds a debug GUI, HP bar for bosses, quick restart, camera zoom, and more.
  • Cuphead/Mugman Color Correction (Steam only) - Changes all the discolored gloves and shoes for Cuphead and Mugman to the correct colors. Works only with the Steam version.
  • Debug Console Enabler - Enables the game's debug console, allowing access to a wide variety of features such as viewing scenes from the game, level selection, 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
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


Notes

  1. Unity engine build: 5.6.2p1[1]
  2. Unity engine build: 2017.4.9f1[2]
  3. 3.0 3.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. Verified by User:Baronsmoki on 2019-04-18
  3. Cuphead :: Cuphead Available Now on Macintosh! - last accessed on 2018-10-22
  4. Verified by User:AmethystViper on 2021-01-20
    Tested on the current Steam release of the game, and game will always prompt a Steam log-in unless Steam was uninstalled or creating a steam_appid.txt with its Steam App ID number.
  5. Verified by User:Aemony on 2019-07-11
    Windows version does not support native HDR, which was verified and confirmed by running the game on a HDR display while Windows HD Color was enabled (allows for HDR output to the display running in HDR mode) and confirming that the brightness of the game changed while manipulating the SDR content appearance slider in the Windows HD Color settings. Since the brightness changed with the SDR content appearance slider, this game does not make use of native HDR, and is in fact merely tonemapped from SDR to HDR automatically by Windows 10 (so called fake HDR).
  6. View topic - CUPHEAD | WSGF
  7. 7.0 7.1 7.2 7.3 7.4 7.5 7.6 7.7 7.8 7.9 Verified by User:Keith on 2017-09-29