spritecook-animate-assets

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

SpriteCook Animate Assets

SpriteCook 资产动画制作

Use this skill for animation workflows. Pair it with

spritecook-workflow-essentials

for credits, manifests, safe downloads, and shared defaults.

Requires: SpriteCook MCP server connected to your editor. Set up with

npx spritecook-mcp setup

or see spritecook.ai.

本技能用于动画工作流。可搭配

spritecook-workflow-essentials

使用，获得积分、清单、安全下载和共享默认配置功能。

要求： 你的编辑器已连接SpriteCook MCP服务器。可通过

npx spritecook-mcp setup

完成配置，或访问spritecook.ai查看详情。

Tool

工具

animate_game_art

animate_game_art

Animate an existing SpriteCook asset into a short pixel-art or detailed animation.

Parameter	Type	Default	Description
`asset_id`	string (required)	-	Existing SpriteCook asset ID to animate
`prompt`	string (required)	-	Describe the exact motion over time. If `auto_enhance_prompt=true` , simple prompts like "Idle" or "Attack" are acceptable
`auto_enhance_prompt`	bool	true	Inspect the source asset and expand short prompts into a fuller animation prompt
`edge_margin`	int	6	Adds spacing on all sides before animation framing
`pixel`	bool	null	Optional mode override. If omitted, SpriteCook infers the mode from the asset
`output_frames`	int	8	Even frame count. Pixel supports 2-16, detailed supports 2-24
`output_format`	string	"webp"	"webp", "gif", or "spritesheet"
`negative_prompt`	string	null	Optional motion/content exclusions
`matte_color`	string	"#808080"	Hex matte color used before processing transparency
`removebg`	string	"Basic"	"None", "Basic", or "Pro"
`colors`	int	24	Pixel palette size. Only valid when `pixel=true`

将现有SpriteCook资产制作为短像素艺术动画或精细动画。

参数	类型	默认值	描述
`asset_id`	字符串（必填）	-	待制作动画的现有SpriteCook资产ID
`prompt`	字符串（必填）	-	精确描述随时间变化的动作。如果 `auto_enhance_prompt=true` ，可使用如「Idle」「Attack」这类简单提示词
`auto_enhance_prompt`	布尔值	true	检测源资产内容，将简短提示词扩展为更完整的动画提示词
`edge_margin`	整数	6	动画构图前在所有边缘添加留白
`pixel`	布尔值	空	可选模式强制切换参数。如果省略，SpriteCook会根据资产自动推断模式
`output_frames`	整数	8	偶数帧数。像素模式支持2-16帧，精细模式支持2-24帧
`output_format`	字符串	"webp"	可选值："webp"、"gif" 或 "spritesheet"
`negative_prompt`	字符串	空	可选，指定要排除的动作/内容
`matte_color`	字符串	"#808080"	处理透明度前使用的十六进制遮罩色
`removebg`	字符串	"Basic"	可选值："None"、"Basic" 或 "Pro"
`colors`	整数	24	像素模式调色板大小。仅当 `pixel=true` 时生效

Workflow

工作流

If the user already has a SpriteCook asset, pass its
```
asset_id
```
directly to
```
animate_game_art
```
.
If the user only has a local image file or data URL, import it through an authenticated helper that returns an
```
asset_id
```
.
Use the returned
```
asset_id
```
in
```
animate_game_art
```
.
Keep
```
pixel
```
omitted unless you need to force a mode.

The import step is where the source image enters SpriteCook. It is not the animation call itself.

如果用户已有SpriteCook资产，直接将其
```
asset_id
```
传给
```
animate_game_art
```
即可。
如果用户只有本地图片文件或数据URL，需通过已认证的辅助工具导入，返回
```
asset_id
```
。
将返回的
```
asset_id
```
传入
```
animate_game_art
```
使用。
除非需要强制指定模式，否则请省略
```
pixel
```
参数。

导入步骤是源图像进入SpriteCook的环节，它本身不是动画调用步骤。

Source Rules

源文件规则

Pixel animation is the correct choice for assets up to
```
256x256
```
.
Detailed animation is the correct choice for assets between
```
256x256
```
and
```
2048x2048
```
.
Do not force a sub-256 source into detailed mode.
Keep
```
edge_margin=6
```
by default. It helps prevent pixel art from crowding the canvas edge.

尺寸不超过
```
256x256
```
的资产适合选择像素动画模式。
尺寸在
```
256x256
```
到
```
2048x2048
```
之间的资产适合选择精细动画模式。
不要强制将尺寸小于256的源文件使用精细模式。
默认保持
```
edge_margin=6
```
，可避免像素艺术内容太贴近画布边缘。

Prompt Writing

提示词编写

Inspect the actual source character before writing the prompt.
For pixel art, upscale the source with nearest-neighbor to about
```
1024x1024
```
for inspection only.
Identify visible character details first: silhouette, armor, visor, weapon, shield, pose, and facing.
Only mention details that are actually visible in the source image.
Write one short paragraph in plain prose, not a label or keyword list.
Describe what moves, how it moves, what stays stable, and how visible props or weapons are used.
Keep the motion grounded in the existing character rather than inventing new equipment or effects.
Avoid generic prompts like
```
idle animation
```
unless
```
auto_enhance_prompt=true
```
.

Example idle prompt:

The armored soldier in purple tactical gear stands in a steady combat stance, subtly bobbing up and down in a rhythmic breathing idle. His yellow visor catches the light while his rifle shifts slightly in his grip, maintaining a high state of readiness.

Example attack prompt:

The armored soldier in purple tactical gear raises his rifle and fires several shots, with yellow muzzle flashes appearing at the tip of the barrel. His body recoils with each shot while his head and visor remain focused forward, maintaining a steady combat stance throughout the firing sequence.

auto_enhance_prompt=true

, simple prompts like

Idle

Attack

, or

Walk

are valid because SpriteCook can inspect the source asset and expand them automatically.

编写提示词前先观察源角色的实际内容。
对于像素艺术，仅在预览时用最近邻插值法将源文件放大到约
```
1024x1024
```
方便观察。
首先识别角色的可见细节：轮廓、盔甲、面罩、武器、盾牌、姿势和朝向。
仅提及源图像中实际存在的可见细节。
用平实的散文写一段简短的描述，不要用标签或关键词列表。
描述哪些部分会动、如何动、哪些部分保持静止，以及可见的道具或武器的使用方式。
动作要基于现有角色设计，不要凭空添加不存在的装备或特效。
除非
```
auto_enhance_prompt=true
```
，否则避免使用
```
idle animation
```
这类泛化提示词。

示例待机提示词：

The armored soldier in purple tactical gear stands in a steady combat stance, subtly bobbing up and down in a rhythmic breathing idle. His yellow visor catches the light while his rifle shifts slightly in his grip, maintaining a high state of readiness.

示例攻击提示词：

The armored soldier in purple tactical gear raises his rifle and fires several shots, with yellow muzzle flashes appearing at the tip of the barrel. His body recoils with each shot while his head and visor remain focused forward, maintaining a steady combat stance throughout the firing sequence.

如果

auto_enhance_prompt=true

，那么

Idle

、

Attack

、

Walk

这类简单提示词也有效，因为SpriteCook会检测源资产内容并自动扩展提示词。

check_job_status

check_job_status

Use

check_job_status(job_id=...)

for long-running animations instead of blocking when the client can continue work in the background.

对于耗时较长的动画任务，使用

check_job_status(job_id=...)

查询状态，避免客户端阻塞，可在后台继续处理其他工作。