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

# 콜라이더

Decentraland로 가져온 3D 모델에 콜라이더를 추가하는 방법을 알아봅니다.

3D 모델과 씬의 사용자 간 충돌을 활성화하려면 모델에 콜라이더를 지정해야 합니다. 콜라이더가 없으면 플레이어는 모델이 없는 것처럼 모델을 통과해 걸어갈 수 있습니다. 또한 오브젝트가 플레이어의 포인터 이벤트에 반응하거나 이를 차단하려면, 또는 레이캐스트가 오브젝트와 교차하거나 오브젝트에 막히게 하려면 콜라이더가 필요합니다. 성능을 위해 콜라이더는 보이는 지오메트리보다 정점 수가 적은 단순한 비가시 지오메트리로 별도 모델링하는 경우가 많습니다.

{% hint style="info" %}
**💡 팁**:  [Decentraland Tools Blender 플러그인](https://extensions.blender.org/add-ons/decentraland-tools/)을 설치하세요. 이 플러그인에는 3D 모델, 웨어러블, Emote를 편집하고 내보내는 데 유용한 여러 기능이 포함되어 있습니다.
{% 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://3980763956-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 월드 엔진에 알려 콜라이더 메시를 보이지 않게 합니다.

플레이어가 씬에서 가로등 모델을 볼 때는 복잡한 가로등 모델이 보입니다. 하지만 가로등에 부딪히면 나무가 아닌 상자와 충돌합니다.

## 플레이어의 공간 제약

플레이어가 걸어 다닐 수 있도록 모델을 디자인할 때는 다음 기준 치수를 고려해야 합니다.

* 플레이어는 점프하지 않고 약 40cm 높이의 단차를 올라갈 수 있습니다. 45cm 이상인 단차를 오르려면 점프해야 합니다. 계단을 편하게 오르내릴 수 있도록 각 단의 높이는 25cm 이하, 깊이는 최소 30cm로 설정하세요.
* 플레이어는 점프하지 않고 최대 46도의 경사면을 올라갈 수 있습니다. 이보다 가파른 곳에서는 아바타가 미끄러져 내려갑니다. 편하게 걸을 수 있도록 경사로는 30도 이하로 설정하세요. 계단 위에 경사로 콜라이더를 배치하는 경우는 예외입니다. 계단의 경사를 따르며, 높이 25cm, 깊이 30cm인 계단의 경우 약 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-ko/sdk7/designing-the-experience/design-games.md#build-interiors-larger-than-real-life).

플레이어가 씬에서 나무 모델을 볼 때는 복잡한 나무 모델이 보입니다. 하지만 나무에 부딪히면 나무가 아닌 상자와 충돌합니다.

### 계단에 콜라이더 추가하기

계단은 콜라이더 오브젝트를 사용하는 매우 일반적인 사례입니다. 플레이어가 계단을 오르려면 밟고 올라설 수 있는 해당 \_collider 오브젝트가 있어야 합니다.

계단 콜라이더에는 경사로 오브젝트를 사용하는 것이 좋습니다. 오르내릴 때 훨씬 자연스럽게 움직일 수 있기 때문입니다. 계단을 오를 때 각 단을 하나씩 “점프”하는 대신 부드럽게 올라가거나 내려가는 것처럼 보입니다.

경사로 오브젝트를 사용하면 불필요한 지오메트리 생성도 방지해 더 복잡한 모델을 위한 공간을 절약할 수 있습니다. 콜라이더 지오메트리도 계산에 포함된다는 점을 기억하세요. [**씬 제한**](https://docs.decentraland.org/creator/development-guide/scene-limitations/)

1. 원래 계단의 크기와 비율을 닮은 경사로 모양의 새 오브젝트를 만듭니다.

![](https://3980763956-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://3980763956-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* 모델로 함께 내보냅니다.

이제 플레이어가 씬의 계단을 볼 때는 더 정교한 계단 모델이 보이지만, 계단을 오를 때는 경사로와 충돌합니다.

## 콜라이더 최적화

* 다음 형태의 **Box**, **Sphere** 및 **Capsule** 충돌 메시를 우선 사용하세요. 로딩과 런타임 성능이 향상됩니다.
* 복잡한 충돌 메시를 여러 기본 도형 충돌 메시로 근사하는 방법을 고려하세요(**Box**/**Sphere**/**Capsule**)

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

*예: 링의 콜라이더는 여러 개의 Capsule 또는 Box 콜라이더로 구성할 수 있습니다.*

* 충돌 메시를 관련 오브젝트의 계층 구조 안에 배치하세요. 예를 들어 Spaceship\_collider는 계층 구조상 Spaceship 부모 오브젝트의 자식으로 둘 수 있습니다.

### 볼록 콜라이더와 오목 콜라이더

임의의 메시 콜라이더를 사용하는 것이 유일한 방법이라면, 충돌 메시를 오목(Concave)이 아닌 볼록(Convex)으로 설정하세요. 이렇게 하면 콜라이더 내부에서 떨리거나 끼이는 현상, 콜라이더를 뚫고 지나가는 현상과 같은 비정상적인 물리 동작을 방지할 수 있습니다. 오목한 메시 하나를 여러 개의 볼록 메시로 흉내 낼 수 있는 경우가 많다는 점도 참고하세요.

![](https://3980763956-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 형태로 근사할 수 있다면, 다음 세 가지 접미사 중 하나를 추가로 사용하세요: \_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-ko/3d/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.
