GungeonUnstuck

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.