> 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/guan-li-collection/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) ## **使用 .zip 文件上传动作** 如果动作带有声音（*mp3* 或 *ogg*），则必须与以下内容一起压缩： `.glb`。然后，只需拖放 `.zip` 到构建器中。另外，还可以添加一个 `.json` 文件以及同一 `.zip` 中的其他资源，一并添加名称、描述、稀有度、类别、播放模式和/或标签。以下是各项定义： * `名称`：动作名称 * `描述`：你的动作描述（总计不超过 64 个字符，包括空格） * `类别`：动作类别（"舞蹈"、"特技"、"问候"、"趣味"、"姿势"、"反应"、"恐怖"、"其他"） * `稀有度`：物品稀有度（"独一无二"、"神话"、"传奇"、"史诗"、"稀有"、"异域"、"罕见"、"普通"） * `播放模式`：单次或循环动画（"简单"、"循环"） * `标签`：便于在市场中查找的标签。 要将这些定义添加到动作中，只需创建一个文本文件，并将其命名为 **emote.json** ，然后按示例添加以下几行： ``` { "name": "网球击球", "description": "让我看看你会打网球吧", "category": "趣味", "rarity":"史诗", "play_mode": "简单", "tags":["网球", "动作", "击球"] } ``` 这样，构建器会读取所有 .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) 旋转、放大或缩小、上移或下移。使用这些工具为你的动画获取最佳镜头！ ## 编辑器 设置好缩略图后，编辑器就会打开。这里可以检查动画是否播放正常，因为会有一个 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) 点击左下角的图标即可编辑虚拟形象。点击右下角的圆柱图标可检查你的动画是否保持在高度和空间边界内。 ![](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) 左下角的图标可让你编辑虚拟形象。 ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-11896efd5c2c154ba0d5312d62934805dd043d4e%2Fboundaries.gif?alt=media) 圆柱图标显示动画的边界。 你还可以编辑动作的名称、缩略图、类别、稀有度和播放模式，也可以为动画添加描述并添加标签。点击 ***保存*** 完成后。 * **描述：** 这是对你的物品的简短说明，它会显示在市场中。 * **用途** 描述该可穿戴物品或动作在世界中的用途。 * **标签：** 标签只是一些描述性词语，用户在搜索或筛选物品时可以使用。它们与比赛或活动相关！ ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0a271b0b5a36f74b74d8d3ab5ddc7ede8baa474e%2Feditor2.png?alt=media) ## 在世界中测试 即使在编辑器中测试过动画，也仍然需要检查它在 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) \ \\ {% 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) \ \\ {% 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) \ \\ {% 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) \ \\ {% 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) \ \\ ## **发布前** 确保添加一段好的描述，并确认所有信息和设置都正确。也要再检查一次缩略图。如果你已填完所有必要信息，就会看到物品状态显示为“准备提交”。现在你的动作已经可以发布了！ ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c105d607825d869d5061e244bc3f2c1b1d054629%2Flast.png?alt=media) “准备提交”状态表示你的文件已经可以发布了！ --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.decentraland.org/creator/content-creator-zh/chuan-dai-wu-yu-biao-qing/guan-li-collection/uploading-emotes.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.