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)。使用したプリセットを明記してください。
ワークフロー
- 常にゲームプロジェクトフォルダを渡してください(
project_dir/--project)。その中のspriteforge.jsonがスタイル、出力フォルダ、キャラクターフォルダ、プロファイルごとの設定を提供し、ゲームのアートを一貫させます。存在しない場合は、作成を提案してください(forge.py init <dir>)。 - プロファイルの
prompt_guideに従ってプロンプトを書いてください(list_profilesが返します)。もの自体を説明し、絵を説明しないでください:「a sprite of」は不要、背景不要、カメラ用語はプロンプトに入れないでください - 角度はparams.viewで設定します(front view、side view、top-down view、isometric view)。 - 複数回登場するキャラクター:まずそれらを作成してください。
create_character(またはcharacterが設定されたcharacterプロファイル)はリファレンスを保存します;ターンアラウンドとアニメーションはその編集版であり、キャラクターは1つの外見を維持します。ピクセルアートシートにはprofile: "pixel_character"を使用し、シートにparams.pixel_grid(例:32)を渡してください。 - 時間のかかるジョブは非同期です。 ツールがジョブIDを返した場合は、ステータスが
queuedまたはrunningでなくなるまでwait_seconds: 50でget_jobを呼び出してください。ジョブは一度に1つだけです。 - プレビューを確認してください。 すべての結果にはプレビュー画像(チェッカーボード上のスプライト)が付属します。アセットが完了したと呼ぶ前に確認してください:誤った被写体、切り取られた部分、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_strength0.5(控えめ)~ 2(強い)。 - 凹凸は描画(アウトライン、色領域、ハイライト)から推定され、モデリングされていません:動くライトの下ではよく読めますが、実際の深度スキャンではありません。
結果がfailed_checkを示した場合
ファイルは書き込まれていますが、そのまま使用すべきではありません。problemsが理由を説明します。
| 問題 | 修正 |
|---|---|
cut off | 新しいseedで再実行。「small, centred, with space around it」を追加するか、params.paddingを上げてください。 |
several objects | 1つのオブジェクトのみ指定。新しい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生成アセットの開示を求める場合があります。