用途:为 SpriteCook 中已有素材生成短动画,支持像素风与精细两种模式,适合游戏角色或物体的待机、行走、攻击等动作制作。
主要能力:核心工具为 animate_game_art,参数包括 asset_id(必填,已有素材 ID)、prompt(必填,描述随时间变化的动作)、auto_enhance_prompt(默认 true,可自动扩展简短提示)、edge_margin(默认 6)、pixel(可选模式覆盖)、output_frames(默认 8,像素支持 2-16,精细支持 2-24)、output_format(webp、gif 或 spritesheet)、negative_prompt、matte_color(默认 #808080)、removebg(None/Basic/Pro)、colors(默认 24,仅 pixel=true 时有效)。工具立即返回任务,需按返回的 poll.tool 与 poll.arguments 轮询,不要保持请求打开。用 check_job_status 配合 job_id 查询结果,成功后使用 asset_id 与规范 sprite_url,仅在存在时使用 spritesheet_url;若返回 warning.code="asset_output_unavailable",执行其提供的 warning.recovery 调用。
使用方式:需先将 SpriteCook MCP 服务器连接到编辑器,可用 npx spritecook-mcp setup 或访问 spritecook.ai。已有素材直接传 asset_id;仅有本地图片路径时用 spritecook-upload-assets 调用 create_asset_upload 上传字节再 finalize_asset_upload;提供小 data URL 或原始 base64 时先调用 import_asset 获取 asset_id。上传/导入只是素材进入 SpriteCook 的步骤,不是动画调用本身。
一致性规则:始终对代表目标角色或物体的同一素材做动画;同一角色多个动作应对同一 asset_id 分别运行 Idle、Walk、Attack 等任务,不要为每个动作新建静帧,除非用户明确想要不同角色设计。
来源规则:256x256 及以下用像素动画,256x256 至 2048x2048 用精细动画,不要把小于 256 的源强制为精细模式;默认保持 edge_margin=6。
提示词写法:先查看实际源角色,像素图可用最近邻放大到约 1024x1024 仅供查看;先识别轮廓、护甲、面罩、武器、盾牌、姿势与朝向,只写源图中真实可见的细节;用一段简短散文而非标签列表,描述什么在动、如何动、什么保持稳定、道具或武器如何使用,动作应基于现有角色,不要凭空添加装备或特效。避免泛泛的 idle animation,除非 auto_enhance_prompt=true。
限制:资料未提供收费、价格、平台支持范围与效果保证等信息。