CupHeads v1.2.24

CupHeads v1.2.24

This rescue build focuses on stabilizing real online play paths that were showing up in logs and playtests:

• Fixed corrupted online loadout sync by encoding Cuphead weapon/super/charm IDs with stable packet wire codes instead of truncating the game's large enum values into raw bytes.
• Added weapon-prefab fallback safety so stale or invalid remote weapon IDs no longer crash shooting, weapon switching, or death cleanup.
• Hardened online equipment/menu closing so mismatched two-player equip-card states can back out instead of soft-locking.
• Rebuilt the portable installer and DLL from the rebased main, including the latest upstream boss-health-bar live HP fixes.

Assets:

• CupHeads.exe - portable installer
• CupheadOnline.dll - direct BepInEx plugin DLL

v1.2.23

CupHeads v1.2.23

This release makes the local multiplayer test workflow much easier.

• Replaces the hidden F11 local-dev toggle with an in-game CupHeads Dev Lab overlay.
• Adds Dev Lab buttons for START SIMULATOR, START + OPEN SAVE SELECT, STOP SIMULATOR, COPY DIAGNOSTICS, and CLOSE.
• Keeps the one-window simulator focused on the useful debug target: Player One is local, Player Two is network-controlled, and Player Two is fed through CupHeads' remote-input path.
• Adds in-game notes explaining why automatic two-window Steam self-testing is not reliable from one Steam account.
• Updates README and changelog with the new Dev Lab workflow.

Testing note: this does not replace true Steam P2P testing. If Dev Lab fails to spawn/control Player Two, the bug is local spawn/input routing. If Dev Lab works but Steam multiplayer fails, the bug is likely lobby, packet, or scene-sync related.

v1.2.22

CupHeads v1.2.22

This patch focuses on making multiplayer feel better to play and easier to test solo.

• Adds latency-friendly hybrid co-op damage: the host still owns scenes, saves, boss/RNG/progression, but each peer owns hits to their own player body so lag is less likely to cause unfair HP loss.
• Adds Networking.LatencyFriendlyDamage so the older strict host-authoritative damage behavior can still be restored for comparison.
• Softens remote position correction during latency-friendly sessions to reduce small rubber-band pulls in boss fights.
• Adds F11 local dev simulation mode for one-PC testing: Player One stays local and Player Two is driven through CupHeads' remote-input path using Player Two/controller bindings.
• Updates README/config docs and changelog with the new authority model and dev test workflow.
• Normalizes the startup splash video to Unity-safe H.264/AAC with frame-zero/keyframe-friendly output.

Solo dev test: launch Cuphead, press F11 before opening a save/level, then use Player One controls for Cuphead and Player Two/controller bindings for Mugman. Press F11 again to stop.

CupHeads v1.2.21

CupHeads v1.2.21

• Installer now verifies the installed CupheadOnline.dll contains the same CupHeads version as the installer.
• Installer refuses to run while Cuphead.exe is open, preventing stale loaded DLLs from surviving a repair install.
• README now documents the old-DLL symptom and emergency startup splash bypass.

If your BepInEx log still says CupHeads 1.2.18, close Cuphead fully, run this v1.2.21 installer, and confirm the next log says CupHeads 1.2.21 loading.

CupHeads v1.2.20

CupHeads v1.2.20

• Fixes the startup splash black-screen / repeated playback-start loop seen in v1.2.18.
• Detaches Unity's prepare callback as soon as it fires so the splash can only start once.
• Adds watchdogs so the overlay closes safely if Unity's VideoPlayer stalls or misses its finish callback.

Built from commit dd7f65b.

CupHeads v1.2.19

• Fixed a Unity 2017 VideoPlayer prepare loop caused by calling Stop() inside prepareCompleted.
• Added a one-shot playback guard so the startup splash can only start once per boot.
• The splash now waits for the Cuphead window to be focused before preparing and playing, so the intro does not burn its opening seconds while the game is in the background.
• Keeps the black boot gate visible while waiting for focus, then starts the intro from frame zero.

CupHeads v1.2.18

• Fixed the startup splash appearing to begin partway through by hiding the video surface until playback starts.
• Rewinds the prepared VideoPlayer back to time = 0 / frame = 0, waits one frame, then starts playback from the beginning.
• Keeps the black boot gate visible while the video is preparing so the first visible splash frame is no longer lost behind Unity startup timing.

CupHeads v1.2.17

• Changed startup splash playback into a true boot gate: Cuphead is paused and background game audio is muted while the intro video plays.
• Added StartScreen and StartScreenAudio input gates so pressing a key during the splash can no longer trigger the title screen underneath.
• Turned the procedural film-static overlay off by default and moved it to the new StartupSplash.FilmStaticOverlay config key.
• Preserved splash audio while game audio is muted by using AudioSource.ignoreListenerPause.
• Restored the previous game time scale and audio pause state after the splash ends, skips, errors, or gets destroyed.

CupHeads v1.2.16

• Re-encoded the bundled startup splash from HEVC/H.265 1440p60 to Unity-friendly H.264 1080p30 with AAC audio.
• Moved startup splash playback out of plugin Awake() so Unity video decoding no longer starts while BepInEx is still patching the game.
• Hardened startup splash errors so unsupported videos stop and destroy immediately instead of fading through a failed media state.
• Documented that replacement splash videos should avoid HEVC/H.265 for Cuphead's Unity 2017 runtime.

CupHeads v1.2.15

• Added an optional CupHeads startup splash video player that looks for BepInEx/plugins/CupheadOnline/Assets/CupHeadsIntro.mp4.
• Added audio playback for the startup splash through Unity's VideoPlayer + AudioSource path.
• Added skip support for Escape, Z, Enter, Space, controller confirm, controller back, and controller start.
• Added a live film-static overlay with configurable intensity so clean intro videos can still get a Cuphead-style projector/static pass.
• Updated the installer to bundle and repair-copy StartupSplash/CupHeadsIntro.mp4 into the plugin Assets folder.
• Added fail-open guards so missing, unsupported, or slow-to-prepare videos skip safely instead of blocking the game boot.