> 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. 미리 보기 창의 콘솔에서 오류 메시지가 있는지 확인하세요. 다음을 클릭하여 콘솔을 여세요  오른쪽 상단 모서리에 있는 아이콘입니다.
3. Creator Hub을 사용하여 장면을 실행했다면 장면의 콘솔 출력이 표시되는 창을 확인하세요. CLI를 사용하여 장면을 실행했다면 다음을 실행한 명령줄의 출력을 확인하세요 `npm run start`
{% hint style="info" %}
**💡 팁**: 프로덕션 환경에 장면을 게시하기 전에 다음에 게시할 수 있습니다 [Decentraland World](/creator/content-creator-ko/sdk7/publishing/publishing-options.md#decentraland-worlds) 프로덕션에 훨씬 더 가까운 환경에서 테스트해 볼 수 있습니다.
{% endhint %}
## 콘솔 사용
다음을 클릭하여 콘솔을 여세요  오른쪽 상단 모서리에 있는 아이콘입니다.
키보드의 백틱 키를 눌러서도 토글할 수 있습니다: **`**. 이 키는 대부분의 영어 키보드에서 1 키의 왼쪽에 있습니다. 또는 Shift + **\ 키를 누르세요`** 더 많은 텍스트를 확인해야 하는 경우 콘솔을 더 넓게 열 수 있습니다.
콘솔에 메시지 출력(다음 사용) `console.log()`). 그런 다음 장면 콘솔을 열어 생성되는 메시지를 확인할 수 있습니다.
콘솔에는 오류 메시지도 표시되며, 빨간색으로 표시됩니다.
## 디버그 패널
다음을 클릭하여 디버그 콘솔을 여세요  오른쪽 상단 모서리에 있는 아이콘입니다.
그러면 렌더러 엔진에 대한 정보가 담긴 패널이 오른쪽 하단 모서리에 열리며, 변경 사항에 따라 실시간으로 업데이트됩니다.
### 현재 장면
다음 **CURRENT SCENE** 탭에는 현재 서 있는 장면에 대한 정보가 포함됩니다. 여기에는 다음이 포함됩니다:
* 장면 내 파셀 수
* 건설이 허용되는 최대 높이(모든 장면에서 330미터)
다음도 확인할 수 있습니다 **Show Scene Bounds** 옵션을 선택하면 장면 경계를 표시하는 빨간색 벽이 장면 주변에 나타납니다.
### 메모리
다음 **MEMORY** 섹션에는 Decentraland에서 사용하는 메모리가 표시됩니다. 항상 이 값을 다음보다 낮게 유지하세요 **Memory Budget Thresholds**. 이 값이 너무 커지면 장면을 방문하는 플레이어의 앱이 충돌할 위험이 있습니다. 프로덕션에서는 장면이 주변의 다른 장면 및 플레이어와 함께 로드될 수 있으며, 이 모든 요소가 미리 보기에서 보이는 것보다 메모리 사용량을 높일 수 있다는 점을 유념하세요.
### 성능
다음 **PERFORMANCE** 탭에는 다음과 관련된 여러 필드가 포함됩니다 *FPS* (초당 프레임 수)입니다. 장면이 복잡해질수록 이 값은 낮아지는 경향이 있으므로, 플레이어에게 좋은 경험을 제공하려면 항상 25 FPS 이상으로 유지하세요. FPS는 이를 실행하는 컴퓨터에 따라 달라집니다.
여기서 가장 중요한 값은 **Average FPS**, 즉 최근 1000프레임의 FPS를 반올림한 값입니다.
{% hint style="warning" %}
**📔 참고**: 렌더러의 FPS는 장면의 게임 루프 초당 업데이트 횟수와 같지 않습니다. 장면의 로직은 30 FPS로 제한되지만 렌더러 FPS는 60 이상까지 올라갈 수 있습니다.
{% endhint %}
끊김 현상은 프레임 속도가 순간적으로 멈추는 현상을 말하며, 전체 FPS 수치에는 영향이 적을 수 있지만 플레이어에게는 매우 눈에 띌 수 있습니다. 일반적으로 무거운 에셋 등을 로드할 때 발생할 수 있습니다.
### 웹 요청
다음 **WEB REQUESTS** 섹션에서는 장면이 수행한 웹 요청 수와 그 내용을 표시하는 Chrome Devtools Network 탭을 열 수 있습니다. 장면이 서버에 너무 많은 요청을 보내 성능에 영향을 미치는지 파악하는 데 유용합니다.
장면이 타사 서버와 상호작용하는 경우, 어떤 데이터가 들어오고 나가는지 확인하는 것이 유용한 경우가 많습니다. 다음을 클릭하세요 **Open Chrome Devtools** 새 Chrome 창에서 Network 탭을 엽니다.
{% hint style="warning" %}
**📔 참고**: 이 기능을 사용하려면 먼저 다음을 설치해야 합니다 [Creator Hub](/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/).
## 빠른 새로고침
장면을 변경할 때마다 미리 보기가 자동으로 다시 로드되고 업데이트되므로 미리 보기 창을 열고 닫을 필요가 없습니다.
현재 서 있는 장면을 다시 로드해야 한다면 다음을 클릭하세요 **Reload Scene** 미리 보기 창의 왼쪽 상단 모서리에 있는 버튼입니다.
채팅에 다음을 입력하고 Enter 키를 눌러 장면을 다시 로드할 수도 있습니다:
`/reload`
## 버그 신고
장면이 아닌 일반적인 Decentraland SDK 관련 문제를 발견했다면 다음을 참조하세요 [버그 신고](/creator/content-creator-ko/sdk7/debugging/report-bug.md).
## 종속성 버전
발생하는 문제는 최신 버전에서 이미 해결되었을 수 있으므로 장면의 모든 종속성에 항상 최신 버전을 사용하세요. Decentraland 장면에 설치할 업데이트가 있으면 Creator Hub에서 알려 줍니다.
명령줄을 통해 종속성을 수동으로 업데이트할 수도 있습니다. 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
```
다음 중 하나를 사용 중인 경우 [유틸리티 라이브러리](https://studios.decentraland.org/resources?sdk_version=SDK7\&resource_type=Library) 이전 버전의 이러한 라이브러리는 최신 버전과 호환되지 않을 수 있으므로 이들도 최신 상태인지 확인하세요 `@dcl/sdk`.
## 조명 조건
월드 내 시간대는 3D 모델이 보이는 방식에 큰 영향을 줍니다. 광원의 색상은 미묘하게 변하며 밤에는 푸르스름한 색조를, 일출과 일몰에는 붉은색 색조를 띱니다. 빛의 방향도 하늘을 가로질러 이동하여 서로 다른 방향으로 그림자를 만듭니다.
게임 시계를 서로 다른 값으로 전환하여 모든 시간대에 장면이 보기 좋은지 확인하세요. 다음을 클릭하세요 **skybox time** 화면 왼쪽 패널의 아이콘을 클릭하여 원하는 시간을 설정하세요. 이 슬라이더가 회색으로 비활성화되어 있다면 다음을 확인하세요 **Auto** 옵션이 비활성화되어 있는지 확인하세요.
월드 내 지침
3D 모델의 머티리얼은 제작에 사용한 모델링 도구에서 보였던 것과 다르게 보일 수 있습니다. 모든 3D 렌더링 엔진은 빛과 머티리얼을 처리하는 방식에 미묘한 차이가 있으므로 이는 예상되는 현상입니다.
시간대를 고정하고 조명이 바뀌지 않도록 장면을 설정할 수도 있습니다. 다음을 참조하세요 [Skybox control](/creator/content-creator-ko/sdk7/interactivity/skybox-control.md) 자세한 내용은 여기에서 확인하세요.
## 멀티플레이어 테스트
장면 미리 보기를 실행하고 서로 다른 탐색기 창 두 개(또는 그 이상)에서 열면, 각 창은 별도의 플레이어로 해석되며 모의 통신 서버가 이 플레이어들을 동기화 상태로 유지합니다.
한 창에서 장면과 상호작용한 다음 다른 창으로 전환하여 해당 상호작용의 효과가 այնտեղ에도 표시되는지 확인하세요.
Creator Hub을 사용하여 다음을 켜세요 **Multi-Instance Preview** 다음의 **Desktop Client** 하위 메뉴에서 **Play Options**, 그런 다음 다음을 클릭하세요 **Play** 버튼을 두 번째로 클릭하여 두 번째 Decentraland 탐색기 창을 여세요. 두 창 모두 서로 다른 주소로 연결해야 합니다. 장면이 다시 로드되어도 동일한 세션은 계속 열려 있습니다. 다른 계정을 선택하려면 두 번째 창에서 로그아웃한 후 다시 로그인해야 할 수 있습니다.
두 플레이어는 서로를 볼 수 있고 서로 상호작용할 수 있습니다. 장면에 멀티플레이어 로직이 있다면 예상대로 작동하고 두 플레이어 간에 동기화됩니다.
대안으로, 브라우저 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=
{% hint style="info" %}
**💡 팁**: 장면으로 직접 로드하려면 position 매개변수를 장면의 좌표로 변경하세요. 이 모드에서 장면을 보는 동안 승인하는 모든 거래는 테스트 네트워크에서만 발생하며 실제 지갑의 MANA 잔액에는 영향을 주지 않습니다.
{% endhint %}
Polygon Testnet에서 거래를 테스트해야 하고 해당 테스트넷에 MANA가 필요하다면, Sepolia에서 MANA를 획득한 후 해당 네트워크로 스왑해야 합니다. Sepolia MANA를 Polygon Testnet으로 브리지하려면 Sepolia의 Decentraland 계정 페이지를 방문하여 Ethereum MANA 쪽의 ‘swap’을 클릭하세요.
---
# 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=&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.
