blockbench-animation

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Blockbench Animation

Blockbench 动画制作

Create animations for 3D models using Blockbench MCP tools.

使用Blockbench MCP工具为3D模型创建动画。

Available Tools

可用工具

Tool	Purpose
`create_animation`	Create animation with keyframes for bones
`manage_keyframes`	Create/edit/delete keyframes per bone and channel
`animation_graph_editor`	Fine-tune animation curves (smooth, linear, ease)
`bone_rigging`	Create/modify bone structure for animation
`animation_timeline`	Control playback, time, FPS, loop settings
`batch_keyframe_operations`	Batch operations: offset, scale, reverse, mirror
`animation_copy_paste`	Copy animation data between bones/animations

工具	用途
`create_animation`	为骨骼创建带有关键帧的动画
`manage_keyframes`	为每个骨骼和通道创建/编辑/删除关键帧
`animation_graph_editor`	微调动画曲线（平滑、线性、缓动）
`bone_rigging`	为动画创建/修改骨骼结构
`animation_timeline`	控制播放、时间、帧率（FPS）、循环设置
`batch_keyframe_operations`	批量操作：偏移、缩放、反转、镜像
`animation_copy_paste`	在骨骼/动画之间复制动画数据

Quick Start

快速入门

Create a Simple Animation

创建简单动画

1. create_animation: name="walk", animation_length=1.0, loop=true
2. manage_keyframes: bone_name="leg_left", channel="rotation",
   keyframes=[{time: 0, values: [30, 0, 0]}, {time: 0.5, values: [-30, 0, 0]}]
3. animation_timeline: action="play"

1. create_animation: name="walk", animation_length=1.0, loop=true
2. manage_keyframes: bone_name="leg_left", channel="rotation",
   keyframes=[{time: 0, values: [30, 0, 0]}, {time: 0.5, values: [-30, 0, 0]}]
3. animation_timeline: action="play"

Animation Channels

动画通道

```
position
```
- [x, y, z] offset
```
rotation
```
- [x, y, z] degrees
```
scale
```
- [x, y, z] or uniform number

```
position
```
- [x, y, z] 偏移量
```
rotation
```
- [x, y, z] 角度
```
scale
```
- [x, y, z] 或统一数值

Interpolation Types

插值类型

```
linear
```
- Constant rate
```
catmullrom
```
- Smooth spline
```
bezier
```
- Custom curves
```
step
```
- Instant change

```
linear
```
- 恒定速率
```
catmullrom
```
- 平滑样条曲线
```
bezier
```
- 自定义曲线
```
step
```
- 瞬时变化

Common Workflows

常见工作流程

Walk Cycle (1 second)

行走循环（1秒）

create_animation: name="walk", animation_length=1.0, loop=true, bones={
  "leg_left": [
    {time: 0, rotation: [30, 0, 0]},
    {time: 0.5, rotation: [-30, 0, 0]},
    {time: 1.0, rotation: [30, 0, 0]}
  ],
  "leg_right": [
    {time: 0, rotation: [-30, 0, 0]},
    {time: 0.5, rotation: [30, 0, 0]},
    {time: 1.0, rotation: [-30, 0, 0]}
  ]
}

create_animation: name="walk", animation_length=1.0, loop=true, bones={
  "leg_left": [
    {time: 0, rotation: [30, 0, 0]},
    {time: 0.5, rotation: [-30, 0, 0]},
    {time: 1.0, rotation: [30, 0, 0]}
  ],
  "leg_right": [
    {time: 0, rotation: [-30, 0, 0]},
    {time: 0.5, rotation: [30, 0, 0]},
    {time: 1.0, rotation: [-30, 0, 0]}
  ]
}

Smooth Curves

平滑曲线

animation_graph_editor: bone_name="arm", channel="rotation", action="smooth"

animation_graph_editor: bone_name="arm", channel="rotation", action="smooth"

Copy Animation to Mirrored Bone

将动画复制到镜像骨骼

animation_copy_paste: action="copy", source={bone: "arm_left"}
animation_copy_paste: action="mirror_paste", target={bone: "arm_right", mirror_axis: "x"}

animation_copy_paste: action="copy", source={bone: "arm_left"}
animation_copy_paste: action="mirror_paste", target={bone: "arm_right", mirror_axis: "x"}

Batch Timing Adjustment

批量调整时间

batch_keyframe_operations: operation="scale", selection="all",
  parameters={scale_factor: 2.0}  # Double animation duration

batch_keyframe_operations: operation="scale", selection="all",
  parameters={scale_factor: 2.0}  # 加倍动画时长

Bone Rigging

骨骼绑定

Create Bone Structure

创建骨骼结构

bone_rigging: action="create", bone_data={name: "spine", origin: [0, 12, 0]}
bone_rigging: action="create", bone_data={name: "head", origin: [0, 24, 0], parent: "spine"}

bone_rigging: action="create", bone_data={name: "spine", origin: [0, 12, 0]}
bone_rigging: action="create", bone_data={name: "head", origin: [0, 24, 0], parent: "spine"}

Set Pivot Point

设置枢轴点

bone_rigging: action="set_pivot", bone_data={name: "arm_left", origin: [4, 22, 0]}

bone_rigging: action="set_pivot", bone_data={name: "arm_left", origin: [4, 22, 0]}

Timeline Control

时间轴控制

animation_timeline: action="set_fps", fps=60
animation_timeline: action="set_length", length=2.5
animation_timeline: action="loop", loop_mode="loop"  # or "once", "hold"
animation_timeline: action="set_time", time=0.5
animation_timeline: action="play"

animation_timeline: action="set_fps", fps=60
animation_timeline: action="set_length", length=2.5
animation_timeline: action="loop", loop_mode="loop"  # 或 "once", "hold"
animation_timeline: action="set_time", time=0.5
animation_timeline: action="play"

Tips

小贴士

Use
```
list_outline
```
to see available bones before animating
Set up bone hierarchy first with
```
bone_rigging
```
before adding keyframes
Use
```
catmullrom
```
interpolation for organic movement
Use
```
step
```
interpolation for mechanical/robotic movement
Mirror animations for symmetrical rigs to save time

动画制作前使用
```
list_outline
```
查看可用骨骼
添加关键帧前，先使用
```
bone_rigging
```
设置骨骼层级
对于自然运动，使用
```
catmullrom
```
插值
对于机械/机器人运动，使用
```
step
```
插值
为对称骨骼绑定镜像动画以节省时间