Skip to content

README.zh-CN.md

Latest commit

 

History

History
260 lines (204 loc) · 12.4 KB

README.zh-CN.md

File metadata and controls

260 lines (204 loc) · 12.4 KB

Agent Sprite Forge

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

Agent Sprite Forge banner

面向 Codex 的 2D 游戏资产技能：生成可用的角色精灵、分层地图，以及能交给游戏引擎继续编辑的原型素材。

用自然语言描述需求，Codex 负责规划资产流程，用内置图像生成产出原始视觉，再用本地处理器去背、切格、对齐、验证，并导出给 Godot、Unity 或普通 2D 游戏项目使用。

Showcase | Skills | Install | Prompts | Star History

有什么不同

Agent Sprite Forge 不是一组 prompt 模板。它是一套 Codex-first 的 2D 游戏资产工作流：agent 先判断需要什么资产、图像生成负责创作原始视觉，本地脚本只做可重复的清理、切割、对齐、验证和导出。

精灵表
角色、怪物、NPC、道具、攻击、法术、投射物、命中特效、idle、walk，以及参考图驱动的变体。		 分层地图
ground-only base、dressed reference、prop pack、透明 props、y-sort 摆放、碰撞、区域和预览图。		 引擎交付
Godot 场景、可编辑 TileMapLayer、分离式 props、遇怪草丛、碰撞体、出口和 debug player。		 本地清理
洋红去背、frame extraction、alignment、透明 PNG/GIF 导出、prop pack 切割和 QA metadata。

Showcase

Engine-Ready Prototypes

这些案例使用 Codex 和 agent-sprite-forge 工作流组装，重点是完整闭环：生成资产、结构化场景数据，以及可玩的 prototype wiring。

Summon Survivors Unity WebGL gameplay
Summon Survivors - Unity WebGL
生成地图、主角 sheet、召唤物、进化、敌人、Boss、拾取物、HUD、FX、升级选项和 WebGL 部署。
Play build | Build conversation 		Forest Pass Defense Godot tower-defense map
Forest Pass Defense - Godot Tower Defense
Godot 4 塔防原型，包含地图、分离式 props、塔位、塔、敌人 sheet、Boss、飞行敌、波次、HUD、建造 / 升级 / 出售流程和投射物规则。
Generate2DMap Godot editor scene
Editable RPG Map - Godot TileMap
图像生成 tileset 和 prop sheet，再接进可编辑 TileMapLayer、Sprite2D props、遇怪草丛 Area2D、StaticBody2D 碰撞、出口、metadata 和 debug player/camera。 		Neon Breach cyberpunk side-scroller
Neon Breach - Cyberpunk Side-Scroller
使用生成的角色、攻击、地图和 gameplay assets 组装出的可玩横向卷轴 prototype。
Sengoku Era JavaScript RPG starter selection
Sengoku Era - JavaScript monster-taming RPG
浏览器 RPG prototype，包含生成角色、初始怪物选择、地图流程和战斗 UI。
Play build 		Sengoku Era JavaScript RPG battle scene
Starter selection and battle loop
用 skill workflow 生成 sprite、monster、battle 和 map assets 后完成的小型 JavaScript 游戏展示。

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 动作 sheet 和透明导出。		 Fire mage cast animation
Spell cast
适合 bundle 的施法动画。		 Fire mage projectile animation
Projectile
匹配的 projectile / impact workflow。

Layered RPG Map Pipeline

当你需要地图而不是单独 sprite 时，使用 $generate2dmap。可读性较高的 layered raster map 目前推荐 clean hand-painted HD game-map style：先生成 ground-only base，再生成 dressed reference，接着生成 prop pack，最后做透明 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 也可以输出可编辑 Godot map project，而不是只有一张 flattened image。这个 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、遇怪草丛 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 用途 输出
generate2dsprite Sprites、animation sheets、props、spell bundles、FX、参考图变体、固定 frame sheet 的 layout guide raw sheet、cleaned transparent sheet、frames、GIFs、metadata
generate2dmap baked maps、layered raster maps、clean HD RPG maps、prop packs、collision/zones、Godot-editable scenes、side-scroll/parallax scenes base map、dressed/stage reference、prop pack、extracted props、preview、scene metadata

$generate2dmap 只有在地图流程需要可复用透明 props 时，才会搭配 $generate2dsprite。小型环境 props 可以批成 2x2、3x3 或 4x4 prop packs，再切成独立透明 props。平台、地板、桥、墙、门和长条 hazard 这类碰撞关键物件，通常应该单独生成或用 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，Codex 也可以组装 placement metadata、collision、trigger zones、Godot scenes 或 Unity project wiring。

脚本不是创意大脑。Agent 负责视觉和 pipeline 决策；Python 工具只做可重复的像素处理和导出。

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 输出：

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

地图输出取决于 pipeline：

  • Single baked map：完整地图图像、可选 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

  • 最好的结果来自明确指定视角、动作和动作节奏的 prompt。
  • 大型 creature 通常更适合 3x3 idle。
  • 小型 spell、projectile 和 impact 通常适合 2x2 或 2x3。
  • 主角攻击、射击、施法动作建议 body-only；大范围 slash、muzzle flash、projectile、impact 独立生成成 FX。
  • 商业项目请优先使用原创角色或你拥有权利的 IP。

Star History

Star History Chart

License

MIT. See LICENSE.