> 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/scene-editor/build/import-items.md). # 사용자 지정 에셋 가져오기 씬에서 사용할 자신만의 3D 모델, 이미지, 사운드 등을 가져옵니다. 장면 편집기에 직접 3D 모델을 가져올 수 있습니다. 인터넷에서 무료 또는 유료로 제공되는 다양한 소스에서 모델을 선택하거나, 직접 맞춤형 모델을 만들 수 있습니다. 이미지, 사운드 파일, 비디오 같은 다른 에셋도 가져올 수 있습니다. {% embed url="" %} ## 에셋 가져오기 로컬 디스크에서 3D 모델, 이미지, 사운드 파일 또는 비디오를 장면으로 가져오려면: 1. 파일을 하단 패널로 직접 드래그하세요. 또한 **+ 에셋 가져오기** 버튼을 하단 패널 왼쪽 위에서 클릭하고 로컬 드라이브에서 선택하세요. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5948f0f1cc9c6dcf332a8b5398abf3a03bfa5a6b%2Fimport-assets.png?alt=media\&token=b446baae-3ec1-4e75-aa08-a4083655a06c) 2. 모델 썸네일을 확인하고 **가져오기**. 여러 에셋을 가져오는 경우 화살표 버튼을 사용해 각 에셋을 순환하세요. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-40d2f049b11f39a8ff535565ffb2c47f1366e916%2Fimport-confirmation.png?alt=media\&token=76a7552f-b366-4f71-8d48-d2dae1092a0e) 이제 에셋을 **로컬 에셋** 탭에서 찾을 수 있습니다. 에셋은 유형별로 폴더에 정렬됩니다. 3D 모델은 *assets/Models* 폴더 아래에, 이미지는 *assets/Images*, 사운드 파일은 *assets/Audio*, 비디오는 *assets/Video*. 기본 제공 무료 에셋 팩의 항목은 *assets/asset-packs/*아래에 저장되고, 편집기에서 만든 맞춤 항목은 *assets/custom/*. 이전 장면에는 사용자 가져오기가 *assets/scene/* 아래에 있을 수 있습니다. 이 경로들은 모두 장면 코드에서 작동하며, 에셋이 있는 폴더를 그대로 참조하면 됩니다. * 3D 모델의 경우, `.glb` 또는 `.gltf` 파일을 캔버스로 드래그하여 장면의 항목으로 추가하세요. * 이미지, 사운드 또는 비디오 파일도 캔버스로 드래그할 수 있습니다. 편집기가 이미 파일을 가리키는 준비된 항목을 만듭니다: * 하나의 `.png`, `.jpg` 또는 `.jpeg` 파일은 다음이 됩니다 **이미지** 항목이 됩니다. * 하나의 `.mp3`, `.ogg` 또는 `.wav` 파일은 주변음 항목이 됩니다. * 하나의 `.mp4` 파일은 다음이 됩니다 **비디오 화면** 항목이 됩니다. 새 항목은 파일 이름을 따서 명명되며, 에셋 팩의 해당 항목과 동일한 구성 요소와 설정으로 제공되므로, 바로 인스펙터에서 조정할 수 있습니다. * 어떤 에셋이든 이미 장면에 있는 항목의 필드에도 드래그할 수 있습니다. 예를 들어 `.mp3` 파일을 *경로* 필드에 *오디오 소스* 컴포넌트를 추가해야 합니다. {% hint style="info" %} **💡 팁**: 또한 프로젝트의 `assets` 폴더에 Finder, Explorer 또는 다른 곳에서 파일을 직접 붙여넣을 수도 있습니다. 복사가 끝난 직후 **로컬 에셋** 탭에 저절로 나타납니다. 표시되지 않으면 **새로 고침** 버튼을 **에셋 가져오기** 버튼.  {% endhint %} ### 지원되는 형식 #### 오디오 다음 오디오 형식이 지원됩니다: * *.mp3* * *.wav* * *.ogg* #### 이미지 다음 이미지 형식이 지원됩니다: * *.png* * *.jpg* * *.jpeg* #### 비디오 다음 비디오 형식이 지원됩니다: * *.mp4* #### 3D 모델 다음 3D 모델 형식이 지원됩니다: * *.glTF* * *.glb* 둘 다 외부 텍스처 이미지 파일 또는 외부 바이너리(*.bin*) 파일을 포함할 수 있습니다. 다른 형식은 다양한 편집기와 도구로 이러한 형식으로 변환할 수 있습니다. 다음을 참조하세요. [3D 모델링](/creator/content-creator-ko/3d/3d-models.md) 추천과 팁을 위해. 모델의 모든 재질은 다음 중 하나여야 합니다. *기본 재질* 또는 *PBR*, 그리고 모든 텍스처는 2의 거듭제곱 크기(예: 256, 512)여야 합니다. 다음을 참조하세요. [장면 제한](/creator/content-creator-ko/sdk7/optimizing/scene-limitations.md) 를 참조하세요. 어떤 유형이든 가져온 각 파일은 장면에서 사용할 수 있으려면 50MB 미만이어야 합니다. 더 큰 파일은 지원되지 않습니다. **3D 모델용 무료 라이브러리** 직접 3D 모델을 만드는 대신, 여러 무료 또는 유료 라이브러리에서 다운로드하거나 AI 도구로 생성할 수도 있습니다. 다음을 참조하세요. [유용한 자료](/creator/content-creator-ko/sdk7/getting-started/useful-resources.md) 권장 에셋 라이브러리와 생성형 AI 도구 목록은 {% hint style="warning" %} **📔 참고**: 다운로드한 콘텐츠에 적용되는 라이선스 제한에 주의하세요. {% endhint %} 이들 사이트 중 몇 곳에서는 모델을 어떤 형식으로 다운로드할지 선택할 수 있습니다. 항상 *.glTF* 또는 *.glb* 형식을 선택하세요. 사용할 수 없다면, 장면에서 사용하기 전에 *.glTF* 또는 *.glb* 로 변환해야 합니다. 이를 위해 Blender로 가져온 다음 사용 가능한 *.glTF* 내보내기 애드온으로 내보내는 것을 권장합니다. ### 콜라이더 미리보기를 실행하면 플레이어가 가져온 3D 모델을 통과해 걸어갈 수 있다는 것을 알 수 있습니다. 이는 모델에 충돌 지오메트리를 정의할 *콜라이더 메시를 포함시킵니다.* 수 없기 때문일 가능성이 높습니다. 다음을 참조하세요. [충돌체](/creator/content-creator-ko/3d/colliders.md) 자세한 내용과 지침은. {% hint style="info" %} **💡 팁**: 모델을 편집하여 *콜라이더 메시를 포함시킵니다.*를 추가하는 대신, 더 간단한 대안은 *보이지 않는 벽* 스마트 항목을 거의 같은 모양으로 추가하여 그 자리를 대신하게 하는 것입니다. {% endhint %} ### 애니메이션 가져온 모델에 애니메이션이 포함되어 있으면, 모델에 묶여 있는 첫 번째 애니메이션이 반복 재생됩니다. 애니메이션이 언제 시작되거나 멈추는지, 또는 여러 애니메이션이 있을 경우 어느 것이 재생되는지에 대해서는 제어할 수 없다는 점에 유의하세요. 장면에 여러 플레이어가 있는 경우, 서로 애니메이션이 동기화되지 않은 상태로 보일 수 있습니다. 이 동작을 변경하려면 다음을 포함할 수 있습니다. **애니메이터** 컴포넌트가 붙은 모든 플레이어를 순회하세요. 자세한 내용은 [모든 항목을 스마트 아이템으로 만들기](/creator/content-creator-ko/scene-editor/interactivity/make-any-item-smart.md) 노코드 도구로 항목을 상호작용 가능하게 만들기 위한 --- # 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/scene-editor/build/import-items.md?ask=&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.