這三個 2D sprite 工具怎麼分工？PerfectPixel、Agent Sprite Forge、Gorest

半夜調 2D 遊戲的 sprite，最怕的不是生不出好看的圖，而是後面那一整串瑣碎的雜事：

• 動畫 frame 數對不上，播起來像在瞬移
• 角色在畫面裡微微漂移，重心根本不對
• 背景去背去不乾淨，邊緣殘留一堆白邊
• 匯出的 sprite sheet 格式怪異，丟進引擎直接報錯
• 想把 scene 拼起來看效果，還得手動建一堆設定檔
• 只要稍微改個動作，整條管線就要重跑一遍

這三個跟 2D sprite 相關的 repo：PerfectPixel、Agent Sprite Forge 和 Gorest，各自切入的痛點截然不同。我通常不會直接比誰比較強，而是看它們在開發流程裡各自卡在什麼位置。

如果用最直覺的開發需求來分：

• 想要極致的輸出品質與穩定的動畫幀：選 PerfectPixel。
• 想在 Codex 裡用複數 Agent 自動化跑完資產管線：選 Agent Sprite Forge。
• 需要在本地快速排 scene、預覽動態並微調 metadata：選 Gorest。

這篇主要不是要念規格，而是想聊聊在實際跑專案時，該怎麼把這三個工具安插在對的位置。

---

2D 遊戲素材的開發路徑

在從零開始的 2D 專案裡，素材通常會走過這幾個階段：

1. 方向探索：決定風格、定色調、快速拉出幾款 prototype 看看感覺。
2. 大量生成：產出角色、道具、地圖背景等各種資產（assets）。
3. 後處理與清理：去背、對齊 anchor、校正位移、切分 frame，並產出對應的 metadata。
4. Scene 排版：在工作台上把角色、背景、UI 拼在一起，調整圖層（layer）順序並即時預覽。
5. 引擎串接：匯出成 Godot 或 Unity 認得的格式，直接進場景動起來。

這三個工具，剛好落點在不同的工作階段。

---

1. PerfectPixel：把 sprite 做到真的能進引擎

PerfectPixel 的定位是「成品產出機」。

它不是只幫你生出一張好看的角色插圖就沒事了，它最核心的價值是把文字描述轉成能直接進遊戲引擎的完整動畫資產。

它在乎的是這些開發現場的硬需求：

• Base character 的設計與風格收斂
• 超過 100 種預設動作（motion presets）
• 8 個方向的完整動作圖組（8-direction sprite set）
• 自動產出 sprite sheet 與對應的 JSON manifest
• 提供每個狀態的 GIF/APNG 與單張 frame 預覽

AI 生出來的圖通常很髒，PerfectPixel 強在它後面接了一套很硬的後處理程序。它先生成 horizontal filmstrip，再跑背景偵測去背，接著切 frame，最後還會檢查 frame count 和角色有沒有漂移（identity drift）。如果品質不過，它自己會默默重跑最多三次，直到收斂為止。

怎麼裝、怎麼用

PerfectPixel 的開發環境要求如下：

• Go 1.25+
• Node.js 18+
• Wails CLI v2
• 本地開發時直接跑 ./dev.sh 或 wails dev

基本流程就是：輸入 prompt -> 選美術風格 -> 生成 base -> 選擇動作與方向 -> 預覽微調 -> 直接匯出。

什麼時候該用它？

這工具最適合放在「資產定稿前」的階段。當你已經確定角色的風格，需要開始大量產出精細、frame 對齊、可以直接交付給引擎的動畫素材時，PerfectPixel 就是首選。

---

2. Agent Sprite Forge：讓複數 Agent 來控管你的資產管線

相較於 PerfectPixel 專注在成品精度，Agent Sprite Forge 走的是「Agent 流程驅動」路線。

它的核心思路是：如果我不想手動操作 GUI，能不能讓 Codex 的複數 Agent 幫我搞定規劃、生成、清理、驗證、到匯出的整條 2D 資產管線？

因此它處理的範圍比 PerfectPixel 更廣，甚至包含了：

• 帶有圖層的地圖（layered maps）
• 透明去背的道具（props）
• 快速驗證的 engine-ready prototype
• Godot 或 Unity 的自動綁定（wiring）

它在 Codex 裡註冊了 generate2dsprite 和 generate2dmap 這兩個技能（skills），把素材產線拆成「角色與特效」以及「地圖與場景」兩條路來跑。

怎麼在本地跑起來

我們可以透過以下指令把 Agent Sprite Forge 的技能裝進 Codex 環境：

git clone https://github.com/0x0funky/agent-sprite-forge.git
cd ./agent-sprite-forge
python3 -m pip install -r ./requirements.txt
mkdir -p ~/.codex/skills
cp -R ./skills/* ~/.codex/skills/

這幾行指令主要是把 Agent Sprite Forge 複製到本地，裝好 Python 依賴，再把它的自訂 skill 塞進 Codex 的設定目錄。這樣一來，Codex 啟動時才能認得這些專屬的 2D 處理指令。

設定好之後，只要開啟 Codex 視窗，就能直接用語意需求去驅動這條管線。

什麼時候該用它？

它最適合放在專案的「前置探索與規劃階段」。當你需要快速鋪量、試地圖風格，或者希望讓 Agent 幫你做前置的清理與基礎去背時，這個工具能省下大量手動搬移檔案的時間。

---

3. Gorest：本地 scene 編排與 live 預覽工作台

Gorest 的卡位則偏向「本地可視化編輯器」。

它既不負責高端的 AI 去背，也不負責管線排程，它只想做好一件事：給開發者一個舒服的本地 workspace，把 scene、spritesheet、動畫 clip 全部放在一起看。

在 Gorest 裡，你可以：

• 在 2D Canvas 上自由拖拉、縮放、複製、刪除物件
• 切換不同的 scene 檔案
• 即時預覽所有 spritesheet 的 animation clip 播放效果
• 修改並保存 assets 的 metadata，建立本地複用 library

怎麼使用

基本架構是基於 Node.js 的本地 web app：

1. 安裝 Node.js 20+
2. 執行 npm install 裝好依賴
3. 啟動 app，在瀏覽器裡打開 workspace
4. 建立 scene，把背景、道具、角色擺進去，並在 Spritesheets 頁面檢查每個 clip 的播放速度與對齊

什麼時候該用它？

當你的素材都準備得差不多，想在進引擎前，先拼凑出一個簡單的 playable prototype，或者想看角色跟地圖擺在一起的視覺體感時，Gorest 的本地預覽功能就很夠用。

---

實務上的串接建議

這三個工具並沒有原生串在一起，但我們可以用開發思路把點連成線：

推薦的工作流

1. 規劃與鋪量：用 Agent Sprite Forge 讓 Codex 幫你快速生出地圖、道具草案和基本角色。
2. 精細化動畫：把決定好的角色丟給 PerfectPixel，產出高品質、去背乾淨、動作一致的 8 方向 sprite sheet。
3. 場景編排預覽：把產出的素材塞進 Gorest 拼出 scene，微調 metadata 並做 live 預覽，確認視覺體感沒問題後，再正式丟進 Godot 或 Unity 裡。

與其期待一個萬能的 AI 工具幫你搞定所有事，不如依據專案當下的痛點，把這三個工具擺在對應的階段。畢竟，在遊戲開發中，工具能幫我們省下越多的瑣碎工時，我們就有越多的精力專注在核心玩法的調校上。