MCP 服务 + 命令行
在 Claude Code、Codex 或 Cursor 里说出你要的角色和动作,SpriteSheetGen 生成后把精灵图、JSON 图集和 Godot SpriteFrames 文件直接放进你的项目。
以上行走动画均由 SpriteSheetGen 制作(小骑士的形象是我们的 logo 原画,只有动画是生成的)。
帮我安装 SpriteSheetGen:按 https://spritesheetgen.com/agents/install.txt 的步骤操作
它会添加 MCP 服务,并装好一份说明(skill),里面写了工具用法、额度规则和各引擎的导入方法。npx -y @spritesheetgen/cli loginclaude mcp add spritesheetgen -s user -- npx -y @spritesheetgen/cli mcpcodex mcp add spritesheetgen -- npx -y @spritesheetgen/cli mcp{
"mcpServers": {
"spritesheetgen": {
"command": "npx",
"args": ["-y", "@spritesheetgen/cli", "mcp"]
}
}
}需要 Node.js 20 或更新版本。服务通过 stdio 通信,读取 login 保存的密钥(或环境变量 SPRITESHEETGEN_API_KEY),之后再登录也不用重启。
| 工具 | 积分 | 作用 |
|---|---|---|
estimate_sprite | 免费 | 查询生成角色或动作的价格、你的余额和密钥剩余额度 |
improve_prompt | 免费 | 把粗略的想法改写成容易生成好的角色描述(每天有少量免费次数) |
create_character | 付费 | 根据描述生成一张角色图 |
upload_character | 免费 | 改用你自己的 PNG、JPEG 或 WebP 角色图 |
animate_character | 付费 | 为角色生成一个动作:walk(走)、run(跑)、idle(待机)、attack(攻击)或 jump(跳) |
get_generation | 免费 | 查看生成任务的状态和结果,可以等待完成 |
list_characters | 免费 | 列出你生成或上传过的角色 |
list_actions | 免费 | 列出角色已有的动画,避免重复付费 |
export_sprite_sheet | 免费 | 把完成的动画(或本地 GIF)打包到你电脑上的文件夹 |
助手会先报价,经你同意后才消费积分。每次付费调用都带 max_credits 上限和 client_key,重试同一请求不会重复扣费。新账户赠送 25 积分,当前价格见价格页。
不用 MCP 也能用同样的功能,加 --json 方便脚本处理:
spritesheetgen estimate --description "a small beetle knight" --json
spritesheetgen character --description "a small beetle knight" --client-key my-key-0001 --max-credits 5 --json
spritesheetgen animate --reference generation:CHARACTER_ID --action walk --client-key my-key-0002 --max-credits 10 --json
spritesheetgen export --id ANIMATION_ID --out ./assets/beetle-walk --name walk --individual-frames --preview --json
打包你已有的 GIF 不需要密钥,也不花积分:
npx -y @spritesheetgen/cli export --file ./walk.gif --out ./assets/walk --name hero_walk --preview
示例导出:小骑士在绿幕上的行走动画,由命令行打包(去背景、清理边缘、对齐帧)。
| 文件 | 用途 |
|---|---|
sheet.png | 任何引擎:帧排成一行或网格,透明背景 |
sheet.json | Phaser、PixiJS 等读取 TexturePacker JSON(hash)的引擎,带 animations 段 |
animation.tres | Godot 4:给 AnimatedSprite2D 用的 SpriteFrames 资源,已设好速度和循环 |
preview.gif | 快速预览 |
export.json | 本次使用的设置,方便重复导出 |
frames/*.png | Unity、GameMaker 等需要单张图片的工具(--individual-frames) |
this.load.atlas("knight", "sheet.png", "sheet.json");
this.anims.create({
key: "walk",
frames: this.anims.generateFrameNames("knight", { prefix: "knight_walk_", end: 11, zeroPad: 2 }),
frameRate: 14,
repeat: -1,
});
把 sheet.png 和 animation.tres 放在同一个文件夹,添加一个 AnimatedSprite2D,把 animation.tres 拖到它的 Sprite Frames 属性上。
以上功能在 spritesheetgen.com 上都能用,另有在你设备上运行的免费工具:视频转精灵图、GIF 转精灵图、精灵图制作、精灵图切割和精灵图转 GIF。