> 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/optimizing/scene-limitations.md).

# 씬 제한 사항

내 씬에 얼마나 많은 항목을 넣을 수 있나요?

메타버스의 성능을 개선하기 위해 모든 씬이 따라야 하는 제한 사항을 정했습니다. 이 제한은 파셀 단위로 적용되므로, 씬이 클수록 제한값도 높아집니다.

다음에서 작업할 때 [Creator Hub](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/get-started/editor-installation.md), 씬에서 3D 모델이 사용하는 리소스 통계와 씬의 제한값을 확인할 수 있습니다.

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

이 메뉴를 펼치면 세부 정보를 볼 수 있습니다.

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

{% hint style="info" %}
**💡 팁**: 파셀 수에 따른 구체적인 수치를 모두 확인하려면 다음 참조 표를 참조하세요.

[참조 표](https://docs.google.com/spreadsheets/d/1BTm0C20PqdQDAN7vOQ6FpnkVncPecJt-EwTSNHzrsmg/edit#gid=0)
{% endhint %}

## 씬 제한 규칙

씬에서 동시에 렌더링할 수 있는 요소의 최대 개수는 다음과 같습니다.

> *n* 은 씬이 차지하는 파셀 수를 나타냅니다.

* **삼각형:** `n x 10000` 씬의 모든 모델에 포함된 삼각형의 총개수입니다.
* **엔티티:** `n x 200` 씬의 엔티티 개수입니다.
* **바디:** `n x 300` 씬의 메시 개수입니다.
* **머티리얼:** `log2(n+1) x 20` 씬의 머티리얼 개수입니다. 모델의 일부로 가져온 머티리얼도 포함됩니다.
* **텍스처:** `log2(n+1) x 10` 씬의 텍스처 개수입니다. 모델의 일부로 가져온 텍스처도 포함됩니다.
* **높이:** `330 meters` 씬이 차지하는 파셀 수와 관계없이 씬에 허용되는 최대 높이입니다.

  > 경고: 200미터보다 높은 곳에 배치된 엔티티는 멀티플레이어 동기화 문제가 발생할 수 있습니다. 플레이어가 상호작용하거나 플레이어 간에 동기화되는 콘텐츠는 모두 해당 높이보다 낮게 배치하세요.

  > 중요: 현재 씬에서 렌더링 중인 엔티티만 이 제한의 계산에 포함됩니다. 씬에서 3D 모델을 전환하는 경우, 전체 모델의 합계가 아니라 어느 시점에 렌더링되는 모델이 기준이 됩니다. 플레이어 아바타와 플레이어가 씬 외부에서 가져온 아이템도 이 제한을 계산할 때 포함되지 않습니다.
* **총 파일 크기:** Genesis City의 경우 -`파셀당 15 MB - 최대 300 MB`. Worlds의 경우 다음을 참조하세요. [월드 크기](#world-size). 콘텐츠 서버에 업로드한 파일의 총크기입니다. 3D 모델과 오디오가 포함됩니다. node.js 패키지처럼 업로드되지 않는 파일은 포함되지 않습니다. 배포를 확정하기 전에 게시할 파일 전체 목록과 각 파일의 크기를 확인할 수 있습니다.
* **파일 개수:** `파셀당 파일 200개` 업로드한 파일의 총개수입니다. 3D 모델과 오디오가 포함됩니다. node.js 패키지처럼 업로드되지 않는 파일은 포함되지 않습니다.
* **최대 파일 크기** `파일당 50 MB` 씬에 있는 어떤 유형의 파일도 50 MB를 초과할 수 없습니다. 작은 씬에는 더 엄격한 제한이 적용되므로 파일 크기가 총 파일 크기 제한을 초과하면 안 됩니다(예: 단일 파셀 씬은 총 15 MB로 제한됩니다).

{% hint style="warning" %}
**📔 참고**: 파일 크기 및 파일 개수 제한은 배포 시 적용되며, 이를 초과하면 배포가 차단됩니다. 삼각형, 엔티티, 바디, 머티리얼, 텍스처, 높이 제한은 소프트 제한입니다. Creator Hub에서 경고로 표시되지만, 이를 초과하면 대개 배포가 완전히 실패하기보다는 성능이 저하됩니다. 이 제한을 반드시 지켜야 할 권장 사항으로 간주하세요.
{% endhint %}

{% hint style="info" %}
**💡 팁**: 씬 프로젝트 폴더의 모든 파일이 파일 크기 제한에 포함되는 것은 아니며, 서버에 업로드되는 파일만 포함됩니다. 용량이 매우 큰 *node\_modules* 폴더의 모든 내용은 업로드되지 않는 종속 항목이므로 제한에 포함되지 않습니다. 다음 위치에 있는 파일도 마찬가지입니다. `/src` 폴더입니다. 소스 코드는 업로드되지 않기 때문입니다.

업로드에서 제외할 다른 파일이나 폴더를 프로젝트의 `.dclignore` 파일에 지정할 수 있습니다. 참고로 `.dclignore` 로컬 미리보기에도 적용되므로, 씬에서 실제로 불러오는 항목은 목록에 추가하지 마세요. 자세한 내용은 [dclignore 파일](https://docs.decentraland.org/creator/content-creator-ko/sdk7/kinds-of-projects/scene-files.md#the-dclignore-file).
{% endhint %}

## 최적화

이 [성능 최적화](https://docs.decentraland.org/creator/content-creator-ko/sdk7/optimizing/performance-optimization.md) 을 참고하여 씬을 이러한 제한보다 작게 유지하고 플레이어가 더 원활하게 실행할 수 있도록 하는 방법을 알아보세요.

{% hint style="info" %}
**📱 모바일**: 이 페이지의 엄격한 제한은 모든 클라이언트에 적용되지만, 모바일 기기는 데스크톱보다 여유 성능이 적습니다. 다음을 대상으로 할 때는 이러한 제한보다 충분히 낮은 수준을 목표로 하고, [모바일 앱](https://docs.decentraland.org/creator/content-creator-ko/build-for-mobile/mobile-client/overview.md)에서는 삼각형 수와 머티리얼 수를 줄이고 텍스처 크기를 작게 유지하세요.
{% endhint %}

## 씬 경계

미리보기를 실행하면 파셀 경계 밖에 있는 콘텐츠가 렌더링될 때 빨간색으로 강조 표시됩니다. 콘텐츠가 경계 밖에 있으면 플레이어가 씬을 방문할 때 해당 부분은 렌더링되지 않습니다.

큰 오브젝트의 끝부분이 경계를 벗어나면 그 끝부분이 잘려 나갑니다.

단일 파셀 씬의 크기는 16미터 x 16미터입니다. 씬에 여러 파셀이 있으면 파셀 배치에 따라 크기가 달라집니다.

엔티티를 지하에 배치해 숨기거나 일부만 지상으로 나오게 할 수 있습니다. 씬에는 기본 지면 높이보다 아래로 이어지는 터널을 만들 수 없으며, 플레이어는 `y = 0` 보다 낮은 높이로 이동할 수 없습니다.

## 셰이더 제한

Decentraland에서 사용하는 3D 모델은 지원되는 셰이더와 머티리얼을 사용해야 합니다. 지원되는 셰이더 목록은 [3D 모델 머티리얼](https://docs.decentraland.org/creator/content-creator-ko/3d/materials.md) 을 참고하세요.

## 메시 압축

{% hint style="warning" %}
**📱 모바일 클라이언트에서 Draco로 압축된 메시를** [**사용하려면**](https://docs.decentraland.org/creator/content-creator-ko/build-for-mobile/mobile-client/overview.md) **에셋 최적화가 필요합니다.** Draco 메시 압축을 사용하는 glTF/GLB 모델은 에셋 최적화 파이프라인에서 처리된 후에만 Decentraland 모바일 앱에서 로드됩니다. Draco로 압축된 모델이 모바일에서 로드되지 않으면 최적화되었는지 확인하거나, [Draco](https://google.github.io/draco/) 압축 없이 모델을 내보내 전체 처리 단계를 생략하세요. 양자화, 텍스처 압축, 메시 단순화 등 다른 glTF 최적화에는 영향을 주지 않습니다. **없이** Draco 압축을 사용하지 않고 모델을 내보내면 해당 단계를 완전히 건너뛸 수 있습니다. 양자화, 텍스처 압축, 메시 단순화 등 다른 glTF 최적화에는 영향을 주지 않습니다.
{% endhint %}

## 조명

씬의 조명 조건은 기본 설정에서 모든 플레이어에게 동일하게 변경할 수 없습니다. 다만 각 플레이어는 Explorer UI에서 자신의 스카이박스 설정을 변경할 수 있습니다.

## 텍스처 크기 제한

텍스처의 너비와 높이(픽셀)는 다음 숫자에 해당해야 합니다.

```
1, 2, 4, 8, 16, 32, 64, 128, 256, 512, 1024
```

> 이 수열은 2의 거듭제곱으로 이루어져 있습니다. `f(x) = 2 ^ x` . 텍스처 크기는 최대 1024이며, 이보다 큰 텍스처는 에셋 번들 변환 과정에서 축소됩니다. 이는 그래픽 프로세서의 내부 최적화 때문에 다른 렌더링 엔진에서도 흔히 적용되는 요구 사항입니다.

너비와 높이가 같은 숫자일 필요는 없지만, 둘 다 이 수열에 포함되어야 합니다.

**권장 텍스처 크기는 1024x1024**입니다. 국내 네트워크를 통한 전송에 적합하고, 로딩 시간과 화질 면에서도 만족스러운 경험을 제공하는 최적의 크기입니다.

그 밖에 유효한 크기의 예:

```
32x32
64x32
512x256
512x512
1024x1024
```

{% hint style="warning" %}
**📔 참고**: 임의 크기의 텍스처가 작동하는 경우도 있지만, 렌더링 오류가 자주 발생하고 안정성도 떨어집니다. 모든 텍스처의 크기를 다음과 같이 맞추는 것을 적극 권장합니다.
{% endhint %}

## 월드 크기

Decentraland [월드](https://docs.decentraland.org/creator/content-creator-ko/sdk7/publishing/publishing-options.md#decentraland-worlds) 는 단일 씬으로 로드되므로 제한 사항이 다릅니다.

* Decentraland NAME에 게시된 월드는 같은 지갑이 소유한 모든 월드가 공유하는 저장 용량을 사용합니다. 소유한 각 NAME은 `100 MB`를 제공하며, 각 LAND 필지는 추가로 `100 MB`를 제공합니다. 또한 보유한 MANA 2,000개마다 `100 MB`가 추가됩니다. 이 용량은 원하는 대로 월드 간에 배분할 수 있습니다.
* ENS 도메인에 게시된 월드에는 `36 MB` 의 제한이 있으며, 늘릴 수 없습니다.

사용한 용량과 남은 용량은 Creator Hub의 **관리** 섹션이나 **월드** 탭에서 확인할 수 있습니다. 해당 탭은 [Builder](https://decentraland.org/builder/worlds)에 있습니다. 예산을 초과하면(예: 에셋을 판매하거나 이전한 후) 월드에 접근할 수 없게 되기 전에 48시간 내에 공간을 확보해야 합니다.

자세한 내용은 [월드 크기 제한](https://docs.decentraland.org/creator/content-creator-ko/sdk7/kinds-of-projects/kinds-of-project.md#size-limits) 을 참조하세요.

콘텐츠 서버에 업로드된 파일의 총 크기입니다. 3D 모델과 오디오가 포함됩니다. node.js 패키지처럼 업로드되지 않은 파일은 포함되지 않습니다. 배포를 확인하기 전에 게시할 파일 전체 목록과 각 파일의 크기를 확인할 수 있습니다.

월드의 그 밖의 모든 제한(삼각형 수, 머티리얼 등)은 필지별로 적용됩니다. 월드에 필지를 추가하는 것은 무료이므로 씬에 최대 300x300개(총 90,000개)의 필지를 추가할 수 있으며, 필지 수에 따라 해당 제한도 적용됩니다.


---

# 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/optimizing/scene-limitations.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.
