動畫精靈交換框架
動畫精靈交換框架允許你在動畫播放時臨時替換NPC精靈，並在動畫結束時自動恢復原樣。
截圖 共 2 張
模組介紹 作者原文
動畫精靈交換框架允許你在動畫播放時臨時替換NPC精靈，並在動畫結束時自動恢復原樣。
Animation Sprite Swap Framework
🎯 核心功能
這個框架讓你能夠在特定**動畫**觸發時**自動交換NPC精靈**，比如在日程動畫如 *alex_lift_weights* 或 *sam_guitar* 播放期間。
🔧 工作原理
- 讀取簡單的數據文件（Sprites/animationDescriptions），列出哪些動畫應該使用哪些精靈表
- 動畫開始時，框架臨時替換NPC的紋理
- 動畫結束時，自動恢復原始精靈
- 無需事件、無需條件、無需複雜設置，只需自動精靈交換
💡 使用場景
特別適用於當你使用其他加載角色精靈的模組（如 *Seasonal Cute Characters*），但仍希望特定動畫使用不同的精靈運行時。
👨💻 模組製作者使用指南
創建或編輯一個**Content Patcher**包，使用簡單的EditData補丁：
```
{
"Action": "EditData",
"Target": "Sprites/animationDescriptions",
"Entries": {
"alex_lift_weights": "Characters/Alex_Tattoo",
"sam_guitar": "Characters/Sam_BlackGuitar"
}
}
```
**關鍵說明：**
- 每個鍵（如"alex_lift_weights"）是日程或事件中使用的**動畫ID**
- 每個值是動畫播放時應加載的**精靈表路徑**
⚡ 自動流程
當動畫在遊戲中運行時，框架自動：
- 用你的自定義精靈替換NPC的紋理
- 動畫結束後恢復默認精靈
就這麼簡單，無需編碼！
📝 模組製作者注意事項
- 可以爲**每個NPC映射多個動畫**，甚至使用不同的精靈
- 動畫鍵必須**完全匹配**遊戲或你的事件/日程中使用的鍵
- 精靈路徑必須指向有效的遊戲資源
- 此框架僅管理紋理 — **不**添加新動畫、更改幀或編輯時序
✅ 兼容性
- 適用於 **Stardew Valley 1.6+**
- 適用於 **SMAPI 4.0+**
- 與所有修改日程或動畫的模組兼容
- 可與**季節性、服裝和外觀**模組安全使用
- 與其他框架無已知衝突
---
✨ 讓NPC動畫更加生動有趣，無需複雜設置即可實現精靈自動切換！
安裝與使用 安裝：SMAPI 模組（星露谷物語標準流程）
- 先安裝 SMAPI（星露谷模組載入器）：從 smapi.io 下載安裝包，執行 install on Windows.bat，按提示選擇遊戲目錄完成安裝。
- 解壓本站下載的壓縮包，找到包含 manifest.json 的那層資料夾（這就是一個模組）。
- 把該模組資料夾整個複製到 Stardew Valley/Mods/ 目錄下。
- 透過 SMAPI 啟動遊戲（執行 StardewModdingAPI.exe 或按指引設定啟動項），標題畫面前的控制台會列出每個模組的載入結果。
修改器類工具可能無需 SMAPI，解壓後按包內說明直接執行即可。 修改存檔前建議先備份；SMAPI 會在控制台列出載入失敗的模組。