STS2戰鬥日誌模組

此模組爲你提供遊戲內的戰鬥日誌和戰後的詳細數據統計。讓你能夠追蹤使用的卡牌、對盟友和敵人造成的傷害來源，並瞭解到底是什麼幫助了你的冒險之旅！

STS2CombatLogMod

🎮 **一款功能強大的《殺戮尖塔2》戰鬥數據分析模組**，讓你洞悉每一次戰鬥的細節！

---

✨ 核心功能

• **戰鬥內日誌** - 在屏幕左側顯示，通常位於剩餘能量上方。你可以使用 `+` 或 `-` 鍵來展開或縮小日誌窗口，也可以點擊“隱藏”按鈕將其收起。
• **戰後統計界面** - 每次冒險結束後，屏幕右側會出現一個按鈕，點擊可以打開本次冒險的詳細記分板，包含以下標籤頁：
• 概覽
• 卡牌
• 充能球
• 遺物
• **冒險歷史統計** - 如果你在“圖鑑”中查看過去的冒險記錄，這些冒險的最終記分板也可以被查看（僅限安裝此模組後進行的冒險！）。
• **新增當前冒險、當前戰鬥及本場冒險的過往戰鬥統計**！現在你可以看到哪些卡牌在整個冒險過程中表現出色，而不僅僅是最後一場戰鬥。

🎪 多人遊戲支持

• ✅ **支持多人遊戲！**
• ✅ 區分每位玩家的統計數據，提供數據對比，並且日誌會按Steam用戶名分開顯示。
• ⚠️ 仍在進行更多測試，歡迎提交錯誤報告。

---

⚠️ 重要使用須知：存檔文件信息

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

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

**快速複製路徑**：`%APPDATA%\SlayTheSpire2\steam\`

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

---

📁 日誌文件

如果你需要向開發團隊發送日誌，它們保存在以下位置：

• **最新冒險日誌**：`%APPDATA%\Roaming\SlayTheSpire2\steam\\modded\profile1\`
• **長期存儲日誌**：`%APPDATA%\Roaming\SlayTheSpire2\steam\\modded\profile1\history\`

日誌文件遵循STS2的命名規則，以冒險開始的時間戳爲前綴。

如果你遇到可能與模組相關的遊戲崩潰，也可以將 `%APPDATA%\Roaming\SlayTheSpire2\logs\godot.log` 發送給開發團隊。請注意，`godot.log` 包含一些基本的識別信息（如計算機名、硬件和安裝路徑），請自行決定是否發送。

**安全提示**：`combat_log.txt` 和 `combat_log_ui_verbose.txt` 這兩個文件**不包含**任何識別信息！

---

📥 安裝指南

• **找到遊戲目錄**：前往你的STS2安裝目錄：`STEAM\steamapps\common\Slay the Spire 2\`
• **創建模組文件夾**：如果不存在，請創建一個名爲 `mods` 的文件夾。
• **解壓模組**：選擇你的版本，並將文件解壓到 `mods` 文件夾中。
• **完整版**：解壓後文件應位於 `mods\STS2CombatLogMod\` 下，包含 `STS2CombatLogMod.dll` 和 `STS2CombatLogMod.json`。
• **啓動遊戲**：啓動遊戲，它會檢測到模組並提示你重啓進入模組模式。

**再次提醒**：請務必閱讀上方的存檔文件信息，STS2爲模組和非模組使用獨立存檔。如果你想轉移進度，請按上述說明覆制存檔。

---

🐛 已知問題

• 如果主機在返回主菜單前斷開連接並自動重連，戰鬥內的日誌顯示可能會有些異常，但會在下一場戰鬥開始時自動修復。

**測試說明**：我主要在單人模式下使用我的另一個模組 AutoSlay 進行測試。如果在多人遊戲中感覺有任何異常或錯誤，請提交問題報告，並附上 `combat_log.txt` 和/或 `combat_log_ui_verbose.txt` 日誌文件（這些文件沒有識別信息）。

---

🔮 未來計劃與已實現功能

以下功能已在 **1.6.0 版本** 中實現或正在開發中：

✅ **已添加**：

• 治療量統計（部分數值可能顯示爲“未知”，正在修復中）
• 卡牌使用/抽取/丟棄/消耗統計
• 充能球被動效果 vs 激發效果統計
• 格擋來源統計
• 遺物觸發次數統計
• 狀態效果施加追蹤（部分數值可能顯示爲“未知”，正在修復中）
• 在選定戰鬥中進行玩家間對比（所有標籤頁顯示本地玩家數據，“每位玩家”標籤頁顯示整個隊伍數據）

🛠️ **規劃中**：

• 傷害貢獻百分比（計劃轉化爲交互式圖表）
• 來自敵人的傷害統計（待定）
• 簡化視圖

---

🎲 裝上這個模組，讓你的《殺戮尖塔2》冒險從“憑感覺”變成“靠數據”，成爲真正的策略大師吧！