Community影像github.com

Sprite Forge

在本地 GPU 上免費生成 2D 遊戲素材:精靈圖、道具、圖示、UI 元件(含透明背景)、真正的像素藝術(真實網格、有限色盤)、角色 4/8 方向轉向與動畫圖集(走路、跑步、閒置、攻擊等)、根據描述為現有像素精靈添加動畫、法線貼圖、無縫地磚、頭像與 VFX 影格——輸出為遊戲就緒的 PNG、GIF 及 TexturePacker/Phaser JSON 圖集。當使用者要求建立、生成、重新生成、動畫化或修復精靈、2D 資產、像素藝術、圖示、精靈圖、角色表、走路循環、地磚或紋理、頭像、特效動畫或法線貼圖,或是檢查 PNG 時皆可使用。

Sprite Forge 是什麼?

Sprite Forge 是一款可在本地 GPU 上運行的 AI 技能,能將文字描述直接轉換為遊戲就緒的 2D 資產。它基於 ComfyUI 建構,所有處理都在本地完成,無需付費服務。此技能支援多種輸出類型,例如道具、圖示、真正的像素藝術(具有真實網格與有限色盤)、角色 4/8 方向轉向圖、動畫圖集(走路、跑步、攻擊等)、現有像素精靈的動作動畫、用於 2D 照明的法線貼圖、無縫地磚、頭像以及 VFX 影格。每次生成都會經過裁切、調整大小、品質檢查,並附帶預覽圖像與完整清單,可完美整合至遊戲引擎開發流程中。使用者可透過 MCP 工具(例如 generate_sprite、create_character、animate_pixel)或命令列使用,所有設定皆透過專案層級的 spriteforge.json 檔案儲存,確保整個遊戲的風格一致性。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Noamcelermajer/comfyui-text-to-sprite-mcp/tree/main/skills/sprite-forge

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

Sprite Forge 是做什麼的?

Sprite Forge 可將文字轉換為遊戲就緒的 2D 資產,並在此機器的 GPU 上執行(底層使用 ComfyUI;會自動啟動)。所有內容皆不會發送至付費服務。每個結果都會被裁剪出乾淨的邊緣、裁切、調整大小、檢查,並附帶清單儲存;系統會進行多次嘗試並保留最佳結果。

如何呼叫

優先使用 sprite-forge MCP 工具(當可用時): list_profiles、generate_sprite、create_character、animate_pixel、make_normal_map、get_job、check_image、models、forge_status。

否則,請從 Sprite Forge 資料夾使用命令列;每個命令會輸出一個 JSON 物件:

python forge.py profiles
python forge.py sprite  <name> "<prompt>" -p sprite --project <game folder>
python forge.py sprite  <name> "<prompt>" -p pixel_sprite --set grid=32 --set palette=project --project <game folder>
python forge.py character <id> "<who, outfit, colours, props>" --project <game folder>
python forge.py sprite  <name> -p turnaround --character <id> --set directions=8 --project <game folder>
python forge.py sprite  <name> -p animation  --character <id> --set action=walk --set facing=right --project <game folder>
python forge.py animate <name> <sprite.png> "<the motion>" --pose "<frame 1>" --pose "<frame 2>" ...
python forge.py normal  <sprite.png>
python forge.py check   <file.png> --kind sprite

退出碼 0 = 正常,2 = 已完成但結果未通過檢查,1 = 錯誤。

選擇設定檔

設定檔用途輸出
sprite道具、物品、拾取物、武器、家具、UI 元件透明 PNG,已裁切,在方形畫布上居中
icon技能/物品圖示、徽章、按鈕方形 PNG 加上 256/128/64 像素版本
pixel_sprite真正的像素藝術:角色、物品、敵人真實像素網格(例如 32 像素),硬邊 Alpha,有限或具名色盤,加上 x8 預覽
character可重複使用的角色參考圖全身透明 PNG,腳踩在地平線上
pixel_character同上,但以像素藝術風格繪製像素藝術圖集的參考
turnaround角色面向 4 或 8 個方向影格 + <name>_sheet.png + <name>.atlas.json
animation走路、跑步、閒置、攻擊、跳躍、受傷、死亡、施法影格 + 圖集 + 附帶動畫標籤的圖集
tile地面、牆壁、地板、水面、植被無縫方形紋理 + 3x3 平鋪預覽(可選像素版本)
portrait對話頭像、卡片、關鍵美術圖全解析度影像
vfx爆炸、煙霧、魔法爆發、打擊火花影格 + 圖集 + 圖集;亮度即透明度
animate_pixel(工具)根據描述為現有像素精靈添加動畫在精靈自身網格與色盤上的影格 + 圖集 + GIF

每個圖集也會生成 <name>.gif(循環播放),方便使用者觀看。

每種設定檔都有三個預設:fast(一次快速嘗試)、standard(預設值)、max(使用較大模型或更多嘗試;轉向/動畫使用 Qwen-Image-Edit)。請註明你使用了哪個預設。

工作流程

  1. 始終傳遞遊戲專案資料夾(project_dir / --project)。其 spriteforge.json 提供了樣式、輸出資料夾、角色資料夾以及每個設定檔的設定,以保持遊戲美術風格一致。如果它沒有此檔案,請主動建立一個(forge.py init <dir>)。
  2. 按照設定檔的 prompt_guide 編寫提示(list_profiles 會回傳)。描述物件本身,而非圖片:不要寫「一個精靈圖」,不要寫背景,提示中不要出現鏡頭用語——請使用 params.view 設定角度(front view、side view、top-down view、isometric view)。
  3. 若角色會出現多次:請先建立它。 create_character(或使用設定了 character 的 character 設定檔)會儲存參考;轉向和動畫是基於它的編輯,因此角色能保持統一外觀。對於像素藝術圖集,請使用 profile: "pixel_character" 並傳遞 params.pixel_grid(例如 32)給圖集。
  4. 較長的任務是非同步的。 如果工具回傳了一個任務 ID,請呼叫 get_job 並設定 wait_seconds: 50,直到狀態不再是 queued 或 running。一次只能執行一個任務。
  5. 檢視預覽圖。 每個結果都會附帶一張預覽圖像(在棋盤格背景上的精靈)。在確認資產完成前請務必檢查:主體是否錯誤、是否被裁切、是否包含第二個物體、是否有光暈、影格是否不是同一個角色。回報該檔案、其尺寸、任何 problems,並提及 .spriteforge/<name>/ 中的其他嘗試。

像素藝術

  • 影像模型只會繪製像素藝術風格;Sprite Forge 會將其變為真正的像素藝術:它會找出模型的像素網格(或強制設定 grid),取每個儲存格的主色,移除雜散像素,讓 Alpha 通道完全開/關,並限制色盤。未經此步驟,切勿聲稱某個精靈是像素藝術。
  • grid:精靈最長邊的像素值(16、24、32、48、64)。設定為 "auto" 則保留模型繪製的像素大小。
  • palette:pico8、gameboy、nes、endesga32、sweetie16、一組十六進制顏色列表,或**"project"**——為整個遊戲凍結一個色盤(由第一個像素資產儲存為專案中的 palette.hex,後續所有資產皆重複使用)。對於一個遊戲,請使用 "project"。
  • outline: true 會添加 1 像素的深色外框;canvas: 32 會將精靈放置於 32x32 的網格上。
  • 不套用遞色(因為會導致動畫閃爍)。

為現有像素精靈添加動畫

當使用者已有像素精靈(自己的,或使用 pixel_sprite 製作的)並描述一個動作時,請使用 animate_pixel:例如「讓史萊姆彈跳」、「讓騎士揮劍」。它會在每個影格中保留精靈的準確像素尺寸和色盤。

  • image:PNG 圖像(原始尺寸最多 256 像素,或經過放大且像素硬邊的副本)。
  • description:動作描述。walk / run / idle / attack / jump / hurt / death / cast 會使用內建的關鍵姿勢。
  • 對於其他動作,請自行編寫 poses:每個影格用一行簡短的文字說明變化,例如劍擊 ["將劍高舉過頭頂", "劍在頂點,身體向後傾", "將劍向下揮至身前", "攻擊後劍已放低"]。3-6 個影格效果最佳。這些是關鍵姿勢,而非中間影格。
  • params.include_original: true 會將未修改的精靈作為第 0 影格;params.fps。
  • 檢視 GIF / 預覽:如果某個影格遺失或改變了精靈的一部分,請使用新的 seed 或 preset: "max"(每個影格更多嘗試)重新執行。

法線貼圖(2D 照明)

針對使用 2D 光照的遊戲(Godot CanvasTexture + Light2D、Unity 2D 光照、Phaser light2d),請傳遞 params.normal_map: true 給 sprite、icon、pixel_sprite、character、turnaround、animation 或 animate_pixel,或是在任何現有 PNG 上呼叫 make_normal_map。

  • 寫入 <name>_normal.png(或 <name>_sheet_normal.png,佈局與圖集相同)以及 <name>_lit_preview.png(從左、上、右、下方向打光的精靈預覽)——請向使用者展示預覽圖。
  • 像素藝術會保留其像素網格,並具有清晰、對齊的法線。
  • 預設慣例為 OpenGL(綠色 = 向上),Godot 和 Unity 使用此慣例;若為 DirectX 則設定 normal_y: "down" / y: "down"。normal_strength 0.5 為輕微,2 為強烈。
  • 浮雕是從繪圖中推斷得出的(輪廓、顏色區域、亮部),並非實際建模:它在動態光源下表現良好,但並非真實的深度掃描。

當結果顯示 failed_check

檔案已寫入,但不應直接使用。problems 會說明原因。

問題修復方式
cut off使用新的 seed 重新執行;加入 "small, centred, with space around it" 或提高 params.padding。
several objects僅命名一個物件;使用新的 seed 重新執行。
background not removed / empty描述一個實心物體;保持 background 簡單;重新執行。
may not look like the character(圖集)使用新的 seed 或 preset: "max" 重新執行該圖集;保持角色提示簡單。
may not have turned(轉向)使用 preset: "max" 重新執行(Qwen-Image-Edit 能更好地跟隨視角變化)。
no clear pixel grid found圖片並非以像素藝術方式繪製:將 grid 設定為一個數字,或重新執行。
visible seam(地磚)使用有機表面或提高 params.blend;重新執行。
much smaller than the original(animate_pixel)該影格遺失了精靈的一部分:使用新的 seed 重新執行,或提供更清晰的姿勢。
flat: almost a single colour模型繪製了一個剪影:使用新的 seed 重新執行;並加上「使用全彩」的描述。

相同的 name 加上相同的設定會回傳現有檔案;更改設定、seed,或傳遞 force: true 以生成新檔案。

自訂

  • 每個專案:spriteforge.json(style、style_preset、output_dir、characters_dir、profiles.<id>.params,例如 {"pixel_sprite": {"params": {"grid": 32, "palette": "project"}}})。
  • 每次呼叫:params,例如 {"size": 256, "candidates": 6, "view": "side view", "directions": 4, "action": "attack", "facing": "down"}。list_profiles 會列出每個參數並附帶說明。
  • 新增設定檔:在專案的 spriteforge_profiles/ 目錄下建立一個小的 JSON 檔案,並 extends 其中一個設定檔。
  • 模型與硬體:models 工具會報告每個設定檔和預設需要哪些模型以及缺少哪些模型。下載檔案很大——請先詢問使用者再進行安裝。
  • 授權:Sprite Forge 安裝的每個模型均允許對您製作的內容進行商業使用(FLUX.2 Klein 4B、Z-Image Turbo、Qwen-Image-Edit 2511 以及像素 LoRA:Apache 2.0;BiRefNet 和 CLIP:MIT)。部分商店(例如 Steam、itch.io)會要求您揭露 AI 生成的資產。

相關技能