> 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/getting-started/preview-scene.md). # 씬 미리보기 씬 미리보기에서 볼 수 있는 것 한 번 [새 씬을 만들었거나](#create-your-first-scene) 다운로드한 [씬 예제를](https://studios.decentraland.org/resources?sdk_version=SDK7) 로컬에서 미리 볼 수 있습니다. ## Creator Hub의 씬 편집기 사용하기 다음이 설치되어 있는지 확인하세요. [Creator Hub를](https://github.com/decentraland/docs/tree/main/creator/sdk7/get-started/editor-installation.md). 1. 씬 프로젝트를 여세요. 2. 다음의 **미리보기** 버튼을 오른쪽 상단 모서리에 있는 이 버튼을 누르면, 여러분의 씬만 실행 중인 Decentraland Desktop Explorer가 새 창으로 열립니다. 여기에서 씬을 둘러보고 상호작용 가능한 항목과 상호작용할 수 있습니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-30317b50bc4b4e646a1b28effe1ff76939ab0f28%2Fpreview-button.png?alt=media) 다음 옆의 드롭다운 메뉴에서 다양한 미리보기 옵션을 설정할 수 있습니다. **미리보기** 버튼: * **다음으로 미리보기**: 다음 중에서 선택하세요. **Desktop Client** (기본 Decentraland Explorer)와 **Bevy(Web)**를 사용할 수 있으며, 이 옵션은 Bevy Web 클라이언트를 사용해 브라우저에서 미리보기를 엽니다. Bevy Web 옵션은 다음과 동일합니다. `--web` CLI 플래그. * **미리보기 중 콘솔 창 열기** : 씬의 콘솔 출력을 보여주는 새 창을 엽니다. 씬에서 발생한 오류를 디버그할 때 유용합니다. * **인증 화면 건너뛰기** : 계정 선택 화면을 건너뛰고 현재 로그인된 계정으로 자동 로그인합니다. 기본적으로 비활성화되어 있으며, 여러 계정을 테스트하려면 활성화하세요. * **지형 활성화** : 씬 주변의 지형을 전환합니다. 기본적으로 활성화되어 있으며, 씬의 메모리 사용량을 줄이려면 비활성화하세요. * **MCP 서버 활성화** : MCP 자동화 서버가 활성화된 상태로 Explorer를 실행하여, AI 에이전트가 실행 중인 미리보기를 보고 제어할 수 있게 합니다. 프로젝트의 SDK 버전이 이를 지원할 때만 표시됩니다. 전체 워크플로우는 [AI와 함께하는 바이브 코딩](/creator/content-creator-ko/sdk7/getting-started/vibe-coding.md#let-the-ai-see-your-scene-in-world) 를 참고하세요. * **에셋 최적화** : [에셋 번들 변환](/creator/content-creator-ko/sdk7/optimizing/performance-optimization.md#asset-bundle-conversion) 후 프로덕션에서 렌더링되는 방식과 동일하게, 로컬에서 생성된 에셋 번들로 씬을 미리 봅니다. 처음 실행하면 모든 에셋이 변환되며, 큰 씬에서는 몇 분이 걸릴 수 있습니다. Desktop Client에서만 사용할 수 있습니다(Bevy Web에서는 불가). 자세한 내용은 [최적화된 에셋으로 미리보기](#preview-with-optimized-assets). * **모바일용 QR 코드 표시** : 씬 미리보기를 다음에서 열 수 있는 QR 코드를 표시합니다. [Decentraland 모바일 앱](/creator/content-creator-ko/build-for-mobile/mobile-client/overview.md)QR 코드를 스캔하세요. 휴대폰이 컴퓨터와 같은 Wi‑Fi 네트워크에 연결되어 있어야 합니다. 자세한 내용은 [모바일에서 미리보기](/creator/content-creator-ko/build-for-mobile/develop/preview-on-mobile.md) 를 참고하세요. {% hint style="info" %} **팁:** 또한 Decentraland 모바일 앱에서 씬을 직접 미리 볼 수 있습니다. **모바일용 QR 코드 표시** 옵션을 Creator Hub에서 사용하거나 `npm run start -- --mobile` CLI에서 실행하세요. 자세한 내용은 [모바일에서 미리보기](/creator/content-creator-ko/build-for-mobile/develop/preview-on-mobile.md) 를 참고하세요. {% endhint %} ## CLI 사용하기 씬을 미리 보려면 씬의 메인 폴더에서 다음 명령을 실행하세요: ```bash npm run start ``` 누락된 종속성이 있으면 설치한 뒤, CLI가 시스템에 로컬 웹 서버를 만들고 `decentraland://` 딥링크를 통해 Decentraland Desktop 클라이언트에서 씬을 실행합니다. Desktop 클라이언트가 기본 미리보기 대상입니다. 브라우저 탭에서 미리 보려면 다음을 추가하세요. `-- --web` (또는 `-- --bevy-web`)을 사용해 다음의 Bevy Web 클라이언트에서 씬을 여세요. `decentraland.org/bevy-web/`. 씬을 수정할 때마다 미리보기가 자동으로 다시 로드되고 업데이트되므로, 명령을 다시 실행할 필요가 없습니다. {% hint style="warning" %} **📔 참고** : 일부 씬은 사용자 정의 로직을 수행하거나 데이터를 저장 및 불러오기 위해 외부 서버와의 통신에 의존합니다. 이런 씬을 미리 볼 때는 보통 다른 포트에서 서버도 로컬로 실행해야 합니다. 서버를 어떻게 실행하는지와 씬을 함께 실행하는 방법은 씬의 readme를 확인하세요. {% endhint %} ### 미리보기 명령의 매개변수 다음 플래그를 `npm run start` 명령에 추가하여 동작을 변경할 수 있습니다: * `-- --web` (별칭 `-- --bevy-web`) Desktop Explorer 대신 `decentraland.org/bevy-web/` 의 Bevy Web 브라우저 클라이언트에서 미리보기를 엽니다. Chromium 기반 브라우저(Chrome 142+)는 호스팅된 페이지가 로컬 미리보기 서버에 접근하려면 로컬 네트워크 액세스 권한이 필요합니다. 브라우저가 기기 앱에 접근하라고 요청하면 "허용"을 클릭하세요. * `-- --mobile` (별칭 `-- -m`) 터미널에 QR 코드를 표시하여 다음에서 씬을 엽니다. [Decentraland 모바일 앱](/creator/content-creator-ko/build-for-mobile/mobile-client/overview.md) 같은 Wi‑Fi 네트워크에 연결된 휴대폰에서. 자세한 내용은 [모바일에서 미리보기](/creator/content-creator-ko/build-for-mobile/develop/preview-on-mobile.md). * `-- --skip-build` 빌드를 건너뛰고 미리보기 모드의 파일만 제공합니다. * `-- --port` (별칭 `-- -p`) 씬을 실행할 특정 포트를 지정합니다. 그렇지 않으면 사용 가능한 포트를 사용합니다. * `-- --no-browser` (별칭 `-- -b`) 미리보기가 새 브라우저 탭을 열지 않도록 합니다. * `-- -w` 또는 `-- --no-watch` 파일시스템 변경을 감시하지 않아 씬 코드가 변경될 때마다 핫 리로드가 발생하지 않도록 합니다. * `-- --ci` 원격 Unix 서버에서 parcel 미리보기 도구를 실행하려면. * `-- --multi-instance` Explorer 인스턴스를 동시에 여러 개 실행할 수 있습니다. * `-- --local-ab` 최적화된 에셋 번들로 미리 봅니다. Desktop Explorer는 미리보기 중 씬의 에셋을 자체적으로 에셋 번들로 변환하여, 프로덕션에서 씬이 렌더링되는 방식과 일치시킵니다. Creator Hub의 **에셋 최적화** 옵션과 동일합니다. Desktop Client에서만 사용할 수 있습니다(Bevy Web에서는 불가). 자세한 내용은 [최적화된 에셋으로 미리보기](#preview-with-optimized-assets). * `-- --no-client` 모든 자동 실행(데스크톱 Explorer 딥링크, 브라우저 열기, 모바일 QR)을 억제합니다. 파일 감시기는 자체적으로 연결한 데스크톱 Explorer에는 계속 알립니다. 외부 도구가 Explorer 프로세스를 관리할 때 유용합니다. * `-- --mcp` Explorer에서 MCP 서버를 활성화합니다(딥 링크 매개변수로 전달됨). * `-- --mcp-port` Explorer의 MCP 서버용 포트(딥 링크 매개변수로 전달됨). 예: `npm run start -- --mcp --mcp-port 3001`. {% hint style="warning" %} **📔 참고** : 매개변수는 두 개의 대시 시리즈로 추가해야 합니다. 예: `npm run start -- --web3`. {% endhint %} ## 최적화된 에셋으로 미리보기 씬을 게시하면 Decentraland 서버가 모든 3D 모델을 에셋 번들로 변환합니다. 이는 로드와 렌더링이 훨씬 가벼운 최적화 형식입니다. 자세한 내용은 [에셋 번들 변환](/creator/content-creator-ko/sdk7/optimizing/performance-optimization.md#asset-bundle-conversion)을 참고하세요. 기본적으로 로컬 미리보기는 이 단계를 건너뛰고 대신 원본 모델을 불러옵니다. 최적화된 에셋을 활성화하면 씬을 미리 볼 때 이 변환을 로컬에서도 수행할 수 있습니다. 여기에는 두 가지 장점이 있습니다. * 특히 무거운 3D 모델이 있는 씬에서 미리보기 로딩이 더 빠르고 실행이 더 부드럽습니다. * 게시 후 플레이어가 보게 될 모델을 정확히 볼 수 있어, 게시 전에 에셋 압축 관련 문제를 확인할 수 있습니다. 이 옵션은 로컬 미리보기에만 영향을 줍니다. 게시된 씬은 이 옵션 사용 여부와 관계없이 항상 서버에서 변환됩니다. 활성화하려면: * **Creator Hub에서**다음을 체크하세요. **에셋 최적화** 다음 옆의 드롭다운 메뉴에서 **미리보기** 버튼. * **CLI에서**다음을 실행하세요. `npm run start -- --local-ab`. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e8a9e4c2c58d07f6493df205efe569837d4701f8%2Foptimize-assets-checkbox.png?alt=media) 이 옵션을 활성화하면 Decentraland explorer가 로드하기 전에 여러분의 컴퓨터에서 씬의 3D 모델을 에셋 번들로 변환합니다. 대부분의 씬에서는 변환이 거의 즉시 이루어지지만, 씬의 에셋이 매우 무거우면 첫 미리보기에 더 오래 걸릴 수 있습니다. 변환된 모델은 캐시되므로, 이후 미리보기에서는 새로 추가되거나 수정된 에셋만 변환하면 됩니다. {% hint style="info" %} **💡 팁** : 어떤 이유로든 에셋 변환에 실패하면, 미리보기는 일반 미리보기와 마찬가지로 원본 3D 모델을 불러오는 방식으로 되돌아갑니다. {% endhint %} ## 씬을 decentraland에 업로드하기 씬에 만족하면 Decentraland에 업로드하고 게시할 수 있습니다. 이를 위해서는 LAND, Decentraland NAME, ETH ENS 이름을 소유하고 있거나, 이를 소유한 사람에게 권한을 부여받아야 합니다. 방법은 [게시](/creator/content-creator-ko/sdk7/publishing/publishing.md) 를 참고하세요. ## 씬 크기 미리보기 미리보기에 표시되는 씬 크기는 씬의 설정을 기반으로 합니다. 씬 편집기의 씬 메뉴 두 번째 탭에서 이 설정을 수정하세요. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-54a1901635efda3371172e647c03614733baca17%2Fscene-parcels-3x3.png?alt=media) 드롭다운을 사용한 다음 **레이아웃 적용** 을 클릭해 씬의 크기를 변경하세요. 각 개별 파셀을 클릭해 레이아웃에서 제외할 수도 있습니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-bbc2ecb567600843892a8c8873aaa70107e66839%2Fscene-parcels-toggled.png?alt=media) 또한 *scene.json* 파일을 편집하여 "parcels" 필드에 여러 파셀을 나열할 수도 있습니다. 자세한 내용은 [명령줄로 파셀 설정하기](/creator/content-creator-ko/sdk7/kinds-of-projects/scene-metadata.md#scene-parcels) 자세한 내용은 다음을 참조하세요. {% hint style="info" %} **💡 팁** : 미리보기를 실행하는 동안에는 파셀 좌표가 실제로 씬이 사용할 좌표와 일치할 필요는 없지만, 서로 인접해 있고 같은 모양으로 배치되어 있어야 합니다. 나중에 [씬을 배포할 때](#upload-a-scene-to-decentraland). {% 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) 오른쪽 상단 모서리의 아이콘입니다. 여기에서 오류 메시지와 함께, 씬이 콘솔에 출력하는 모든 텍스트를 다음을 통해 확인할 수 있습니다. `console.log()`. 또한 다음 키를 눌러 열 수 있습니다. **\`** 키를 키보드에서. 또한 Shift + **\`** 를 눌러 콘솔을 더 넓게 열 수 있습니다. 더 많은 텍스트를 봐야 할 때 유용합니다. ## 로컬에서 멀티플레이어 씬 테스트하기 장면 미리보기를 실행하고 두 개 이상의 서로 다른 탐색기 창에서 열면, 열려 있는 각 창은 별도의 플레이어로 해석되며 모의 통신 서버가 이 플레이어들을 동기화 상태로 유지합니다. 한 창에서 장면과 상호작용한 다음 다른 창으로 전환하여 그 상호작용의 효과가 그곳에도 보이는지 확인하세요. Creator Hub에서 미리보기 버튼을 두 번째로 클릭하면 두 번째 Decentraland explorer 창이 열립니다. 두 창 모두 서로 다른 주소로 연결해야 합니다. 같은 세션은 씬이 다시 로드되는 동안 계속 열려 있습니다. ![](https://3980763956-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-30317b50bc4b4e646a1b28effe1ff76939ab0f28%2Fpreview-button.png?alt=media) 대안으로, 다음을 브라우저 URL에 입력하여 두 번째 Decentraland 탐색기 창을 열 수 있습니다: > `decentraland://realm=http://127.0.0.1:8000&local-scene=true&debug=true&multi-instance=true` ### 고급: 원격 에셋 번들로 빠른 반복 작업 {% hint style="info" %} **💡 팁** : 대부분의 씬에서는 에셋 번들로 미리 보는 가장 간단한 방법은 [최적화된 에셋](#preview-with-optimized-assets)을 활성화하는 것입니다. 그러면 모델이 로컬에서 변환되고 항상 최신 버전이 반영됩니다. 아래 모드는 서버에 이미 게시된 번들을 재사용하는 대안입니다. {% endhint %} 3D 모델이 많은 무거운 씬에서는 이미 [에셋 번들](/creator/content-creator-ko/sdk7/optimizing/performance-optimization.md#asset-bundle-conversion) 이 Decentraland 서버에 게시되어 있는 원본의 비최적화 3D 모델 대신 이를 재사용하여 씬 로딩과 다시 로딩을 더 빠르게 할 수 있습니다. 이는 코드만 변경하며 반복 작업할 때 특히 유용합니다. 이 모드를 활성화하려면 다음 인수로 Decentraland Desktop 클라이언트를 실행하세요. ```bash npm run start -- --realm http://127.0.0.1:8000/ --position 0,0 --local-scene true --debug --skip-version-check true --lsd-use-remote-ab ``` 그 `` 인수는 씬이 이미 어디에 게시되어 있는지에 따라 달라집니다. * **Genesis City에서**: `--lsd-remote-ab-server Genesis` * **World에서**: `--lsd-remote-ab-world .dcl.eth` 예를 들어, 이미 World에 배포된 씬의 로컬 복사본을 미리 보려면: ```bash npm run start -- --realm http://127.0.0.1:8000/ --position 0,0 --local-scene true --debug --skip-version-check true --lsd-use-remote-ab --lsd-remote-ab-world myworld.dcl.eth ``` 두 경우 모두 `--realm http://127.0.0.1:8000/` 는 클라이언트를 로컬 미리보기 서버로 지정합니다( `npm run start` 먼저 실행하여 시작하고), `--local-scene true` 는 클라이언트가 그 위치에서 씬의 코드를 불러오도록 합니다. {% hint style="warning" %} **📔 중요** : 이 모드를 사용할 때는 **모든** 아트가 이미 게시되어 있고, 콘텐츠 서버에서 에셋 번들이 완전히 처리되어 있는 것이 좋습니다. 새 에셋을 추가했다면, 일반 미리보기처럼 원본 gltf 파일로 로드되므로 최적화된 로딩의 이점을 누리지 못합니다. 하지만 이미 게시된 에셋을 같은 파일 이름으로 로컬에서 수정했다면, 그 에셋의 이전 게시 버전이 보이게 됩니다. 그 경우에는 먼저 씬을 다시 배포하고, 에셋 번들이 생성될 때까지 몇 분 기다린 다음(자세한 내용은 [에셋 번들 변환](/creator/content-creator-ko/sdk7/optimizing/performance-optimization.md#asset-bundle-conversion)를 참고), 코드 전용 반복 작업을 위해 이 모드를 다시 사용하세요. {% 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 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/getting-started/preview-scene.md?ask=&goal= ``` `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.