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

# 재질

Decentraland로 가져온 3D 모델에서 지원되는 재질 속성과 텍스처를 알아봅니다.

재질은 *.gltf* 또는 *.glb* 파일에 포함됩니다.

{% hint style="info" %}
**💡 팁**:  [Decentraland Tools Blender 플러그인](https://extensions.blender.org/add-ons/decentraland-tools/)을 설치하세요. 이 플러그인에는 3D 모델, 웨어러블, Emote를 편집하고 내보내는 데 유용한 여러 기능이 포함되어 있습니다.
{% endhint %}

이 문서에서는 3D 모델에서 가져온 재질을 다룹니다. 기본 도형에 적용할 재질을 코드로 정의하는 방법은 [**재질**](https://docs.decentraland.org/creator/development-guide/materials/) .

{% hint style="warning" %}
**📔 참고**: 기본 도형이 아닌 경우, 현재는 씬의 코드에서 3D 모델의 재질을 동적으로 변경할 수 없습니다.
{% endhint %}

## 셰이더 지원

Decentraland로 가져온 모델에서 모든 셰이더를 사용할 수 있는 것은 아닙니다. 다음 중 하나를 사용하세요:

* **표준 재질:** 확산, 정반사, 투명도 등의 셰이더를 모두 지원합니다.
* **PBR(물리 기반 렌더링) 재질**: 이 셰이더는 확산, 거칠기, 금속성, 발광 등의 속성을 포함하므로 더 유연합니다. 이러한 속성으로 재질이 빛과 상호작용하는 방식을 설정할 수 있습니다.

아래 이미지는 동일한 색상과 텍스처를 사용해 만든 똑같은 모델 두 개를 보여 줍니다. 왼쪽 모델은 모두 *PBR* 재질을 사용하며, 일부에는 *금속성*, *투명도*, 그리고 *발광*이 포함되어 있습니다. 오른쪽 모델은 모두 *표준* 재질을 사용하며, 일부에는 *투명도* 및 *발광*.

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

### 현재 Decentraland 엔진에서 작동하는 PBR 속성

> * 기본 색상
> * 금속성
> * 거칠기
> * 정반사
> * 발광
> * 발광 강도
> * 알파
> * 노멀

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

### 알파

재질을 *투명하게*설정할 수 있습니다. 투명 재질은 *알파*값에 따라 다양한 정도로 비쳐 보입니다. 투명도를 설정하려면 재질의 투명도 속성을 활성화한 다음 *알파* 을 원하는 값으로 설정하세요. 알파가 1이면 재질이 완전히 불투명해지고, 0이면 보이지 않게 됩니다.

아래 이미지는 표준 머티리얼로 만든 동일한 모델 두 개를 보여 줍니다. 왼쪽 모델은 불투명 머티리얼만 사용하고, 오른쪽 모델은 일부에 투명 머티리얼과 불투명 머티리얼을 모두 사용합니다.

{% hint style="warning" %}
💡 투명 머티리얼은 확산 머티리얼보다 성능 비용이 항상 더 높다는 점을 기억하세요. 투명 머티리얼은 가능한 한 적게 사용하세요.
{% endhint %}

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

투명도 모드는 크게 두 가지입니다. *알파 클립* 과 *알파 블렌드*. 주요 차이점은 다음과 같습니다.

* **알파 클립:** 알파 클립은 그레이스케일 값의 클립 임계값을 기준으로 알파 값을 0 또는 1로 렌더링합니다. 알파 값이 클립 임계값보다 높은 경우에만 이전 색상이 표면 색상으로 덮어써집니다.

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

* **알파 블렌드:** 알파 블렌드는 0과 1 사이의 값을 보간합니다. 알파 블렌딩을 사용하면 이전 색상 위에 표면 색상을 겹쳐 표시할 수 있습니다.

![](https://3980763956-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" %}
**🔥최적화 팁🔥** 중간 단계의 투명도가 꼭 필요한 경우가 아니라면, **렌더링 성능을 위해 항상 \_알파 클립을 사용하는 것이***\*\*보다 더 효율적입니다. \*\****알파 블렌드**\_**.**
{% endhint %}

{% hint style="warning" %}
**⚠️ 정렬 문제**

게임에서 투명 블렌드 모드를 사용할 때는 색상 블렌딩이 적용되는 순서를 고려하는 것이 중요합니다. 블렌딩 순서에 따라 최종 출력 색상이 크게 달라질 수 있기 때문입니다. 현재 엔진은 객체 단위 정렬만 지원하므로, 객체의 원점을 기준으로 모든 투명 표면을 자동 정렬합니다. 하지만 프래그먼트(픽셀) 단위 정렬과 삼각형 단위 정렬은 지원하지 않습니다.

정렬 관련 문제를 방지하려면 같은 메시에서 알파 클립과 알파 블렌드를 모두 사용하는 객체는 피하는 것이 좋습니다. 이렇게 하면 예상치 못한 블렌딩 아티팩트를 방지하고 게임을 보기 좋게 유지할 수 있습니다.
{% endhint %}

### 발광

머티리얼을 *발광*하도록 설정할 수도 있습니다. 발광 머티리얼은 자체적으로 빛을 냅니다. 하지만 렌더링 시 장면의 주변 객체를 실제로 비추는 것은 아니며, 주변에 흐릿한 빛이 있는 것처럼 보일 뿐입니다.

아래 이미지는 표준 머티리얼로 만든 동일한 모델 두 개를 보여 줍니다. 오른쪽 모델의 일부 표면에는 빛나는 발광 머티리얼이 적용되어 있습니다.

![](https://3980763956-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://3980763956-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://3980763956-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://3980763956-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"*&#xB4F1;
* 🔴 **사용하지 마세요** 다음과 같은 이름을 *"Material009"*, *"material1"*&#xC0AC;용하면 장면과 모델을 추적하고 분석하기가 매우 어려워집니다.

## glTF 재질 재정의

장면 코드에서 *glTF* 모델의 재질을 재정의하려면 [GltfNodeModifiers](https://docs.decentraland.org/creator/content-creator-ko/sdk7/3d/materials.md#modify-gltf-materials) 컴포넌트를 사용할 수 있습니다. 자세한 내용은 [glTF 재질 수정](https://docs.decentraland.org/creator/content-creator-ko/sdk7/3d/materials.md#modify-gltf-materials) 을 참조하세요.

## 재질 모범 사례

* 장면에 동일한 텍스처를 사용하는 모델이 여러 개 포함되어 있다면, 3D 모델에 텍스처를 임베드하는 대신 외부 파일로 참조하세요.

임베드된 텍스처는 모델마다 복제되어 장면의 크기를 늘립니다. *.glb* 파일에는 기본적으로 텍스처가 임베드되지만, [**glTF pipeline**](https://github.com/AnalyticalGraphicsInc/gltf-pipeline) 을 사용해 텍스처를 외부로 추출할 수 있습니다.

> 참고: 임베드하지 않을 텍스처 파일을 참조하도록 설정한 후에는 해당 파일을 이동하거나 이름을 변경하지 마세요. 그러면 파일 참조가 끊어집니다. 또한 파일이 장면과 함께 업로드되도록 장면 폴더 안에 있어야 합니다.

* 재질의 투명도를 설정할 때는 *알파 클립* 을 *알파 블렌드*보다 항상 우선적으로 사용하세요. 유리처럼 부분적으로 투명한 재질이 꼭 필요한 경우는 예외입니다. 이렇게 하면 엔진이 모델의 앞뒤를 잘못 렌더링하는 문제를 방지할 수 있습니다.
* 일반적으로 재질에서 항상 *뒷면 컬링* 을 설정해야 합니다. 엔진이 모델의 보이는 면만 렌더링하므로 장면의 성능이 향상됩니다. 다음과 같은 경우에만 해제하세요. *뒷면 컬링* 모델의 양면을 모두 렌더링해야 하는 경우(예: 3D 평면으로 만든 나뭇잎 무리).

![](https://3980763956-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) 를 사용하면 에셋이 훨씬 빠르게 렌더링됩니다.
* glTF 모델에서 PBR 텍스처를 사용하는 전체 아트 파이프라인에 대한 자세한 개요는 [**이 문서**](https://www.khronos.org/blog/art-pipeline-for-gltf) 를 참조하세요.
* 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-ko/3d/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.
