Communitygithub.com

AHMADALIPARR/game-animation-frames

遊戲動畫資產深度指南:動作循環、關鍵幀、特效序列與動畫精靈表 — 以影片優先的管線為基礎。

game-animation-frames 是什麼?

這是一個專為遊戲動畫資產設計的深度指南,涵蓋動作循環、關鍵幀、特效序列與動畫精靈表。其核心方法是「影片優先」:利用影片生成器自然產生連貫的動作(如腿部交替、弧線連續性、布料與火焰動態),而非依賴靜態圖像生成器想像中間動作。 在應用建構器沙盒中,執行時應透過 `video2dsprite` 或 `generate2dsprite` 技能(含洋紅色背景與腳本),而非隨意使用 ffmpeg。這項技能同時確立了一套「動作法則」,包括循環對仗、連續性、物理合理性,以及雙向翻轉測試來驗證動畫循環是否流暢。 預設管線包含五個步驟:基礎幀 → 動畫化 → 擷取清理 → 選取循環幀 → 打包輸出。它與 game-asset-core 和對應的精靈生成技能緊密整合,適用於任何需要動畫的場合:行走/跑步循環、攻擊、待機、特效、旗幟、火焰、動畫精靈表。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AHMADALIPARR/skill-inventory/tree/HEAD/skills/sovereign/opengrok/game-animation-frames

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

動畫幀 — 影片優先

圖像生成器繪製姿勢;影片生成器理解運動── 腿部交替、弧線連續性、布料與火焰動態都會自然出現, 因為影片必須讓它們動起來。所以不要要求圖像模型想像 中間運動姿勢:先讓基礎動作動畫化,再從中擷取真實幀。

應用建構器執行(請先閱讀)

本技能是原則文件(運動法則、循環品質檢查、何時使用影片)。 在應用建構器沙盒中,請勿擅自執行自由形式的 ffmpeg 擷取 或發明一個可隨意替換的 #hex 背景。

步驟執行這個
製作精靈 / 固定網格generate2dsprite — 純色 #FF00FF 洋紅精靈表 + 色鍵腳本
從影片取得更密集的動作video2dsprite — 基礎圖層仍是 #FF00FF → imagine_image_to_video → 技能腳本(ffmpeg + 色鍵)
可替換背景使用任一管線時,始終用 #FF00FF(色鍵需要)
本技能循環 / 翻轉測試 / 下方運動法則 — 在管線執行後應用

開啟 .grok/skills/video2dsprite/SKILL.md 或 .grok/skills/generate2dsprite/SKILL.md 並遵循其工作流程進行生成與後處理。然後應用 這裡的運動法則與翻轉測試,再將幀輸出到遊戲中。

預設管線(意圖)

  1. 基礎幀。 主體處於中立/起始姿勢,完整風格詞彙,側面 / 適合遊戲的視角,純色 #FF00FF 背景(應用建構器色鍵)。 套用 game-asset-core 預設值。
  2. 動畫化。 從基礎幀執行 imagine_image_to_video:一個清楚的動作,原地進行, 靜態鏡頭(「騎士原地行走,側面視角,鏡頭鎖定」, 6 秒)。保持鏡頭簡單——一個主體、一個動作。優先透過 video2dsprite 執行,以保持擷取與色鍵一致。
  3. 擷取 + 清理。 使用 video2dsprite 腳本(不要單獨用 ffmpeg -i … fps=12)。洋紅填滿 / 去幻彩功能在那裡; 除非你完全離開洋紅管線,否則不要使用另一個不同的 #hex 重新設定色鍵。
  4. 選取。 選擇那些 (a) 捕捉動作的階段性差異以及 (b) 能夠循環的幀——序列的結尾必須能順暢銜接回開頭。不要強迫 特定數量:如果動作用 8、10 或 12 幀表現最好,就提供 那麼多(更多幀 = 引擎內動畫更流暢)。對於一個循環,使用動作 標記(腳著地點、翅膀極端位置、火焰峰值)選取一個完整的週期。
  5. 打包。 按播放順序(零填充名稱)和/或 依照 game-asset-core 規則(均勻儲存格、無分隔線)產生精靈表——或使用 video2dsprite / generate2dsprite 產生的透明條紋/網格。 說明預期的 fps。

僅在影片無法產生所需動作時(罕見:非常風格化的姿勢、單一戲劇性關鍵幀), 才退回到逐關鍵幀的 imagine_text_to_image(後處理精靈腳本時仍使用 #FF00FF 背景),然後自己規劃階段並遵守下方的運動法則。優先使用 generate2dsprite 以獲得清晰的生產級多幀網格。

運動法則(無論使用哪種管線,請根據這些法則驗證)

  • 循環必須能循環;交替步態的半步週期是鏡像的。
  • 連續性:肢體、道具、解剖結構、效果應沿連續路徑移動—— 相鄰幀之間不應有瞬移、消失或重複。
  • 靜止幀中也能讀出物理:空中表現有空氣感,預備姿勢壓縮, 跟進動作過衝;效果應保持在原始位置,除非請求移動它們。
  • 能量匹配要求:待機/微小動作意味著幾乎相同的幀。

驗證 — 翻轉測試

嚴格按順序檢視最終幀,並口頭描述動作;明確檢查 循環閉合(最後→第一)。若口頭描述中有任何猶豫,代表該幀不合格。 影片管線通常第一次就能通過此測試——這就是為何它是預設選項。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能