Agent Sprite Forge

May 5, 2026 · View on GitHub

言語：English | 繁體中文 | 简体中文 | 日本語 | 한국어

Agent Sprite Forge banner

Codex 向けの 2D ゲームアセット Skill。ゲームで使えるスプライト、レイヤー化されたマップ、エンジンへ渡せるプロトタイプ素材を生成します。

自然言語で依頼すると、Codex がアセット制作パイプラインを設計し、内蔵画像生成で元画像を作り、ローカル処理で背景除去、フレーム分割、整列、検証、Godot / Unity / 通常の 2D ゲーム向けエクスポートを行います。

Showcase | Skills | Install | Prompts | Star History

何が違うのか

Agent Sprite Forge は単なる prompt 集ではありません。Codex-first の 2D ゲームアセット制作ワークフローです。Agent が必要なアセットと手順を判断し、画像生成がビジュアルを作り、決定論的なローカルスクリプトが再利用可能なゲーム素材へ整えます。

スプライトシート
キャラクター、モンスター、NPC、props、攻撃、魔法、投射物、impact、idle、walk、参照画像ベースの派生。		 レイヤー化マップ
ground-only base、dressed reference、prop pack、透明 props、y-sort 配置、collision、zones、preview。		 エンジン連携
Godot scenes、編集可能な TileMapLayer、分離 props、エンカウント草むら、collision bodies、exits、debug player。		 ローカル処理
マゼンタ背景除去、frame extraction、alignment、透明 PNG/GIF 出力、prop-pack slicing、QA metadata。

Showcase

Engine-Ready Prototypes

以下は Codex と agent-sprite-forge workflow で組み立てた例です。生成アセット、構造化されたシーンデータ、実際に遊べる prototype wiring までを示します。

Summon Survivors Unity WebGL gameplay
Summon Survivors - Unity WebGL
マップ、hero sheets、summons、evolutions、enemies、bosses、pickups、HUD、FX、level-up choices、WebGL deployment を生成。
Play build | Build conversation 		Forest Pass Defense Godot tower-defense map
Forest Pass Defense - Godot Tower Defense
Godot 4 のタワーディフェンス prototype。マップ、分離 props、tower slots、towers、enemy sheets、boss/flying enemies、waves、HUD、build/upgrade/sell flow、projectiles を含みます。
Generate2DMap Godot editor scene
Editable RPG Map - Godot TileMap
画像生成した tileset と prop sheet を、編集可能な TileMapLayer、Sprite2D props、草むら Area2D、StaticBody2D collision、exits、metadata、debug player/camera に接続。 		Neon Breach cyberpunk side-scroller
Neon Breach - Cyberpunk Side-Scroller
生成された character、attack、map、gameplay assets を使った、プレイ可能な横スクロール prototype。
Sengoku Era JavaScript RPG starter selection
Sengoku Era - JavaScript monster-taming RPG
生成キャラクター、starter selection、map flow、battle UI を含むブラウザ RPG prototype。
Play build 		Sengoku Era JavaScript RPG battle scene
Starter selection and battle loop
sprite、monster、battle、map assets を skill workflow で生成して組み立てたコンパクトな JavaScript game showcase。

Sprite Sheets And FX

アニメーションユニット、プレイヤーキャラクター、モンスター、props、spell bundles、projectile/impact FX、参照画像ベースの派生が必要な場合は $generate2dsprite を使います。

Goku Kamehameha sprite animation
Text to sprite
自然言語から攻撃アニメーションを生成。		 Naruto Rasengan sprite animation
Character action
透明出力つきのコンパクトな 2D action sheet。		 Fire mage cast animation
Spell cast
bundle に使いやすい cast animation。		 Fire mage projectile animation
Projectile
対応する projectile / impact workflow。

Layered RPG Map Pipeline

スプライト単体ではなくマップが必要な場合は $generate2dmap を使います。読みやすい layered raster map では、clean hand-painted HD game-map style を推奨します。ground-only base、dressed reference、prop pack、transparent prop extraction、layered preview composition の順に進みます。

Ground-only cyberpunk canal RPG base map
Ground-only base		 Dressed cyberpunk canal reference map
Dressed reference		 Generated 3x3 cyberpunk canal prop pack
3x3 prop pack

Layered cyberpunk canal RPG map preview
Flattened layered RPG map preview 

layered_raster + y_sorted_props + precise_shapes + trigger_zones + raw_canvas

Godot Editable TileMap Export

$generate2dmap は、1 枚の flattened image だけではなく、編集可能な Godot map project も出力できます。この showcase では、画像生成した tileset と 3x3 prop sheet を Godot 4.5 scene に接続しています。

Generate2DMap Godot editor scene with editable TileMapLayer and nodes
Godot editor scene: editable layers, props, zones, collision, exits, and debug player

Godot 出力には、編集可能な TileMapLayer nodes、独立した Sprite2D props、encounter grass Area2D zones、StaticBody2D collision blockers、exit Area2D zones、debug player/camera を含められます。

image_gen tileset + prop_pack_3x3 + layered_tilemap + separate_props + trigger_zones + Godot_TileMap

Included Skills

Skill用途出力
generate2dspritesprites、animation sheets、props、spell bundles、FX、reference variants、fixed-frame sheets 用 layout guidesraw sheet、cleaned transparent sheet、frames、GIFs、metadata
generate2dmapbaked maps、layered raster maps、clean HD RPG maps、prop packs、collision/zones、Godot-editable scenes、side-scroll/parallax scenesbase map、dressed/stage reference、prop pack、extracted props、preview、scene metadata

$generate2dmap は、選ばれた map pipeline が再利用可能な透明 props を必要とする場合だけ $generate2dsprite を併用します。小さな環境 props は 2x2、3x3、4x4 の prop pack にできます。一方、platform、floor、bridge、wall、door、long hazard のような collision-critical object は、個別生成または tile/object layer として扱うのが安全です。

How It Works

  1. ユーザーが Codex に sprite、prop pack、map、engine-ready prototype を依頼します。
  2. Agent が asset type、action、bundle shape、sheet layout、frame count、style、alignment strategy を決めます。
  3. 内蔵画像生成が raw visual asset を作ります。
  4. ローカルスクリプトが deterministic post-processing を行います：chroma-key cleanup、despill、frame extraction、alignment、prop-pack slicing、GIF/PNG export、validation metadata。
  5. マップや prototype では、placement metadata、collision、trigger zones、Godot scenes、Unity project wiring も Codex が組み立てられます。

スクリプトは創造部分を担当しません。視覚と pipeline の判断は Agent が行い、Python tools は再現可能な pixel/export 処理だけを担当します。

Install

Windows PowerShell

git clone https://github.com/0x0funky/agent-sprite-forge.git
cd .\agent-sprite-forge
python -m pip install -r .\requirements.txt
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex\skills" | Out-Null
Copy-Item -Recurse -Force `
  ".\skills\*" `
  "$env:USERPROFILE\.codex\skills\"

macOS / Linux

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/

インストール後は、新しい Codex session を開始して skills を読み込み直してください。

Suggested Prompts

Sprite

Use $generate2dsprite to create a 3x3 idle for an ultimate earth titan.

Use $generate2dsprite to create a side-view lightning knight attack animation.

Use $generate2dsprite to create a wizard spell bundle with cast, projectile, and impact sprites.

Map

Use $generate2dmap to create a Godot-editable RPG map with separated props, encounter grass Area2D zones, collision StaticBody2D blockers, exit zones, and a debug player scene.

Use $generate2dmap to create a playable side_scroll_mode platformer stage with parallax layers, stage-reference, separate platform_objects, collision metadata, camera bounds, and a stage-preview.

What You Get

典型的な sprite sheet output：

  • raw-sheet.png
  • raw-sheet-clean.png
  • sheet-transparent.png
  • frame PNGs
  • animation.gif
  • prompt-used.txt
  • pipeline-meta.json

map output は pipeline によって変わります：

  • Single baked map：完成した map image、任意の prompt file、任意の collision metadata。
  • Layered raster map：base map、dressed reference、prop folders または prop-pack extraction manifest、prop placement metadata、collision/zones metadata、flattened layered preview。
  • Side-scroll map：parallax layers、stage reference、separate platform/object assets、objects/collision metadata、camera bounds、stage preview。
  • Godot editable map：tileset/prop assets、scene files、layer metadata、collision/zones、exits、debug player setup。

Notes

  • 視点、動作、モーションの雰囲気を明確に書くほど結果が安定します。
  • 大型 creature には 3x3 idle が向いています。
  • 小さな spell、projectile、impact は 2x2 または 2x3 が向いています。
  • hero の attack/shoot/cast は body-only を推奨します。大きな slash、muzzle flash、projectile、impact は別 FX として生成します。
  • 商用利用では、オリジナルキャラクターまたは権利を持つ IP を優先してください。

Star History

Star History Chart

License

MIT. See LICENSE.