> 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/guan-li-he-ji/uploading-emotes.md).

# 上传表情动作

将表情动作上传到编辑器的指南

一旦你导出你的表情动作，就需要将它上传到构建器。本说明将介绍上传表情动作的流程。

## **上传你的文件**

请记住，在上传文件之前，你需要先创建一个合集。如果你不知道该怎么做，请查看 [创建合集](https://docs.decentraland.org/creator/wearables-and-emotes/manage-collections/creating-a-collection). 要上传你的表情动作，只需将文件拖放到 ***新物品*** 窗口，或者浏览你的电脑。系统会自动检测文件是否包含任何动画，并将其识别为表情动作。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6e60c7fe27f0300b0cee4e8e6078e06001aeb7b3%2F01_new_item%20\(1\).png?alt=media)

将你的动画文件拖放以上传。

系统会要求你输入表情动作的名称，定义其稀有度、类别和播放模式。在缩略图下方会显示文件中的动画片段数量、动画时长（秒）、时长（帧）以及帧率。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-25866943a45b47b14067a714d392b2d7bea62f5e%2Fupload_emote.png?alt=media\&token=71fd423f-0c54-469d-bada-131804b26403)

## **使用 .zip 文件上传表情动作**

如果表情动作带有声音（*mp3* 或 *ogg*）则必须与 `.glb`一起打包成 `.zip` 上传到构建器。此外，也可以将一个 `.json` 文件与其他资源一起放在同一个 `.zip` 中，以添加名称、描述、稀有度、类别、播放模式和/或标签。以下是每个字段的定义：

* `name`：表情动作名称
* `描述`：你的表情动作的描述（总计不超过64个字符，包括空格）
* `类别`：表情动作的类别（"dance"、"stunt"、"greetings"、"fun"、"poses"、"reactions"、"horror"、"miscellaneous"）
* `稀有度`：物品的稀有度（"unique"、"mythic"、"legendary"、"epic"、"rare"、"exotic"、"uncommon"、"common"）
* `播放模式`：简单或循环动画（"simple"、"loop"）
* `标签`：便于在市场中查找的标签。

要将这些定义添加到表情动作中，只需创建一个文本文件，并将其命名为 **emote.json** ，然后按示例添加以下几行：

```
{
  "name": "Tennis Shot",
  "description": "向我展示你会打网球",
  "category": "fun",
  "rarity":"epic",
  "play_mode": "simple",
  "tags":["tennis", "emote", "shot"]

}

```

这样，构建器就会读取所有 .json 信息，并将其自动应用到表情动作上。

**稀有度**

查看稀有度图表于 [这里](https://docs.decentraland.org/creator/wearables-and-emotes/manage-collections/creating-a-collection#rarity).

## **分类**

选择最能描述你的表情动作的类别。

* 舞蹈
* 特技
* 问候
* 趣味
* 姿势
* 反应
* 恐怖
* 杂项

## **播放模式**

当前有两种播放模式：

* ***播放一次***：表示你的表情动作只会播放一次。之后角色将返回到 *闲置* 姿势。
* ***循环***：表情动作将会循环播放，直到用户输入另一个动作。

## **自定义缩略图**

对于表情动作，你无需上传任何图片，因为编辑器已经内置了创建缩略图的工具。只需选择最能代表该动作的帧即可。

人们应该能够通过缩略图辨认出这个动画的内容。如果正面镜头还不够好，试着旋转模型、放大或缩小、上移或下移视角，或从你的片段中选择任意一帧。选择最佳画面真的很重要！

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e02692d27d899be4728188446efaf3019e02ca5d%2FEdit_thumbnail.gif?alt=media\&token=4d75a294-a0ae-49d0-b9bb-9a41d334bbb4)

旋转、放大或缩小、上移和下移。使用这些工具为你的动画获取最佳画面！

## 编辑器

一旦你设置好缩略图，编辑器就会打开。在这里你可以检查动画是否播放正常，因为一个3D头像将会执行它。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d3210dd79d67e891d32eaba1dc9e344421ba5690%2Feditor.png?alt=media\&token=d6a661dc-2687-4d43-ab22-d30c7bb15360)

点击左下角的图标，你可以编辑头像。点击右下角的圆柱图标，检查你的动画是否保持在高度和空间边界内。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-fbd7fadcbc6908f3a6b71489db338f3f8d20f729%2Fedit_avatar.gif?alt=media\&token=273855be-7958-4b1a-b33a-0a5af9719446)

左下角的图标可让你编辑头像。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-11896efd5c2c154ba0d5312d62934805dd043d4e%2Fboundaries.gif?alt=media\&token=c5e8ac87-3454-46c3-a81d-c35a6116f1b5)

圆柱图标显示动画的边界。

你也可以编辑表情动作的名称、缩略图、类别、稀有度和播放模式，以及为动画添加描述和标签。完成后点击 ***保存*** 。

* **描述：** 这是一段用于描述你物品的简短说明，将显示在市场中。
* **用途** 描述可穿戴物品或表情动作在世界中的用途。
* **标签：** 标签只是用户在搜索或筛选物品时可以使用的描述性词语。它们与比赛或活动相关！

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0a271b0b5a36f74b74d8d3ab5ddc7ede8baa474e%2Feditor2.png?alt=media\&token=ad669dad-b368-448a-ad1c-9477d7feca1a)

## 在世界中测试

即使在编辑器中测试过动画，仍然很重要的是检查它在 Decentraland 中实际会如何显示和表现。要在世界中测试，请进入 Collections 选项卡，选择所需的集合，它会显示其中的所有物品。点击“在 Decentraland 中查看”。

\
\\

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6c7e5ab3fa411b08bc8abd7a078a231dd6b38c2b%2Fgetting_started.png?alt=media\&token=669a0f67-eb78-44f2-87c5-bd191ee78616)

\
\\

{% hint style="info" %}
系统会要求你选择是在空地块还是在 Genesis Plaza 中进行测试。选择空地块会把你传送到一个内容不太多、加载更快的地方。选择 Genesis Plaza 会带你前往主广场。
{% endhint %}

\
\\

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-efe4b167e04b9293b5042b3051897adb930df523%2Fchoice.png?alt=media\&token=fed0a02f-dbab-45f2-94f9-3e82d3a52d1a)

\
\\

{% hint style="info" %}
选择后，你的浏览器中会打开一个新标签页，并提示你即将使用自定义 Catalyst。点击 TRUST PEER-TESTING.DECENTRALAND.ORG 继续。
{% endhint %}

\
\\

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ff14bd3b0971cc30bc8e62e61dd9beb3176bf00e%2Fcustom_catalyst.png?alt=media\&token=61e340c2-308f-4e67-9cf4-2d64be2c2b37)

\
\\

{% hint style="info" %}
之后会弹出一个窗口，询问是否打开 Decentraland Explorer。Explorer 运行后，点击“跳进 Decentraland”。
{% endhint %}

\
\\

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d95b40abaf5d123a90cdd7033dbeef56ec1b1035%2Fmonoco.png?alt=media\&token=7417df06-e281-4a9d-a46e-8b9b652d842d)

\
\\

{% hint style="info" %}
进入世界后，按 I 打开背包，然后在表情动作选项卡中选择要测试的表情动作。
{% endhint %}

\
\\

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-74738e0c9646bcbad4ebe95221e475f7b06f938d%2Ftesting.gif?alt=media\&token=c7d53b30-ca16-46ff-bad6-4967e9b51f53)

\
\\

## **发布前**

确保添加一段好的描述，并核实所有信息和设置是否正确。也要再次检查缩略图。如果你已填写所有必要信息，你会在物品状态中看到“准备提交”。现在你的表情动作已准备好发布了！

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c105d607825d869d5061e244bc3f2c1b1d054629%2Flast.png?alt=media\&token=00630669-f541-4698-89fa-7aa8ae65e9b9)

“准备提交”状态表示你的文件已准备好发布！


---

# 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/guan-li-he-ji/uploading-emotes.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.
