SlayTheStats

（v0.2.0 圖鑑更新）追蹤你所有遊戲輪次中的卡牌、遺物和遠古數據，並將其顯示爲提示信息。

SlayTheStats

📊 **你的《殺戮尖塔2》個人數據助手！** 這個模組能深入分析你的遊戲歷史，讓你更瞭解自己的決策模式和勝率。

✨ 核心功能

SlayTheStats 會追溯讀取你的完整遊戲歷史。統計數據會在你完成一輪遊戲或啓動遊戲時更新，被放棄的輪次會被跳過。

• **選取率 (Pick%)** —— 當一張卡牌作爲戰鬥獎勵出現時，你選擇它的頻率。
• **勝率 (Win%)** —— 在包含某張卡牌或遺物的輪次中，你獲勝的頻率。
• **輪次統計 (Runs)** —— 以分數形式顯示（例如 12/30）。分子是卡牌出現在你最終牌組中的輪次數，分母是卡牌作爲戰鬥獎勵出現的輪次數。對於遺物，則只顯示其存在的輪次數。數據會按你首次獲得該卡牌的“層數”進行細分。
• **購買統計 (Buys)** —— 針對無色卡牌和遺物：顯示爲你從商店購買該物品的輪次 / 該物品出現在商店的輪次（例如 12/30）。

在遊戲過程中、商店裏以及圖鑑中，當你將鼠標懸停在卡牌和遺物上時，這些統計數據會以提示信息的形式顯示。

🎨 直觀的顏色編碼

顏色編碼幫助你一目瞭然地讀取數據：

• **選取率和勝率** 會根據你的個人基準線進行着色。你的基準線是該角色戰鬥獎勵的平均勝率和選取率。
• 顏色強度對樣本量和偏差都很敏感，因此少數輪次的高勝率可能與許多輪次的中等偏高勝率具有同等顯著性。

🛠️ 安裝要求

• 爲《殺戮尖塔2》安裝 **GUMM (Godot Universal Mod Manager)**：
• **BaseLib v0.2.5 或更高版本**：

📥 安裝步驟

• 如果尚未安裝，請先爲 STS2 安裝 GUMM。
• 如果尚未安裝，請下載並解壓 BaseLib (v0.2.5 或更高版本) 到你的 mods 文件夾。
• 從“文件”選項卡下載 `SlayTheStats-vX.X.X.zip` 並解壓到你的 mods 文件夾。最終你應在 `mods/` 內得到一個 `SlayTheStats/` 文件夾，其中包含 `SlayTheStats.dll`、`SlayTheStats.json`、`SlayTheStats.pck` 和一個 `fonts/` 子文件夾。

🔍 圖鑑過濾器

打開遊戲內的圖鑑（卡牌庫或遺物收藏），點擊側邊欄的 SlayTheStats 按鈕即可打開過濾器面板。該面板讓你可以調整哪些輪次的數據被計入統計：

• **進階等級範圍** —— 僅顯示特定進階等級範圍內的數據（例如 A5+）。
• **遊戲版本範圍** —— 限制爲特定的遊戲版本。
• **遊戲檔案** —— 限制爲單個存檔，或聚合所有檔案的數據。
• **職業** —— “全部”、“匹配卡牌職業”（對職業卡使用其所屬職業，對無色/詛咒卡使用全職業），或篩選爲特定角色。
• **合併卡牌升級** —— 合併升級變體（例如 Strike+ 計入 Strike）或將它們分開追蹤。

激活的過濾器會以綠色高亮顯示，讓你清楚知道哪些設置與你的默認值不同。面板底部有三個操作按鈕：

• **清除過濾器** —— 移除所有過濾器
• **重置** —— 恢復到已保存的默認值
• **保存爲默認值** —— 將當前設置持久化爲你的新默認值。在遊戲過程中，將始終使用你的默認值。

📝 重要說明

• **選取率** 僅來源於戰鬥獎勵。商店購買、事件卡牌和其他來源不計入。
• **勝率** 統計所有在你的最終構築中出現了該卡牌或遺物的輪次，無論其來源。
• **商店購買**：對於無色卡牌和遺物，提示信息顯示你購買某物品的頻率相對於它在商店出現的頻率，顏色則相對於你的整體商店購買率。請注意，無論你是否買得起該物品，其出現都會被計數。
• **無色卡牌、事件卡牌、遠古遺物、詛咒等** 都會被追蹤。
• 模組設置（色盲模式、遊戲內統計開關、總開關、調試模式）可以在遊戲內通過 BaseLib 的模組配置頁面進行配置，或者，如果你安裝了可選的 ModConfig 模組，也可以通過它來配置。

♿ 無障礙支持

設置中提供了 **色盲模式**（使用青色/橙色代替綠色/紅色）。

💾 數據存儲

統計數據存儲在 `slay-the-stats.json` 文件中：

• **Windows**: `%APPDATA%\Slay the Spire 2\`
• **Linux**: `~/.local/share/Slay the Spire 2/`

❓ 常見問題

**Q: 爲什麼一張卡牌顯示的“存在”輪次數多於“出現”輪次數（例如 5/1）？**

A: “存在”（分子）統計的是該卡牌通過任何來源（包括在篝火處升級基礎卡）最終進入你牌組的所有輪次，而“出現”（分母）只統計戰鬥獎勵屏幕。過濾器面板中的“合併卡牌升級”選項控制我們是否將升級視爲單獨的卡牌。初始卡牌和初始遺物將始終顯示“出現”爲 0，因爲它們從未出現在戰鬥獎勵屏幕上。

**Q: 爲什麼我的勝率是 100% 但統計數據是灰色的？**

A: 顏色強度反映了樣本量以及與你基準線的偏差幅度。在輪次非常少的情況下，即使是完美的比率也會保持暗淡——隨着證據的積累，顏色會逐漸加深。

**Q: 爲什麼我看不到我用過的卡牌的統計數據？**

A: 打開圖鑑中的 SlayTheStats 過濾器面板，檢查你的默認過濾器設置。

**Q: 我看到所有東西都顯示“無數據”。**

A: 模組無法找到你的遊戲歷史來填充數據。在這種情況下，你需要找到遊戲存檔數據（例如遊戲歷史）的存儲位置。將“DataDirectory”設置爲存儲數據的“SlayTheSpire2”文件夾。對於 Windows，通常是 `%APPDATA%/SlayTheSpire2`。請注意，你需要在那裏填寫完整路徑。請提交錯誤報告，以便我修復默認設置！

**Q: 安裝後我丟失了存檔數據。**

A: 數據並沒有丟失——如果這是你第一次安裝模組，我建議安裝模組 **UnifiedSavePath**。這樣，當你開始使用模組時，你的無模組進度將會轉移。默認情況下，遊戲會將模組存檔與普通存檔分開。如果你想保持原版進度“純淨”，那麼請創建另一個使用模組的檔案，並使用解鎖模組來獲得你的進度。

🔧 故障排除

檢查 Godot 日誌中的 `[SlayTheStats]` 條目（先關閉遊戲）：

• **Windows**: `%APPDATA%\Godot\app_userdata\Slay the Spire 2\logs\godot.log`
• **Linux**: `~/.local/share/godot/app_userdata/Slay the Spire 2/logs/godot.log`

🚧 即將推出

一個自定義的怪物圖鑑：

• **每場戰鬥統計**：平均承受傷害、每場戰鬥回合數、死亡次數、使用藥水數等。
• 圖鑑中新增一個“怪物圖鑑”頁面，包含詳細的戰鬥統計數據。
• **戰鬥中敵人提示信息**：在戰鬥中將鼠標懸停在怪物上，查看你對該場戰鬥的統計數據。