GungeonUnstuck

《挺进地牢》软锁救援工具 / Enter the Gungeon soft-lock recovery tool.

当 Mod 冲突、过场动画、Boss 死亡流程或异常敌人导致“游戏还在运行，但玩家无法继续推进”时，GungeonUnstuck 提供几个控制台命令来尽量恢复当前局面，而不是立刻放弃本轮游戏。

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 / 命令

unstuck

完整软锁恢复命令。适合角色无法行动、UI 消失、镜头卡住、Boss 死亡过场没有收尾等情况。

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

• 恢复玩家输入、手部/枪械渲染、受击状态和移动限制。
• Restore player input, hand/gun renderers, vulnerability, and movement restrictors.
• 恢复核心 UI、小地图、屏幕淡入淡出、Boss 血条与镜头控制。
• Restore core UI, minimap, screen fade, boss health bars, and camera control.
• 修复枪龙/金枪龙死亡流程卡住导致的门不开、无奖励、无法传送问题。
• Fix stuck High Dragun / Advanced Dragun death sequences that leave doors sealed, rewards missing, or teleport disabled.
• 兼容修复 MikuMikuMod 的 Leek 道具当rolling中物品掉落到坑里时产生的软锁问题。
• Compatibly fix MikuMikuMod's Leek item pitfall soft-locks when rolling items fall into pits.

openroom

强制打开当前房间命令。适合敌人出 Bug 死不掉，导致房间门不开、不能传送的情况。

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

• 将当前房间内仍注册的敌人标记为不再阻止清房。
• Mark currently registered enemies as ignored for room-clear checks.
• 强制解除房间、门和 standalone blocker 的封锁。
• Force-unseal the room, connected doors, and standalone blockers.
• 恢复当前房间传送点和传送图标。
• Restore the current room's teleporter and minimap teleporter icon.
• 重新显示小地图并标记当前房间为已发现。
• Restore the minimap and mark the current room as revealed.

Notes / 注意事项

• 这是救援工具，不是永久修复所有 Mod 冲突的补丁。
• This is a recovery tool, not a permanent fix for every mod conflict.
• unstuck 理论上会跳过大部分的动画演出效果,我强烈不建议在正常情况下使用,这可能会产生意想不到的后果。只建议角色无法行动,卡在动画时使用。
• 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 会绕过当前房间的敌人清房条件；只建议在确认房间已经无法正常完成时使用。
• openroom bypasses the current room's enemy-clear condition; use it only when the room cannot be completed normally.

Compatibility / 兼容性

• 需要 BepInEx 和 Mod the Gungeon API。
• Requires BepInEx and Mod the Gungeon API.
• 包含对 MikuMikuMod Leek 道具掉坑软锁的专门恢复逻辑。
• Includes a dedicated recovery path for MikuMikuMod Leek item pitfall soft-locks.