Cuphead

3D Vision feature for Cuphead, with some extra graphics options to disable some post processing filters. This isn't a fix, because the game was just 100% flat by default. This is layered (with curves sometimes) 3D made from scratch, texture by texture.


WARNING: as of the 1.2.2 update (April of 2019), the 3D fix is broken. Hotkey toggles for filters and HUD toggle still work, but you need to roll back to "hotfix 1.1.4" to make 3D work again.


Update (2018-04-07): updated the fix with 3Dmigoto 1.3.8, combined controller and keyboard hotkeys for convergence and HUD depth, and added two more textures for the "no flashing" mod (for run & gun levels).

Yet another update (2018-01-02): with this new update there is a new feature to disable flickering at the start of a level. Read the section below the installation steps.

Another update (2018-01-01): the last stage of Hilda Berg was missing 3D for some textures. I have updated the fix for that.

New update (2018-01-01): I have added shaders so you can disable film grain, chromatic aberration and blur in the other two color filters available. Black and white mode doesn't have chromatic aberration, so you don't need to use the chromatic aberration hotkey for that.

Update (four hours since the original post): redownload the fix again. I have included two new hotkeys to control chromatic aberration and film grain separately.


Fixed
- Geometry textures separated by custom layers that depend on separation and convergence.


Known issues
- Some elements that should be at different depths are in the same texture, so there can be some layers with wrong depth or a compromised setting, espacially the run & gun levels.
- The game can sometimes crash at boot. Just try to boot it again. This has been tested only with the GOG version.


Installation
- Download this file and extract its contents in the "Cuphead" folder, where "Cuphead.exe" is.
- The game needs to run in exclusive fullscreen mode to enable 3D. If you are going to launch the game through GOG Galaxy or Steam, make a launch command line parameter with "-window-mode exclusive" (no quotes). Do the same with a shortcut if you are booting the game standalone (for example, the GOG version without Galaxy).

- Launch the game. The first time you run it, it will ask for permission to write a setting (it's convergence) into the Nvidia game profile. Allow it.


Texture mod for no flickering at the start of levels
- This is a texture replacement mod that can't be toggled in real time. The textures come in the "ReplacementTextures" folder. To enable this mod, open "d3dx.ini", go to (currently) line 1062, and uncomment 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

So it will be:

[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


Save the changes, and the next time you start the game, those textures won't flicker at the start of a level.



Hotkeys
- F1 or XB_RIGHT_THUMB: five convergence presets. Cuphead is at screen depth by default. These presets will lower convergence.
- F2 or XB_LEFT_THUMB: HUD depth presets. Screen depth by default.
- F3: HUD toggle.
- F4: film grain and chromatic aberration toggle. Not disabled by default. Warning: if you use overscan ingame, this hotkey will freeze the image. Use the separate hotkeys instead.
- F5: screen blur toggle. Not disabled by default.
- F6: aspect ratio cycle. Unmodified by default. It has also 16:9->2.37:1, 16:9->32:9 and 16:9->48:9 presets. For 21:9, it would be better to follow the pcgamingwiki steps.
- 1 (not the numpad): film grain toggle. Not disabled by default.
- 2 (not the numpad): chromatic aberration toggle. Not disabled by default.


If you liked this and want to contribute for more future fixes, you can donate to this PayPal account: masterotakusuko@gmail.com