> 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/build-for-mobile/develop/optimize-performance.md).

# 성능

Decentraland 씬의 모바일 제한 및 성능 목표, 그리고 Creator Hub에서 이를 미리 보고 측정하는 방법입니다.

모바일 기기는 데스크톱이나 웹보다 리소스 제약이 큽니다. 모바일 씬의 제한과 이를 미리 확인하는 방법을 알아두면 더 많은 사용자에게 원활하게 실행되는 씬을 제공할 수 있습니다.

## 모바일 씬 제한

아래 표는 모바일에서 실행할 때 적용되는 제한을 보여 줍니다.  **소프트 제한** 에 도달하면 성능 패널에 경고가 표시되고,  **하드 제한** 에 도달하면 씬을 불러올 수 없습니다.

| 항목            | 소프트 제한    | 하드 제한     |
| ------------- | --------- | --------- |
| 삼각형           | 1,000,000 | 1,200,000 |
| 엔티티           | 4,800     | 6,000     |
| 메시(바디)        | 2,400     | 3,000     |
| 지오메트리         | 1,000     | 2,000     |
| 머티리얼          | 400       | 500       |
| 텍스처           | 400       | 500       |
| 콜라이더          | 1,200     | 1,500     |
| VFX 이미터       | 8         | 10        |
| 활성 파티클        | 25,000    | 50,000    |
| 광원            | 8         | 16        |
| 그림자 광원        | 2         | 4         |
| 콘텐츠 크기        | 120 MB    | 150 MB    |
| 외부 콘텐츠        | 40 MB     | 50 MB     |
| 메모리(프로세스 RSS) | 1,638 MB  | 2,048 MB  |
| 드로 콜          | 1,000     | 2,000     |
| 성능(높을수록 좋음)   | 90%       | 85%       |

## 조명과 파티클

조명 행에는 씬에서  **제작한** 콘텐츠의 조명 수가 표시되며, 엔진이 실제로 실행하는 조명 수가 표시되는 것은 아닙니다. 각 그래픽 프로필은 가장 가까운 광원만 예산 한도 내에서 활성화하며(매우 낮음에서는 0개, 높음에서는 최대 8개), 그림자를 완전히 비활성화할 수도 있습니다. 따라서 조명을 20개 제작한 씬은 한 번에 최대 8개만 빛을 내더라도 씬에 조명 20개의 비용이 발생합니다. 제작 단계에서 제한을 지키고, 런타임 예산에 의존하지 마세요.

파티클에도 런타임 제한이 적용됩니다. 이미터당 5,000개, 씬당 50,000개입니다. 제작된 파티클이 이 제한을 초과하면 자동으로 제한값에 맞춰 조정되므로, 제한을 넘겨도 씬 예산만 낭비됩니다.

## 모바일 성능 미리 보기

실제 기기에 배포하지 않고도  **Creator Hub** 에서 바로 씬의 모바일 성능을 확인할 수 있습니다.

1. 에서 씬을 엽니다:  **Creator Hub**.
2. 미리 보기 > 모바일 QR 코드 표시를 선택합니다.
3. 휴대폰에서 오른쪽 위 아이콘(빨간색 통계가 표시된 모니터)을 눌러  **씬 제한 미리 보기** 를 엽니다.

![Creator Hub의 모바일 씬 제한 패널](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-643086d38d714356d285000ffc14f00b54889437%2Fmobile_scene_limits.webp?alt=media)

{% hint style="warning" %}
**높음 그래픽 설정에서 성능을 90% 이상으로 유지**

다음 **성능** 값은 활성 그래픽 프로필에서 설정한 FPS 예산의 백분율입니다. 점수가 **100%** 이면 장면이 전체 FPS 목표에 도달하고 있다는 뜻입니다.

항상 다음과 같은 중간 사양 기기에서 테스트하고 **Samsung Galaxy A54** 를 사용해 **높음 그래픽 프로필에서 성능 점수가 90%를 넘도록 목표를 설정하세요**. 이렇게 하면 대다수 모바일 플레이어에게 원활한 경험을 제공할 수 있습니다. 참고 기기는 [하드웨어 요구 사항](https://docs.decentraland.org/creator/content-creator-ko/build-for-mobile/mobile-client/hardware-requirements.md) 을 참조하세요.

다음 경로에서 그래픽 프로필을 변경할 수 있습니다. **게임 내 메뉴 → 설정 → 그래픽 → 동적 그래픽을 끔으로 설정 → 프로필 전환**.
{% endhint %}


---

# 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/build-for-mobile/develop/optimize-performance.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.
