SpriteSheetGen 标志SpriteSheetGen

AI 游戏素材生成:在编程助手里用 MCP

直接让你的 AI 编程助手做游戏角色和动画:SpriteSheetGen 负责生成,精灵图在你自己的电脑上打包,直接放进项目。

1. 把这句话发给 Claude Code、Codex 或其他支持 MCP 的助手

帮我安装 SpriteSheetGen:按 https://spritesheetgen.com/agents/install.txt 的步骤操作

2. 创建一个 API 密钥,然后在你自己的终端运行这条命令,按提示粘贴密钥

npx -y @spritesheetgen/cli login
创建 API 密钥密钥不会进入聊天。新密钥在你设好额度之前不能花积分。

这个 MCP 能做什么

它给你的助手提供 9 个工具。助手把你的描述生成角色图(或者给你自己画的角色做动画),一次加一个动作,再把结果打包成游戏引擎能直接读的文件:

  • sheet.png:透明背景、按网格排好的全部帧

  • sheet.json:TexturePacker 格式的 JSON,包含每帧位置和动画,Phaser 等大多数引擎都能读

  • animation.tres:Godot 4 的 SpriteFrames 资源,直接给 AnimatedSprite2D 用

  • export.json:帧尺寸、帧数和帧率;需要的话还有单帧图和预览 GIF

红披风圆盾 Q 版小骑士的 8 帧行走动画,由助手通过 MCP 生成并打包成透明背景精灵图
由助手通过这个 MCP 生成:“a small knight with a red cape and a round shield”,再加一个行走动作,导出为 8 帧透明精灵图(按一半尺寸显示)。

怎么用

1. 一句话安装

把上面的话发给助手。它会读取 install.txt,装好教它使用流程的说明(skill),并添加 MCP 服务,配置里不放密钥。

2. 给它一个有额度的密钥

在账户页创建密钥,勾选“生成角色和动作”,设好每天和总共最多花多少积分。然后在你自己的终端运行 npx -y @spritesheetgen/cli login 并粘贴密钥,它只保存在你的用户目录里。

3. 说出游戏需要什么

比如:“给我的 Godot 项目做一个骑士,要行走和攻击动画。”助手会先看你已经有什么,报价,等你同意后才花积分。

4. 文件直接进项目

每个动画导出到一个新文件夹,比如 assets/sprites/knight_walk,不会覆盖你已有的文件。

工具一览

工具积分作用
estimate_sprite免费查角色或动作的价格、余额和密钥剩余额度
create_character5根据描述生成角色图
animate_character10给角色做一个动画:行走、奔跑、待机、攻击或跳跃
get_generation免费查看生成状态和结果
list_characters免费列出你生成或上传的角色
list_actions免费列出某个角色已有的动画
improve_prompt免费把粗略的想法改写成更好生成的描述
upload_character免费上传你自己的 PNG、JPEG 或 WebP 角色图,用来做动画
export_sprite_sheet免费在本机把动画打包成精灵图

花多少积分由你控制

  • 每个密钥自己的每日和总额度是硬上限,新密钥额度为 0。

  • 每次付费调用都带着你同意的价格,价格更高就不扣费。

  • 超时后重试会沿用同一个购买标识,同一个请求不会扣两次。

  • 生成失败会退回账户积分,但不恢复密钥已消耗的额度;导出、列表和报价都免费。

手动安装

想自己配置的话(需要 Node.js 20 或更新版本):

  • Claude Code:claude mcp add spritesheetgen -s user -- npx -y @spritesheetgen/cli@latest mcp

  • Codex:codex mcp add spritesheetgen -- npx -y @spritesheetgen/cli@latest mcp

  • Cursor 和其他 MCP 客户端(mcp.json):{ "mcpServers": { "spritesheetgen": { "command": "npx", "args": ["-y", "@spritesheetgen/cli@latest", "mcp"] } } }

  • 使用说明(skill):npx -y @spritesheetgen/cli@latest skill install --dir ~/.claude/skills(或 ~/.codex/skills)

  • 密钥:npx -y @spritesheetgen/cli login

不用 MCP 也能用同样的命令:npx -y @spritesheetgen/cli --help。npm 包名是 @spritesheetgen/cli。

放进游戏引擎

  • Godot 4:把 AnimatedSprite2D 的 Sprite Frames 设成 animation.tres,播放动画即可。

  • Phaser 3:用 this.load.atlas 加载 sheet.png 和 sheet.json。

  • Unity:按 export.json 里的帧尺寸,用 Grid By Cell Size 切分 sheet.png。

  • GameMaker:使用 Import Strip,按 export.json 设置帧数、每行帧数(columns)和帧尺寸。

已经有 GIF 或视频动画?免费的 GIF 转序列帧和视频转序列帧工具可以在浏览器里打包。

常见问题

支持哪些助手?

任何支持 stdio MCP 服务的助手:Claude Code、Codex、Cursor 等。Claude Code 和 Codex 还会装上使用说明(skill),它会先报价、等你同意再花积分。

助手能看到我的 API 密钥吗?

登录流程不会把密钥传入聊天、MCP 配置或工具返回结果。密钥保存在本机用户目录;有权读取该目录的助手仍可能读取它。不要把密钥发进聊天,并只给它需要的额度。

要花多少积分?

一张角色图 5 积分,每个动画 10 积分,和网站上一样。新账号赠送 25 积分。导出、列表和报价都免费。

能给我自己画的角色做动画吗?

可以。助手可以上传你自己画的或有授权的 PNG、JPEG、WebP 图片,然后像生成的角色一样做动画。

精灵图在哪里打包?

在你自己的电脑上,用的是和网站相同的代码。服务器只负责生成角色和动画;打包、去背景和像素化都在本地完成。

助手会不会超出我允许的额度?

不会。每个密钥都有自己的每日和总额度,由服务器检查。用完后助手会收到错误,只能来问你。

更多免费精灵图工具

  • 视频转序列帧

    把 MP4 或 WebM 片段转成背景透明、已对齐的序列帧精灵图。

  • GIF 转序列帧

    把 GIF 动图拆成单帧,再拼成游戏引擎能直接用的精灵图。

  • 精灵图制作

    把多张 PNG 帧拼成一张精灵图,同时导出 JSON 图集和 Godot 资源。

  • 序列帧转 GIF

    把精灵图当作循环动画预览,并导出透明背景的 GIF。

  • 精灵图切割

    按网格把精灵图切成单独的 PNG 帧,可自动识别网格。

  • AI 精灵图生成器

    用文字描述角色,使用积分生成 AI 角色动画。