路線建議

一個爲《殺戮尖塔2》設計的模組，它會在地圖界面上以金色/紅色高亮顯示最優路線。

RouteSuggest 🗺️

一個爲《殺戮尖塔2》設計的模組，它會在地圖界面上以金色/紅色高亮顯示最優路線，幫助你做出更明智的決策！

**支持的遊戲版本：** v0.99.1 和 v0.102.0 (公測版)

---

✨ 核心功能

• **雙路線建議**：提供兩條最優路線——**安全路線**和**激進路線**。
• **視覺高亮**：
• **金色**：安全路線（最小化風險）
• **紅色**：激進路線（優先戰鬥以獲取獎勵）
• **智能評分**：爲不同玩法風格（安全 vs 激進）設置不同的權重。
• **專家評分**：可選的位置相鄰獎勵，獎勵特定的節點序列模式（例如，在精英戰前休息）。
• **GUI配置**：通過 **ModConfig** 進行完整的遊戲內配置（可選）。
• **手動配置**：高級用戶可以直接編輯JSON配置文件。

---

🚀 工作原理

模組使用不同的評分系統計算兩條最優路徑：

安全路徑 (金色) 🛡️

最小化遭遇戰，優先考慮安全：

| 房間類型 | 評分 | 原因 |

|:--- |:--- |:--- |

| **休息點** | +1 | 治療和升級卡牌 |

| **寶箱房** | +1 | 免費遺物 |

| **商店** | +1 | 購買卡牌、遺物和藥水 |

| **怪物** | -1 | 避免戰鬥 |

| **精英** | -3 | 避免高難度遭遇 |

| **首領** | 0 | 最終目的地 |

激進路徑 (紅色) ⚔️

優先考慮戰鬥獎勵和未知遭遇：

| 房間類型 | 評分 | 原因 |

|:--- |:--- |:--- |

| **休息點** | +1 | 治療和升級卡牌 |

| **寶箱房** | +1 | 免費遺物 |

| **商店** | +1 | 購買卡牌、遺物和藥水 |

| **怪物** | +2 | 金幣和卡牌獎勵 |

| **精英** | +3 | 遺物和更好的獎勵 |

| **未知** | +2 | 潛在的戰鬥機會 |

| **首領** | 0 | 最終目的地 |

當兩條路徑共享同一條邊時，它會顯示爲金色。

專家評分 (相鄰獎勵) 🧠

每條路徑都可以選擇啓用**專家模式**，在基礎權重之上應用位置相鄰獎勵。專家模式是一個全局開關，影響所有路徑。這些獎勵特定的節點序列：

| 模式 | 描述 | 默認值 |

|:--- |:--- |:--- |

| **休息 -> 精英** | 休息點緊接在精英遭遇之前 | 0 |

| **精英 -> 休息** | 精英遭遇緊接在休息點之前 | 0 |

| **寶箱 -> 精英** | 寶箱房緊接在精英遭遇之前 | 0 |

| **休息 -> 任意 -> 精英** | 休息點在精英遭遇前兩步（中間隔一個節點） | 0 |

| **精英 -> 任意 -> 休息** | 精英遭遇在休息點前兩步（中間隔一個節點） | 0 |

所有獎勵默認值爲0（禁用）。當專家模式關閉時，評分與之前相同。開關和獎勵可以通過ModConfig GUI或JSON進行配置。

---

⚙️ 配置選項

GUI設置 (推薦) 🎮

RouteSuggest 可選地與 **ModConfig** 集成。安裝ModConfig後，RouteSuggest 會出現在遊戲的 **設置 > Mods** 菜單中。如果未安裝ModConfig，模組仍可正常工作，但你需要手動編輯JSON配置文件。

通過ModConfig GUI，你可以：

• **常規設置**：
• **高亮類型**：選擇高亮一條最優路徑或所有得分最優的路徑。
• **啓用專家評分**：全局開關，啓用相鄰獎勵（影響所有路徑）。
• **配置每條路徑**：
• **啓用**：啓用/禁用此路徑（禁用的路徑不會被計算或顯示）。
• **名稱**：路徑標識符。
• **顏色**：輸入十六進制顏色代碼（例如，金色用 `#FFD700`，紅色用 `#FF0000`）。
• **優先級**：滑塊設置渲染優先級（數值越高，路徑重疊時顯示在上層）。
• **評分權重**：每個房間類型的滑塊。
• 正值 = 偏好此房間類型
• 負值 = 避免此房間類型
• 零 = 中立
• **專家評分**：5個用於位置模式相鄰獎勵的滑塊。
• **添加新路徑**：滑塊添加新路徑（滑動到1）。
• **移除路徑**：每個路徑都有一個滑塊用於移除它（0=保留，1=移除）。
• **重置爲默認值**：滑塊重置所有路徑爲默認配置。
• **更改會自動保存**到配置文件位置。

手動JSON配置 📝

或者，你可以通過手動編輯 `RouteSuggestConfig.json` 來自定義路徑類型。配置文件通常位於模組DLL文件旁邊或 `mods/` 文件夾根目錄。

可用的房間類型：`RestSite`, `Treasure`, `Shop`, `Monster`, `Elite`, `Unknown`, `Boss`

如果配置文件缺失或無效，將使用默認的路徑配置。

社區配置分享 🤝

用戶們在 帖子頁面 分享了他們的自定義配置。快去看看吧，尋找靈感或找到適合你遊戲風格的配置！

---

📥 如何安裝

• **下載**：從 GitHub releases 或 下載最新版本。
• **解壓**：將模組文件解壓到你的《殺戮尖塔2》模組文件夾（`mods` 文件夾應位於遊戲可執行文件同一目錄下）：
• **Windows**: `C:\Program Files (x86)\Steam\steamapps\common\Slay the Spire 2\mods\`
• **macOS**: `~/Library/Application Support/Steam/steamapps/common/Slay the Spire 2/SlayTheSpire2.app/Contents/MacOS/mods/`
• **Linux**: `~/.steam/steam/steamapps/common/Slay the Spire 2/mods`
• **啓動**：啓動《殺戮尖塔2》——模組將自動加載。

---

📜 更新日誌

v1.9.0

• 測試支持遊戲公測版 v0.99.1 和 v0.102.0。
• 新增專家評分模式，附帶相鄰獎勵（配置文件版本4）。
• 模組現在集成了ModConfig v0.2.1中新增的按鈕/顏色選擇器控件，如果可用則使用它們，並對舊版ModConfig進行回退兼容。

v1.8.0

• 改進ModConfig UI：將某些滑塊改爲開關以便配置。
• 爲每個路徑配置添加啓用/禁用選項。
• 測試支持遊戲公測版 v0.100.0。

v1.7.0

• 將 `affects_gameplay` 設置爲 false，因爲此模組僅爲視覺輔助，不影響實際遊戲玩法。

v1.6.0

• 改進配置文件路徑解析邏輯，使模組文件夾更整潔。

v1.5.0

• 新增高亮類型選項，控制高亮多少條路徑。

v1.4.0

• 添加了與ModConfig的GUI設置集成，支持遊戲內路徑配置。
• 測試支持遊戲公測版 v0.99.1。

v1.3.0

• 調整了安全/激進路徑的默認權重。
• 添加了通過JSON文件的可配置路徑。

v1.2.0

• 修復了進入新章節時的路徑高亮問題。

v1.1.0

• 新增雙路徑模式：安全路徑（金色）和激進路徑（紅色）。

v1.0.0

• 初始版本發佈。

---

**提示**：這個模組是你規劃爬塔策略的絕佳助手，無論是想穩紮穩打還是富貴險中求，它都能爲你指明方向！