STS2自動爬塔模組

解鎖遊戲內置的AutoSlay自動化測試功能。我一直在用它通過快速模擬大量遊戲來驗證我的模組不會導致遊戲崩潰。提供針對特定角色和遊戲行爲的配置選項。

STS2自動爬塔模組 🎮

✨ 解鎖並擴展了MegaCrit內部使用的內置AutoSlay運行器，讓你可以自動化運行遊戲，快速測試模組穩定性或進行壓力測試！

---

🚀 核心功能

• **主菜單的“自動爬塔”按鈕**：在主菜單的“退出”按鈕上方新增了一個按鈕，點擊即可立即開始自動化運行，無需開發者控制台！
• **高度可配置**：點擊“自動爬塔”按鈕後，會彈出一個配置菜單！（1.2.0版本新增）
• **運行中暫停與恢復**：在AutoSlay運行時，隨時按下 **F9** 鍵即可將其凍結。屏幕上會顯示橫幅確認暫停。再次按下F9即可恢復。暫停期間遊戲完全可交互，你可以檢查棋盤狀態。
• ⚠️ **注意**：戰鬥在暫停期間仍會緩慢進行。此功能主要用於暫停戰鬥外的事件，方便你觀察周圍環境。

📝 使用須知

⚠️ 存檔文件信息

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

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

**小貼士**：如果是第一次安裝模組，你的遊戲進度不會自動轉移。解決方法很簡單：只需將你的存檔文件從非模組文件夾複製到模組文件夾。請確保是**複製**（而不是移動），以便保留備份。

⚙️ 配置文件

首次啓動時，會在DLL文件同目錄下創建 `autoslay_settings.json` 文件。每個字段上方都有內聯的 `_help_` 註釋，解釋了有效的選項。更改將在下次啓動遊戲時生效。

📊 日誌文件

如果需要報告崩潰，`%APPDATA%\Roaming\SlayTheSpire2\logs\godot.log` 是最有用的文件。它包含一些基本的識別信息（計算機名、硬件、安裝路徑），請酌情發送。

📥 安裝指南

• 前往你的STS2安裝目錄：`STEAM\steamapps\common\Slay the Spire 2\`
• 如果不存在，創建一個名爲 `mods` 的文件夾。
• 將模組解壓到該文件夾，最終目錄結構應如下所示：

`mods\STS2AutoSlayMod\STS2AutoSlayMod.dll`

• 啓動遊戲，它會檢測到模組並要求你在模組模式下重啓。

**再次提醒**：請務必閱讀上面的存檔文件信息，以確保你的遊戲進度能順利轉移。

---

💡 重要說明

• **功能純粹**：此模組**不會**修改卡牌、遊戲平衡或規則——它僅僅解鎖並擴展了MegaCrit內部使用的內置AutoSlay運行器。
• **循環模式**：運行後的 `loop` 模式非常適合壓力測試，但會無限運行直到你關閉遊戲。在某些特定邊緣情況下，遊戲仍可能關閉。我們正在努力追蹤這些情況（例如AI輸掉一局、彈窗或意外情況導致30秒超時後遊戲關閉）。
• **最佳循環條件**：如果所有“紀元”都已解鎖，循環模式效果最佳！否則每次解鎖新紀元時遊戲都會停止。可以通過控制台命令輕鬆解鎖所有紀元。
• **開發工具**：本模組主要作爲開發/測試工具。歡迎提交錯誤報告。
• **調試挑戰**：已識別出特定事件和戰鬥會導致崩潰。由於這是一個非發行版工具（我必須將遊戲設置爲非發行版才能啓動它），調試起來有些困難。

🐛 已知問題

• “拳擊賽/拳擊構造體”事件可能導致軟鎖。
• 如果自動玩家耗盡了整個牌庫，可能導致軟鎖。說的就是你，**Eidolon**...

---

**作者**：Thebuda4

享受自動化測試的便利吧！🚀