Repolode
0x0funky

0x0funky/agent-sprite-forge

一套 Agent Skill,可从一张已确认的角色定稿图生成完整的 2D 精灵动画集,输出透明帧与多种引擎格式。

Star
5,312
Fork
517
未关闭 Issue
14
最近提交
20小时前

这是什么?

Agent Sprite Forge 是一组面向 Claude Code、Codex 和 Grok 的 Agent Skill,用于生成 2D 游戏精灵。流程从角色定稿图开始,由用户确认后,智能体为每个动作(待机、行走、跑步、攻击、跳跃、受击)生成一段图生视频,再由确定性的 Python 工具完成抠像、帧对齐、循环选取、单次动作变速和打包。

图像与视频生成通过统一脚本调度:优先使用已配置的 OpenAI、Google Gemini、xAI、BytePlus 或 fal.ai 的 API Key,其次调用已登录的 Codex 或 Grok 命令行工具,最后使用代码绘制的像素图作为兜底。每段视频在采纳前需通过面积、脚部位置、角色一致性和色彩漂移等质量检查。

输出内容包括带 PNG 图集的 animation.json、VP9 透明 WebM、打包透明通道的 MP4、Godot SpriteFrames 以及 Aseprite JSON。项目还附带地图生成工具,可导出为 Tiled、Godot 4 和 LDtk 格式。

核心功能

  • 01从一张已确认的角色定稿图生成完整动作集。
  • 02使用软遮罩抠像并对齐帧,保持角色体型稳定。
  • 03通过测量选取行走、跑步、待机循环,并对单次动作重新定时。
  • 04默认提供高清成品,也可选择有限调色板的像素风格成品。
  • 05导出带 PNG 图集的 animation.json、WebM 透明视频、打包透明通道的 MP4,以及 Godot 和 Aseprite 文件。
  • 06图像与视频生成可调用已配置的 API、本地 Codex 或 Grok 命令行,或代码绘制的图形。

适用场景

  • 为 2D 平台或动作游戏,由单张概念图制作角色动画。
  • 为 Godot 或 Aseprite 项目生成精灵图和逐帧动画。
  • 用生成的角色、特效和瓦片地图快速搭建游戏原型。
  • 制作网页游戏,播放透明 WebM 或打包透明通道的 MP4 动画。

快速上手

  1. 1

    克隆仓库

    git clone https://github.com/0x0funky/agent-sprite-forge.git
  2. 2

    进入项目文件夹

    cd agent-sprite-forge
  3. 3

    安装 Python 依赖

    python -m pip install -r requirements.txt
  4. 4

    为 Codex 安装技能

    python tools/install_skills.py --apply --host codex

使用前须知

  • 视频生成需要 PATH 中有 ffmpeg 5.1 或更新版本。
  • 图像和视频片段生成需要付费服务商的 API 密钥,或已登录的 Codex 或 Grok CLI。

收录于专题

标签

常见问题

agent-sprite-forge 是什么?
一套 Agent Skill,可从一张已确认的角色定稿图生成完整的 2D 精灵动画集,输出透明帧与多种引擎格式。 Agent Sprite Forge 是一组面向 Claude Code、Codex 和 Grok 的 Agent Skill,用于生成 2D 游戏精灵。流程从角色定稿图开始,由用户确认后,智能体为每个动作(待机、行走、跑步、攻击、跳跃、受击)生成一段图生视频,再由确定性的 Python 工具完成抠像、帧对齐、循环选取、单次动作变速和打包。
agent-sprite-forge 可以免费使用吗?用的什么许可证?
agent-sprite-forge 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
agent-sprite-forge 还在维护吗?
活跃维护中。agent-sprite-forge 最近一次提交是在 2026年11月6日。
agent-sprite-forge 适合用来做什么?
为 2D 平台或动作游戏,由单张概念图制作角色动画。 为 Godot 或 Aseprite 项目生成精灵图和逐帧动画。 用生成的角色、特效和瓦片地图快速搭建游戏原型。 制作网页游戏,播放透明 WebM 或打包透明通道的 MP4 动画。
agent-sprite-forge 怎么安装和运行?
克隆仓库: git clone https://github.com/0x0funky/agent-sprite-forge.git 进入项目文件夹: cd agent-sprite-forge 安装 Python 依赖: python -m pip install -r requirements.txt 为 Codex 安装技能: python tools/install_skills.py --apply --host codex
在哪里获取 agent-sprite-forge?
源代码和安装说明在 GitHub 上:https://github.com/0x0funky/agent-sprite-forge

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目