> 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/debugging/debug-in-preview.md).

# 미리보기에서 디버그

미리보기에서 로컬로 실행하는 동안 씬을 디버그하는 방법

미리보기를 실행하면 씬이 렌더링되는 방식을 이해하는 데 도움이 되는 유용한 디버깅 정보와 도구가 제공됩니다.

씬을 컴파일할 수 없다면 아무것도 렌더링되지 않은 빈 땅만 표시됩니다. 이런 경우 다음 위치에서 오류 메시지를 확인하여 무엇이 잘못되었는지 파악할 수 있습니다.

1. 코드 편집기에서 구문 오류나 논리 오류가 표시되어 있지 않은지 확인하세요.
2. 미리보기 창의 콘솔에서 오류 메시지를 확인하세요. 콘솔을 열려면 오른쪽 상단의 ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a673f6b987216e9e471fdac882879c44fcf94652%2Fconsole-icon.png?alt=media\&token=1965a51b-d4b0-4caa-b9d5-d24d738c1fb8) 아이콘을 클릭하세요.
3. Creator Hub를 사용하여 씬을 실행했다면 씬의 콘솔 출력이 표시되는 창을 확인하세요. CLI를 사용하여 씬을 실행했다면 다음 명령을 실행한 명령줄의 출력을 확인하세요. `npm run start`

{% hint style="info" %}
**💡 팁**: 씬을 프로덕션 환경에 게시하기 전에 [Decentraland World](https://docs.decentraland.org/creator/content-creator-ko/sdk7/publishing/publishing-options.md#decentraland-worlds) 에 게시하여 프로덕션에 훨씬 가까운 환경에서 테스트해 볼 수 있습니다.
{% endhint %}

## 콘솔 사용

콘솔을 열려면 오른쪽 상단의 ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a673f6b987216e9e471fdac882879c44fcf94652%2Fconsole-icon.png?alt=media\&token=1965a51b-d4b0-4caa-b9d5-d24d738c1fb8) 아이콘을 클릭하세요.

키보드의 백틱 키를 눌러 콘솔을 열거나 닫을 수도 있습니다. **`**. 대부분의 영문 키보드에서 이 키는 1 키 왼쪽에 있습니다. 더 많은 텍스트를 봐야 한다면 Shift + **\를 눌러`** 콘솔을 더 넓게 열 수도 있습니다.

콘솔에 메시지를 출력하세요( `console.log()` 사용). 그런 다음 씬 콘솔을 열어 메시지가 생성되는 대로 확인할 수 있습니다.

콘솔에는 오류 메시지도 표시되며, 오류 메시지는 빨간색으로 표시됩니다.

## 디버그 패널

디버그 콘솔을 열려면 오른쪽 상단의 ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-9af92d7a9edeb4111484adc136865c46bf27e9e1%2Fdebug-icon.webp?alt=media) 아이콘을 클릭하세요.

그러면 오른쪽 하단에 렌더러 엔진에 관한 정보가 담긴 패널이 열리며, 변경 사항이 실시간으로 업데이트됩니다.

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

### 현재 씬

디버그 패널의 **현재 씬** 탭에는 현재 서 있는 씬에 관한 정보가 포함됩니다. 여기에는 다음이 포함됩니다.

* 씬의 구획 수
* 건물을 지을 수 있는 최대 높이(모든 씬에서 330미터)

또한 **씬 경계 표시** 옵션을 선택하면 씬 경계를 표시하는 빨간색 벽을 볼 수 있습니다.

### 메모리

디버그 패널의 **메모리** 섹션에는 Decentraland가 사용하는 메모리가 표시됩니다. 이 값을 항상 **메모리 예산 임곗값**미만으로 유지하세요. 이 값이 너무 커지면 씬을 방문하는 플레이어의 앱이 충돌할 위험이 있습니다. 프로덕션 환경에서는 주변의 다른 씬과 플레이어가 함께 로드되어 미리보기에서 보이는 것보다 메모리 사용량이 더 높아질 수 있다는 점을 유의하세요.

### 성능

디버그 패널의 **성능** 탭에는 *FPS* (초당 프레임 수)와 관련된 여러 필드가 있습니다. 씬이 복잡해질수록 이 값은 낮아지는 경향이 있습니다. 플레이어에게 좋은 경험을 제공하려면 이 값을 항상 25 FPS 이상으로 유지하세요. FPS는 실행하는 기기에 따라 달라집니다.

여기서 가장 중요한 값은 **평균 FPS**로, 최근 1,000프레임의 FPS를 반올림한 값입니다.

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

{% hint style="warning" %}
**📔 참고**: 장면의 게임 루프는 렌더러와 같은 속도로 실행됩니다. 시스템은 렌더링된 프레임마다 한 번씩 실행되므로, 여기에 표시되는 FPS는 장면 로직이 초당 업데이트되는 횟수이기도 합니다.
{% endhint %}

프레임 속도의 순간적인 저하를 히컵(hiccup)이라고 합니다. 전체 FPS 수치에는 큰 영향을 미치지 않을 수 있지만 플레이어에게는 매우 눈에 띌 수 있습니다. 일반적으로 대용량 에셋을 불러오는 중에 이런 현상이 발생할 수 있습니다.

### 웹 요청

다음 **웹 요청** 섹션에서는 Chrome DevTools의 네트워크 탭을 열 수 있습니다. 이 탭에는 장면에서 발생한 웹 요청의 수와 내용이 표시됩니다. 장면이 서버에 지나치게 많은 요청을 보내 성능에 영향을 주는지 확인할 때 유용합니다.

장면이 타사 서버와 상호작용한다면 주고받는 데이터를 확인하는 것이 유용할 때가 많습니다. 다음을 클릭하세요. **Chrome DevTools 열기** 네트워크 탭이 열린 새 Chrome 창을 엽니다.

{% hint style="warning" %}
**📔 참고**: 이 기능을 사용하려면 먼저 [Creator Hub](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/get-started/editor-installation.md)를 설치해야 합니다. 필요한 종속 항목이 해당 설치에 포함되어 있기 때문입니다.

이 기능을 사용하기 위해 Creator Hub를 열어 두거나 Creator Hub를 통해 장면 미리보기를 실행할 필요는 없습니다. CLI로 장면 미리보기를 실행할 때도 사용할 수 있습니다.
{% endhint %}

또는 Decentraland 애플리케이션에서 오가는 모든 데이터를 보여 주는 무료 도구를 컴퓨터에서 실행할 수도 있습니다. 예를 들면 [Charles](https://www.charlesproxy.com/) 또는 [Wireshark](https://www.wireshark.org/).

## 빠른 새로고침

장면을 변경하면 미리보기가 자동으로 다시 로드되고 업데이트되므로 미리보기 창을 닫았다가 다시 열 필요가 없습니다.

현재 서 있는 장면을 다시 로드해야 한다면 미리보기 창의 왼쪽 위에 있는 **장면 다시 로드** 버튼을 클릭하세요.

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

채팅에 다음 명령을 입력하고 Enter 키를 눌러 장면을 다시 로드할 수도 있습니다.

`/reload`

## 버그 신고

장면이 아니라 Decentraland SDK 전반에 문제가 발생하면 다음을 참조하세요. [버그 신고](https://docs.decentraland.org/creator/content-creator-ko/sdk7/debugging/report-bug.md).

## 종속 항목 버전

장면의 모든 종속 항목을 항상 최신 버전으로 사용하세요. 겪고 있는 문제가 최신 버전에서 이미 해결되었을 수 있습니다. Decentraland 장면에 설치할 업데이트가 있으면 Creator Hub에서 알려 줍니다.

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

명령줄을 통해 종속 항목을 직접 업데이트할 수도 있습니다. Decentraland 장면을 로컬에서 실행하려면 주로 다음 두 라이브러리가 필요합니다. `@dcl/sdk` 및 `@dcl/js-runtime`이며, 각 프로젝트 폴더에 설치됩니다. 두 라이브러리가 모두 최신 상태인지 확인하세요. 다음 명령을 실행하면 두 라이브러리를 최신 안정 버전으로 직접 업데이트할 수 있습니다.

```
npm i @dcl/js-runtime@latest
npm i @dcl/sdk@latest
```

장면에서 스마트 아이템을 사용하는 경우 `@dcl/asset-packs` 라이브러리도 사용 중일 수 있습니다. 다음 명령으로 업데이트할 수 있습니다.

```
npm i @dcl/asset-packs@latest
```

다음 중 하나라도 사용하고 있다면 [utils 라이브러리](https://studios.decentraland.org/resources?sdk_version=SDK7\&resource_type=Library) 해당 라이브러리도 최신 상태로 유지하세요. 오래된 버전은 최신 버전의 `@dcl/sdk`.

## 조명 조건

월드 내 시간대는 3D 모델의 외관에 큰 영향을 줍니다. 광원의 색은 미묘하게 달라져 밤에는 푸른빛을 띠고, 해 뜰 무렵과 해 질 무렵에는 붉은빛을 띱니다. 빛의 방향도 하늘을 따라 이동하며 서로 다른 방향으로 그림자를 드리웁니다.

게임 시계를 여러 값으로 바꿔 하루 중 어느 시간대에도 장면이 잘 보이는지 확인하세요. 다음을 클릭하세요. **스카이박스 시간** 화면 왼쪽 패널의 아이콘을 사용해 원하는 시간으로 설정하세요. 이 슬라이더가 회색으로 표시되면 **자동** 옵션이 비활성화되어 있는지 확인하세요.

<figure><img src="https://github.com/decentraland/docs/blob/main/creator/images/daylight-settings.webp" alt="Dynamic skybox" width="300"><figcaption><p>월드 내 안내</p></figcaption></figure>

3D 모델의 머티리얼은 모델을 만든 모델링 도구에서 보던 모습과 다르게 보일 수 있습니다. 모든 3D 렌더링 엔진은 빛과 머티리얼을 처리하는 방식에 미묘한 차이가 있으므로 이는 자연스러운 현상입니다.

시간대를 고정하고 조명이 바뀌지 않도록 장면을 설정할 수도 있습니다. 자세한 내용은 [스카이박스 제어](https://docs.decentraland.org/creator/content-creator-ko/sdk7/interactivity/skybox-control.md) 를 참조하세요.

## 멀티플레이어 테스트

장면 미리보기를 실행한 다음 서로 다른 탐색기 창 두 개(또는 그 이상)에서 열면, 열려 있는 각 창은 별도의 플레이어로 간주되고 모의 통신 서버가 플레이어들의 상태를 동기화합니다.

한 창에서 장면과 상호작용한 다음 다른 창으로 전환해 해당 상호작용의 효과가 다른 창에도 표시되는지 확인하세요.

Creator Hub에서 **다중 인스턴스 미리보기** 를 **데스크톱 클라이언트** 의 **플레이 옵션**하위 메뉴에서 켠 다음, **플레이** 버튼을 한 번 더 클릭해 Decentraland 탐색기 창을 하나 더 여세요. 두 창에서 서로 다른 주소로 연결해야 합니다. 장면이 다시 로드되어도 동일한 세션이 열린 상태로 유지됩니다. 두 번째 창에서 다른 계정을 선택하려면 로그아웃한 다음 다시 로그인해야 할 수 있습니다.

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

두 플레이어는 서로를 볼 수 있고 상호작용할 수도 있습니다. 장면에 멀티플레이어 로직이 있다면 정상적으로 작동하며 두 플레이어 간에 동기화됩니다.

또는 브라우저 URL에 다음을 입력해 Decentraland 탐색기 창을 하나 더 열 수 있습니다.

> `decentraland://realm=http://127.0.0.1:8000&local-scene=true&debug=true&multi-instance=true`

## Ethereum 테스트 네트워크 사용

장면을 테스트할 때 실제 MANA나 다른 통화를 전송하지 않으려면 Ethereum Sepolia 테스트 네트워크를 사용해 가짜 테스트넷 MANA를 전송할 수 있습니다.

테스트 네트워크를 사용하려면 Metamask Chrome 확장 프로그램에서 *Sepolia 테스트 네트워크* 대신 *메인 네트워크*를 사용하도록 설정해야 합니다. 또한 Sepolia 블록체인에서 MANA를 보유해야 하며, Decentraland에서 무료로 받을 수 있습니다.

{% hint style="info" %}
**💡 팁**: Sepolia MANA를 지갑으로 전송하는 트랜잭션을 실행하려면 Sepolia Ether로 가스 수수료를 지불해야 합니다.
{% endhint %}

이 모드에서 장면을 보는 동안 승인한 트랜잭션은 테스트 네트워크에서만 처리되며 실제 지갑의 MANA 잔액에는 영향을 주지 않습니다.

테스트 네트워크를 사용해 장면을 미리 보려면 다음 URL을 브라우저 탭에 붙여넣으세요. 그러면 Decentraland 데스크톱 클라이언트에서 장면이 열립니다.

> decentraland://realm=<http://127.0.0.1:8000\\&local-scene=true\\&debug=true\\&dclenv=zone\\&position=0,0>

{% hint style="info" %}
**💡 팁**: position 매개변수를 장면의 좌표로 변경하면 장면으로 바로 이동할 수 있습니다. 이 모드에서 장면을 보는 동안 승인한 트랜잭션은 테스트 네트워크에서만 처리되며 실제 지갑의 MANA 잔액에는 영향을 주지 않습니다.
{% endhint %}

Polygon 테스트넷에서 트랜잭션을 테스트해야 하고 해당 테스트넷에서 MANA가 필요한 경우, Sepolia에서 MANA를 받은 뒤 해당 네트워크로 스왑해야 합니다. Sepolia MANA를 Polygon 테스트넷으로 브리지하려면 Sepolia에서 Decentraland 계정 페이지로 이동한 후 Ethereum MANA 옆의 ‘스왑’을 클릭하세요.


---

# 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/debugging/debug-in-preview.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.
