BetterSpire2

適用於《殺戮尖塔2》的輕量級遊戲體驗優化模組包。提供完整版或輕量版（聯機安全）。包含傷害計數器、預期生命值、多段攻擊總計、隊友手牌/藥水查看器（帶緊湊網格模式）、可拖動時鐘、自動確認、即時快速模式、按住R鍵重啓、雙擊R鍵重置回合、跳過啓動畫面、踢人/靜音、難度動態調整等功能。按F1或使用ModConfig進行設置。

BetterSpire2

🎮 **一個爲《殺戮尖塔2》量身打造的輕量級遊戲體驗優化模組包！** 它將衆多實用功能集於一身，每個功能都可以在遊戲內設置菜單中單獨開關。完美支持多人遊戲，包含踢人、斷線處理和難度動態調整。

---

🎯 兩個版本任你選

BetterSpire2 提供兩種口味：

• **完整版** — 包含所有功能。在模組清單中標記爲 `affects_gameplay`。**建議聯機房間內的所有玩家都安裝此版本。**
• **輕量版** — 僅包含顯示類和外觀類功能。標記爲 `affects_gameplay: false`，因此**即使其他玩家不安裝，也能安全用於多人遊戲**。

**輕量版包含：** 傷害計數器、多段攻擊總計、預期生命值、帶狀態顯示的隊友手牌查看器、時鐘、跳過啓動畫面、靜音塗鴉、即時快速模式。

**完整版額外增加：** 按住R鍵重啓、雙擊R鍵重置回合、踢出玩家、難度動態調整、自動確認棄牌/保留。

---

✨ 核心功能一覽

▶️ 即將受到的傷害計數器

在你的角色上方顯示一個數字，精確展示你**本輪將受到多少生命值傷害**。計算會考慮你當前的格擋、寵物吸收、冰霜球被動格擋（包括“聚焦”和“鍍金電纜”遺物）、回合結束時的減益效果（如纏繞、消亡、魔法炸彈、瓦解），以及回合結束時手牌造成的傷害（如燃燒、腐朽、召喚等）。

• 🔴 角色上方的紅色數字 = 你實際將受到的HP傷害
• 🟢 綠色的0 = 你被完全保護（格擋或寵物吸收了所有傷害）
• 🟠 寵物上方的橙色數字 = 你的寵物將吸收的傷害

當你打出卡牌或獲得格擋時，數字會實時更新！

在設置中開啓“顯示預期生命值”，還能看到受傷後的剩餘HP。例如，“14 (38)”表示你將受到14點傷害，回合結束時生命值爲38。

▶️ 多段攻擊傷害總計

敵人的多段攻擊現在會在原始標籤旁用括號顯示總傷害。例如，原本顯示“3x3”的攻擊，現在會顯示“3x3 (9)”，你再也不用自己心算啦！

▶️ 自動確認棄牌/保留選擇（僅完整版）

當遊戲要求你棄牌或保留卡牌時，一旦選擇了最大數量的卡牌，系統會自動確認，無需你再點擊確認按鈕。適用於任意數量的卡牌選擇。

▶️ 即時快速模式

解鎖遊戲隱藏的“即時”動畫速度，比內置的“快速模式”還要快！在F1設置菜單中切換。這僅僅是改變了遊戲偏好設置，不會修改任何遊戲邏輯。

▶️ 按住R鍵重啓本輪（僅完整版 - 僅限單人模式）

按住R鍵1.5秒，即可立即放棄當前本輪，並使用相同的角色、爬塔等級和章節配置（但使用新的隨機種子）開始全新的一輪。非常適合當你覺得本輪已經沒救，想快速重開時使用。

▶️ 雙擊R鍵重置當前房間（僅完整版 - 僅限單人模式）

快速雙擊R鍵，即可重新加載上一個自動存檔，重啓當前房間。遊戲在進入每個房間時都會自動存檔，因此這相當於重置當前的戰鬥或事件。會保留你的地圖塗鴉和敵人位置。無需返回主菜單，實現無縫的原地重載。

▶️ 跳過啓動畫面

遊戲啓動時自動跳過Logo/啓動動畫，直達主菜單。

▶️ 隊友手牌查看器

按F3打開一個透明的浮動面板，顯示戰鬥中**每位玩家當前的手牌**。每張卡牌都以小縮略圖形式顯示，並帶有卡牌名稱。將鼠標懸停在任意卡牌上，會顯示完整的工具提示和卡牌描述——你再也不用猜隊友手裏有什麼牌了！

每位玩家的名字行會使用遊戲圖標顯示手牌統計：總攻擊力（劍）、防禦力（盾）、虛弱和易傷。這有助於協調攻擊——如果你的隊友有一張能施加“易傷”的卡牌，你可以等他打出後再使用你的高傷害卡牌。

**面板特性：**

• **可調整大小** — 拖動右側、底部或右下角來調整大小。尺寸會在關閉後記住。
• **分頁** — 如果玩家超過4人，會出現箭頭按鈕（）進行翻頁。也可以使用Page Up / Page Down鍵。
• **可拖動重新定位** — 點擊並拖動面板，將其移動到屏幕任何位置。位置會在關閉後記住。
• **點擊外部或按X按鈕關閉**。
• **保持打開模式** — 在設置中啓用“保持打開”，可防止點擊面板外部（例如爲了出牌）時面板關閉。需使用F3或X按鈕關閉。
• **隱藏自己的手牌** — 切換此選項可僅顯示隊友手牌，釋放屏幕空間。
• **藥水顯示** — 每位玩家的藥水會顯示爲小圖標，懸停可查看名稱和描述。當藥水被獲得、使用或丟棄時會實時更新。
• **緊湊視圖** — 在設置中切換“緊湊視圖”，可隱藏卡牌縮略圖，並將玩家排列在2x2的網格中，僅顯示名字、狀態和藥水，佔用最小的屏幕空間。
• **持久位置** — 面板的位置和大小會在遊戲會話之間保存。

默認會顯示你自己的手牌，以便你驗證顯示是否匹配。需要啓用“在戰鬥中顯示隊友手牌”設置（默認開啓）。

▶️ 時鐘顯示

一個可選的可拖動時鐘，出現在屏幕右上角。支持12小時和24小時制格式（在設置中切換）。點擊並拖動可重新定位——位置會在遊戲會話之間保存。默認禁用。

---

👥 多人遊戲支持

所有功能都支持多人遊戲。每位玩家看到的傷害數字是根據他們自己的格擋、寵物和減益獨立計算的。輕量版可用於多人遊戲，且不需要所有玩家都安裝此模組。完整版則建議會話中的所有玩家都安裝。版本無需完全匹配——舊版本只是功能較少。

---

🎪 隊伍管理（F1 → 隊伍）

在多人遊戲中，F1設置菜單包含一個“隊伍”部分，按Steam名稱和角色職業顯示所有玩家。在這裏你可以：

• **隱藏塗鴉** — 阻止另一位玩家的地圖塗鴉出現在你的屏幕上。切換時也會清除他們現有的塗鴉。
• **清除所有塗鴉** — 一次性擦除地圖上的所有塗鴉。
• **踢出玩家**（僅房主，完整版）— 將玩家移出會話。

塗鴉靜音是按人設置的——任何安裝了此模組的玩家都可以獨立選擇隱藏誰的塗鴉。

---

🚪 踢人與斷線處理（僅完整版）

當房主踢出一名玩家（或玩家失去連接）時，遊戲會繼續運行而不會卡住。所有同步器都經過修補，確保戰鬥回合、地圖投票、事件選擇、寶箱房遺物拾取、章節過渡和玩家選擇都能爲缺失的玩家自動解決。

如果被踢出的玩家被重新邀請並重新連接，他們的被踢狀態會自動清除——無需重啓遊戲。

---

⚖️ 難度動態調整（僅完整版）

當有玩家在遊戲中途離開時，敵人的生命值、格擋量和能力強度會自動調整，以匹配剩餘玩家的數量。如果你開始的是2人遊戲，有人離開後，敵人會下調至單人難度。

這在中途戰鬥中同樣有效——現有敵人的生命值會重新調整，並保持其當前生命值比例（一個生命值爲50%的敵人調整後仍爲50%）。

由F1菜單中一個僅房主可用的開關控制：“根據活躍玩家調整難度”（默認啓用）。房主可以隨時切換此開關，即使在戰鬥中，敵人也會立即重新調整。

---

⚙️ 設置菜單

隨時按F1打開遊戲內設置面板。每個功能都可以單獨開關。設置採用兩欄佈局——左欄：戰鬥HUD和多人遊戲；右欄：遊戲玩法和快捷鍵——隊伍部分橫跨底部。你的偏好設置會自動保存，並在遊戲會話之間持續存在。

面板可拖動——點擊並拖動可重新定位。點擊面板外部或按X按鈕關閉。位置會在打開之間記住。

BetterSpire2 還與 **ModConfig** 集成。如果安裝了 ModConfig，所有設置都會出現在遊戲的“設置 → 模組”標籤頁中。這對於無法訪問F1覆蓋層的移動端/安卓玩家尤其有用。ModConfig 是可選的——沒有它，模組也能正常工作。

輕量版顯示一組精簡的開關（僅顯示類功能）。完整版顯示所有開關。

---

💾 重要：存檔文件信息

遊戲爲模組遊戲和非模組遊戲使用獨立的存檔文件：

• **非模組遊戲存檔路徑：** `%APPDATA%\Roaming\SlayTheSpire2\steam\\profile1\saves\`
• **模組遊戲存檔路徑：** `%APPDATA%\Roaming\SlayTheSpire2\steam\\modded\profile1\saves\`

如果你是第一次安裝模組，你的進度**不會**自動轉移。要解決此問題，只需將你的存檔文件從非模組文件夾複製到模組文件夾。請確保是**複製**（而不是移動），以便保留備份。你也可以使用 UnifiedSavePath 模組。

---

🐛 已知問題與錯誤報告

**已知問題：**

• 目前沒有！如果你遇到問題，請附帶你的 `betterspire2_log.txt` 日誌文件進行報告。

**錯誤報告：**

請使用 Bugs 標籤頁報告問題。所有錯誤報告**必須**包含：

• 重現問題的步驟
• 顯示錯誤的截圖或短視頻

沒有重現步驟或證據的錯誤報告將被立即關閉。“它不工作”或“我發現了一個錯誤”但沒有細節的描述是無法處理的。

如果可能，也請附上你的日誌文件：`%APPDATA%\SlayTheSpire2\betterspire2_log.txt`