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

# 씬 편집

Scene Editor는 Decentraland 씬을 만들고 게시할 수 있게 해주는 간단한 시각적 도구입니다.

Creator Hub에는 간단한 노코드 인터페이스와 코드를 작성해 씬을 더 세밀하게 사용자 지정할 수 있는 강력한 Scene Editor가 포함되어 있습니다.

![Creator Hub](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-4bb587d1b095c40805b28f7194d42697474dea03%2Ficon-creator-hub.png?alt=media\&token=65114cd1-c26b-4aca-99dd-b5e4c5c5dbab)

참고: [Creator Hub 설치](/creator/content-creator-ko/scene-editor/get-started/editor-installation.md) 시작하려면.

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

## 씬 만들기

새 씬을 만들려면 Creator Hub를 열고 다음 옆의 화살표를 클릭하세요 **만들기** 버튼을 클릭합니다. 드롭다운에서 다음을 선택하세요 **새 씬**.

![만들기 버튼의 드롭다운이 열려 있으며, 새 씬과 씬 가져오기 옵션이 보입니다.](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-36abbf1843260b86209d7b723e8cbd6c70036e7d%2Fcreate-dropdown.png?alt=media\&token=93d582f4-c379-4b20-8a0f-04dbb29eb3c7)

그런 다음 씬 이름을 지정하고 저장 위치를 선택하라는 메시지가 표시됩니다. 빈 씬 대신 초기 콘텐츠가 포함된 프로젝트로 시작하려면 다음을 클릭하세요 **템플릿** 에서  **씬** 탭을 선택하고 하나를 고르세요.

참고: [씬 관리](/creator/content-creator-ko/scene-editor/get-started/manage-scenes.md) 자세한 내용은 여기에서 확인하세요.

씬이 열리면 왼쪽에는 엔티티 트리, 가운데에는 캔버스, 오른쪽에는 선택한 항목의 속성, 아래에는 에셋 팩이 표시됩니다.

![작은 씬이 열린 Scene Editor: 왼쪽 엔티티 트리에는 Player, Camera, Scene과 몇 개의 항목이 나열되고, 캔버스에는 바비큐와 새 분수가 있는 잔디 바닥이 보이며, 오른쪽 속성 패널에는 선택된 Bird Fountain의 Transform 및 GLTF 컴포넌트가 표시됩니다.](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-133bafbc6b2f6452c18dd716327aa81218314b64%2Feditor-overview.png?alt=media\&token=01f5222c-a0e7-42c2-8e6b-d886cc889977)

참고: [Scene Editor 필수 요소](/creator/content-creator-ko/scene-editor/get-started/scene-editor-essentials.md) 각 섹션을 둘러보려면.

## 이동하기

Scene Editor를 둘러보려면:

* 다음을 사용하세요 **W** 그리고 **S** 를 사용해 가까이 또는 멀리 이동하세요. 마우스 스크롤 휠을 사용하거나 **+** 그리고 **-** 키
* 다음을 사용하세요 **A** 그리고 **D** 를 사용해 좌우로 이동하세요.
* 다음을 사용하세요 **Q** 그리고 **E** 를 사용해 위아래로 이동하세요.
* 다음을 사용하세요 **왼쪽 마우스 버튼** 을 사용해 항목을 클릭하고 선택한 다음 이동하세요.
* 다음을 사용하세요 **오른쪽 마우스 버튼** 을 누른 채 드래그하여 카메라를 회전하세요.

{% hint style="info" %}
**💡 팁**: 또한 다음을 눌러 카메라를 회전할 수 있습니다 **Alt** 를 Windows에서, 또는 **Option** 를 Mac에서 누른 채 드래그하세요. 특히 마우스 대신 트랙패드를 사용할 때 유용합니다.
{% endhint %}

* 다음을 누르세요 **스페이스바** 를 눌러 카메라를 기본 위치로 되돌리세요

## 아이템 추가

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

![](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\&token=99210953-9718-4fa7-895c-317c45f74d6e)

항목을 배치하려면 에셋 팩 메뉴에서 해당 항목을 클릭해 캔버스의 씬 안 위치로 드래그하세요.

![](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\&token=5d263b79-cd82-4436-bc8e-3a07e68df559)

선택한 항목을 클릭해 드래그하면 지면 수준에서 씬 안을 자유롭게 이동할 수 있습니다. 다음을 참조하세요 [Scene Editor 기본 사항](/creator/content-creator-ko/scene-editor/get-started/scene-editor-essentials.md#position-items) 자세한 내용은 여기에서 확인하세요.

{% hint style="info" %}
**💡 팁**: 일부 항목은 **스마트 항목**, 이 항목들은 내장된 상호작용 동작을 제공합니다. 다음을 참조하세요 [스마트 항목](/creator/content-creator-ko/scene-editor/interactivity/smart-items.md) 자세한 내용은 여기에서 확인하세요.
{% endhint %}

![](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\&token=8f5f5b70-db16-4d37-b41c-4ee0eafe87e4)

3D 보기의 창 높이를 최대한 활용하려면 탭 표시줄 오른쪽 끝의 꺾쇠 버튼으로 에셋 패널을 접으세요. 패널은 탭만 남길 정도로 줄어들며, 같은 버튼을 누르면 이전 높이로 다시 펼쳐집니다. 접힌 상태에서 아무 탭이나 클릭해도 다시 열립니다.

### 아바타 애니메이션

해당 **아바타 애니메이션** 팩에는 배치할 항목이 아니라 플레이어 아바타용 애니메이션이 들어 있습니다: 앉는 자세, 낚시, 상자 들기, 춤추기 등. 이것들은 같은 **Actions**, **앉기** 그리고 **표정** 그룹으로 나뉘며 나머지와 같습니다.

카드를 가리키면 애니메이션이 재생되는 것을 볼 수 있습니다. 3D 보기로 드래그하면 해당 파일이 씬의 로컬 에셋으로 복사됩니다. 애니메이션은 씬 안에 놓여 있는 것이 아니므로 엔티티는 추가되지 않습니다: 코드에서 재생합니다. 다음을 참조하세요 [아바타 애니메이션](/creator/content-creator-ko/sdk7/interactivity/avatars/avatar-animations.md).

다음이 표시된 카드 **내장** 배지는 다르게 작동합니다. 해당 애니메이션은 이미 Decentraland와 함께 제공되므로, 모든 씬에서 추가 파일 없이 재생할 수 있습니다. 드래그해서 넣을 수는 없습니다. 대신 카드에서 마우스 오른쪽 버튼을 클릭하고 다음을 선택하세요 **이름 복사** 를 클릭해 코드에서 사용할 이름을 가져오세요.

에서 **로컬 에셋** 탭에서, **아바타 애니메이션** 필터는 프로젝트의 애니메이션 파일과 읽기 전용 **내장 애니메이션** 폴더를 함께 모아 파일이 필요 없는 항목을 나열합니다.

## 미리보기

씬을 테스트하고 플레이어처럼 체험하려면 다음을 클릭하세요 **재생** 버튼을 화면 오른쪽 상단 모서리에서 클릭하세요. 그러면 Decentraland Desktop Explorer가 새 창으로 열리고, 오직 씬만 실행됩니다. 그곳에서 씬 안을 이동하고 상호작용 가능한 항목과 상호작용할 수 있습니다.

{% hint style="warning" %}
**📔 참고**: 기기에 설치되어 있지 않다면 다음을 다운로드하세요 **Decentraland Launcher** 에서 [Decentraland.org](https://decentraland.org).
{% endhint %}

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-30317b50bc4b4e646a1b28effe1ff76939ab0f28%2Fpreview-button.png?alt=media\&token=fbed0f2f-8063-4283-9b07-2d964c9c0e68)

다음 옆의 화살표를 클릭하세요 **재생** 버튼을 눌러 다음을 여세요 **재생 옵션** 메뉴를 열고, 데스크톱 클라이언트, 브라우저 또는 휴대폰에서 미리 볼지 선택하세요. 사용 가능한 모든 옵션의 전체 목록은 다음을 참조하세요 [장면을 미리보기](/creator/content-creator-ko/sdk7/getting-started/preview-scene.md) .

## 장면 렌더러

Scene Editor는 편집 캔버스의 기본 렌더러로 **Babylon** 을 사용합니다. 다음으로 전환할 수 있습니다 **Bevy(실험적)**.

렌더러를 변경하려면:

1. 왼쪽 상단의 Creator Hub 로고를 클릭하고 **설정**.
2. 으로 이동하세요. **실험적** 탭을 통해서입니다.
3. 켜기 **Bevy 씬 렌더러 사용**.

![실험적 탭의 앱 환경설정 대화상자이며, Bevy 씬 렌더러 사용 스위치가 보입니다.](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f6da3df8ec8d9406ec57a9eabac5665b12d7011d%2Fsettings-experimental.png?alt=media\&token=f31b0e80-88ef-4e66-80f7-4f7139783082)

Bevy 렌더러는 편집 캔버스를 위한 대체 엔진입니다. 게시 후 플레이어에게 어떻게 보이는지가 아니라, 편집할 때 씬이 어떻게 보이는지에 영향을 줍니다.

Bevy 렌더러를 사용하면 툴바에 카메라 모드 드롭다운, 캔버스에서 씬을 실행하기 위한 재생 및 중지 버튼, **상호작용** 토글(게임패드 아이콘), 그리고 **씬 오디오 음소거** 토글(스피커 아이콘)이 추가됩니다.

![Bevy 렌더러에서의 편집기 툴바: 실행 취소 및 다시 실행, 기즈모 도구, '자유'라고 표시된 카메라 드롭다운, 재생 및 중지 버튼, 상호작용 게임패드 토글, 환경설정 톱니바퀴, 검사기 버튼.](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6fc9e97a2b94bc9f72334ce6691f80760c50dfb6%2Feditor-toolbar-bevy.png?alt=media\&token=66943bd3-3fba-4e0b-99ed-3e257d99ef2f)

다음을 사용하세요 **상호작용** 별도 미리보기 창을 열지 않고 편집기 캔버스에서 바로 실행 중인 씬을 테스트하도록 토글합니다. 이를 통해 씬을 중지하지 않고도 상호작용을 빠르게 확인할 수 있습니다. 상호작용하는 동안 스마트 항목은 눌러야 할 키와 같은 힌트를 캔버스에 바로 표시합니다.

스피커 버튼을 클릭하세요. 라벨은 **씬 오디오 음소거**'씬 오디오 음소거'로 되어 있으며, 작업하는 동안 씬을 음소거합니다. 이는 편집 중과 씬이 캔버스에서 실행되는 동안 씬의 모든 [Audio Source](/creator/content-creator-ko/sdk7/3d/sounds.md) 및 오디오 스트림을 음소거하며, 씬이 다시 로드되어도 계속 음소거 상태로 유지됩니다. 다시 클릭하면, 이제 라벨이 **씬 오디오 켜기**로 바뀌며 소리가 다시 켜집니다. 이 버튼은 Bevy 렌더러에서만 표시되는데, Babylon 렌더러는 씬의 오디오를 재생하지 않기 때문입니다.

Bevy 편집기는 또한 [사용자 지정 항목](/creator/content-creator-ko/scene-editor/interactivity/custom-items.md)도 불러오고, 손상되었거나 누락된 에셋에 대한 자리표시자 표시를 보여주며, 씬의 SDK 종속성이 오래되었을 때 수정 작업이 포함된 친절한 오류 메시지도 제공합니다. 툴바의 카메라 토글에는 **자유** 또는 **플레이어**가 표시되며, 현재 모드에 따라 달라집니다.

{% hint style="warning" %}
**📔 참고**: 씬 메트릭스 탭은 Bevy에서 사용할 수 없습니다. 데스크톱 또는 모바일 클라이언트에서 씬 미리보기를 실행하고 거기서 통계를 확인하세요.
{% endhint %}

{% hint style="warning" %}
**참고:** Bevy 렌더러는 실험적 기능이며 기본 Babylon 렌더러가 제공하는 모든 편집 기능을 지원하지 않을 수 있습니다.
{% 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\&token=21677d31-8915-4809-a60a-6674c7497d98)

참고: [씬 설정](/creator/content-creator-ko/scene-editor/configure/scene-settings.md) 자세한 내용은 여기에서 확인하세요.

## 씬 게시

씬이 만족스러우면 다음을 누르세요 **게시** 버튼.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a9b358ccf604ec11addf4852ce36c321e35745e0%2Fpublish-options.png?alt=media\&token=8790912e-6224-459d-94da-4d3d86816f2e)

참고: [씬 게시](/creator/content-creator-ko/scene-editor/publish/publish-scene.md) 자세한 내용은 여기에서 확인하세요.

## 참고

* 참고: [Scene Editor 필수 요소](/creator/content-creator-ko/scene-editor/get-started/scene-editor-essentials.md) Scene Editor 인터페이스에 대한 자세한 내용을 확인하려면.
* 참고: [스마트 항목](/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 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/get-started/about-editor.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.