GungeonUnstuck

v1.0.0·Updated 2026-05-05

Soft-lock recovery tool: restore input/UI/camera, fix stuck boss deaths, force-open rooms and restore teleport/minimap

About this mod Machine translation

GungeonUnstuck

Enter the Gungeon soft-lock recovery tool.

When mod conflicts, cutscenes, boss death sequences, or unusual enemies result in "the game is still running, but the player cannot progress," GungeonUnstuck provides several console commands to try to restore the current situation instead of giving up the game immediately.

When mod conflicts, cutscenes, boss death sequences, or bugged enemies leave the run technically alive but no longer playable, GungeonUnstuck provides console commands that try to recover the current room/run instead of forcing you to abandon it.

Commands/commands

unstuck

Complete soft lock recovery command. It is suitable for situations where the character cannot move, the UI disappears, the camera is stuck, the boss death scene has no ending, etc.

Full soft-lock recovery command. Use it when the player cannot move, UI is hidden, the camera is stuck, or a boss death/cutscene did not properly finish.

It will try:

It attempts to:

  • Restored player input, hand/gun rendering, hit status and movement restrictions.
  • Restore player input, hand/gun renderers, vulnerability, and movement restrictors.
  • Restore core UI, minimap, screen fade, boss health bar and camera control.
  • Restore core UI, minimap, screen fade, boss health bars, and camera control.
  • Fixed the problem of the door not opening, no rewards, and being unable to teleport due to the stuck death process of Gun Dragon/Golden Gun Dragon.
  • Fix stuck High Dragun / Advanced Dragun death sequences that leave doors sealed, rewards missing, or teleport disabled.
  • Compatible with fixing the soft lock problem of MikuMikuMod's Leek props when rolling items fall into the pit.
  • Compatibly fix MikuMikuMod's Leek item pitfall soft-locks when rolling items fall into pits.

openroom

Force open the current room command. It is suitable for situations where a bug prevents the enemy from dying, resulting in the room door not opening and being unable to teleport.

Force-open command for the current room. Use it when a bugged enemy refuses to die and keeps the room sealed or teleport disabled.

It will try:

It attempts to:

  • Marking enemies still registered in the current room to no longer block room clearing.
  • Mark currently registered enemies as ignored for room-clear checks.
  • Force unblocking of rooms, doors and standalone blockers.
  • Force-unseal the room, connected doors, and standalone blockers.
  • Restore the current room teleport point and teleport icon.
  • Restore the current room's teleporter and minimap teleporter icon.
  • Redisplay the minimap and mark the current room as discovered.
  • Restore the minimap and mark the current room as revealed.

Notes/Notes

  • This is a rescue tool, not a patch to permanently fix all mod conflicts.
  • This is a recovery tool, not a permanent fix for every mod conflict.
  • unstuck will theoretically skip most of the animation performance effects. I strongly do not recommend using it under normal circumstances, as this may have unexpected consequences. It is only recommended to use when the character cannot move and is stuck in animation.
  • unstuck is designed to skip most animations and cutscene effects, and I strongly recommend against using it under normal circumstances as it may have unintended consequences. Use it only when the player cannot move or is stuck in an animation.
  • openroom will bypass the enemy clearing conditions in the current room; it is only recommended to be used when it is confirmed that the room cannot be completed normally.
  • openroom bypasses the current room's enemy-clear condition; use it only when the room cannot be completed normally.

Compatibility / compatibility

  • Requires BepInEx and Mod the Gungeon API.
  • Requires BepInEx and Mod the Gungeon API.
  • Contains special recovery logic for MikuMikuMod Leek props that fall into the soft lock.
  • Includes a dedicated recovery path for MikuMikuMod Leek item pitfall soft-locks.

Install & use Install: BepInEx plugin

  1. The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
  2. Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
  3. Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
  4. Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.

Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.

Dependencies

Install these first, or the mod will not work:

BepInEx-BepInExPack_EtGMtG_API-Mod_the_Gungeon_API

File & checksum

Filename
GungeonUnstuck-1.0.0.zip
File size
142.1 KiB