> 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/sdk7/kinds-of-projects/scene-metadata.md).

# 씬 메타데이터

씬을 설정하고 메타데이터를 구성하는 방법을 알아보세요.

씬은 공간적으로 경계가 정해져 있고 하나 이상의 구획에 매핑되는 Decentraland 프로젝트입니다. 씬을 Decentraland Genesis City 지도에 배포하면 플레이어는 씬의 좌표를 방문해 씬을 경험할 수 있습니다. 씬을 다음에 배포하면 [월드](https://docs.decentraland.org/creator/content-creator-ko/sdk7/publishing/publishing-options.md#decentraland-worlds)에는 URL을 통해 방문할 수 있습니다.

씬 프로젝트에서 사용하는 파일 목록은 [씬의 파일](https://docs.decentraland.org/creator/content-creator-ko/sdk7/kinds-of-projects/scene-files.md) 을 참조하세요.

## 메타데이터

에서 씬의 메타데이터를 수정하려면 씬을 열고 [Creator Hub의 씬 편집기](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/get-started/about-editor.md)에서 **연필 아이콘**.

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

을 클릭하세요. 그러면 여러 속성을 설정할 수 있는 씬 메뉴가 열립니다.

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

또는 모든 값이 저장된 `scene.json` 파일을 직접 수정할 수도 있습니다.

{% hint style="warning" %}
**📔 참고** 이 페이지에 언급되지 않은 사용자 지정 필드를 `scene.json` 파일에 추가하지 마세요. 씬을 불러올 때 문제가 발생할 수 있습니다.
{% endhint %}

## 씬 제목, 설명 및 이미지

플레이어의 관심을 끌고 씬에서 무엇을 기대할 수 있는지 알 수 있도록 제목과 설명을 작성하고 썸네일 이미지를 설정하는 것이 매우 중요합니다.

플레이어가 지도에서 씬의 구획을 선택하면 모달 창에 이러한 정보가 표시됩니다. 또한 다른 씬에서 그곳으로 [순간 이동](https://docs.decentraland.org/creator/content-creator-ko/sdk7/interactivity/external-links.md) 할 때 표시되는 확인 화면에서도 볼 수 있습니다. 이 정보를 매력적으로 작성하면 씬 방문자 수를 크게 늘리는 데 도움이 됩니다.

플레이어가 월드를 탐색하다 씬에 들어오면 미니맵 아래에서 씬 제목을 볼 수 있습니다.

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

씬 편집기의 씬 메뉴에서 이 정보를 추가하세요.

다른 개발자가 여러분에게 연락할 수 있도록 씬에 연락처 정보를 추가할 수도 있습니다.

{% hint style="info" %}
**📔 참고** 월드는 씬 메타데이터와 별도로 고유한 이름, 설명, 썸네일을 사용합니다. 월드에 씬이 하나만 있으면 게시할 때마다 월드의 메타데이터가 씬의 메타데이터로 업데이트됩니다. 씬이 여러 개 포함된 경우 월드 메타데이터는 씬 메타데이터와 별개이며 Creator Hub의 **관리** 탭에서만 수정할 수 있습니다. 자세한 내용은 [월드 메타데이터와 씬 메타데이터 비교](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/publish/publish-scene.md#world-metadata-vs-scene-metadata).
{% endhint %}

### 씬 썸네일

썸네일은 `navmapThumbnail` 필드에 설정합니다. 이미지 형식은 *.png* 또는 *.jpg* 이어야 하며 가로세로 비율은 **16:9** 이어야 합니다. *1920x1080* 픽셀을 권장합니다. 16:9 비율만 유지하면 다른 크기도 사용할 수 있습니다.

플랫폼의 일부 영역에서는 썸네일을 중앙 기준으로 잘라 정사각형으로 축소해 표시합니다. 이때 크기는 *1080x1080* 픽셀입니다. 텍스트나 로고처럼 중요한 요소가 잘리지 않도록 이 안전 영역 안에 배치하세요.

{% hint style="warning" %}
**📔 참고** Creator Hub에서는 16:9가 아닌 이미지를 사용할 수 없습니다. 다른 비율의 이미지를 `navmapThumbnail` 에 직접 지정하면 이미지를 표시하는 클라이언트에서 예측할 수 없이 늘어나거나 잘릴 수 있습니다. 자세한 내용은 [씬 썸네일](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/configure/scene-settings.md#scene-thumbnail).
{% endhint %}

![씬 썸네일 안전 영역: 전체 1920x1080 이미지에서 중앙의 1080x1080 정사각형은 안전 영역으로 표시하고, 좌우 띠는 잘리는 영역으로 표시합니다.](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-16b056fbe6b140419900fa4e47cdb080320ca8b1%2Fscene-thumbnail-safe-area.webp?alt=media)

의 이미지 `navmapThumbnail` 에는 프로젝트 폴더에 있는 이미지 파일의 경로를 지정해야 합니다. 다른 곳에 호스팅된 이미지의 URL을 지정할 수도 있습니다.

{% hint style="warning" %}
**📔 참고**: 이미지를 다른 곳에 호스팅하는 경우, 다른 사이트에 콘텐츠를 표시할 수 있도록 CORS 정책이 허용적인 사이트인지 확인하세요.
{% endhint %}

{% hint style="warning" %}
**📔 참고**: 이 필드에 다음 파일을 지정하지 마세요. `assets/Images/autogenerated-thumbnail.png` (또는 `assets/images/autogenerated-thumbnail.png` (이전 프로젝트의 경우). Creator Hub는 썸네일을 캡처할 때마다 해당 파일을 덮어씁니다. 자세한 내용은 다음을 참조하세요. [파일 이름을 autogenerated-thumbnail.png로 지정하지 마세요](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/configure/scene-settings.md#dont-name-your-file-autogenerated-thumbnailpng).
{% endhint %}

## 카테고리

플레이어가 Decentraland를 탐색하는 데 도움이 되도록 씬에 카테고리를 추가할 수 있습니다. 카테고리는 [Decentraland Places dApp](https://places.decentraland.org) 에서 각 장소를 분류하고 플레이어가 원하는 콘텐츠를 더 쉽게 찾도록 하는 데 사용됩니다.

**카테고리는** 미리 정의된 다음 옵션 중에서 선택해야 합니다.

* 🎨 예술
* 🕹️ 게임
* 🃏 카지노
* 👥 소셜
* 🎶 음악
* 👠 패션
* 🪙 암호화폐
* 📚 교육
* 🛍️ 쇼핑
* 🏢 비즈니스
* 🏅 스포츠
* 🏃 파쿠르

씬에는 여러 카테고리를 지정할 수 있으며, 최대 3개까지 등록할 수 있습니다.

scene.json 파일에서 `scene.json` 카테고리는 `tags` 배열에 나열됩니다.

미리 정의된 카테고리는 다음과 같습니다.

* `art`
* `game`
* `casino`
* `social`
* `music`
* `fashion`
* `crypto`
* `education`
* `shop`
* `business`
* `sports`
* `parkour`

예를 들어, `game`  및  `casino`  태그를 장면에 지정하려면 다음 내용을  `scene.json`

```json
  "tags": [
    "game",
    "casino",
  ],
```

그 후 Places dApp의  `game`  및  `casino`  카테고리에 장면이 표시됩니다.

## 연령 등급

장면의  **연령 등급**  필드는 콘텐츠를 분류하는 데 사용됩니다. Decentraland는 18세 이상을 위한 플랫폼입니다. 다음 옵션을 사용할 수 있습니다.

* **🟡 `A`  성인용(18세 이상)**: Decentraland의  [이용 약관](https://decentraland.org/terms)에 명시된 최소 연령 요건입니다. 장면에 중간 수준이거나 심한 욕설, 폭력, 노골적인 콘텐츠, 도박 또는 알코올, 담배, 마약과 같은 성인에게 적합한 콘텐츠가 포함되어 있다면 이 카테고리를 선택하세요.

연령 등급을  `scene.json`에서 수정할 때는  **한 글자 코드**를 사용합니다. 성인용은  **A** 로 입력합니다.  `rating`  필드는 JSON 트리의 루트 수준에 위치합니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a28e388dcdd8223c5e6bc19f6af043f50f307fc6%2Fcontent-moderation-flag-icon.webp?alt=media)

```json
 "rating": "A"
```

### 제한된 콘텐츠

장면에는 세 번째 카테고리인 🔴  `R` (제한)이 있습니다. 이 등급은 Decentraland의  [콘텐츠 정책](https://decentraland.org/content)을 위반하는 장면에 콘텐츠 관리자가 수동으로 적용합니다. 위반 사항에는 다음이 포함될 수 있으며, 이에 국한되지 않습니다.

* 의심스러운 콘텐츠 또는 스팸
* 학대 또는 혐오 콘텐츠
* 성적이거나 모욕적인 콘텐츠
* 아동 학대
* 괴롭힘 또는 따돌림
* 테러 또는 폭력 조장
* 지식재산권 또는 저작권 침해

이 등급이 적용된 장면은 로드되지 않으며 아무도 상호작용할 수 없습니다. 장면이 이 카테고리에 해당한다면 다음 정책을 준수하도록 검토하고 수정해야 합니다:  [콘텐츠 정책](https://decentraland.org/content).

## 기능 토글

플레이어가 특정 기능을 악용하지 못하도록 특정 씬에서 해당 기능을 비활성화할 수 있습니다. 씬 설정의 **설정** 탭에서 이를 구성하세요.

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

현재 다음 기능만 이 방식으로 처리됩니다.

* **음성 채팅**: 플레이어가 마이크를 사용해 주변의 다른 플레이어와 음성 채팅으로 대화하는 기능입니다.
* **휴대용 경험 비활성화**: 이 설정은 플레이어가 씬 안에 있을 때 사용하는 모든 휴대용 경험의 동작을 지정합니다. 여기에는 [휴대용 경험](https://docs.decentraland.org/creator/content-creator-ko/sdk7/kinds-of-projects/portable-experiences.md) 뿐만 아니라 [스마트 웨어러블](https://docs.decentraland.org/creator/content-creator-ko/sdk7/kinds-of-projects/smart-wearables.md)도 포함됩니다. 이 설정을 사용하면 모두 활성화된 상태로 유지(기본값)하거나, 비활성화하거나, UI를 숨길 수 있습니다. 휴대용 경험이 일부 플레이어에게 부당한 이점을 줄 수 있는 씬에서 유용합니다. 예를 들어 파쿠르 챌린지에서 제트팩을 사용하는 경우가 있습니다. 블록체인 트랜잭션이 발생하는 씬에서도 이를 방지하는 것이 좋습니다. 악의적인 휴대용 경험이 씬의 UI를 사칭할 가능성이 있기 때문입니다.

scene.json `scene.json` 파일에서 이러한 토글은 `featureToggles`아래에서 관리합니다. 해당 기능은 별도로 *disabled* 로 지정하지 않는 한 기본적으로 활성화됩니다. 이 설정은 `scene.json` 파일에서 지정할 수 있습니다.

```json
"featureToggles": {
    "voiceChat": "disabled",
    "portableExperiences": "enabled" | "disabled" | "hideUi"
},
```

featureToggles `featureToggles` 속성이 `scene.json` 파일에 없으면 JSON 트리의 최상위 수준에 추가하세요.

### 팁 받기

씬을 방문한 플레이어로부터 팁을 받을 수 있습니다. 팁을 활성화하려면 씬 설정의 **세부 정보** 탭으로 이동해 **제작자 지갑 주소**.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-141837c9074308b3524701488518275229f85190%2Fcreator-wallet-address.webp?alt=media)

아래에 이더리움 주소를 입력하세요. 씬의 팁 수신 주소를 `scene.json` 파일의 `creator` 필드에 입력할 수도 있습니다.

```json
  "creator": "0x1234567890123456789012345678901234567890"
```

플레이어가 씬을 방문하면 화면 왼쪽 상단에 저금통 아이콘이 표시됩니다. 이 아이콘을 클릭하면 팁을 보낼 수 있는 모달이 열립니다. 지도에서 씬 정보를 열어도 이 메뉴에 접근할 수 있습니다.

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

팁 모달에서 플레이어는 보낼 MANA 금액을 선택할 수 있습니다. 팁을 보내려면 지갑에 MANA가 있어야 합니다. 입력한 주소가 Decentraland NAME에 연결되어 있으면, 모달에 이더리움 주소와 함께 지갑 소유자의 이름이 표시됩니다.

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

플레이어가 팁을 보낼 때마다 Decentraland 알림 탭에서 알림을 받게 됩니다.

## 스폰 위치

씬 설정의 **스폰 설정** 은 **설정** 탭에서 확인할 수 있으며, 플레이어가 브라우저에 좌표를 직접 입력하거나 순간이동을 통해 씬에 바로 접근할 때 스폰되는 위치를 지정합니다.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6d964e91ecaa272ac10ffd1261f2daea6ae92619%2Fspawn-point-ui.webp?alt=media)

씬에 나무나 계단처럼 플레이어가 위에 스폰될 경우 이동을 막을 수 있는 오브젝트가 있을 수 있습니다. 지형이 높은 곳에 있을 수도 있습니다. 플레이어가 이동할 수 없는 위치에 스폰되는 일을 방지하려면 특정 위치에 여러 스폰 지점을 설정할 수 있습니다.

위치는 장면 내 좌표로 구성됩니다. 이 숫자는 구획 내 위치를 나타내며, 장면 코드의 Transform 구성 요소에서 다음과 같이 엔티티를 [배치할 때 사용하는 좌표와 비슷합니다](https://docs.decentraland.org/creator/content-creator-ko/sdk7/3d/entity-positioning.md).

{% hint style="warning" %}
**📔 참고**: 모든 생성 지점은 장면을 구성하는 구획 안에 있어야 합니다. 이 구획의 영역 밖에는 플레이어를 생성할 수 없습니다.
{% endhint %}

플레이어 생성 지점 주변에 무작위 오프셋을 적용하려면 **무작위 오프셋** 확인란을 선택하세요. 그러면 플레이어가 생성될 때 서로 겹치지 않도록 위치가 무작위로 조정됩니다. 플레이어가 붐비는 장면에서 겹쳐 나타나는 보기 흉한 상황을 방지할 수 있습니다. **최대 오프셋** 값은 원래 생성 지점에서 X축과 Z축 방향으로 떨어질 수 있는 최대 거리입니다.

플레이어가 장면에 들어올 때 바라볼 방향을 제어하려면 **카메라 대상** 을 설정하세요. 플레이어가 처음 장면을 접하는 방식을 더 잘 제어하고, 특정 방향으로 유도할 수 있습니다. 기본적으로 이 값은 `{x: 8, y:1, z:8}`을 가리킵니다. 단일 구획 장면에서는 장면의 중앙이고, 더 큰 장면에서는 왼쪽 아래 구획의 중앙입니다.

원하는 만큼 생성 지점을 목록에 추가하려면 **생성 지점 추가** 를 클릭하세요. 플레이어는 목록에 있는 지점 중 하나에 무작위로 나타납니다.

### JSON의 생성 지점

생성 지점은 `scene.json` 파일의 `spawnPoints` 필드에서도 설정할 수 있습니다.

```json
  "spawnPoints": [
    {
      "name": "spawn1",
      "position": {
        "x": 5,
        "y": 1,
        "z": 4
      }
    }
  ],
```

하나의 장면에 여러 생성 지점을 설정할 수 있습니다. 이는 특히 큰 장면에서 유용합니다. 여러 생성 지점을 추가하려면 배열에 나열하면 됩니다.

```json
  "spawnPoints": [
    {
      "name": "spawn1",
      "position": {
        "x": 5,
        "y": 1,
        "z": 4
      }
	},
	{
      "name": "spawn2",
      "position": {
        "x": 3,
        "y": 1,
        "z": 1
      }
    }
  ],
```

생성 지점이 여러 개면 플레이어가 지정한 좌표에서 가장 가까운 지점이 선택됩니다.

생성 지점이 `default`로 표시되어 있으면 가장 가까운 지점인지와 관계없이 항상 해당 지점이 사용됩니다. 생성 지점이 여러 개 `default`로 표시되어 있으면 가장 가까운 지점이 선택됩니다.

```json
  "spawnPoints": [
    {
      "name": "spawn1",
      "default": true,
      "position": {
        "x": 5,
        "y": 1,
        "z": 4
      }
	},
	{
      "name": "not-used",
      "position": {
        "x": 3,
        "y": 1,
        "z": 1
      }
    }
  ],
```

**생성 영역**

장면의 한 영역 전체가 생성 지점 역할을 하도록 설정할 수 있습니다. 위치의 각 차원에 두 숫자로 된 배열을 지정하면 플레이어가 해당 범위 내 무작위 위치에 나타납니다. 이 기능은 장면에 들어오는 플레이어들이 서로 겹치는 것을 방지하는 데 도움이 됩니다. 세 차원 모두 같은 형식을 사용해야 합니다. 즉, 모두 단일 숫자이거나 모두 두 숫자로 된 배열이어야 합니다. 한 차원의 값을 고정하려면 `"y": [1,1]`.

```json
  "spawnPoints": [
    {
      "name": "region",
      "position": {
        "x": [1,5],
        "y": [1,1],
        "z": [2,4]
      }
    }
  ],
```

위 예시에서 플레이어는 다음 좌표에 꼭짓점이 있는 정사각형의 어느 위치에나 나타날 수 있습니다. *1,1,2* 및 *5,1,4*.

장면에는 생성 지점이 여러 개 있을 수 있듯이 생성 영역도 여러 개 설정할 수 있습니다.

```json
  "spawnPoints": [
    {
      "name": "region1",
      "position": {
        "x": [1,5],
        "y": [1,1],
        "z": [2,4]
      }
    },
      {
      "name": "region2",
      "position": {
        "x": [1,5],
        "y": [1,1],
        "z": [6,8]
      }
    }
  ],
```

**회전**

플레이어가 스폰될 때 특정 방향을 바라보도록 회전 값을 지정할 수도 있습니다.

간단히 다음을 추가하면 됩니다. `cameraTarget` 필드를 스폰 지점 데이터에 추가하세요. 이 값은 `cameraTarget` 공간상의 위치를 참조해야 하며, *x*, *y* 및 *z* 장면을 기준으로 한 좌표이며, `position` 필드와 같습니다.

```json
  "spawnPoints": [
    {
      "name": "spawn1",
      "position": {
        "x": 5,
        "y": 1,
        "z": 4
      },
      "cameraTarget": {
        "x": 10,
        "y": 1,
        "z": 4
      }
    }
  ],
```

이 예시에서는 플레이어를 다음 위치에 생성합니다. *5, 1, 4* 동쪽을 향해 바라보도록 설정합니다. *10, 1, 4*. 생성 위치가 범위인 경우 플레이어의 회전은 항상 지정된 대상을 향합니다. 생성 지점이 여러 개라면 각 지점에 별도의 대상을 지정할 수 있습니다.

## 필수 권한

이 `requiredPermissions` 속성에는 다음에서 사용하는 제한된 기능이 나열됩니다. [스마트 웨어러블](https://docs.decentraland.org/creator/content-creator-ko/sdk7/kinds-of-projects/smart-wearables.md) 기기에서 사용합니다. 이 속성은 스마트 웨어러블 기기에만 적용됩니다.

{% hint style="warning" %}
**📔 참고**: 일반 씬(파슬 또는 월드 내)과 [휴대용 경험](https://docs.decentraland.org/creator/content-creator-ko/sdk7/kinds-of-projects/portable-experiences.md) 은 모든 권한이 부여된 상태로 실행됩니다. 이 속성이 필요하지 않으며, 추가해도 영향을 미치지 않습니다.
{% endhint %}

스마트 웨어러블이 이러한 기능을 사용하려면 다음 파일에 해당 기능을 선언해야 합니다. `scene.json`에 선언하지 않으면 호출이 실패하고 Explorer에 다음 오류가 기록됩니다. *permission denied*  오류:

* `USE_FETCH`: 다음을 사용해 타사 서버로 HTTP 요청 전송 `fetch` 또는 `signedFetch`
* `USE_WEBSOCKET`: 타사 서버에 웹소켓 연결 열기
* `USE_WEB3_API`: 플레이어의 지갑과 상호작용하여 트랜잭션을 실행하거나 메시지에 서명
* `OPEN_EXTERNAL_LINK`: 플레이어에게 외부 사이트 링크를 열도록 요청

```json
"requiredPermissions": [
    "USE_FETCH",
    "OPEN_EXTERNAL_LINK"
  ],
```

다음 중 하나라면 `requiredPermissions` 속성이 없는 경우 `scene.json` 파일의 JSON 트리 루트 수준에 생성합니다.

스마트 웨어러블에 이러한 권한 중 하나라도 선언되어 있으면, 플레이어가 웨어러블을 착용할 때 Explorer에서 권한을 허용하도록 요청합니다. 플레이어가 거부하면 웨어러블 코드가 실행되지 않습니다. 실제로 사용하는 권한만 선언하여 플레이어에게 필요한 것보다 더 많은 권한을 요청하지 않도록 하세요.

{% hint style="warning" %}
**📔 참고**: 이 페이지의 이전 버전에는 다음 항목도 나열되어 있었습니다. `ALLOW_TO_MOVE_PLAYER_INSIDE_SCENE`, `ALLOW_TO_TRIGGER_AVATAR_EMOTE` 및 `ALLOW_MEDIA_HOSTNAMES`. 현재 Explorer에서는 이러한 항목을 무시하므로 삭제해도 됩니다. 플레이어 이동, 이모트 재생, 물리력 적용, 미디어 스트리밍에는 권한이 필요하지 않습니다.
{% endhint %}

## 씬 구획

씬을 [배포하면](https://docs.decentraland.org/creator/content-creator-ko/sdk7/publishing/publishing.md) 콘텐츠가 씬 구성에 지정된 좌표에 업로드됩니다. 씬에는 하나의 구획만 포함하거나 수십 개에 이르는 구획 목록을 포함할 수 있습니다.

Scene Editor의 씬 메뉴에서 두 번째 탭을 열어 수정하세요.

![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a5dcb2c0e22a2e3e4a4798791490f40793abdac0%2Fscene-parcels-3x3.webp?alt=media)

드롭다운을 사용하고 **레이아웃 적용** 을 클릭해 씬의 크기를 변경하세요. 각 구획을 클릭해 레이아웃에서 제외할 수도 있습니다.

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

기본 장면의 좌표는 *0,0*로 설정되어 있습니다. 오프라인으로 장면을 개발하는 동안에는 여러 필지를 차지해야 하는 경우가 아니라면 이 값을 변경할 필요가 없습니다. 배포 권한이 있는 좌표에 배포하기 전에는 이 값을 변경해야 합니다.

장면 좌표는 다음 파일에서도 변경할 수 있습니다. `scene.json` 파일:

```json
 "scene": {
    "parcels": [
      "54,-14"
    ],
    "base": "54,-14"
  }
```

다음 `base` 필드는 어떤 구획을 기준 구획으로 사용할지 정의합니다. 장면에 구획이 하나만 있다면 해당 구획을 기준 구획으로 지정해야 합니다. 장면에 구획이 여러 개 있다면 왼쪽 아래(남서쪽) 구획을 기준 구획으로 지정해야 합니다. 모든 엔티티의 위치는 이 구획의 남서쪽 모서리를 기준으로 측정됩니다.

장면 미리보기에서 여러 구획을 표시하려면 사용할 구획을 모두 나열하세요. 실제로 배포할 구획과 정확히 일치할 필요는 없지만, 모두 서로 인접해 있고 상대적 위치가 동일해야 합니다.

```json
 "scene": {
    "parcels": [
      "54,-14",  "55,-14"
    ],
    "base": "54,-14"
  }
```

{% hint style="warning" %}
**📔 참고**: 설정할 수 있는 장면 크기는 최대 300 x 300개 구획(총 90,000개 구획)입니다.
{% endhint %}

### 명령줄에서 구획 설정하기

장면 폴더에서 다음 명령을 실행하여 장면의 구획을 설정할 수 있습니다. `npx update-parcels` 이 방법은 특히 규모가 큰 장면에 유용합니다. 관련된 구획을 모두 나열할 필요가 없기 때문입니다.

{% hint style="warning" %}
**📔 참고**: `update-parcels` 은 타사 커뮤니티 도구이며, 공식 Decentraland SDK의 일부가 아니고 Decentraland Foundation에서 유지 관리하지 않습니다.
{% endhint %}

**단일 필지**

장면 좌표를 단일 인수로 전달합니다. 이 좌표는 기준 필지로도 설정됩니다.

`npx update-parcels <parcel>`

예를 들면 다음과 같습니다.

`npx update-parcels 15,-26`

**여러 필지**

남서쪽 필지와 북동쪽 필지, 두 개의 인수를 전달합니다. 남서쪽 필지는 기준 필지로도 설정됩니다.

`npx update-parcels <parcel> <parcel>`

{% hint style="info" %}
**💡 팁**: 남서쪽 필지는 두 좌표 값이 모두 가장 낮은 필지입니다. *X* 및 *Y* 좌표.
{% endhint %}

예를 들면 다음과 같습니다.

`npx update-parcels 15,-26 17,-24`

이 명령은 기준 구획을 다음 위치에 두고 3x3 장면을 생성합니다. `15,-26`.

**기준 구획 맞춤 설정**

인수 세 개를 전달합니다. 남서쪽 구획과 북동쪽 구획, 그리고 기준 구획으로 사용할 구획입니다.

`npx update-parcels <parcel> <parcel> <parcel>`

{% hint style="warning" %}
**📔 참고**: 기준 구획은 장면에 포함된 구획 중 하나여야 합니다.
{% endhint %}

**정사각형이 아닌 장면**

위 명령은 모두 직사각형 모양의 장면을 생성합니다. Decentraland 장면은 L자 모양이나 다른 형태로 구성할 수도 있습니다. 더 큰 정사각형을 생성한 다음 `npx update-parcels` 에서 초과 구획을 수동으로 제거할 수 있습니다. `scene.json` 파일에서.

{% hint style="warning" %}
**📔 참고**: 기준 구획은 장면에 포함된 구획 중 하나여야 합니다.
{% endhint %}

## 스카이박스 시간대

장면에 고정된 시간대를 설정할 수 있습니다. 모든 플레이어에게 해당 시간대의 장면이 표시되며, 스카이박스는 낮과 밤의 주기에 따라 바뀌지 않습니다.

장면 설정을 열고 **설정** 탭을 클릭하면 **스카이박스** 섹션을 찾을 수 있습니다. **자동** 옵션의 선택을 해제하고 원하는 시간대를 설정합니다.

장면 코드에서도 스카이박스 시간대를 설정할 수 있습니다. 이렇게 하려면 다음 섹션을 `scene.json` 의 최상위 수준에 추가합니다.

```json
 "skyboxConfig": {
    "fixedTime": 36000
  }
```

숫자는 하루가 시작된 후 경과한 초를 나타내며, 0(다음을 나타냄)부터 86400(다음을 나타냄)까지입니다. *00:00*) *24:00*)입니다. 86400보다 큰 숫자도 자정으로 해석됩니다.

다음은 유효한 값의 추가 예시입니다.

* 0초 => *00:00*
* 21600초 => *06:00*
* 43200초 => *12:00*
* 64800초 => *18:00*
* 86400초 => *24:00*

## 지형 풍경

게시된 장면 [Decentraland 월드](https://docs.decentraland.org/creator/content-creator-ko/sdk7/publishing/publishing-options.md#decentraland-worlds) 은 자동 생성된 초원, 나무, 바다 풍경으로 둘러싸입니다. 이 풍경이 장면의 미적 분위기와 맞지 않는 경우(예: 탁 트인 바다나 우주에 떠 있는 장면) 비활성화할 수 있습니다. 비활성화하려면 다음 필드를 `scene.json` 의 최상위 수준에 추가합니다.

```json
{
	"landscapeTerrain": false
}
```

값을 `landscapeTerrain` 로 설정하면 `false`, 씬의 구획 너머로는 아무것도 렌더링되지 않으며 플레이어에게는 씬을 둘러싼 스카이박스만 표시됩니다. 주변 지형을 제거하면 렌더링 리소스도 확보되어 씬이 더 원활하게 실행될 수 있습니다.

필드를 설정하지 않으면 기본값은 `true` 이며 풍경이 평소와 같이 표시됩니다.

{% hint style="warning" %}
**📔 참고**: 이 필드는 단일 씬을 포함하는 월드에만 적용됩니다. 주변 환경이 항상 인접한 구획에 따라 결정되는 Genesis City에서는 무시됩니다. 씬의 로컬 미리보기를 실행하는 동안에도 이 필드를 사용해 풍경이 없는 상태에서 씬이 어떻게 보이는지 확인할 수 있습니다.
{% endhint %}

## 월드 구성

게시할 때 [Decentraland 월드](https://docs.decentraland.org/creator/content-creator-ko/sdk7/publishing/publishing-options.md#decentraland-worlds), 여러 World 전용 설정은  `scene.json`  파일에서  `worldConfiguration`  객체를 사용해 구성할 수 있습니다.

### 기본 World 설정

World에 게시하려면 NAME 또는 ENS 도메인을 다음 파일에 지정해야 합니다:  `scene.json`:

```json
{
	"worldConfiguration": {
		"name": "my-name.dcl.eth"
	}
}
```

해당  **이름** 지정된 값은 Decentraland NAME 또는 ENS 도메인일 수 있으며, 배포에 서명하는 지갑(또는 액세스 제어 목록을 통해 권한을 부여받은 지갑)이 소유해야 합니다.

### 통신 서비스 구성

다음 `fixedAdapter` 속성은 씬에서 사용할 통신 서비스를 나타냅니다. 현재는 `offline:offline` 값만 허용됩니다. 이 값을 설정하면 씬에 통신 서비스가 전혀 제공되지 않으며, 해당 월드에 참여하는 각 사용자는 항상 혼자 있게 됩니다. 설정하지 않으면 Worlds 콘텐츠 서버가 구성에 따라 적절한 값을 생성합니다.

```json
{
	"worldConfiguration": {
		"name": "my-name.dcl.eth",
		"fixedAdapter": "offline:offline"
	}
}
```

{% hint style="warning" %}
**📔 참고**: 설정 `fixedAdapter` 로 `"offline:offline"` (또는 다음을 활성화하면 **싱글 플레이어** 월드의 [설정 탭에서](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/publish/manage-lands-and-worlds.md#settings) (Creator Hub에서) 실시간 스트리밍이 비활성화됩니다. 스트리밍 기능은 시청자에게 동영상을 전송하기 위해 통신 계층에 의존합니다. 월드에서 실시간 스트리밍이 필요하다면 이 옵션을 사용하지 마세요.
{% endhint %}

### 플레이스 목록 구성

옵트아웃하지 않는 한 모든 월드는 플레이스 페이지에 자동으로 등록됩니다. 월드가 플레이스에서 색인되지 않도록 하려면 다음을 추가하세요:

```json
{
	"worldConfiguration": {
		"name": "my-name.dcl.eth",
		"placesConfig": {
			"optOut": true
		}
	}
}
```

### 전체 예시

다음은 모든 World 구성 옵션을 포함한 전체 예시입니다:

```json
{
	"worldConfiguration": {
		"name": "my-name.dcl.eth",
		"fixedAdapter": "offline:offline",
		"placesConfig": {
			"optOut": true
		}
	}
}
```

자세한 내용은 [World에 게시하기](https://docs.decentraland.org/creator/content-creator-ko/sdk7/publishing/publishing.md#publishing-to-worlds) 에서 World에 배포하는 방법을 확인하세요.

## 씬 코드에서 메타데이터 가져오기

[씬 API 참조](https://js-sdk-toolchain.pages.dev/modules/js_runtime_apis.__system_Scene_)

씬 메타데이터의 필드(예: 씬이 배포된 구획이나 스폰 지점의 위치)에 접근하려면 씬 코드가 필요할 수 있습니다. 이는 복제할 씬이나 다른 씬에서 재사용할 코드를 만들 때 특히 유용합니다. 씬의 경계가 어디인지 알아야 하는 라이브러리에도 매우 유용합니다.

이 데이터에 접근하려면 먼저 다음을 가져옵니다. `getSceneInformation` 함수:

```ts
import { getSceneInformation } from '~system/Runtime'
```

그런 다음 `getSceneInformation()` 함수를 호출할 수 있습니다. 이 함수는 scene.json 파일의 내용 대부분을 포함하는 JSON 객체를 반환합니다. 아래 예제는 이 함수의 응답에서 자주 사용되는 여러 필드에 접근하는 방법을 보여줍니다:

```ts
import { getSceneInformation } from '~system/Runtime'

executeTask(async () => {
  const sceneInfo = await getSceneInformation({})

  if (!sceneInfo) return
  console.log("SCENE INFO: ", sceneInfo)
})
```

{% hint style="warning" %}
**📔 참고**: `getSceneInformation()` 는 [비동기 함수](https://docs.decentraland.org/creator/content-creator-ko/sdk7/programming-patterns/async-functions.md)로 실행해야 합니다. 데이터를 반환하는 데 몇 분의 일 초 이상 걸릴 수 있기 때문입니다. 더 이상 사용되지 않는 `getSceneInfo()` 함수는 사용하지 마세요.
{% endhint %}

다음 함수 `getSceneInformation()` 가 반환하는 객체에는 다음 항목이 포함됩니다:

* `baseUrl`: 씬의 콘텐츠가 호스팅되는 기본 URL
* `content`: 해시를 포함하여 씬의 모든 파일을 담은 배열입니다. baseUrl과 함께 사용하여 파일을 가져올 수 있습니다.
* `metadataJson`: 씬의 scene.json 전체 내용을 담은 문자열입니다. 특정 값을 가져오려면 이를 파싱해야 합니다.
* `urn`: 씬 전체의 고유 URN입니다.

아래 예제에서는 `metadataJson` 의 내용을 파싱하여 scene.json 파일의 속성 값을 가져옵니다.

```ts
import { getSceneInformation } from '~system/Runtime'

executeTask(async () => {
	const sceneInfo = await getSceneInformation({})

	if (!sceneInfo) return

	const sceneJson = JSON.parse(sceneInfo.metadataJson)
	const spawnPoints = sceneJson.spawnPoints
	const parcels = sceneJson.scene.parcels
	console.log({ parcels, spawnPoints })
})
```


---

# 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/sdk7/kinds-of-projects/scene-metadata.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.
