Sunday, December 31, 2017


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.

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.

- 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.

- 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 996, and uncomment this block of text:

;Hash = f735b9a3
;ps-t0 = ResourceReplaceTexture1
;Hash = a27c9df9
;ps-t0 = ResourceReplaceTexture2
;Hash = 42cd867e
;ps-t0 = ResourceReplaceTexture3

So it will be:

Hash = f735b9a3
ps-t0 = ResourceReplaceTexture1
Hash = a27c9df9
ps-t0 = ResourceReplaceTexture2
Hash = 42cd867e
ps-t0 = ResourceReplaceTexture3

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

- 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:


  1. In the version when I press F4 it freezes the game. Known bug?
    Btw can film grain and chromatic aberration be toggled separately?

    1. It's a Unity game. In my experience, they are usually unstable when booting or closing. Seems random. For example, this game closes fine for me, but Yooka-Laylee usually freezes.

      About your other question, now that you said it, I think it's possible. I have modified (in my PC) the shader and I could disable film grain without disabling chromatic aberration. I'll try to make them separated with different hotkeys. In the meantime, pcgamingwiki mentions how to disable each of them permanently:

    2. Done. Redownload the fix. It now has two separate hotkeys. The F4 hotkey disables some extra blurring when you pause the game, at the cost of not being able to use the overscan setting (it freezes the image when that hotkey is in use). The new hotkeys are safe because they don't disable that.

    3. That's awesome, thanks for the update!

    4. I've noticed the film grain and chromatic aberration toggles do not seem effective for the 2-Strip and Black & White filters in the game: Could you take a look at this?

    5. Oh... I didn't unlock them yet ingame. Then they must be different shaders. It's a bit of cheating, but I'll unlock them then and see if I can do the toggle for them too.

    6. There you go, new update. It was a bit of cheating, unlocking these modes early. But it was for a worthy reason :).

    7. Excellent! Thanks so much and have a happy new year. :)

  2. You're a true 3d shaderhacker master but this is pure genius, thank you so much for this!

  3. Pretty awesome job Master. Always outdoing yourself!

  4. Hi. Thank you so much for this.
    Can you do anything about the flashing text that displays at the start of levels?

    1. Your wish is my command :p. Download the fix again and follow the "Texture mod for no flickering at the start of levels" steps. There is currently a mod that replaces original game files. But mine doesn't. It uses external textures, and can be enabled or disabled easily.

    2. Thank you, so very much. I'm quite sensitive to blinking/flashing, so this entire mod and now this recent addition will enable me to play the game. :)

  5. This looks surprisingly great in 3D. Super cool approach too. Thanks man!

  6. Huge thanks for all your hard work !
    So many great fixes thanks to you