> 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/get-started/scene-editor-essentials.md).

# 씬 에디터 필수 사항

씬 에디터 사용 방법

씬 편집기의 UI는 서로 다른 목적을 가진 몇 개의 섹션으로 나뉩니다.

![
](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-80eb7f0f2596e0dde68a93113665f40c1157ea1e%2Feditor-layout.png?alt=media)

* **캔버스**: 항목을 직접 조작하고 씬이 어떻게 보이는지 확인하세요.
* **엔티티 트리**: 씬의 모든 항목과 그 계층 구조 목록을 포함합니다.
* **속성**: 현재 선택된 항목에 대한 세부 정보를 표시합니다.
* **자료**: 사용할 수 있는 리소스를 보여줍니다.

## 이동

씬 편집기에서 이동하는 방법:

* 사용: **W** 및 **S** 를 눌러 가까이 또는 멀리 이동합니다. 마우스 스크롤 휠이나 **+** 및 **-** 키
* 사용: **하나의** 및 **D** 를 눌러 좌우로 이동합니다.
* 사용: **Q** 및 **E** 를 눌러 위아래로 이동합니다.
* 다음의 **오른쪽 마우스 버튼** 을 누른 채 드래그하여 카메라를 회전합니다.
* 다음 키를 누르세요 **스페이스바** 를 눌러 카메라를 기본 위치로 되돌립니다
* 사용: **왼쪽 마우스 버튼** 을 클릭하여 항목을 선택하고 이동합니다.

## 모바일에서 미리보기

옆의 드롭다운에는 **미리보기** 버튼에 **모바일용 QR 코드 표시** 옵션이 있습니다. 같은 Wi‑Fi 네트워크에 있는 휴대폰으로 QR 코드를 스캔하여 씬을 [Decentraland 모바일 앱](/creator/content-creator-ko/build-for-mobile/mobile-client/overview.md)에서 씬을 열 수 있습니다. 이는 모바일 플레이어를 위한 UI, 조작, 성능 검증에 권장되는 방법입니다. 참조 [모바일에서 미리보기](/creator/content-creator-ko/build-for-mobile/develop/preview-on-mobile.md) 전체 가이드는 다음을 참조하세요.

## 지면 설정

씬의 지면에는 다양한 텍스처를 사용할 수 있습니다. 아이템 메뉴의 다양한 테마별 에셋 팩에서 이를 찾을 수 있습니다.

유형이 **지면** 인 항목에는 페인트통 아이콘이 표시됩니다. 이를 씬으로 끌어다 놓으면 이 항목의 복사본으로 씬의 모든 지면을 덮습니다.

![
](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-8d952452b5bf6475868c3392c6f0472690587580%2Fground.png?alt=media)

또한 **Shift** 를 누른 채 지면을 씬으로 드래그하면 항목의 복사본 하나를 추가할 수도 있습니다.

![
](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-069d473c6ec47b6f54ae95ee9d91bb27c2e81665%2Fground-entities.png?alt=media)

지면 항목 모음은 [엔티티 트리](#the-entity-tree) 안의 폴더에 나타납니다. 그 각각은 실수로 선택하는 것을 방지하기 위해 잠겨 있습니다. [잠금 해제](#lock-or-hide-items) 하여 항목을 이동하거나 편집하세요.

## 항목 추가

하단 메뉴에서 테마별 에셋 팩 카테고리를 탐색해 씬에 배치할 수 있는 다양한 항목을 찾아보세요.

![
](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-533d4553c3a38522cdd08dce8040a08c038699e7%2Fasset-packs.png?alt=media)

검색 상자를 사용할 수도 있습니다. 에셋 팩 안에 있을 때는 검색이 해당 에셋 팩에서만 이루어진다는 점에 유의하세요.

항목을 배치하려면 에셋 팩 메뉴에서 항목을 클릭한 채 캔버스의 씬 내 원하는 위치로 드래그하세요.

![
](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-30237e6006c76b69f5cfe737e543875987ed67b8%2Fdrop-item.gif?alt=media)

{% hint style="info" %}
**💡 팁**: 씬의 항목을 추가, 이동하거나 속성을 편집할 때마다 변경 사항이 자동으로 저장됩니다.
{% endhint %}

항목을 복제하려면 선택한 다음 **Ctrl + C** 그리고 나서 **Ctrl + V**를 누르세요. 또한 [엔티티 트리](#the-entity-tree) 에서 항목을 마우스 오른쪽 버튼으로 클릭하고 옵션 **복제**를 선택할 수도 있습니다. 새 항목은 원본과 완전히 겹쳐 있게 됩니다.

씬에서 항목을 삭제하려면 선택한 다음 *삭제* 키를 누르세요.

참고 [항목 가져오기](/creator/content-creator-ko/scene-editor/build/import-items.md) 디스크에서 직접 사용자 지정 3D 모델을 추가할 때 사용합니다.

{% hint style="warning" %}
**📔 참고**: 3D 모델을 씬으로 드래그하면 프로젝트 폴더에 다운로드되며, 삭제해도 그 안에 남아 있습니다. 이렇게 사용되지 않는 모델은 씬의 크기를 늘릴 수 있습니다.

다음을 여세요 **로컬 에셋** 탭에서 사용하지 않는 모델을 삭제하세요.
{% endhint %}

## 항목 배치

{% embed url="<https://www.youtube.com/watch?v=cNl02PFPdcQ>" %}

클릭하고 **왼쪽 마우스 버튼** 를 누른 상태에서 선택한 항목을 드래그하면 지면 수준에서 씬 안을 자유롭게 이동할 수 있습니다.

또한 상단 메뉴의 도구를 사용할 수 있습니다:

![
](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-4b95b511c15b05517739d57d024d0f0b23007782%2Fgizmos.png?alt=media)

* **이동 도구**: 각 화살표를 클릭하고 드래그하여 항목을 한 축씩 이동합니다. 이 도구를 사용하면 지면보다 높은 위치에 항목을 놓을 수도 있습니다.
* **회전 도구**: 항목 주위의 각 고리를 클릭하고 드래그하여 항목을 한 축씩 회전시킵니다.
* **크기 조절 도구**: 기즈모의 중앙을 클릭하고 안팎으로 드래그하여 크기를 키우세요. 이 도구를 사용하면 한 축으로 항목을 늘려 비율을 바꿀 수도 있습니다. 그러려면 기즈모의 축 중 하나를 클릭하고 드래그하세요.

![
](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-dfe9363a387a120ae140da69d76e1c66dc5d5399%2Fmove-items.gif?alt=media)

항목을 이동, 회전 또는 크기 조절할 때 더 높은 정밀도를 얻으려면 *Shift* 키를 누른 채로 유지하세요. 이렇게 하면 그리드에 맞춰 달라붙는 것을 방지할 수 있습니다.

이동 세분화 및 기타 설정을 변경하려면 도구 오른쪽의 아래쪽 화살표를 클릭하세요. 다음 설정을 사용할 수 있습니다:

* **스냅**: 그리드를 켜거나 끕니다. 꺼져 있을 때 **Shift** 의 동작은 반대로 됩니다: 기본적으로는 그리드를 따르지 않고,  **Shift**.
  * **위치**: 이동 증분의 크기(미터 단위) **스냅** 가 켜져 있을 때.
  * **회전**: 회전 증분의 크기(도 단위) **스냅** 가 켜져 있을 때.
  * **스케일**: 크기 조절 증분의 크기 **스냅** 가 켜져 있을 때.
* **월드에 정렬**: 기즈모에 사용되는 축을 가리키는 단일 체크박스입니다. 체크되어 있으면 이동 및 회전 도구의 축은 항상 월드에 맞춰지며, 오브젝트의 방향에 따라 바뀌지 않습니다. 체크 해제되어 있으면 오브젝트의 방향에 맞춰집니다.

여러 항목을 동시에 선택하려면 선택하는 동안 *제어* 키를 누른 채로 유지하세요. 그러면 한 번의 작업으로 모두 이동, 회전, 크기 조절, 복제 또는 삭제할 수 있습니다.

## 스마트 아이템

스마트 항목은 내장된 인터랙티브 동작이 포함된 특별한 항목입니다. 참조 [스마트 아이템](/creator/content-creator-ko/scene-editor/interactivity/smart-items.md) 자세한 내용은 다음을 참조하세요.

![
](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f368bfdf7894d18f29875528bdd91cf8429e70b3%2Fsmart-items.jpg?alt=media)

## 엔티티 트리

왼쪽 여백에는 씬의 모든 엔티티가 있는 트리 구조가 보입니다. 여기에는 추가한 모든 항목과 몇몇 기본 엔티티가 포함됩니다.

{% hint style="info" %}
**💡 팁**: 씬의 모든 것은 엔티티이며, 씬의 기본 구성 요소입니다. 항목은 최소한 위치와 보이는 모양을 가진 엔티티입니다.
{% endhint %}

씬의 3D 보기에서 항목을 클릭해 선택하는 대신 트리 보기에서 선택할 수도 있습니다. 엔티티를 마우스 오른쪽 버튼으로 클릭하면 더 많은 옵션이 표시됩니다. 이름 변경, 삭제, 복제, 자식 엔티티 생성, 또는 엔티티에 컴포넌트 추가를 할 수 있습니다.

### 엔티티 트리 검색

엔티티 트리 상단의 검색 상자를 사용하면 이름으로 엔티티를 찾을 수 있습니다. 엔티티 이름의 일부를 입력하면 트리가 해당 엔티티와 그 부모 계층만 표시하도록 필터링되어, 각 일치 항목이 트리의 어디에 있는지 확인할 수 있습니다. 검색은 대소문자를 구분하지 않습니다. 일치 항목의 부모 엔티티는 자동으로 펼쳐져 모든 결과가 보입니다.

다음 키를 누르세요 **Esc** 를 누르거나 지우기 아이콘을 클릭하여 필터를 제거하고 전체 트리로 돌아가세요. 엔티티가 선택된 상태에서 검색을 지우면 선택된 엔티티로 다시 스크롤되어 위치를 잃지 않습니다.

\[스크린샷: 검색어가 입력된 엔티티 트리, 필터링된 결과와 펼쳐진 부모 계층 구조 표시]

### 엔티티 계층 구조

엔티티는 원하는 만큼 많은 수준을 가질 수 있는 계층 구조를 따릅니다. 트리에서 한 항목을 다른 항목 위로 드래그하여 두 엔티티 사이에 부모-자식 관계를 설정하세요. 자식 엔티티는 부모의 위치를 상속하므로 부모가 이동하면 자식도 함께 이동합니다. 이는 씬을 만들 때 유용할 수 있습니다. 예를 들어 안경과 접시를 테이블의 자식으로 설정한 다음, 다른 것을 다시 맞출 필요 없이 테이블만 이동할 수 있습니다. 씬과 상호작용할 때 항목들이 함께 움직이도록 하는 데도 중요할 수 있습니다.

![
](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a184c50ad6e26c4a37418ff8c28de2067ad3b02a%2Fitem-hierarchy.png?alt=media)

또한 엔티티의 자식들을 최소화하거나 펼쳐서 보기를 간단하게 유지할 수 있으며, 이 작업은 씬에는 영향을 주지 않습니다.

### 특수 엔티티

씬에는 엔티티 트리에서 볼 수 있는 몇 가지 특수 엔티티가 포함됩니다.

* **씬**: 이는 루트 엔티티를 의미하며, 씬에 추가하는 모든 것은 이 엔티티의 자식입니다. 이를 열어 [씬 설정](#scene-settings).
* **플레이어**: 플레이어의 아바타입니다. 게임플레이 메커니즘을 바꿀 수 있는 특수 컴포넌트를 이 엔티티에 추가할 수 있습니다. 또한 다른 엔티티를 아바타의 자식으로 드래그할 수도 있습니다. 엔티티가 아바타의 자식이면 그 위치는 플레이어에 고정됩니다. 예를 들어 플레이어의 머리 위에 떠 있는 마커를 추가하여 플레이어를 따라다니게 할 때 사용할 수 있습니다.
* **카메라**: 플레이어의 카메라입니다. 다른 엔티티를 카메라의 자식으로 드래그할 수 있습니다. 엔티티가 카메라의 자식이면 그 위치는 화면에 고정됩니다. 예를 들어 슈팅 게임에서 총을 표시할 때 사용하면, 플레이어가 위나 아래를 향해도 항상 화면에 보이게 할 수 있습니다.

### 항목 잠그기 또는 숨기기

실수로 선택하거나 이동하는 것을 방지하기 위해 가끔 항목을 잠그는 것이 유용할 수 있습니다. 이는 지면이나 건물 같은 배경 항목에 특히 유용합니다. 항목을 잠그려면 왼쪽의 엔티티 트리에서 해당 항목을 찾고, 마우스를 올린 뒤 잠금 아이콘을 선택하세요. 같은 아이콘을 통해 이 동작을 켜거나 끌 수 있습니다.

또한 다른 항목을 배치하는 동안 시야를 가릴 수 있는 항목을 숨기고 싶을 수도 있습니다. 이는 내부를 작업하는 동안 지붕이나 건물을 숨길 때 특히 유용합니다. 숨겨진 항목은 플레이어에게는 보이지 않고, Scene Editor의 캔버스 창에서만 숨겨집니다. 항목을 숨기려면 왼쪽의 엔티티 트리에서 해당 항목을 찾고, 마우스를 올린 뒤 눈 아이콘을 선택하세요. 같은 아이콘을 통해 이 동작을 켜거나 끌 수 있습니다.

![
](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-fb3144eb3c62fc5b632f69e8944f3392e91d8d0e%2Fhide-lock-item.png?alt=media)

## 속성 패널

캔버스나 엔티티 트리에서 항목을 클릭하여 선택하세요. 그러면 화면 오른쪽의 속성 패널에 해당 컴포넌트가 표시됩니다. 항목마다 서로 다른 컴포넌트가 있으며, 각 컴포넌트는 특정 설정을 표시합니다.

![
](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c9c570da87ad3e8ba629f2a0c0b64ea2587a34ac%2Fcomponents-in-editor.png?alt=media)

대부분의 비상호작용 항목에는 다음 컴포넌트가 있습니다:

* **Transform**: 항목의 위치, 회전, 크기를 설정합니다.
* **GLTF**: 불러올 3D 모델

[스마트 아이템](/creator/content-creator-ko/scene-editor/interactivity/smart-items.md) 은 다른 컴포넌트를 포함할 수 있습니다.

참고 [컴포넌트](/creator/content-creator-ko/scene-editor/build/components.md) 자세한 내용을 알아보세요.

## 씬 제한 사항

Decentraland 씬은 서로 나란히 실행될 수 있도록 특정 제한을 따라야 합니다. 씬의 구획 수에 비례하는 재질, 텍스처, 삼각형 등의 최대 개수가 있습니다. 참조 [씬 제한 사항](/creator/content-creator-ko/sdk7/optimizing/scene-limitations.md) 자세한 내용은 다음을 참조하세요.

씬의 콘텐츠가 이러한 제한 중 하나라도 초과하면 Scene Editor가 왼쪽 아래 모서리에 이를 알려줍니다.

![
](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-88f68a93b0cfcb7f8c48270f31ba7137655ee2e1%2Ftriangle-limit1.png?alt=media)

이 메뉴를 펼치면 자세한 내용을 볼 수 있습니다.

![
](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-aebaad725f1d9397552b2fb36a318eec91589b9c%2Ftriangle-limit2.png?alt=media)

{% hint style="info" %}
**💡 팁**: Decentraland World를 만들고 있다면 언제든 [씬 크기](/creator/content-creator-ko/scene-editor/configure/scene-settings.md#layout) 를 늘려 제한을 증가시킬 수 있습니다.
{% endhint %}

Decentraland 씬의 콘텐츠는 이웃 구획으로 넘쳐나지 않도록 해야 합니다. 씬의 모델 일부가 제한을 넘어가면, 씬 미리보기를 열 때 그 부분이 잘려 보입니다. Scene Editor는 전체 모델을 빨간색으로 표시하지만, 실제로는 씬 제한을 넘어가는 모델 부분만 주의하면 됩니다.

![
](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5eb877a01228cb5624728411a6bb06d3e0cfa194%2Fout-of-bounds.png?alt=media)

{% hint style="info" %}
**💡 팁**: 표시하려는 모델이 맞지 않으면 씬 크기를 늘리는 것이 좋습니다. 참조 [씬 크기](/creator/content-creator-ko/scene-editor/configure/scene-settings.md#layout) 를 통해 씬을 더 크게 하세요.
{% endhint %}

3D 모델의 전체 기하 구조가 씬에 들어가더라도, 모델의 바운딩 박스가 영역을 넘어가면 빨간색으로 표시될 수 있습니다. 이 경우 전체 모델은 올바르게 표시되므로 경고를 무시해도 됩니다. 에 대해 자세히 알아보기 [바운딩 박스](/creator/content-creator-ko/3d/meshes.md#bounding-boxes).

## 에셋 정리

더 이상 사용되지 않는 에셋을 제거하여 프로젝트를 깔끔하게 유지하세요. 화면 하단의 **로컬 에셋** 탭을 열고 브러시 아이콘을 클릭하세요.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-01a4d7c5065b98293092e6d7bad815766a62af29%2Fbrush-icon.png?alt=media)

대화 상자가 열리며 씬의 모든 에셋 목록이 표시되고, 어떤 항목에서도 참조되지 않는 에셋이 강조 표시됩니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-496245893e408c868cc77aa4989002aa713c8e71%2Fclean-up-assets.png?alt=media)

체크박스를 사용하여 삭제할 에셋을 선택한 다음 **선택한 항목 제거** 를 클릭하여 영구적으로 삭제하세요.

씬에서 항목을 삭제해도 해당 파일은 제거되지 않습니다. 가져온 모델, 텍스처 또는 사운드는 정리할 때까지 프로젝트에 남아 있으므로, 사용하지 않는 에셋을 주기적으로 검토하세요.

{% hint style="warning" %}
**중요:** 씬에 에셋을 참조하는 코드가 포함되어 있으면, 사용 중인 일부 에셋이 사용되지 않는 것으로 표시될 수 있습니다. 이 대화 상자는 Creator Hub UI의 컴포넌트에서 참조된 에셋만 감지합니다.  **선택한 항목 제거**를 클릭하면 파일이 프로젝트 폴더에서 삭제되며, 이 작업은 영구적이고 되돌릴 수 없습니다.
{% endhint %}

## 씬 설정

다음의 **연필 아이콘** 를 화면 오른쪽 상단에서. 그러면 편집할 수 있는 씬 수준 속성들이 열립니다.

![
](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d2147688ebde75948ba26a9fbe1261f9abdc66c7%2Fpencil-icon.png?alt=media)

여기에서 제목과 썸네일, 씬 크기, 씬 카테고리와 연령 등급, 플레이어 스폰 위치, 기능 토글 등 여러 속성을 구성할 수 있습니다.

참고 [씬 설정](/creator/content-creator-ko/scene-editor/configure/scene-settings.md).

## 또한 참조

* 참고 [스마트 아이템](/creator/content-creator-ko/scene-editor/interactivity/smart-items.md) 씬에 간단한 상호작용을 추가하는 방법은
* 참고 [코드와 결합](/creator/content-creator-ko/scene-editor/extend-with-code/overview.md) 씬 코드 편집 방법은
* 참고 [씬 게시](/creator/content-creator-ko/scene-editor/publish/publish-scene.md) 씬을 Decentraland에 게시하는 방법은


---

# 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/scene-editor/get-started/scene-editor-essentials.md?ask=<question>&goal=<endgoal>
```

`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.