Community画像github.com

スプライトフォージ

ローカル環境で無料で2Dゲームアートを生成します。スプライト、プロップ、アイテム、アイコン、UI要素(透明背景)、本物のピクセルアート(実際のグリッド、限定パレット)、4/8方向ターンアラウンド付きキャラクター、アニメーションスプライトシート(歩く、走る、待機、攻撃など)、既存ピクセルスプライトの説明からのアニメーション化、2Dライティング用ノーマルマップ、シームレスタイル、ポートレート、VFXフレームを生成。ゲームで使えるPNG、GIF、TexturePacker/Phaser JSONアトラスとして出力します。

スプライトフォージ とは?

Sprite Forgeは、開発者のマシン上のGPU(ComfyUIを自動起動)を使って、テキスト説明からゲーム対応の2Dアセットを生成するAIエージェントスキルです。有料サービスにデータを送信することなく、完全にローカルで動作します。スプライト、アイコン、ピクセルアート、キャラクター(4/8方向ターンアラウンド)、アニメーションスプライトシート(歩く、走る、待機、攻撃など)、シームレスタイル、ポートレート、VFXフレーム、ノーマルマップなど、幅広い2Dアセットを生成できます。特に、実際のピクセルグリッドと限定パレットを使用した本物のピクセルアートの生成、既存のピクセルスプライトの説明からのアニメーション化、2Dライティング用のノーマルマップ生成などの高度な機能を備えています。結果はすべて自動でクロップ、サイズ調整、チェックされ、マニフェストとともに保存され、複数のテイクから最良のものが選択されます。CLIコマンドとMCPツールの両方をサポートしており、ゲームプロジェクトフォルダを指定することで一貫したアートスタイルを維持できます。

対応~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に質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Sprite Forge

Sprite Forge は、このマシンのGPU上でテキストをゲーム対応の2Dアセットに変換します(内部でComfyUIを使用;自動的に起動されます)。有料サービスにデータが送信されることはありません。すべての結果はきれいに切り抜かれ、クロップされ、サイズ調整され、チェックされ、マニフェストとともに保存されます。複数のテイクが行われ、最良のものが保持されます。

呼び出し方

利用可能な場合は、sprite-forge MCPツールを優先してください: list_profiles, generate_sprite, create_character, animate_pixel, make_normal_map, get_job, check_image, models, forge_status。

それ以外の場合は、Sprite Forgeフォルダからコマンドラインを使用します。すべてのコマンドは1つの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 = OK、2 = 完了したが結果がチェックに失敗、1 = エラー。

プロファイルの選択

プロファイル用途出力
spriteプロップ、アイテム、取得アイテム、武器、家具、UIパーツ透明PNG、クロップ済み、正方形キャンバスに中央配置
iconスキル/アイコン、バッジ、ボタン正方形PNGと256/128/64pxバージョン
pixel_sprite本物のピクセルアート:キャラクター、アイテム、敵実際のピクセルグリッド(例:32px)、ハードアルファ、限定または名前付きパレット、x8プレビュー付き
character再利用可能なキャラクターのリファレンス全身透明PNG、足が地面ラインに配置
pixel_character同様。ピクセルアートスタイルで描画ピクセルアートシート用リファレンス
turnaroundキャラクターが4または8方向向いたものフレーム + <name>_sheet.png + <name>.atlas.json
animation歩く、走る、待機、攻撃、ジャンプ、ダメージ、死亡、キャストフレーム + シート + アニメーションタグ付きアトラス
tile地面、壁、床、水、草シームレスな正方形テクスチャ + 3x3タイルプレビュー(オプションでピクセル版)
portrait会話ポートレート、カード、キーアートフル解像度画像
vfx爆発、煙、魔法のバースト、ヒットスパークフレーム + シート + アトラス;明るさ=透明度
animate_pixel (ツール)説明から既存のピクセルスプライトをアニメーション化スプライト自身のグリッドとパレットのフレーム + シート + アトラス + GIF

すべてのシートには <name>.gif(ループ)も付属するので、ユーザーは確認できます。

各プロファイルには3つのプリセットがあります:fast(1回のクイックテイク)、standard(デフォルト)、max(より大きなモデルまたはより多くのテイク;ターンアラウンド/アニメーションにはQwen-Image-Edit)。使用したプリセットを明記してください。

ワークフロー

  1. 常にゲームプロジェクトフォルダを渡してください(project_dir / --project)。その中のspriteforge.jsonがスタイル、出力フォルダ、キャラクターフォルダ、プロファイルごとの設定を提供し、ゲームのアートを一貫させます。存在しない場合は、作成を提案してください(forge.py init <dir>)。
  2. プロファイルのprompt_guideに従ってプロンプトを書いてください(list_profilesが返します)。もの自体を説明し、絵を説明しないでください:「a sprite of」は不要、背景不要、カメラ用語はプロンプトに入れないでください - 角度はparams.viewで設定します(front view、side view、top-down view、isometric view)。
  3. 複数回登場するキャラクター:まずそれらを作成してください。 create_character(またはcharacterが設定されたcharacterプロファイル)はリファレンスを保存します;ターンアラウンドとアニメーションはその編集版であり、キャラクターは1つの外見を維持します。ピクセルアートシートにはprofile: "pixel_character"を使用し、シートにparams.pixel_grid(例:32)を渡してください。
  4. 時間のかかるジョブは非同期です。 ツールがジョブIDを返した場合は、ステータスがqueuedまたはrunningでなくなるまでwait_seconds: 50でget_jobを呼び出してください。ジョブは一度に1つだけです。
  5. プレビューを確認してください。 すべての結果にはプレビュー画像(チェッカーボード上のスプライト)が付属します。アセットが完了したと呼ぶ前に確認してください:誤った被写体、切り取られた部分、2つ目のオブジェクト、ハロー、同じキャラクターでないフレーム。ファイル、そのサイズ、problemsがあれば報告し、.spriteforge/<name>/内の他のテイクについて言及してください。

ピクセルアート

  • 画像モデルはピクセルアートスタイルのみを描画します;Sprite Forgeはそれを本物にします:モデルのピクセルグリッドを見つけ(またはgridを強制)、各セルの支配的な色を取得し、浮遊ピクセルを除去し、アルファを完全にオン/オフにし、パレットを制限します。このステップなしでスプライトがピクセルアートであると主張しないでください。
  • grid:スプライトの最長辺のピクセル数(16、24、32、48、64)。"auto"はモデルが描画したピクセルサイズを維持します。
  • palette:pico8、gameboy、nes、endesga32、sweetie16、16進数カラーのリスト、または**"project"** - ゲーム全体で固定された1つのパレット(最初のピクセルアセットによってプロジェクトにpalette.hexとして保存され、後続のすべてのアセットで再利用されます)。ゲームの場合は"project"を使用してください。
  • outline: trueは1ピクセルの暗いアウトラインを追加します;canvas: 32はスプライトを32x32グリッドに配置します。
  • ディザリングは適用されません(アニメーションでちらつきます)。

既存のピクセルスプライトをアニメーション化する

ユーザーがすでにピクセルスプライト(自分で作ったもの、またはpixel_spriteで作ったもの)を持っており、動作を説明する場合にanimate_pixelを使用します:「スライムをバウンドさせる」、「騎士が剣を振っているアニメーション」。すべてのフレームでスプライトの正確なピクセルサイズとパレットを維持します。

  • image:PNG(ネイティブサイズ最大256px、またはハードピクセルで拡大されたコピー)。
  • description:動作。walk / run / idle / attack / jump / hurt / death / cast は組み込みのキーポーズを使用します。
  • それ以外の場合はposesを自分で書いてください:フレームごとに1行の短い説明で何が変わるかを示します。例えば、剣のスイングの場合 ["raising the sword high above his head", "the sword at the top, body leaning back", "swinging the sword down in front of him", "the sword low after the strike"]。3~6フレームが最適です。これらはキーポーズであり、中間フレームではありません。
  • params.include_original: trueは未編集のスプライトをフレーム0として含めます;params.fps。
  • GIF/プレビューを確認してください:フレームがスプライトの一部を失ったり変更した場合は、新しいseedまたはpreset: "max"(フレームあたりのテイク数増加)で再実行してください。

ノーマルマップ(2Dライティング)

2Dライトを使用するゲーム(Godot CanvasTexture + Light2D、Unity 2Dライト、Phaser light2d)の場合、sprite、icon、pixel_sprite、character、turnaround、animation、animate_pixelにparams.normal_map: trueを渡すか、既存の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 objects1つのオブジェクトのみ指定。新しい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で再実行。「in full colour」と指定してください。

同じ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生成アセットの開示を求める場合があります。

関連スキル