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

# 3D 모델

외부 3D 모델에서 지원되는 에셋과 컴포넌트를 알아보고, Decentraland로 가져오기 전에 이를 어떻게 설정하는지 알아봅니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-53d39d4a954bc59ae0ec6b47e31b8dc04d0c6a4b%2F01-3d-essentials-banner.webp?alt=media)

Decentraland로 3D 모델을 가져올 때는 glTF 형식인지 확인해야 합니다. 이러한 모델에는 다양한 지원 기능을 포함할 수 있습니다. 이 섹션에서는 모델을 Decentraland와 호환되게 만들고 모범 사례를 따르는 방법을 알아봅니다.

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

모든 모델, 셰이더, 텍스처는 다음을 준수해야 합니다. [**씬 제한 사항**](https://docs.decentraland.org/creator/scenes-sdk7/optimizing/scene-limitations/).

## **지원되는 3D 모델 형식**

Decentraland의 모든 3D 모델은 glTF 형식이어야 합니다. [**glTF**](https://www.khronos.org/gltf) (GL Transmission Format)는 Khronos에서 개발한 개방형 프로젝트로, 3D 에셋을 위한 공통의 확장 가능한 형식을 제공합니다. 효율적이며 최신 웹 기술과 상호 운용성이 뛰어납니다.

glTF 모델의 확장자는 다음 중 하나입니다. *.gltf* 또는 *.glb* 입니다. glTF 파일은 사람이 읽을 수 있으므로 텍스트 편집기에서 열어 JSON 파일처럼 읽을 수 있습니다. 예를 들어 애니메이션이 올바르게 연결되었는지 확인하고 이름을 살펴볼 때 유용합니다. glb 파일은 바이너리 형식이라 읽을 수 없지만 크기가 훨씬 작아 씬 성능에 도움이 됩니다.

씬 작업 중에는 *.gltf* 를 사용하고, 업로드할 때는 *.glb* 로 전환하는 것을 권장합니다.

3D 모델의 다음 요소는 *glTF* 파일에 포함하거나 외부에서 참조할 수 있습니다.

* 텍스처는 파일에 포함하거나 외부 이미지 파일에서 참조할 수 있습니다.
* 모델의 지오메트리, 애니메이션 및 기타 버퍼 관련 요소에 관한 바이너리 데이터는 파일에 포함하거나 외부 *.bin* 파일에서 참조할 수 있습니다.

{% hint style="warning" %}
**📔 참고**: 애니메이션은 *반드시* Decentraland에서 사용하려면 *glTF* 파일에 포함해야 합니다. 또한 각 모델에는 UV 맵을 하나만 사용할 수 있습니다.
{% endhint %}

## **glTF를 사용하는 이유**

glTF는 다음을 비롯한 강력한 기능을 제공하므로 사용합니다.

* 계층적 오브젝트
* 골격 구조 및 애니메이션
* 머티리얼 및 셰이더를 위한 견고한 파이프라인
* 광원 및 카메라와 같은 씬 정보(향후 개발에서 사용할 수 있음)

지원 기능은 *COLLADA*와 매우 유사합니다. 하지만 glTF는 편집기 형식이 아닌 '전송 형식'을 제공하는 데 초점을 두므로 웹 기술과의 상호 운용성이 더 뛰어납니다.

## **glTF 내보내기 및 변환**

### **Blender에서 glTF로 내보내기**

Blender에는 기본 glTF 내보내기 기능이 있습니다.

내보내려면 .glb 파일에 포함할 모델을 선택한 다음 File - Export - glTF 2.0으로 이동합니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a0c73d489695d94bf1513516f3c5070882415328%2F02-export-glt-from-blender.webp?alt=media) ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-fd4b360f85f1f67052fee21ce7e2ac5dcda0e37e%2F03-exporting-options.webp?alt=media)

*씬에서 선택한 오브젝트만 내보내려면 측면 패널에서 “Selected Objects”를 선택합니다. 또한 Mesh 드롭다운에서 Apply Modifiers(해당하는 경우)를 선택한 다음 Export를 클릭합니다.*

### **3D Studio Max에서 glTF로 내보내기**

3D Studio Max는 기본적으로 glTF 내보내기를 지원하지 않지만 플러그인을 설치해 기능을 추가할 수 있습니다.

1. 다음에서 플러그인을 다운로드합니다. [이 링크](https://github.com/BabylonJS/Exporters/tree/master/3ds%20Max).
2. 다음 안내에 따라 플러그인을 설치합니다. [이 지침](http://doc.babylonjs.com/resources/3dsmax#how-to-install-the-3ds-max-plugin).
3. 플러그인을 사용해 glTF 파일을 내보내려면 [다음 안내를 따르세요](http://doc.babylonjs.com/resources/3dsmax_to_gltf).

### **Maya에서 glTF로 내보내기**

Maya는 기본적으로 glTF 내보내기를 지원하지 않지만, 플러그인을 설치하면 사용할 수 있습니다.

1. 다음 안내에 따라 플러그인을 설치합니다. [이 지침](http://doc.babylonjs.com/resources/maya).
2. 플러그인을 사용해 glTF 파일을 내보내려면 [다음 안내를 따르세요](http://doc.babylonjs.com/resources/maya_to_gltf#pbr-materials).

{% hint style="warning" %}
**📔 참고**: 대안으로 [다른 플러그인](https://github.com/WonderMediaProductions/Maya2glTF) 도 사용해 볼 수 있습니다.
{% endhint %}

### **Unity에서 glTF로 내보내기**

Unity는 기본적으로 glTF 내보내기를 지원하지 않지만, 플러그인을 설치하면 사용할 수 있습니다.

다음에서 플러그인을 다운로드합니다. [이 링크](https://github.com/sketchfab/Unity-glTF-Exporter).

{% hint style="warning" %}
**📔 참고**: 대안으로 [다른 플러그인](https://assetstore.unity.com/packages/tools/utilities/collada-exporter-for-unity2017-99793) 도 사용해 볼 수 있습니다.
{% endhint %}

### **SketchUp에서 glTF로 내보내기**

SketchUp은 기본적으로 glTF 내보내기를 지원하지 않지만, 플러그인을 설치하면 사용할 수 있습니다.

다음에서 플러그인을 다운로드합니다. [이 링크](https://extensions.sketchup.com/en/content/gltf-exporter).

### **FBX를 glTF로 변환하기**

*.fbx* 는 3D 모델에 널리 사용되는 표준입니다. 저희 엔진에서는 지원하지 않지만, 쉽게 내보내 *.fbx* 모델을 *.gltf* 형식으로 저장할 수 있습니다.

다음 도구를 추천합니다:

* [**Blender**](https://www.blender.org/download/): .fbx를 glTF로 쉽게 변환하려면 Blender에서 .fbx를 가져와 씬을 만든 다음, 해당 씬에서 내보내면 됩니다.
* [**Facebook의 CLI 도구**](https://github.com/facebookincubator/FBX2glTF): 가장 안정적인 대안이지만, 명령줄을 사용해야 합니다.
* [**Blackthread**](https://blackthread.io/gltf-converter): 웹 기반 도구 중 가장 기능이 완전합니다. CLI보다 안정성은 떨어지지만 사용하기는 훨씬 쉽습니다.
* [**Modelconverter**](https://modelconverter.com/convert.html): 사용하기 쉬운 또 다른 웹 기반 도구입니다.

## **glTF 모델 미리 보기**

glTF 모델을 씬으로 가져오기 전에 내용을 빠르고 쉽게 미리 보려면 [**Babylon.js Sandbox**](https://sandbox.babylonjs.com/). glTF 파일(해당하는 경우 *.bin* 파일도 함께)을 캔버스에 끌어다 놓으면 모델을 볼 수 있습니다.

샌드박스에서는 모델에 포함된 애니메이션도 미리 볼 수 있습니다. 드롭다운 메뉴에서 애니메이션을 선택하면 표시할 애니메이션을 지정할 수 있습니다.

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

## **glTF 분석하기**

glTF를 분석하는 데 유용한 도구로 [**glTF Sample Viewer**](https://github.khronos.org/glTF-Sample-Viewer-Release/)가 있습니다. 이 도구를 사용하면 채널과 텍스처를 살펴보고, 다양한 조명 환경에서의 반응을 확인하고, 애니메이션을 미리 보는 등 여러 작업을 할 수 있습니다. 개별 모델에 적합합니다.

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

또 다른 유용한 도구는 [**gltf.report/**](https://gltf.report/)입니다. 모델을 웹사이트에 끌어다 놓기만 하면 glTF 패키지의 내용을 확인하고 최적화할 수 있는 모델 부분을 파악할 수 있습니다.

이 도구는 여러 모델과 텍스처, 애니메이션이 포함된 대용량 파일을 다룰 때 특히 유용합니다. 예를 들어 텍스처를 크기별로 정렬하면 리소스를 가장 많이 사용하는 텍스처를 쉽게 파악할 수 있습니다.

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

## **glTF 최적화하기**

다음 도구를 사용하면 3D 모델의 용량을 줄여 씬의 플레이어가 더 빠르게 다운로드할 수 있도록 최적화할 수 있습니다.

[glTF pipeline](https://github.com/AnalyticalGraphicsInc/gltf-pipeline)

이 도구는 여러 기능 중 하나로 *.gltf* 형식을 *.glb*로 변환합니다. .glb는 바이너리 형식이므로 용량이 훨씬 작습니다. 또한 텍스처 파일을 3D 모델 외부에 두므로 여러 모델에서 같은 텍스처를 사용할 수 있습니다.

{% hint style="warning" %}
**📔 참고**: *.glb* 형식은 기본적으로 항상 텍스처를 파일에 포함합니다. 엔진은 파일에 포함된 두 텍스처가 동일한지 인식할 수 없으므로, 동일한 해시를 공유하는 외부 파일이어야 합니다.
{% endhint %}

## 관련 항목

다음 페이지에서도 Decentraland용 3D 모델과 관련된 주제를 다룹니다.

* [메시](https://docs.decentraland.org/creator/content-creator-ko/3d/meshes.md)
* [머티리얼](https://docs.decentraland.org/creator/content-creator-ko/3d/materials.md)
* [텍스처](https://docs.decentraland.org/creator/content-creator-ko/3d/textures.md)
* [콜라이더](https://docs.decentraland.org/creator/content-creator-ko/3d/colliders.md)
* [애니메이션](https://docs.decentraland.org/creator/content-creator-ko/3d/animations.md)
* [유용한 리소스](https://docs.decentraland.org/creator/content-creator-ko/sdk7/getting-started/useful-resources.md): 3D 작업 흐름을 빠르게 진행하는 데 유용한 Blender 애드온, 에셋 라이브러리 및 AI 도구


---

# 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/3d-models.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.
