> 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/materials.md).

# 材质

了解导入到 Decentraland 的 3D 模型支持哪些材质属性和纹理。

材质嵌入在 *.gltf* 或 *.glb* 文件中。

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

本文介绍导入 3D 模型的材质。若要了解如何通过代码定义材质并将其应用于基本形状，请参阅 [**材质**](https://docs.decentraland.org/creator/development-guide/materials/) .

{% hint style="warning" %}
**📔 注意**：目前，除基本形状外，你无法通过场景代码动态更改 3D 模型的材质。
{% endhint %}

## 着色器支持

并非所有着色器都可用于导入 Decentraland 的模型。请确保使用以下类型之一：

* **标准材质：** 支持各种着色器，例如漫反射、高光、透明度等。
* **PBR（基于物理的渲染）材质**：这种着色器更加灵活，包含漫反射、粗糙度、金属度和发光等属性，可用于配置材质与光线的交互方式。

下图展示了两个使用相同颜色和纹理创建的相同模型。左侧模型全部使用 *PBR* 材质，其中一些包含 *金属度*, *透明度*和 *发光*。右侧模型全部使用 *标准* 材质，其中一些包含 *透明度* 和 *发光*.

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

### 目前可与 Decentraland Engine 配合使用的 PBR 属性

> * 基础颜色
> * 金属度
> * 粗糙度
> * 高光
> * 自发光
> * 发光强度
> * Alpha
> * 法线

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

若要了解这些属性在世界中的表现，可以前往这个 [测试世界](decentraland://?realm=TestEnvironment.dcl.eth) ，查看不同的物体和材质，以及它们与光线和世界环境的交互方式。

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

### 基础色/漫反射颜色

定义物体表面的基础颜色。它本身不受光照影响，因此会与粗糙度、金属度、高光等其他节点组合使用。

### 金属度

金属着色器是一种用于模拟金属表面外观的渲染技术。它会考虑金属的物理属性以及金属与光线的交互方式，从而呈现出金属特有的光泽和反射效果。

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

### 粗糙度

粗糙度材质用于逼真地模拟光线与材质表面的交互。通常会使用粗糙度贴图，为模型表面赋予不同程度的“光滑”或“粗糙”效果。通常使用灰度纹理贴图来提供这类信息。

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

此属性可在非金属和金属材质模型之间进行混合。值为 1.0 时，材质会产生以基础颜色着色的完全高光反射，不包含漫反射或透射。值为 0.0 时，材质由漫反射或透射的基础层构成，其上覆盖一层高光反射层。

### 高光

在基于物理的渲染（PBR）着色器中，高光属性描述光线与表面的交互方式，包括表面的反射率和光泽度。镜面反射是光线从表面反射时产生的类似镜面的反射效果。在 PBR 中，此属性用于控制表面产生镜面反射的程度。金属等材质通常具有较强的高光反射，因此会形成锐利明亮的高光；而塑料等非金属材质的高光反射较弱，因此高光更宽、更柔和。

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

### Alpha

你可以将材质设为 *透明*。透明材质的可见程度各不相同，具体取决于其 *alpha*。为此，请启用材质的透明度属性，然后将其 *alpha* 设为所需值。Alpha 值为 1 时，材质完全不透明；值为 0 时，材质完全不可见。

下图展示了两个使用标准材质创建的相同模型。左侧模型仅使用不透明材质，右侧模型的部分区域则同时使用了透明材质和不透明材质。

{% hint style="warning" %}
💡 请记住，与漫反射材质相比，使用透明材质总是会带来更高的性能开销。请尽量减少透明材质的使用。
{% endhint %}

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

主要有两种透明模式： *Alpha Clip* 和 *Alpha Blend*。它们的主要区别如下：

* **Alpha Clip：** Alpha Clip 会根据灰度值的裁剪阈值，将透明度值渲染为 0 或 1。只有当 Alpha 值高于「裁剪阈值」时，表面颜色才会覆盖之前的颜色。

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

* **Alpha Blend：** Alpha Blend 会对 0 到 1 之间的值进行插值。你可以使用 Alpha 混合，将表面颜色叠加到之前的颜色上。

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

{% hint style="warning" %}
**🔥优化提示🔥** 除非你确实需要实现中间级别的透明度， **使用 \_Alpha Clip 的渲染性能***\*\* 总是优于 \*\****Alpha Blend**\_**.**
{% endhint %}

{% hint style="warning" %}
**⚠️ 排序问题**

在游戏中使用透明混合模式时，必须考虑颜色混合的顺序，因为最终输出颜色可能会受到混合顺序的显著影响。目前，引擎仅支持按对象排序，也就是说，它会根据对象原点自动对所有透明表面进行排序。但目前不支持按片段（像素）排序或按三角形排序。

为避免排序相关问题，最好不要在同一个网格上同时使用 Alpha Clip 和 Alpha Blend 对象。这样有助于避免意外的混合瑕疵，确保游戏呈现最佳效果。
{% endhint %}

### 自发光

你还可以将材质设为 *自发光*。自发光材质会发出自身的光。请注意，渲染时它们并不会真正照亮场景中的附近对象，而只是看起来周围有一圈模糊的光晕。

下图展示了两个使用标准材质创建的相同模型。右侧模型的部分表面使用了发光的自发光材质。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-46d721ea0ef42370ad4e157d22aeb0ca80143263%2F34-emissive-materials.webp?alt=media) ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ef396956cdf5da2acc3b3cb0df87d0c1e5042912%2F35-emissive-nodes.webp?alt=media)

*要在 Blender 中将材质设为自发光，只需向材质添加一个 `emission` 着色器。*

### 自发光强度

发出光线的强度。值为 1.0 时，图像中的对象会与发射颜色完全相同，也就是说，对象不会受到阴影影响。

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

*你可以在* [*测试世界*](decentraland://?realm=TestEnvironment.dcl.eth) *中查看发射强度在场景中的表现。*

### 法线

PBR 着色器中的“normal”节点是用于控制材质表面法线的基本组件。法线是定义表面某一点垂直方向的向量，在决定光线如何与表面交互方面起着关键作用。

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

## 顶点绘制

Decentraland 的引擎目前不支持对 3D 模型进行顶点绘制。

## 材质限制

请注意，每个地块的材质数量限制为：

> log2(n+1) x 20 场景中的材质数量。此限制也包括作为模型一部分导入的材质。

请务必注意，每种材质都会为每个对象产生一次绘制调用，因此应尽可能减少材质数量，并尽量重复使用材质，例如采用纹理图集等技术。这样也能让场景中的资产保持统一的风格。

## 材质命名

为了让美术资源制作流程井然有序、运行顺畅，我们建议为材质规范命名。一种方法是采用以下命名约定。

```
<Object>_<Classification>_<Sub-Classification(optional)>_<_MAT>
```

例如，假设我们制作了两种不同的树：一种是适合春季、会发光的自发光树，另一种是适合冬季、冷冽而带有金属质感的树。我们可以将材质命名为： *"TreeSpring\_Emissive\_MAT"* 以及另一个 *"TreeWinter\_Metallic\_MAT"*

总之，

* 🟢 **建议** 使用以对象名称和分类开头的名称： *"Wood\_Oak\_MAT"*, *"SciFiFence\_Metallic\_MAT"*&#x7B49;。
* 🔴 **避免** 使用诸如 *"Material009"*, *"material1"*&#x8FD9;样的名称，否则会让场景和模型难以跟踪和分析。

## 覆盖 glTF 材质

你可以使用场景代码中的 *glTF* 模型 [GltfNodeModifiers](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/3d-nei-rong-ji-chu/materials.md#modify-gltf-materials) 组件来覆盖其材质。更多详情请参阅 [修改 glTF 材质](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/3d-nei-rong-ji-chu/materials.md#modify-gltf-materials) 。

## 材质最佳实践

* 如果场景中有多个模型使用相同的纹理，请将纹理作为外部文件引用，而不要将其嵌入 3D 模型中。

嵌入的纹理会在每个模型中重复存储，增大场景体积。 *.glb* 文件默认会嵌入纹理，但你可以使用 [**glTF pipeline**](https://github.com/AnalyticalGraphicsInc/gltf-pipeline) 将纹理提取到外部。

> 注意：为不嵌入的纹理引用文件后，请确保该文件不会被移动或重命名，否则文件引用会失效。该文件还必须位于场景文件夹中，以便与场景一同上传。

* 设置材质透明度时，尽量始终使用 *Alpha clip* 而不是 *Alpha blend*，除非你确实需要材质具有部分透明效果（例如玻璃）。这样可以避免引擎将错误的模型渲染在另一个模型前面。
* 一般来说，请记得始终在材质中启用 *背面剔除* 。这样可以提升场景性能，因为引擎只会渲染模型可见的一面。只有在需要模型双面渲染时，才取消勾选 *背面剔除* （例如，由 3D 平面构成的一簇树叶）。

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

* 使用 Decentraland 的 [**默认纹理**](https://github.com/decentraland/builder-assets/tree/master/textures) ，这些纹理已由玩家预加载，可大幅加快资产的渲染速度。
* 阅读 [**这篇文章**](https://www.khronos.org/blog/art-pipeline-for-gltf) 了解使用 glTF 模型中的 PBR 纹理的完整美术制作流程。
* 有关如何使用 Blender 创建兼容 glTF 的材质，请参阅 [**Blender 文档**](https://docs.blender.org/manual/en/latest/addons/import_export/scene_gltf2.html) .
* 你可以在以下网站找到免费的高品质 PBR 纹理： [**cgbookcase**](https://cgbookcase.com/) .


---

# 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/materials.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.
