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

# 纹理

了解纹理在 Decentraland 中的工作方式

纹理是 3D 美术制作流程中的重要组成部分，能帮助你为场景打造想要的外观和氛围。本节将介绍创建纹理所需了解的所有内容，包括相关限制、Blender 中的节点，以及如何优化纹理以获得最佳性能！

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

## 限制

### 纹理尺寸限制

目前，为了优化性能，Decentraland Explorer 会在场景上传到内容服务器后，使用 Asset Bundle Converter 将纹理压缩至最大 1024px。创建资源时，请务必考虑这一限制！

还要注意，纹理尺寸始终应为 2 的幂。任何不符合此规格的纹理都可能导致场景渲染出现问题。

纹理的宽度和高度（以像素为单位）必须符合以下数值序列：

```
1, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024
```

> 以下序列由 2 的幂组成： `f(x) = 2 ^ x` . **纹理尺寸的上限为 1024。** 这是其他渲染引擎中相当常见的要求，原因在于图形处理器的内部优化。

宽度和高度不必相同，但两者都必须属于此序列。

**纹理的推荐尺寸为 1024x1024**。我们发现，这种尺寸最适合通过家庭网络传输，也能提供合理的加载速度和画质体验。

其他有效尺寸示例：

```
32x32px
64x32px
512x256px
512x512px
1024x1024px
```

此外，每个地块的纹理数量也有限制：

```
每个地块的纹理数量为 log2(n+1) x 10。包括作为模型一部分导入的纹理。
```

## UV 映射

UV 映射是将 3D 模型的表面展开为 2D 坐标的过程，之后可利用这些坐标为资源添加不同的贴图。这是创建流程中的重要环节。正确展开模型是充分利用模型分辨率的关键，也能让贴图更有条理，便于灵活修改。

如需进一步了解 UV 展开，可以观看 Blender 基金会制作的这段精彩视频：

[![Video Preview](https://i.ytimg.com/vi/Y7M-B6xnaEM/maxresdefault.jpg)](https://youtu.be/Y7M-B6xnaEM?si=qMnWTMsXxC-vxZAH)

\[Blender Guru] (<https://www.youtube.com/@blenderguru>) 也制作了一段很棒的中级 UV 展开教程，讲解如何展开更复杂的模型：

[![Video Preview](https://i.ytimg.com/vi/scPSP_U858k/maxresdefault.jpg)](https://youtu.be/scPSP_U858k?si=Uw0xHbv9jtqVstDS)

## 贴图

在 [材质部分](https://docs.decentraland.org/creator/3d-modeling/materials/) 中，我们介绍了 Decentraland 如何使用 PBR 着色器。本节将说明每种纹理贴图如何影响着色器，以及最终导出到世界中的 3D 对象的外观和氛围。

## 漫反射贴图

这是对象表面的基础颜色。让模型之间的色彩搭配保持平衡，是为你的体验营造协调统一风格的关键。

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

如果你需要，这里有一个很棒的免费配色方案生成器！

* **Coolors：** <https://coolors.co/>

或者，也可以从精彩电影中寻找配色灵感：

* **Movies in Color：** <https://moviesincolor.com/>

## 金属度贴图

在金属度贴图中，灰度表示对象的金属程度：白色表示完全金属，黑色表示非金属。在下面的示例中，可以看到光线如何影响模型，以及模型如何与环境互动。

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

*从图中可以看到，纹理中的深色部分会如何影响模型。深色条纹是不透明的，白色条纹则呈现金属着色器属性的效果，灰色部分则是两者的混合。*

## 粗糙度贴图

在粗糙度贴图中，较暗的区域对应更光滑的表面，较亮的区域对应更粗糙的表面。渲染引擎会使用这种灰度表示，来确定光线在表面不同位置应如何散射或反射。

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

## 透明贴图

### Alpha Clip（透明裁剪）

在 Blender 中，将 Alpha Clip 与纹理配合使用时，会利用纹理的 Alpha 通道来确定材质的哪些部分可见。Alpha 值高于指定阈值的像素会显示，低于阈值的则会被舍弃，从而根据纹理的透明度信息产生镂空效果。

在下面的示例中，我们使用了一个启用 Alpha Clip 的材质，并使用两张纹理：漫反射颜色贴图和黑白 Alpha 贴图，将颜色连接到 Alpha 通道。

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

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

*最终，黑色区域会被舍弃，而白色区域则会渲染出来。*

### Alpha Blend（Alpha 混合）

*Alpha Blend（Alpha 混合）* 可让你为各个区域指定中间值。

在 Blender 中，将 Alpha Blend 与纹理配合使用时，会根据纹理的 Alpha 通道混合透明区域和不透明区域。这样，纹理中的可见部分和透视部分便能平滑融合，并与场景背景或其他对象自然互动。

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

*Alpha Clip 的渲染值只有 0 或 1（由指定阈值决定），而 Alpha Blend 会在 0 到 1 之间插值。上面的示例中，Alpha Blend 材质呈现了完整的渐变过渡，而 Alpha Clip 则会根据裁剪阈值排除纹理的一部分。*

{% hint style="warning" %}
**🔥优化提示🔥**

* 请注意，使用透明纹理（RGB+A）的性能开销始终高于使用灰度值表示透明度。
* 渲染场景时，透明效果始终会带来较大的性能开销。请尽量减少透明效果，并仅在必要时使用 Alpha Blend；其他情况下优先使用 Alpha Clip。
  {% endhint %}

## 自发光贴图

自发光贴图是一种纹理贴图，用于控制 3D 场景中表面的自发光效果或发出的光线。它是着色器的一个组成部分，用来决定 3D 模型的特定部分发出多少光（以及发出何种颜色的光），且不受外部光源影响。自发光贴图常用于模拟看起来会自行发光的材质或对象。

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

*此示例展示了发光贴图与发光强度的搭配用法，并在启用了辉光后期处理的环境中，大致测试发光效果在场景中的表现。*

## 法线贴图

法线贴图是一种用于 3D 图形的纹理，可模拟精细的表面细节，让人产生复杂几何结构的错觉，而无需实际改变模型的基础几何形状。它常用于增强低多边形模型的真实感，让表面看起来有凸起、凹槽和其他不规则细节。使用法线贴图图层来呈现大量细节，而不是采用复杂的几何结构，也能让物体本身更轻量。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c513762520326590dcc7f57983b459ff05e4643c%2F51-normal-map.webp?alt=media) ![](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)

若要使用 *着色器编辑器*为材质添加法线贴图，需要在纹理与 ***法线贴图*** 节点之间连接该节点，然后将其连接到 *Principled BSDF* 着色器。

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

{% hint style="warning" %}
**⚠️重要提示⚠️：** 切勿同时将同一张纹理用作反照率贴图和法线贴图，否则可能会导致场景渲染出现问题。
{% endhint %}

## 优化纹理

优化纹理能为场景在 Explorer 中的渲染带来诸多好处，也有助于保持场景风格一致，并让设计流程更加灵活。部分好处如下：

* 优化纹理的尺寸和压缩后，场景运行会更加流畅、快速，下载速度也会更快，渲染也更轻松（尤其是对于网络连接较慢的玩家）。
* 这能减少渲染体验所需的内存和处理能力，从而为玩家带来更好的体验。
* 还能节省社区内容服务器的存储空间。
* 使用 **纹理图集** 和/或 **Trim Sheet** 可以让你更灵活地迭代场景创作，并确保物体之间的风格一致。通过这些技术，你可以轻松替换纹理、调整颜色或图案，而不必逐个修改模型。
* 在多个模型间共享纹理，可以减少每个场景中的纹理数量，大幅降低游戏中的绘制调用。如果你使用的是 glb（包含嵌入纹理），可以按照以下指南使用提取工具从文件中提取纹理，并将模型重定向为使用同一张纹理。

## 在 glTF 模型之间共享纹理

优化场景时，一个明智且常见的做法是在场景中的多个模型之间共享纹理和材质。这样可以大幅减少绘制调用，让你的 Decentraland 场景运行得更加流畅。

以下工具基于 [**glTF pipeline**](https://github.com/AnalyticalGraphicsInc/gltf-pipeline)**,** 提供了一些优化功能，可以让 3D 模型更加轻量，并让场景中的玩家更快下载模型。

**Mac：** [MAC GLB Extractor](https://github.com/decentraland/docs/blob/main/creator/images/3d-models-and-animations/glb-extractor/texture_extractor.sh)

**PC：** [PC GLB Extractor](https://github.com/decentraland/docs/blob/main/creator/images/3d-models-and-animations/glb-extractor/glb_texture_extract.bat)

此工具会将 .gltf 格式转换为二进制格式 .glb，从而大幅减小文件体积。它还会将纹理文件从 3D 模型中分离出来，让你能在多个模型中使用同一张纹理。

> 📔 注意：.glb 格式默认会将纹理嵌入文件中。引擎无法识别两个嵌入的纹理是否相同；它们必须是具有相同哈希值的外部文件。

### 如何使用 GLB 纹理提取工具

在此示例场景中，我们在 Blender 中创建了一个简单的科幻场景。

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

场景包含静态模型所需的基础环境，此外还有两个资源：一个机器人和一艘太空船。我们希望将它们单独导出，以便之后通过代码移动它们，使其能够与玩家互动。本例中我们使用了 4 张纹理（一张用于地板，一张供大多数资源使用的图集颜色贴图，一张发光贴图，以及一张用于面板的科幻风格 UI 纹理）。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-53bfdb7102a3b8cacbdfc7cb94fbdaf716c7a5bd%2F02-model-01.webp?alt=media) ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-85a938c3b445951ac0612f1d6e9606ce214b8a4c%2F03-model-02.webp?alt=media)

将所有这些资源导出到 models 文件夹后，我们会得到 3 个模型：静态环境场景、太空船和机器人。

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

但这里有个问题：.glb 文件会将纹理嵌入其中，因此，如果导出的不同资源重复使用相同纹理，每个新资源都会重复包含这些纹理。为了避免纹理重复，我们可以使用这个实用工具。

{% hint style="warning" %}
⚠️ 重要提示：使用此工具之前，请先备份模型，以防出现问题！！！
{% endhint %}

**在 Mac 上**

将所有资源导出到 models 文件夹后，可以把脚本文件拖到该文件夹中。

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

1 - 将文件夹拖到终端中，在终端里打开该文件夹。

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-45de47c7a81170de1fb90cb6216db8150f6cd2ab%2F06-move-to-terminal.webp?alt=media)

2 - 将 texture-extractor.sh 拖到终端中。

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

3 - 运行命令。处理所有资源可能需要几秒钟。完成后，你会看到类似下面的内容：

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

4 - 打开 models 文件夹，其中会出现一个名为 "out" 的新文件夹。打开后即可看到提取出纹理的新资源。

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

5 - 用新资源替换所有旧资源！完成后，还要删除 "texture-extractor.sh" 和空的 "out" 文件夹。

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

**在 Windows 上**

将所有资源导出到 models 文件夹后，可以把脚本文件拖入该文件夹。

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

1 - 双击 glb\_texture\_extract.bat 以提取文件。如果 Windows 提示应用无法识别，请前往 **更多信息** 然后 **仍然运行**.

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-3a2482266a4e3864ca60ce6729150ec379f222f7%2F11-windows-02.webp?alt=media) ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-99ab951fb6ced7088713791b7730e6b52359ef33%2F12-windows-03.webp?alt=media)

2 - 脚本会生成一个名为 out 的文件夹，所有提取了纹理的新 .glb 文件都在其中。

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

5 - 用新资源替换所有资源。完成后，删除“texture-extractor.bat”脚本和空的“out”文件夹。

按照所有步骤操作后，场景现在会快得多，而且各资源将共用相同的纹理！处理多个资源和大型场景时，性能提升会非常明显！使用此工具可以节省大量存储空间！

{% hint style="warning" %}
⚠️ 完成此步骤后，务必检查每张纹理是否符合规范。如果纹理不符合规范或文件过大，请先优化以减小体积，再进行部署。为了保证场景性能，建议纹理尺寸为 1024x1024。还要检查分辨率；超过 72 DPI 的图像会影响性能，却不会让图像看起来更好。
{% endhint %}

## 纹理图集 / Trim Sheet

纹理图集是一个包含多个较小图像数据的单一图像文件，这些图像被打包在一起。多个网格可以共用一张较大的纹理，而不是每个网格各用一张纹理。

你可以在制作资源之前创建纹理图集，这意味着要根据纹理图集对资源进行 UV 展开。创建纹理时需要提前做好规划。

或者，也可以在资源制作完成后，通过在绘图软件中合并纹理来创建纹理图集。不过，这也意味着必须根据纹理重新排列 UV 岛。

下图展示了多个使用同一组纹理的 3D 对象：

![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-69ff8bbc87fe5ffd1d2943db7aa044dce79b5660%2F37-atlas-texture.webp?alt=media) ![](https://2460066822-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-65e708b3c3c4fbb7cfc83b9caa799c836459c90b%2F38-uv-atlas.webp?alt=media)

创建图集的另一种方式是使用 Trim Sheet。这是 3D 建模和游戏开发中常见的技术，大型工作室和游戏行业会用它来确保视觉一致性并提高美术制作流程的效率。Trim Sheet 使用一张包含多个小细节或元素的图像或纹理，并将其应用于模型的不同部位。创建大型场景时，这种技术非常实用，因此应在美术制作流程的早期阶段就加以考虑。

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

*Trim Sheet 拼贴示例，使用了漫反射纹理、法线纹理和自发光纹理。*

这里有一个很棒的 [教程](https://www.artstation.com/blogs/jennifermcgarry/yd4Q/jenns-guide-to-trim-sheets) 作者是 [Jennifer McGarry](https://www.artstation.com/jennifermcgarry/blog) 介绍如何使用 Blender 制作 Trim Sheet！

## 纹理命名

**正确命名纹理至关重要。** 正确命名纹理可以：

* 让美术制作流程更加高效、灵活、有序，并便于定位和修改。
* 使用纹理提取器或其他工具时，避免同名纹理相互覆盖。
* 避免使用 Asset Bundles 时出现纹理覆盖问题。
* 在分析场景时，更高效地排查问题。

**如何正确命名纹理：**

* **资源名称** 应清楚地表明纹理所代表的内容。
* 纹理名称应以此前缀开头： `T_`.
* 纹理名称应以表示纹理类型的后缀结尾：
  * `_D` - **漫反射 / 颜色贴图**
  * `_A` - **Alpha 纹理**
  * `_MT` - **金属度**
  * `_R` - **粗糙度**
  * `_N` **- 法线贴图**
  * `_E` - **自发光**

例如，如果这是用于墙面的砖块纹理的漫反射贴图，可以将其命名为 `T_BrickWall_D` 如果是同一资源的法线贴图，则可以命名为 `T_BrickWall_N`

**示例：**

* 🟢 **推荐** 纹理名称以 - 开头 `T_Parquet_D`, `T_Floor_R`, `T_Pipes_MT`,
* 🔴 **避免** 纹理名称以 - 开头 `Image_`, `sprite_`,`Untitled`

## 可选工具

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

### UV 工具

* **UV Packer（免费）**:<https://www.uv-packer.com/blender/>
* **Zen UV：** <https://blendermarket.com/products/zen-uv>
* **Uvpackmaster 3：** <https://blendermarket.com/products/uvpackmaster>

### 图像压缩工具

你可以使用多种在线图像压缩工具来减小纹理文件的体积。以下列举几款：

* **CompressPNG：** <https://compresspng.com/>
* **TinyPNG：** <https://tinypng.com/>
* **FreeConvert：** <https://www.freeconvert.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/textures.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.
