> 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-5367cb41c363e65a52e8beaf39559643751a7b1f%2F01-3d-essentials-banner%20\(1\).png?alt=media) Decentraland에 3D 모델을 가져올 때는 glTF 형식인지 반드시 확인하는 것이 중요합니다. 이러한 모델에는 다양한 지원 기능이 포함될 수 있습니다. 이 섹션에서는 Decentraland와 호환되도록 만드는 방법과 모범 사례를 따르는 방법을 다룹니다. {% hint style="info" %} **💡 팁**: 다음을 설치하세요 [Decentraland Tools Blender 플러그인](https://extensions.blender.org/add-ons/decentraland-tools/). 여기에는 3D 모델, 착용 아이템, 이모트를 편집하고 내보내는 데 도움이 되는 여러 유용한 기능이 포함되어 있습니다. {% endhint %} 모든 모델, 셰이더 및 텍스처는 다음을 준수해야 합니다. [**씬 제한 사항**](https://docs.decentraland.org/creator/scenes-sdk7/optimizing/scene-limitations/). ## **지원되는 3D 모델 형식** Decentraland의 모든 3D 모델은 glTF 형식이어야 합니다. [**glTF**](https://www.khronos.org/gltf) (GL 전송 형식)은 Khronos의 오픈 프로젝트로, 3D 에셋을 위한 공통적이고 확장 가능한 형식을 제공하며, 효율적이면서도 최신 웹 기술과의 상호 운용성이 매우 뛰어납니다. glTF 모델은 다음 중 하나의 *.gltf* 또는 *.glb* 확장자를 가질 수 있습니다. glTF 파일은 사람이 읽을 수 있으므로 텍스트 편집기에서 열어 JSON 파일처럼 읽을 수 있습니다. 이는 예를 들어 애니메이션이 올바르게 연결되어 있는지 확인하고 이름을 점검하는 데 유용합니다. glb 파일은 바이너리이므로 읽을 수는 없지만 크기가 훨씬 작아 씬 성능에 좋습니다. 작업 중에는 *.gltf* 를 사용하는 것을 권장하지만, *.glb* 업로드할 때는 다음과 같은 3D 모델의 요소는 다음 중 하나로 포함할 수 있습니다. *glTF* 파일에 포함되거나 외부에서 참조될 수 있습니다: * 텍스처는 파일에 포함되거나 외부 이미지 파일에서 참조될 수 있습니다. * 기하 구조, 애니메이션 및 모델의 기타 버퍼 관련 요소에 대한 이진 데이터는 외부 *.bin* 파일을 추가할 수 있습니다. {% hint style="warning" %} **📔 참고**: 애니메이션 *반드시* 안에 포함되거나 *glTF* 파일에서 참조되어 Decentraland에 사용할 수 있습니다. 또한 각 모델은 UV 맵을 1개만 가질 수 있습니다. {% endhint %} ## **glTF를 사용하는 이유** 우리는 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-30e38513ce59831ac027cf1787af061bfdb7c267%2F02-export-glt-from-blender%20\(1\).png?alt=media) ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-86db9dd94033fbf82446265353dce37915351452%2F03-exporting-options%20\(1\).png?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-bf9bd765a4a99705f7649909c74acd6dddb860d1%2F04-preview-gltf%20\(1\).png?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-9d1b28696f55191432bb5c9c315c7497f91b970c%2F05-gltf-sample-viewer%20\(1\).png?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-ca94129743df645c2e758d463f7837dea3dd03d0%2F05-gltf-report%20\(1\).png?alt=media) ## **glTF 최적화** 다음 도구는 씬의 플레이어들에게 3D 모델을 더 가볍고 빠르게 다운로드되도록 만드는 몇 가지 최적화를 제공합니다. [glTF 파이프라인](https://github.com/AnalyticalGraphicsInc/gltf-pipeline) 그중에서도 *.gltf* 형식을 *.glb*로 변환합니다. 이 형식은 이진이므로 훨씬 더 적은 공간을 차지합니다. 또한 텍스처 파일을 3D 모델 외부에 배치하므로 여러 모델에서 동일한 텍스처를 사용할 수 있습니다. {% hint style="warning" %} **📔 참고**: *.glb* 형식은 기본적으로 항상 텍스처가 파일에 포함되어 있습니다. 엔진은 포함된 두 텍스처를 동일한 것으로 인식할 수 없으며, 같은 해시를 공유하는 외부 파일이어야 합니다. {% endhint %} ## 또한 참조 다음 페이지에서도 Decentraland의 3D 모델과 관련된 주제를 다룹니다: * [메시](/creator/content-creator-ko/3d/meshes.md) * [재질](/creator/content-creator-ko/3d/materials.md) * [텍스처](/creator/content-creator-ko/3d/textures.md) * [콜라이더](/creator/content-creator-ko/3d/colliders.md) * [애니메이션](/creator/content-creator-ko/3d/animations.md) * [유용한 자료](/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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.decentraland.org/creator/content-creator-ko/3d/3d-models.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.