> 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/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-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" %}
**💡 팁**: 파셀 수별 모든 세부 수치의 참조 표는 다음을 참조하세요:

[참조 표](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` 씬 내 텍스처 수입니다. 모델의 일부로 가져온 텍스처도 포함됩니다.
* **높이:** `log2(n+1) x 20` 미터 단위의 높이입니다.

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

{% hint style="warning" %}
**📔 참고**: 파일 크기 및 파일 수 제한은 배포 시 적용되며, 이를 초과하면 배포가 차단됩니다. 다른 제한(삼각형, 엔티티, 바디, 머티리얼, 텍스처, 높이)은 소프트 제한입니다. Creator Hub에서 경고로 표시되지만, 이를 초과하더라도 대부분은 심각한 실패보다는 성능 저하를 초래합니다. 강력한 권장 사항으로 간주하세요.
{% endhint %}

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

업로드에서 제외할 다른 파일이나 폴더가 있다면 다음에 나열할 수 있습니다. `.dclignore` 파일에서
{% endhint %}

## 최적화

참고 [성능 최적화](/creator/content-creator-ko/sdk7/optimizing/performance-optimization.md) 씬이 이러한 제한 아래를 유지하고 플레이어에게 더 원활하게 실행되도록 하는 팁은 다음을 참조하세요.

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

## 씬 경계

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

큰 객체의 끝부분이 경계를 벗어나면, 그 끝부분은 객체에서 잘려 나갑니다.

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

엔티티를 지하에 배치하여 숨기거나 일부만 드러나게 할 수 있습니다. 씬에는 기본 지면 높이 아래로 내려가는 터널을 만들 수 없으며, 플레이어는 다음 아래로 이동할 수 없습니다. `y = 0` 높이.

## 셰이더 제한

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

## 메시 압축

{% hint style="warning" %}
**📱 Draco로 압축된 메시를** [**모바일 클라이언트**](/creator/content-creator-ko/build-for-mobile/mobile-client/overview.md) **에서 사용하려면 에셋 최적화가 필요합니다.** Draco를 사용하는 glTF/GLB 모델은 [Draco](https://google.github.io/draco/) 메시 압축은 에셋 최적화 파이프라인을 거친 후에만 Decentraland 모바일 앱에서 로드됩니다. Draco로 압축된 모델이 모바일에서 로드되지 않으면, 최적화되었는지 확인하세요. 또는 모델을 **압축 없이** 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 %}

## 월드 크기

디센트럴랜드 [Worlds](/creator/content-creator-ko/sdk7/publishing/publishing-options.md#decentraland-worlds) 는 단일 씬으로 로드되므로 서로 다른 제한이 있습니다.

* Decentraland NAMEs에 게시된 월드들은 동일한 지갑이 소유한 모든 월드에서 공유되는 저장 공간 예산을 사용합니다. 소유한 각 NAME은 `100MB`, 각 LAND 파셀은 추가로 `100MB`, 그리고 보유한 2,000 MANA마다 추가로 `100MB`. 이 예산은 원하는 대로 월드 간에 분배할 수 있습니다.
* ENS 도메인에 게시된 월드의 한도는 `36MB` 로, 확장할 수 없습니다.

예산 사용량과 남은 예산은 다음에서 확인할 수 있습니다. **관리** 섹션 또는 **Worlds** 탭에서 확인할 수 있습니다. [Builder](https://decentraland.org/builder/worlds). 예산을 초과하면(예: 자산을 판매하거나 이전한 후) 월드가 접근 불가능해지기 전에 공간을 확보할 수 있도록 48시간이 주어집니다.

참고 [월드 크기 제한](/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 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/sdk7/optimizing/scene-limitations.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.