> 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         |
| 콘텐츠 크기        | 120MB     | 150MB     |
| 외부 콘텐츠        | 40MB      | 50MB      |
| 메모리(프로세스 RSS) | 1,638MB   | 2,048MB   |
| 드로우 콜         | 1,000     | 2,000     |
| 성능(높을수록 좋음)   | 90%       | 85%       |

## 조명과 파티클

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

파티클은 런타임에서도 추가로 제한됩니다. 이미터당 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-65a2ca6fbdd8873f352431b5433817c0f944121d%2Fmobile_scene_limits.png?alt=media\&token=ed32dc52-362d-4af1-9a40-56e683774e94)

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

이 **성능** 값은 현재 활성 그래픽 프로필이 설정한 FPS 예산의 백분율입니다. 점수 **100%** 는 씬이 전체 FPS 목표에 도달하고 있음을 의미합니다.

항상 다음과 같은 중급 사양 기기에서 테스트하세요. **Samsung Galaxy A54** 그리고 다음을 목표로 하세요. **높음 그래픽 프로필에서 90%를 넘는 성능 점수**. 이렇게 하면 대부분의 모바일 플레이어에게 원활한 경험을 보장할 수 있습니다. 다음을 참조하세요. [하드웨어 요구사항](/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.
