CupheadVR 1.03

CupheadVR 1.03 adds a Surround setting, so Quest players can see their room around the stage.

• Surround (Stage tab): Black (default), Green or Transparent.
  • Green fills everything around the stage with pure green. In Virtual Desktop, turn on passthrough with the chroma key set to green, and your room shows around the stage.
  • Transparent asks the headset software for a see-through background where it offers one. If it doesn't, the surround stays black, and the menu row says so.
• The log now lists what the headset software supports, which helps with bug reports.

Install or update: unzip CupheadVR-1.03.zip anywhere, double click "Install CupheadVR.bat" and type 1. Your settings are kept.

CupheadVR 1.02

CupheadVR 1.02 adds a Picture setting, for players who see the stage stretch or lean when they turn their head on Virtual Desktop.

• Picture (first row on the Picture tab): Auto, Steady or Panel. Auto uses Steady on Virtual Desktop and Panel on everything else. Steady draws the stage and the menu into each eye's view, and holds still when you turn your head. Panel can look a little sharper.
• The Steady mode comes from OriVR, based on a contribution by junglejuz.

Install or update: unzip CupheadVR-1.02.zip anywhere, double click "Install CupheadVR.bat" and type 1. Your settings are kept.

CupheadVR v1.01

CupheadVR 1.01 fixes two problems players reported in 1.0.

• Cuphead out of line with his ground and hitbox. Moving your head away from where you last recentered (sitting taller, leaning) slid the depth layers against each other, so Cuphead drifted away from where he really was, worse as a session went on. Depth now comes only from the gap between your eyes.
• The stage shrinking or growing when you moved your head up or down. The edge trim followed your head position. It now stays steady.
• Small rounding drift when layers were put back after each frame is gone.
  New: Lean parallax on the Depth tab (default 0%) brings back layers sliding as you lean, like a real diorama, if you want it.
  Install or update: unzip CupheadVR-1.01.zip anywhere, double click "Install CupheadVR.bat" and type 1. Your settings are kept.

CupheadVR 1.0

CupheadVR 1.0: Cuphead in VR as a pop-up storybook stage (free mod, OpenXR)

Cuphead on a stage floating in front of you, in true native stereo: both eyes are drawn from the same game tick, with no alternate-eye rendering and no warping. The game's own parallax layers become real depth, so the hand-painted backgrounds sit far behind, Cuphead and the bosses stand out like cut-outs, and the foreground leans out toward you. Play it seated with a gamepad.

What it does

• Native stereo through OpenXR, with depth taken from the game's own parallax layers
• Smooth motion at your headset's refresh rate (72, 90, 120 Hz and up), at exactly the normal game speed
• Resolution set from your headset's pixel density and the stage size
• In-headset settings menu styled like the game's own cards. Hold both sticks to open it
• Settings for stage size and distance, layer depth, character pop, pop-out, sky distance, film grain, colour fringe, sharpening and resolution
• Installs with one bat file, and uninstalls the same way. No game files are changed

What you need

• The Steam version of Cuphead
• A PC VR headset with OpenXR: SteamVR set as your OpenXR runtime, or Virtual Desktop's VDXR
• A gamepad

Please read

• Tested in real headsets on two setups: Pimax Dream Air through SteamVR, and Meta Quest 3 through Virtual Desktop's VDXR. Other headsets and graphics cards should work but have not been tried. Reports are welcome.
• The overworld map stays flat on the stage, because its art has no depth layers.
• The mod is not signed, so Windows may warn you, and Smart App Control can block it. The README covers this.

Install
Unzip it, double click "Install CupheadVR.bat", and type 1. Start SteamVR or connect Virtual Desktop, then start Cuphead from Steam.

Download: https://github.com/scubasteve2365/CupheadVR/releases/tag/v1.0

By scubasteve2365. MIT licence. Uses BepInEx and the Khronos OpenXR loader. This is a fan mod, not made or approved by Studio MDHR.