> 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/3d-jian-mo-yu-dong-hua/meshes.md).

# 网格

了解导入到 Decentraland 的 3D 模型支持哪些网格属性。

3D 模型具有一个 *网格* 由三角形 *面*组成。这些面彼此相交于 *边* （它们相接的线），以及 *顶点* （它们的角相交的点）。

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

## 空间限制

场景中的所有 3D 模型都必须位于场景地块的边界内。如果预览时模型的任何部分超出这些边界，超出的部分都会被裁切，不予渲染。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6b07da4ce07533f34b2791242a920ad6beeb65e5%2Fcut-train.webp?alt=media)

在 Creator Hub 编辑器中，模型会显示为红色，包围盒也会标记为红色。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6907f08addc3dc3e1f828f7f28ae4c16ad7b50db%2Ftrain-out-of-bounds.webp?alt=media)

{% hint style="info" %}
**📔 注意**：在 Decentraland 较早版本的 Web 客户端中，出于性能考虑，只要 3D 模型有任何部分超出边界（即使只有包围盒超出），整个模型就不会被渲染。自 Decentraland 2.0 桌面客户端起，只有模型超出边界的部分会被裁切，位于场景内的部分仍会渲染。
{% endhint %}

## 包围盒

如果模型的所有顶点都位于场景范围内，但包围盒很大，其中大部分为空，并且超出了场景边界，那么 Creator Hub 会将整个模型标记为超出场景边界。位于地块内的模型部分仍会正常渲染，而且你仍可以发布场景。

每个网格都有一个包围盒，用于包围其形状的边界。为了让 3D 模型在 Decentraland 中更易于使用，请确保包围盒不会超出模型本身太多。

为避免这个问题，可以清理 3D 模型，重置网格的位置和旋转，使包围盒不会超出其所包围的网格。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-cba6a2eb2659a3cfcf117f9534023236081d36d9%2F14-reset-position.webp?alt=media)

*在 Blender 中，选中对象后按 Ctrl+A，再选择“应用所有变换”（Apply “All transforms”）。*

例如，旋转模型边缘附近的子网格时要格外小心。包围盒是立方体，即使网格是圆形，旋转 45° 后，包围盒的角也可能会凸出。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ec42a8d202c3bd78724fd0dfe5e90f8b10c980d8%2F10-apply-rotation.webp?alt=media)

我们建议烘焙模型中每个网格的旋转和缩放，以确保包围盒不会超出所需范围。

## 三角形数量限制

Decentraland 是一个开放世界，充满了不同的场景和物体，这些内容会在同一个 3D 空间中按需下载。为了保证游玩时的性能，我们需要优化网格。因此，使用网格时务必牢记以下场景限制：

> n 表示场景占用的地块数量。

* **三角形数量：** n x 10000 场景中所有模型的三角形总数。
* **高度：** 330 米，与地块数量无关。
* **文件大小：** 每个地块 15 MB，最多 300 MB。上传到内容服务器的文件总大小，包括 3D 模型和音频。不包括未上传的文件，例如 node.js 包。
* **单个文件最大为 50 MB** 场景中的任何单个文件（无论类型）都不能超过 50 MB，与场景包含的地块数量无关。

如需了解更多信息，请查看所有场景限制 [这里。](https://docs.decentraland.org/creator/development-guide/scene-limitations/)

{% hint style="warning" %}
**🔥优化提示🔥：添加多边形数量** 一个很有用的建议是随时关注模型的多边形数量。要在 Blender 中查看该数据，需要在视口叠加层面板中启用统计信息。

<img src="https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-8cfbd1397ed139852514fb88fec9867a6837c38a%2F41-stats.webp?alt=media" alt="" data-size="original">
{% endhint %}

## 大型场景中的网格

创建网格时，应牢记以下两项最佳实践：

* **模块化：** 将大型网格拆分为较小的模块化部件。例如，与其用单个网格表示整栋建筑，不如将建筑拆分为墙壁、地板和各个区域的独立网格。这样可以让 Unity 的视锥体剔除更有效地工作，因为渲染时只需处理可见部分。这也能改善内存占用，因为同一个网格可以在不同位置重复用于相同物体（为此，你需要在 SDK7 场景定义中引用同一网格，或者从 Blender 导出场景时使用实例，而非复制对象）。
* **包围体**：确保每个对象的包围体尽可能紧贴对象。包围体中多余的空间可能导致对象在不可见时仍被渲染。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-50551eddd6b34a313e21300f65335224c7156b9b%2F40-modularity.webp?alt=media)

### 什么是视锥体剔除？

视锥体剔除是一种优化技术，会禁用位于摄像机视野之外的对象的渲染器（网格）。请看以下两个示例：

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-61c969ce0d1d9489be40c5e11271b8a5697cd6ac%2F18-frustum-culling.webp?alt=media)

*一个迷宫式的室内关卡。此常规场景视图显示了所有可见的游戏对象。*

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-112b78c912015e34096e1351677af4dbd9b80a8d%2F19-frustum-culling-2.webp?alt=media)

*常规视锥体剔除只会渲染摄像机视野内的对象。这一过程会自动进行，始终处于启用状态。*

## 实例化对象与复制对象

在 Blender 中，复制对象会创建一个完全独立的副本；实例化对象则会创建一个与原对象共享相同数据的副本。

复制对象时，会创建一个拥有完全独立数据的新对象，其中包括所有几何体、材质和动画。这意味着对原对象所做的更改不会反映到副本上，反之亦然。

另一方面，实例化对象时，对原对象所做的任何更改都会反映到它的所有实例上，反之亦然。这是因为所有实例都共享相同的底层数据。

在性能方面，实例化的效率可能远高于复制，尤其是在处理复杂场景或大量对象时。这是因为实例化比复制占用更少的内存，因为它不会为每个实例创建新数据。此外，实例化还可以让 Blender 将所有实例视为一个对象来优化渲染流程，而不是分别渲染每个副本。

总的来说，实例化是提升 Blender 和 Decentraland 场景性能与工作流效率的强大工具，尤其适用于大型复杂场景。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-758d8892008ff01c913fdd4a2d5c1a28d0bb0de2%2F20-duplicate-objects.webp?alt=media)

在某些情况下，复制树木、植物和路灯等对象时，使用实例化相比直接复制可以显著提升性能。例如，这个场景中有十四盏路灯，它们完全相同。我们知道，每盏路灯有两种不同的纹理，一种用于灯柱，另一种用于灯。因此，这种情况下会有两次绘制调用，每种纹理一次。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-cce244b171ee7034d123f095865b33569acc26fd%2F21-duplicate-objects-2.webp?alt=media)

在 Blender 中，当你开始克隆并在空间中摆放元素时，有三种选择：复制、实例化或合并对象。

下面来分析每种做法的优缺点。

### 复制对象

| 菜单：  | Object ‣ Duplicate Objects |
| ---- | -------------------------- |
| 快捷键： | Shift-D                    |

这会创建所选对象的视觉上完全相同的副本，但它们会被视为不同的对象。因此，导出后每个对象会产生 2 次绘制调用，2 × 14 = 28 次绘制调用，磁盘占用总计为 320 KB。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f8cc0edd782b217b08e12e1a13c7be98a13d1255%2F22-duplicate-objects-3.webp?alt=media)

### 实例化对象

| 面板：  | Toolbar ‣ Tools ‣ Edit ‣ Duplicate Linked |
| ---- | ----------------------------------------- |
| 菜单：  | Object ‣ Duplicate Linked                 |
| 快捷键： | Alt-D                                     |

这会创建一个新对象，其所有数据都与原对象关联。在编辑模式下修改其中一个关联对象时，所有关联副本都会随之修改。变换属性仍然是副本，而不是关联数据，因此你仍可以自由旋转、缩放和移动对象，而不会影响其他副本。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f19f24e7222294aef278d9f2e6e095a3445079f9%2F23-instancing.webp?alt=media)

*导出这些模型时，绘制调用的数量仍然相同（28 次）。不过请注意，现在我们只有一个网格，这显著减少了磁盘占用（41 KB）。*

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-4c315a6b7e927bbb47c83a492465c91974f3dc81%2F24-instancing-2.webp?alt=media)

*为了让场景保持井然有序，你可以直接在场景中实例化集合。这样就能从同一个文件夹和源集合统一控制所有实例。*

{% hint style="info" %}
**💡 提示**：同样的原理也适用于 SDK。十四个实体都将其 `GltfContainer` 指向同一个 *.glb* 文件时，其行为就像实例：无论有多少实体使用该文件，文件都只下载一次、转换一次，其网格和纹理也只在内存中保存一份。将相同内容拆分为十四个几乎相同的 *.glb* 文件，就相当于复制，会产生十四次下载，并在内存中保存十四份副本。
{% endhint %}

### 合并对象

| 菜单：  | Object ‣ Join |
| ---- | ------------- |
| 快捷键： | Ctrl-J        |

这会将所选对象合并为一个具有单个网格的对象。此操作在物体模式下进行，会将所有内容合并到最后选中的 *活动* 对象中，并且要求所有所选对象类型相同。材质会保留并合并，因此十四盏路灯不再是十四个可渲染对象，而是变成一个对象；引擎只需进行 2 次绘制调用，而不是 28 次——每种材质一次。

在这三种选择中，只有合并能真正减少绘制调用。需要明确这一点的原因是：Decentraland 引擎会在运行时根据流式内容构建场景，因此无法像处理预先烘焙的内容那样，替你对重复对象进行分组或批处理。如果需要减少绘制调用，就必须在 Blender 中完成合并。

这种减少并非没有代价。合并会同时舍弃以下几项优势：

* **磁盘占用会再次增加。** 合并后的网格会存储十四根灯柱的几何体，因此实例化带来的空间节省就不复存在。
* **视锥体剔除会变成全有或全无。** 只要合并对象的任何部分出现在屏幕上，就会绘制整个对象。沿街分布的十四根灯柱几乎总会有一根可见，因此最终会始终绘制全部十四根——这很容易比节省下来的绘制调用开销更大。
* **各个部分将无法再单独操作。** 你将无法再单独移动、制作动画、点击或隐藏某一根灯柱，因为场景中只剩下一个对象。

请谨慎使用合并：仅适用于大量总是在同一位置同时出现、不会交互的小型道具，并且要先确认性能问题确实由对象数量造成。其他情况下，实例化通常是更好的默认选择。

{% hint style="warning" %}
**📔 注意**：将十四个独立对象导出到同一个 *.glb* 文件中， **并不** 等同于合并。引擎仍会看到十四个对象，并仍会发出 28 次绘制调用。只有合并网格才能改变对象数量。
{% endhint %}

## 网格命名

为网格使用有意义的名称。名称应说明资产的用途或它对应对象的哪个部分。

资产命名时，请结合使用 `PascalCase` 和 `snake_case`，我们可以称之为 `PascalSnake_case`。基本规则是：新单词或分隔符（`_`）后的单词以 **大写字母开头。**

* 为网格使用有意义的名称 **示例：** 🟢 **优先使用** 名称： `Theater`, `Tram` 🔴 **避免使用** 名称： `Untitiled.008`, `primitive(1)`, `Cylinder.091`, `_sphere-AB`
* 使用下划线 `_` 作为分隔符，为名称补充更多上下文。将较常见的内容放在前面，具体信息放在末尾。 **示例：** 🟢 **优先使用** 名称： `FountainStatue`, `TheaterMainWall`, `TramWheelLeft` 🔴 **避免使用** 名称： `North_MainWall_Theater`, `Tram_LeftFront_Wheel`

如果有多个对象名称相同，请在单词后添加数字： `FountainStatue01, FountainStatue02, etc.`

## 模型创建工具

有许多插件和外部工具可帮助创建资源，让工作流程更快、更高效。有些免费，有些需要付费，下面列举几款：

### 简化

这是一个广为人知的修改器，可在保留模型表面结构的同时减少网格的三角面数量。虽然它是优化模型的强大工具，但请注意，简化后拓扑可能会受到影响，变得不理想（因为几何体会被拆分成不可预测的部分）。此外，简化会将网格中的四边面转换为三角面，使模型在处理后难以修改。因此， **简化适用于静态模型，但不建议用于动画模型。**

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a9339c43ca63e7f2599fd928ef1d3c733154fa79%2F42-decimate-01.webp?alt=media) ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-434b2725cc7cc70a152e6b055a89c27891d79c65%2F43-decimate-02.webp?alt=media)

另一种通过简化优化网格的方法是先简化模型，然后进行适当的重拓扑。这样可以确保结果更可预测，拓扑也更整洁。

以下是一些可能有用的重拓扑插件（其中一些需要付费）：

* **Simplygon：** <https://www.simplygon.com/>
* **Speedretopo：** <https://blendermarket.com/products/speedretopo?ref=2>
* **Retopoflow：** <https://blendermarket.com/products/retopoflow>

### 镜像修改器

Blender 中的镜像修改器可将物体的一半沿任意轴（X、Y、Z）镜像，用于创建对称模型。如果模型具有对称结构，这个工具非常实用：它能缩短 3D 建模和 UV 展开的时间（因为只需展开模型的一部分，其余部分会共用相同的 UV 坐标），还可以通过避免在本质上互为镜像的部分浪费纹理分辨率来优化纹理。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-59cf597ef54c2b3832259986b8e6efda08a91818%2F44-mirror-modifier.webp?alt=media)

### 批量重命名

要轻松更改命名规则，一个非常实用的方法是使用 Blender 工具集内置的“批量重命名”功能。要使用该功能，请前往 *编辑* 然后选择 *批量重命名*.

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-99eb27463cc924be848c3ff4b353af21b09ced6e%2F45-batch-rename.webp?alt=media)

选择要重命名的对象，然后将默认对象名称替换为新名称即可。此工具提供多种重命名方法和资产类型，因此也能灵活地重命名网格、动画、骨骼等。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-fe3be0f7d4c5fbac746529bff8ba8bdf6327f058%2F47-batch-rename-methods.webp?alt=media) ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-845886b63580e6c82b49a91d90b9753725440727%2F46-batch-rename-types.webp?alt=media)

## 几何体最佳实践 [#](https://docs.decentraland.org/creator/3d-modeling/meshes/#best-practices-for-geometries)

* 请留意 3D 模型中面的数量，因为面数越多，渲染负担越大。有关场景的限制，请参阅 [**场景限制**](https://docs.decentraland.org/creator/development-guide/scene-limitations/) 。
* 请确保没有不可见的隐藏面，因为它们也会增加三角形数量。
* 对于需要圆滑侧面的形状，应将其设置为 *平滑* 而不是增加额外的面。
* 请确保所有面的 *法线* 都朝外，而不是朝内。如果模型中的某些面在渲染时似乎消失了，最可能的原因就是法线方向错误。
* 烘焙网格的旋转和缩放，避免其边界框出现不必要的延伸。


---

# 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/3d-jian-mo-yu-dong-hua/meshes.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.
