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

# 碰撞体

了解如何为导入到 Decentraland 的 3D 模型添加碰撞体。

若要让 3D 模型与场景中的玩家发生碰撞，必须为模型添加碰撞体。没有碰撞体时，玩家可以像模型不存在一样直接穿过它。若要让物体响应玩家的指针事件或阻挡这些事件，或让射线检测与其相交或被其阻挡，也需要碰撞体。出于性能考虑，碰撞体通常会单独建模为更简单的不可见几何体，其顶点数少于可见几何体。

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

模型可以使用不可见几何体作为碰撞体；或者（从 SDK7 开始）也可以将可见几何体指定为碰撞体。请参阅 [**3D 模型上的碰撞体**](https://docs.decentraland.org/creator/development-guide/sdk7/colliders/#colliders-on-3d-models) 。你还可以为不同几何体分配不同的碰撞层，以便分别控制玩家物理、指针事件和其他自定义层。请参阅 [**3D 模型上的碰撞体**](https://docs.decentraland.org/creator/development-guide/sdk7/colliders/#collision-layers) .

碰撞体不会影响模型和实体之间的交互，它们始终可以相互重叠。碰撞体只影响模型与玩家化身之间的交互。

要让 Decentraland 场景将某个物体识别为碰撞体，只需按特定方式为其命名。物体名称必须以“\_collider”后缀结尾。

例如，要为路灯创建碰撞体，可以创建一个简单的盒体包住灯柱。场景中的玩家看不到这个盒体，但它会挡住玩家的去路。

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

在这种情况下，我们可以将盒体命名为“LampPost*collider”，并将树和盒体一起导出为一个 \_\_gltf 模型。\*\_\_collider*\* 标签会通知 Decentraland 世界引擎，该盒体属于碰撞体集合，并使碰撞网格不可见。

玩家在场景中看到路灯模型时，会看到复杂的路灯模型。但走到它旁边时，玩家会与盒体而不是树发生碰撞。

## 玩家空间尺寸限制

设计供玩家行走的模型时，请牢记以下参考尺寸：

* 玩家无需跳跃即可迈上约 40 厘米高的台阶。45 厘米或更高的台阶则需要跳跃。为了让楼梯走起来舒适，每级台阶的高度应不超过 25 厘米，深度至少为 30 厘米。
* 玩家无需跳跃即可走上坡度不超过 46 度的斜坡。坡度更大的表面会让化身滑落。为了便于行走，坡道的坡度应保持在 30 度或以下。楼梯上方的坡道碰撞体是个例外：它应顺着楼梯的坡度设置；当台阶高 25 厘米、深 30 厘米时，坡度约为 40 度（请参阅 [为楼梯添加碰撞体](#add-a-collider-to-a-staircase)).
* 玩家最多可以跳起 1.8 米
* 化身的身高约为 1.9 米，但请考虑到他们头上可能戴着帽子或其他可穿戴物品。
* 化身的碰撞体是一个宽 0.6 米的胶囊体（半径为 0.3 米）。高度低于约 1.85 米的横梁或天花板会挡住化身。玩家行走路线的净高至少应为 2 米。在室内应留出更多空间供摄像机使用，请参阅 [室内空间应比现实中的更大](https://docs.decentraland.org/creator/content-creator-zh/chang-jing-sdk7/ti-yan-she-ji/design-games.md#build-interiors-larger-than-real-life).

玩家在场景中看到树模型时，会看到复杂的树模型。但走到树旁边时，玩家会与盒体而不是树发生碰撞。

### 为楼梯添加碰撞体

楼梯是碰撞体对象很常见的一种用途。玩家要能爬上楼梯，就必须有一个对应的 \_collider 对象供玩家踩踏。

我们建议使用坡道对象作为楼梯的碰撞体，这样上下楼梯的体验会好得多。玩家爬楼梯时，动作看起来会平滑上升或下降，而不必“跳”上每一级台阶。

使用坡道对象还可以避免创建不必要的几何体，为其他更复杂的模型节省空间。请注意，在计算 [**场景限制**](https://docs.decentraland.org/creator/development-guide/scene-limitations/)

1. 创建一个坡道形状的新对象，使其大小和比例与原楼梯相近。

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

2. 将坡道对象命名为类似 S*tair\_collider*的名称。名称必须以 \_*collider*.
3. 将坡道对象与楼梯重叠放置，使两者占据相同的空间。

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

4. 将两个对象一起导出为一个 *glTF* 模型。

这样一来，玩家在场景中看到楼梯时，会看到更精细的楼梯模型；但爬楼梯时，他们会与坡道发生碰撞。

## 优化碰撞体

* 优先使用 **盒体**, **球体** 和 **胶囊体** 碰撞网格，因为它们在加载和运行时的性能更好。
* 可以考虑用多个基本形状的碰撞网格来近似复杂的碰撞网格（**盒体**/**球体**/**胶囊体**)

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

*示例：环形物体的碰撞体可以由多个胶囊体或盒体组成*

* 将碰撞网格放在其所属对象的层级结构内。例如，从层级结构的角度来看，Spaceship\_collider 可以是 Spaceship 父对象的子对象。

### 凸面与凹面碰撞体

如果只能使用任意网格碰撞体，请将碰撞网格设为凸面（而非凹面）。这样可以避免出现奇怪的物理现象，例如抖动、卡在碰撞体内部或穿透碰撞体。请注意，通常可以用多个凸面网格来模拟凹面网格。

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

## 碰撞体命名

**使用有意义的名称。名称应说明资产的使用场景，或它对应对象的哪个部分。**

资产命名采用 `PascalCase` 与 `snake_case`的混合形式，我们称之为 `PascalSnake_case`。基本规则是：新单词或分隔符（`_`）后的单词以 **大写字母开头。**

碰撞网格是在 Explorer 中创建碰撞体时用作参照的网格

* 它遵循上述网格的相同原则，但末尾要添加 `_collider` 后缀 **示例：** 🟢 **推荐使用** 以下名称： `Tram_Wheel_LeftFront_collider` 🔴 **避免使用** 以下名称： `Primitive.001_Collider`, `collider (1)`, `Cylinder.007_collider`,

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

如果碰撞体可以用方盒、球体或胶囊体形状近似表示，请使用以下三种后缀之一：\_box、\_sphere 或 \_capsule。使用这三种形状进行碰撞检测，而不是使用任意网格，可以提升场景性能并缩短加载时间 💪🚀

示例：🟢 Teater\_MainWall\_North\_collider\_box、Fountain\_Statue\_collider\_sphere
{% endhint %}

## 碰撞体最佳实践

* **创建碰撞体时，三角形数量应尽可能少。** 避免复制复杂对象并将副本用作碰撞体。简单的碰撞体能确保良好的用户体验，并使场景保持在三角形数量限制之内。
* **碰撞体对象不应具有任何材质**，因为场景中的玩家永远看不到它。碰撞体对玩家不可见。
* **所有碰撞体对象的名称都必须以 \_*****collider*****.** 结尾*例如，T*.
* **ree\_collider**如果将 \_plane\_\*\* 用作碰撞体，它只会阻挡一个方向。\*\*如果想让碰撞体双向阻挡（例如用作墙壁），则需要创建两个平面，并让它们的法线朝向相反方向。
* 复制碰撞体对象时，请留意它们的名称。有些程序会在文件名末尾追加 \_*1* 以避免重名，例如 *tree\_collider\_1*。Decentraland World Engine 会将这类名称的对象识别为普通对象，而不是碰撞体。
* 向实体添加一个不可见的 `MeshCollider` 组件来近似 3D 模型的形状，就可以避免添加碰撞网格。
* 你也可以配置 `GLTFContainer` 组件，将可见几何体用作碰撞体，从而避免添加碰撞网格。参见 [**3D 模型上的碰撞体**](https://docs.decentraland.org/creator/development-guide/sdk7/colliders/#colliders-on-3d-models) .
* 如果要创建包含许多网格形状的 3D 模型，并且每个形状都需要碰撞体，可以使用一些实用的附加组件来帮忙。对于 Blender，你可以使用 Blender 中的批量重命名选项，自动为一组中的所有网格名称添加 `_collider` 后缀。有关此工具的更多信息，请参阅“**使用 Blender 重命名资源”部分**


---

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