AutoSLCut

AutoSLCut 是一款專爲內容創作者設計的《Slay the Spire 2》模組。它能自動檢測錄製過程中的保存與加載（SL）事件，並生成時間線數據，幫助你使用外部工具剪掉無效片段。⚠️ 此模組不影響遊戲玩法。

AutoSLCut

✨ **專爲視頻創作者打造的自動化剪輯助手！**

AutoSLCut 是一款用於《Slay the Spire 2》視頻創作輔助的 Mod。它可以在你錄製遊戲時，自動記錄 SL（Save & Load）行爲，並在錄製結束後生成剪輯數據，配合外部工具自動剪掉無效片段，大幅減少手動剪輯時間。

⚠️ **重要提示**：本 Mod **不影響遊戲玩法**，僅服務於視頻創作者。

---

✨ 功能特點

• **自動檢測**：智能識別遊戲中的 Save / Load 行爲。
• **數據生成**：自動生成剪輯時間軸（JSON格式）。
• **OBS 集成**：支持與 OBS Studio 自動連接。
• **一鍵剪輯**：配套 Python 工具，一鍵完成視頻剪輯。
• **靈活調整**：支持自定義 SL 偏移量，適配不同機器性能。

---

🚀 使用方法

1️⃣ 安裝 Mod

正常安裝並啓用本 Mod 即可。

2️⃣ 開始錄製

• 啓動遊戲和 OBS Studio（順序不限）。
• 開始錄製（推薦使用 `.mkv` 格式）。
• 正常進行遊戲（包括 SL 操作）。

3️⃣ 錄製結束

錄製結束後，OBS 輸出文件夾中會生成兩個文件：

• `xxx.mkv`（原始視頻）
• `xxx.json`（剪輯時間軸數據）

4️⃣ 自動剪輯

• 將 `Cut.py` 腳本放入上述文件夾。
• 雙擊運行腳本。

腳本會自動：

• 查找匹配的 `.mkv` 和 `.json` 文件。
• 調用 FFmpeg 進行自動剪輯。
• 輸出最終視頻：`xxx_cut.mkv`。

---

⚙️ 參數調整（非常重要）

在 `Cut.py` 文件中，可以調整以下參數：

`LOAD_OFFSET = 0.45`

這個值用於控制 Load 操作後額外裁剪的時間（單位：秒）。

**如何調整？**

這個值並非固定，取決於：

• 你的電腦性能
• 遊戲加載速度
• 使用的 SL 方式（官方/一鍵SL）

**建議方法**：

• 先用默認值錄製一次。
• 觀察剪輯結果。
• 根據需要進行微調（±0.1 ~ 0.3）。

---

🧰 環境要求

你需要準備：

• Python 3.x
• FFmpeg（已加入系統 PATH）

---

🎯 適用人羣

• ❌ 普通玩家（不推薦）
• ✅ 視頻內容創作者（強烈推薦）

---

🎬 額外說明

• 本工具也可用於剪輯其他視頻。
• 你可以自由修改 `Cut.py` 腳本，例如：
• 調整輸出格式（mp4 / mkv）
• 修改編碼參數
• 定製剪輯策略

---

❤️ 支持作者

如果這個工具對你有幫助，歡迎在視頻中註明：

`Edited with AutoSLCut Mod`

---

🔮 未來計劃

如果使用人數較多，計劃提供：

• 無需 Python 的獨立剪輯工具
• 圖形用戶界面（GUI）
• 更智能的剪輯策略

---