> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-zh/chuan-dai-wu-yu-biao-qing-dong-zuo/biao-qing-dong-zuo/rig-features.md).

# 骨架特性

关于头像骨架和可下载文件的特性。

本文档介绍 Rig 1.0 的设置、控件和功能。

{% hint style="info" %}
**💡 提示**：安装 [Decentraland Tools Blender 插件](https://extensions.blender.org/add-ons/decentraland-tools/)。该插件包含多种实用功能，可帮助你编辑和导出 3D 模型、可穿戴物品和表情动画。
{% endhint %}

### 骨架变换

这些是 Object Mode 下骨架的变换，以及控件的设置。 **请勿以任何方式编辑此内容**。骨架只能在 Pose Mode 下操作。为避免意外编辑，Object Mode 下的变换已锁定。

*Rig 1.0 的变换。*

{% hint style="warning" %}
⚠️ **警告**: **切勿在 Object Mode 下编辑骨架。**
{% endhint %}

## 骨骼方向

这是 Rig 1.0 的骨骼方向。

*骨骼方向的轴。*

*镜像姿势时的行为。*

### 镜像姿势

骨架的左右骨骼布局并不对称，因此单一的镜像技巧无法适用于整个身体。先执行 **Pose > Copy Pose**，然后执行 **Paste X-Flipped**，最后手动完成上半身的调整。

**粘贴后再处理腿部和脚部。** **Paste X-Flipped** 对以下控件能得到正确结果： `CTRL_FK_Avatar_UpLeg`, `CTRL_FK_Avatar_Leg`, `CTRL_FK_Avatar_Foot`, `CTRL_FK_Avatar_ToeBase`, `CTRL_IK_Foot`, `CTRL_IK_Avatar_ToeBase` 和 `CTRL_Avatar_Knee`。对于 IK 腿，结果完全准确；对于 FK 腿，脚部位置的误差约在 3 厘米以内，这是因为左右两侧的静止骨骼滚转角略有不同。如果需要完全准确，可目测微调 FK 脚部。

**肩部、手臂、手和手指还需要再进行一步调整。** **Paste X-Flipped** 单独使用时，会使另一只手偏离目标位置 40 到 70 厘米。粘贴后，逐个调整以下控件，并 **将 X 和 Z 值取反，Y 值保持不变**:

* `CTRL_Avatar_Shoulder`
* `CTRL_FK_Avatar_Arm`, `CTRL_FK_Avatar_ForeArm`, `CTRL_FK_Avatar_Hand`
* `CTRL_IK_Avatar_Hand`, `CTRL_IK_Avatar_Elbow`
* 全部 30 个 `CTRL_Avatar_Hand*` 手指控件

无论使用四元数还是欧拉角，都要对旋转应用此操作。两种方式的正负号相同。对于 IK 手部和肘部控件，位置也要进行同样的处理。

例如，粘贴后的手臂读数为 X -0.5、Z 0.1，则调整为 X 0.5、Z -0.1。

这样整个手臂骨骼链就能完全对齐。

**上半身需要不同处理的原因：** 右腿的骨骼坐标系与左腿的完全镜像，这正是 **Paste X-Flipped** 所假定的情况。而右臂的坐标系相对于左臂镜像时，其局部 **Z** 轴翻转的是 Z 而不是 X，因此翻转粘贴后会朝错误的方向旋转。将 X 和 Z 取反即可准确修正这一点。

#### 直接设置数值

如果要根据左侧的原始数值设置右侧的数值，而不是粘贴，请按以下方式翻转符号：

| 控制器 | 旋转 `(w, x, y, z)` | 位置           |
| --- | ----------------- | ------------ |
| 上半身 | `(w, -x, -y, z)`  | `(x, y, -z)` |
| 腿部  | `(w, x, -y, -z)`  | `(-x, y, z)` |

这是近似的路径：手臂的误差约在 1 mm 以内，但 FK 腿部会偏差 5 到 10 cm。 **Paste X-Flipped** 还能修正左右静止骨骼之间的细微滚转差异，而直接翻转符号无法做到。建议采用上文的先粘贴再修正方法。

{% hint style="warning" %}
**📔 注意**：初始姿势本身并非完全对称，因此将一侧的姿势镜像到另一侧会覆盖这点细微的不对称。设置关键帧前，请目测检查结果。
{% endhint %}

### 旋转手臂

上臂控制器 `CTRL_FK_Avatar_Arm`的局部 X 轴是倾斜的。绕此轴旋转会使手臂扫过胸前；这是本来想抬起手臂却让双臂交叉的最常见原因。

* 要 **调整** 手臂的指向，请改为绕世界坐标轴旋转：世界 X 轴使手臂向前抬起，世界 Z 轴使手臂向内或向外摆动。
* 要 **扭转** 手臂，使手掌朝上或朝下、肘部朝内或朝外，请绕骨骼自身的局部 Y 轴旋转。

### 各关节弯曲所绕的轴

肘部和膝盖绕各自的局部 X 轴弯曲。手腕和手指则不同：它们绕局部 Z 轴弯曲。手指绕局部 X 轴旋转会使其向侧面摆动；这是最终表情动作中手指朝错误方向弯折的最常见原因。

| 控制器                                                   | 弯曲轴              | 其他轴                       |
| ----------------------------------------------------- | ---------------- | ------------------------- |
| 肘部 `CTRL_FK_Avatar_ForeArm`，膝盖 `CTRL_FK_Avatar_Leg`   | 局部 X 轴           | Y 轴和 Z 轴已锁定               |
| 手腕 `CTRL_FK_Avatar_Hand`                              | 局部 Z 轴使手朝掌心方向弯曲  | 局部 X 轴使手向侧面倾斜             |
| 手指 `CTRL_Avatar_Hand{Index,Middle,Ring,Pinky}{1,2,3}` | 局部 Z 轴使手指朝掌心方向弯曲 | 局部 X 轴使手指在掌面上向侧面摆动。Y 轴已锁定 |
| 拇指根部 `CTRL_Avatar_HandThumb1`                         | 局部 X 轴使拇指横向扫过掌心  | Y 已锁定                     |
| 拇指 `CTRL_Avatar_HandThumb2`, `CTRL_Avatar_HandThumb3` | 本地 Z 轴使拇指弯曲      | Y 已锁定                     |

双手的弯曲方向相同。肘部弯曲、手腕倾斜以及拇指横扫掌心的方向在左侧和右侧相反，因此一侧适用的数值在另一侧需要反转符号。

### 骨骼集合

为避免误操作并便于识别控制器，此绑定按骨骼集合进行组织，可在 Blender 的 *数据属性* 选项卡中访问。单击 *眼睛图标* 即可切换这些集合的可见性。默认情况下，除 DON'T TOUCH 集合外，所有集合均可见。

骨架数据属性选项卡。

骨骼集合的划分方式如下：

* Global/Switch：全局控制器，例如根骨骼、脊柱和肩部控制器。带有自定义属性的控制器也位于此集合中。
* FK Upper：所有上半身 FK 设置控制器。
* FK Lower：所有下半身 FK 设置控制器。
* IK Upper：所有上半身 IK 设置控制器。
* IK Lower：所有下半身 IK 设置控制器。
* Fingers：双手手指的控制器。
* Deformation Bones：此集合用于存放变形骨骼。

{% hint style="warning" %}
**⚠️ 注意！**

DON'T TOUCH 集合包含 IK 设置及其他绑定约束，应保持隐藏。编辑这些骨骼可能会破坏绑定的功能。
{% endhint %}

## 控制器与分组

控制器是驱动基础骨架的非变形骨骼。它们根据类别显示不同颜色：

* 黄色：全局控制器及带有自定义属性的控制器
* 绿色：髋部（在脊柱层级中更容易识别）
* 蓝色：具有 FK 行为的控制器
* 红色：IK 控制器
* 粉色：左侧控制器
* 橙色：右侧控制器

*所有控制器及其颜色。*

## 自定义属性与设置

### FK/IK 混合

虽然手臂通常设置为 FK，腿部通常设置为 IK，但某些情况下需要采用不同的设置。如果手需要保持在某个位置，例如做俯卧撑或攀爬时，IK 是最佳选择。至于腿部，在腾空、游泳或翻滚时，FK 效果最好。为了让动画拥有更大的灵活性和自由度，此绑定在 UpperBody 控制器中提供 FK/IK 混合：0 表示完全 FK，1 表示完全 IK；介于两者之间的数值则表示两者的混合。

![双臂和双腿的 FK/IK 混合。](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/ik_fk_rig_1.0.png)

*双臂和双腿的 FK/IK 混合。*

![FK > IK 切换的工作方式。](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IK_FK_rig_1.0.gif)

*FK > IK 切换的工作方式。*

一条简单的规则适用于大多数情况：肢体与某个物体保持接触时使用 IK；失去接触并自由摆动时则切换到 FK。以坐姿为例：

* **双脚着地**：腿部保持 IK。使用 `CTRL_IK_Foot`移动双脚，然后降低 `CTRL_Avatar_UpperBody` 以放低身体。双脚会保持踩在地面上。使用 `CTRL_Avatar_Knee`.
* **一条腿交叉搭在另一条腿上**：只将抬起的那条腿切换到 FK。
* **双脚悬空**：将双腿都切换到 FK。

使用 `CTRL_Avatar_UpperBody` 用于上下移动整个身体。它是重心。 `CTRL_Avatar_Hips` 只移动骨盆和腿部，导致躯干被拉伸，因此不适合用于坐下动作。

{% hint style="warning" %}
**📔 注意**：避免在片段中途将肢体在 FK 和 IK 之间切换。除非两条骨骼链在该帧完全对齐，否则肢体会突然跳动。如果确实需要切换，请为 FK > IK 属性本身设置关键帧，这样就能在需要的位置进行切换。
{% endhint %}

#### 使用 IK 触碰面部或目标

要让手触碰某个东西（例如面部、道具或另一只手），请将该手臂切换为 IK。旋转 FK 关节无法可靠地让指尖落在目标上。请注意，IK 手部控制器位于手腕处，因此将控制器放到目标位置时，对准的是手腕，而不是指尖。移动控制器，直到指尖落在所需位置。

FK > IK 属性会在其关键帧之间逐渐混合。在切换该属性的关键帧上，将 FK 手臂摆到接近 IK 姿势的位置。否则，垂在身体一侧的 FK 手臂会在混合过程中划过胸前。

以下是默认虚拟形象处于待机姿势、站立时测量的头部尺寸，可用于将手放到面部：

| 标志点              | 距地面的高度               | 相对于 `Avatar_Head` 骨骼的位置            |
| ---------------- | -------------------- | ---------------------------------- |
| `Avatar_Head` 骨骼 | 1.72 米               | 这是面部中央的位置，而不是颅骨底部                  |
| 鼻尖               | 1.66 米（男性身体为 1.64 米） | 向前 0.19 米，向下 0.06 米（男性身体向下 0.08 米） |
| 下巴               | 1.60 米               | 向下 0.12 米                          |
| 头顶               | 1.90 米               | 向上 0.18 米                          |

头部宽约 0.30 米。将手对准头部骨骼上方 0.12 米处，手就会落在额头上。如果头部旋转，请在头部旋转后的坐标系中应用这些偏移量。

### 隔离旋转 FK 混合

上半身控制器中还有一个自定义属性：隔离旋转。它可以让你选择骨骼是否继承父级的旋转（处于 FK 模式时）。值为 0 时，骨骼不会继承旋转；值为 1 时，骨骼会完全跟随父级。介于两者之间的其他值则表示两种状态的混合。这个工具很有用，因为它能让 FK 骨骼保持位置，表现得有点像 IK。

![手臂的隔离旋转属性。](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_rig_1.0.png)

*手臂的隔离旋转属性。*

![手臂的 IsoRot 属性工作方式。](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_Arms_rig_1.0.gif)

*手臂的 IsoRot 属性工作方式。*

头部控制器也有此属性。例如，在走路循环中它非常有用：即使躯干扭转，头部也会保持原有旋转，确保始终朝前。若没有此选项，每次躯干扭转时，动画师都必须手动旋转头部，让它保持端正并朝前。

![头部的隔离旋转属性。](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_Head_rig_1.0.png)

*头部的隔离旋转属性。*

![头部的 IsoRot 属性工作方式。](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/IsoRot_Head_rig_1.0.gif)

*头部的 IsoRot 属性工作方式。*

{% hint style="warning" %}
⚠️ **警告**：在较旧版本的 Blender 中，即使已选中所有控制器并设置了关键帧，这些自定义属性也不会自动设置关键帧。请务必为每个属性手动插入关键帧，以免丢失创建的姿势或动作。在 Blender 4.4 中，按 I 即可为所有属性和自定义属性设置关键帧。
{% endhint %}

![在旧版 Blender 中，务必为所有控制器和自定义属性设置关键帧！](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/custom_attributes.gif)

*在旧版 Blender 中，务必为所有控制器和自定义属性设置关键帧！*

*在 Blender 4.4 中，按 I 即可自动为位置、旋转、缩放和自定义属性设置关键帧。*

为自定义属性设置关键帧的另一种方法是，在时间轴选项卡中选择 ***关键帧*** 下的选项，并在 ***活动关键帧集*** 中选择位置、旋转、缩放和自定义属性，如下方动图所示。这样，每次按 I 都会创建关键帧，而不会弹出菜单。有些动画师更喜欢使用菜单，因此此选项默认未启用。不过，你可以自由选择最适合自己的方法。

![使用“关键帧”选项设置关键帧。](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/keyframe_custom_properties.gif)

*使用“关键帧”选项设置关键帧。*

### 反向 IK 脚部设置

为 FK 脚部制作动画相当简单：抓取任意控制器并旋转即可。由于脚部和脚趾各有一个控制器，动画师可以完全控制它们的动作。然而，IK 就没那么简单了。脚部必须贴在地面上，同时还要能够以脚掌和脚跟为轴旋转，并向两侧倾斜。

这个绑定的设置方式让动画师可以自由控制脚部动作，同时保留 IK 系统的优势。它由四个控制器组成：

* 脚部滚动：此控制器可使脚前后及左右转动。为了避免脚跟或前脚掌弯曲过度，系统设置了限制，以防脚部绑定出错。达到此限制时，脚将停止转动。

![脚部滚动：绕 X 轴旋转可使脚前后转动；绕 Z 轴旋转可使脚左右转动。](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/foot_roll.gif)

*脚部滚动：绕 X 轴旋转可使脚前后转动；绕 Z 轴旋转可使脚左右转动。*

* 脚尖滚动：以脚趾尖为轴转动脚部。它只能向前转动。

![脚尖滚动只能沿 X 轴正方向转动。](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/toe_tip.gif)

*脚尖滚动只能沿 X 轴正方向转动。*

* 脚趾控制器：以跖球为轴转动脚趾。

![脚趾可以向任意方向转动。](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/toes.gif)

*脚趾可以向任意方向转动。*

* 脚部控制器：这是一个全局控制器，可整体移动脚部。由于它是所有其他脚部控制器的父级，因此在保留所有变换的同时，也可以抓取并旋转整个脚部。

![脚部控制器的工作方式。](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/foot.gif)

*脚部控制器的工作方式。*

### 已锁定的变换

某些控制器的变换参数旁边可能会显示锁定图标，这表示这些值无法更改。这样设置是为了让控制器仅按特定方式运动，并避免不必要的变换。例如，肘部和膝盖应只绕一个轴旋转；此处为 X 轴，因此其他轴已锁定。其他具有锁定属性的控制器还包括 IK 肘部和膝盖、手指、脚部滚动以及脚尖滚动。

建议保持这些属性锁定；如果需要更大的运动自由度，只需点击锁定图标将其解锁。

锁定仅适用于 Blender 的交互式工具。直接修改骨骼旋转的 Python 脚本会忽略这些锁定，因此，如果使用脚本为绑定摆姿势，请自行确保每个关节的旋转仅沿其未锁定的轴进行。

![控制器中的锁定变换](https://raw.githubusercontent.com/decentraland/documentation-creators/main/images/emotes/locked_transform.png)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-zh/chuan-dai-wu-yu-biao-qing-dong-zuo/biao-qing-dong-zuo/rig-features.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
