##光暈戰記角色動畫編輯器
非光暈戰記官方工具。
用來製作 光暈戰記 角色(actor)的部件動畫——頭、手、腳、披風、武器的關鍵格動畫,外加追加特效、命中區間、音效時間點,存成一份可攜的 JSON。做好的動畫由 TWActorAnimationLib 在遊戲裡播放。
編輯器本身不連遊戲伺服器、可以離線編輯,作品先存在本機;登入之後可以選擇同步到雲端、發布到公開作品區讓別人瀏覽與 fork。
# 光暈戰記角色動畫編輯器(TWActorAnimationEditor)
非光暈戰記官方工具。
用來製作 [**光暈戰記**](https://twilightwars.gamelet.online/) 角色(actor)的部件動畫——頭、手、腳、披風、武器的關鍵格動畫,外加追加特效、命中區間、音效時間點,存成一份可攜的 JSON。做好的動畫由 [**TWActorAnimationLib**](https://code.gamelet.com/edit/TWActorAnimationLib) 在遊戲裡播放。
編輯器本身不連遊戲伺服器、可以離線編輯,作品先存在本機;登入之後可以選擇同步到雲端、發布到公開作品區讓別人瀏覽與 fork。
## 怎麼用
1. 中間是 actor 預覽,上面 menu 選檔案 / 編輯 / 檢視,下面是時間軸,右邊是 inspector。
2. 點時間軸某個部件的 track,雙擊空白處加 keyframe。
3. 右邊 inspector 編 keyframe 屬性(位置 / 旋轉 / 縮放 / 軸心等)。
4. 按 ▶(或 `Space`)預覽。
5. 想保存就「檔案 → 儲存」存進本機作品庫;要備份可「匯出 JSON」,也能匯出單張 PNG(當前幀、透明底)/ APNG / GIF 分享。
快捷鍵在編輯器裡按 `?` 查看。
## 動畫概念
動畫只記「部件每個時間點要長什麼姿勢」,actor 是誰、武器是什麼由當下決定,所以同一份動畫套不同 actor / 武器都通用。
四種軌:
- **部件軌** — 7 條,每條是一個身體部位的 keyframe(位置 / 旋轉 / 縮放 / 軸心)
- **生成物件軌** — 動畫期間生出來的 PIXI 物件(特效 / 殘影),可染色、可動畫化各種屬性
- **傷害區軌** — 攻擊命中範圍 + 時段(時間軸上的可拖 bar)
- **音效軌** — 在某個時間點觸發音效,支援 sound 單檔與 soundPack 壓縮包
## 注意事項
動畫要在遊戲裡播放,遊戲端需安裝 **TWActorAnimationLib**。編輯器本身不新增任何事件表動作 / 檢查 / 觸發;如果想用事件表來播放動畫,請另外安裝 **TWEventsBetterExp** 模組——它提供「播放角色動畫」事件表動作:對角色播放編輯器做的動畫,可選等待播完 / 結束重設姿勢,並可啟用傷害判定(吃動畫內的傷害區段、多人下 owner 端結算),播放時還能複寫傷害數值(傷害值 / 倍率 / 類型)。
## 玩家社群
### Discord
- [**嘎姆討論區**](https://discord.gg/hZKQzRfPJM):於 2021/05/08 創立的非官方社群,主要用於討論嘎姆擂台的相關資訊。
## 作者
**酷可**:[**Code.Gamelet**](/profile/114899766849308759711@google)、[**Gamelet.Online**](https://gamelet.online/user/114899766849308759711@google/board)、[**Youtube**](https://www.youtube.com/@cook1470)
# Changelog (TWActorAnimationEditor)
## [v0.2.0](/view/TWActorAnimationEditor/0.2.0) (2026-06-03)
#### Added
- 傷害區新增「命中模式」設定:單次命中/多段命中/週期重打,用一個選單描述武器的傷害行為,不必逐一調整底層開關。週期重打可設定「每隔幾秒造成一次傷害」,適合做電鑽、持續傷害這類效果。
- 傷害區可設定命中數量(全部/指定數量);選「指定數量」時可再選「優先打誰」(離最近的/最正前方/先碰到的)。
- 選「最正前方」時,顯示區會畫出攻擊中心線方便對位。
## [v0.1.1](/view/TWActorAnimationEditor/0.1.1) (2026-06-02)
#### Bug fixed
- 修復顯示區(viewport)滑鼠滾輪縮放失效的問題(v0.1.0 起在角色身上以外的空白處滾輪無法縮放)。
## [v0.1.0](/view/TWActorAnimationEditor/0.1.0) (2026-06-02)
#### Added
- 編輯器預覽新增「角色造型」選擇:在作品資訊區點造型按鈕,從內建造型庫(96 種角色外觀)挑一個,預覽(含原版對照那隻)即時換成該造型。一個作品記一個造型。
- 所選造型會存進作品(本機/雲端/公開都帶),作品卡縮圖、hover 預覽、公開作品區都會顯示該造型。
#### Changed
- 作品存檔格式更新以容納角色造型設定,舊作品開啟時自動沿用、無須手動處理。
- 匯出 JSON 維持乾淨骨架、不含造型 —— 造型是編輯器的預覽設定,匯出的動畫資料保持純粹(播放時套用當下的角色造型)。
## [v0.0.2](/view/TWActorAnimationEditor/0.0.2) (2026-06-02)
#### Added
- 編輯器預覽新增「循環播放」開關(播放控制列):開啟後播到結尾會自動從頭重播,不必反覆按播放鍵。
- 屬性數值欄位支援滑鼠滾輪增減:滑鼠移到輸入框上即可滾輪微調(按住 Ctrl 為粗調),效果與拖曳屬性名稱相同。
#### Changed
- 部件透明度(alpha)數值限定在 0 ~ 1。
#### Bug fixed
- 公開作品卡的作者暱稱過長時自動截斷(顯示「暱稱…」),不再撐亂卡片排版。
- 切換動畫或開啟其他作品時,部件與武器不再殘留上一個動畫的姿勢(沒有設關鍵格的部件會回到基準姿勢,而不是卡在舊位置)。
- 開啟其他作品或切換動畫時,時間軸會自動回到起點;先前會沿用上一個動畫的播放位置,較短的動畫因此卡在結尾。
- 切換基準動作後,武器會跟著時間軸目前的位置走,不再固定停在基準動作的預設位置。
## [v0.0.1](/view/TWActorAnimationEditor/0.0.1) (2026-06-01)
#### Added
- 首次發布。製作光暈戰記角色(actor)的部件動畫——頭、手、腳、披風、武器的關鍵格動畫,外加追加特效、命中區間、音效時間點,存成一份可攜的 JSON,交給 **TWActorAnimationLib** 在遊戲裡播放。
- 作品先存在本機,登入後可選擇同步到雲端、發布到公開作品區供他人瀏覽與 fork;另可匯出 APNG / GIF / JSON。
## Authors
**[cook1470](/profile/cook1470)**