Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

씬 미리보기

씬 미리보기에서 볼 수 있는 것

일단 새 씬을 만들었거나 또는 다운로드한 씬 예제 를 로컬에서 미리 볼 수 있습니다.

Creator Hub의 씬 편집기 사용

다음을 확인하세요. Creator Hub를 설치했는지.

  1. 씬 프로젝트를 여세요.

  2. 다음을 클릭하세요: 미리보기 버튼을 오른쪽 상단 모서리에서 클릭하세요. 그러면 Decentraland 데스크톱 Explorer에서 자신의 씬만 실행되는 새 창이 열립니다. 여기서 씬을 돌아다니고 상호작용 가능한 항목과 상호작용할 수 있습니다.



옆에 있는 드롭다운 메뉴에서 다른 미리보기 옵션을 설정하세요. 미리보기 버튼:

  • 다음으로 미리보기: 다음 중에서 선택하세요 데스크톱 클라이언트 (기본 Decentraland Explorer) 및 Bevy(웹)를 선택할 수 있습니다. 이는 Bevy Web 클라이언트를 사용해 브라우저에서 미리보기를 엽니다. Bevy Web 옵션은 다음과 동일합니다: --web CLI 플래그.

  • 디버그 콘솔 열기: 미리보기가 실행되는 동안 Creator Hub 안에 씬의 콘솔 출력을 표시합니다. 씬의 오류를 디버깅하는 데 유용합니다. 참고: Creator Hub 콘솔.

  • 인증 화면 건너뛰기: 계정 선택 화면을 건너뛰고 현재 로그인된 계정으로 자동 로그인합니다. 기본적으로 비활성화되어 있으며, 여러 계정을 테스트하려면 활성화하세요.

  • 풍경 지형 활성화: 씬 주변의 풍경을 켜거나 끕니다. 기본적으로 활성화되어 있으며, 씬의 메모리 사용량을 줄이려면 비활성화하세요.

  • MCP 서버 활성화: MCP 자동화 서버가 활성화된 상태로 Explorer를 실행하므로, AI 에이전트가 실행 중인 미리보기를 보고 제어할 수 있습니다. 프로젝트의 SDK 버전이 지원할 때만 표시됩니다. 참고: AI와 함께하는 바이브 코딩 전체 워크플로를 보려면.

  • 에셋 최적화: 로컬에서 생성된 에셋 번들로 씬을 미리 봅니다. 프로덕션에서 렌더링되는 방식과 동일하며, 다음 이후: 에셋 번들 변환. 첫 실행에서는 모든 에셋을 변환하므로 큰 씬에서는 몇 분 걸릴 수 있습니다. 데스크톱 클라이언트에서만 사용할 수 있으며(Bevy Web에서는 불가), 참고: 최적화된 에셋으로 미리보기.

  • 모바일용 QR 코드 표시: 씬 미리보기를 열 수 있는 QR 코드를 표시합니다. Decentraland 모바일 앱. 컴퓨터와 같은 Wi‑Fi 네트워크에 연결된 휴대폰으로 코드를 스캔하세요. 참고: 모바일에서 미리보기 자세한 내용은.

팁: 씬을 Decentraland 모바일 앱에서 직접 미리 볼 수도 있습니다. 다음을 사용하세요: 모바일용 QR 코드 표시 Creator Hub의 옵션을 사용하거나 다음을 실행하세요: npm run start -- --mobile CLI에서. 참고: 모바일에서 미리보기 자세한 내용은.

CLI 사용

씬을 미리 보려면 씬의 메인 폴더에서 다음 명령을 실행하세요:

누락된 종속성이 있으면 설치된 다음, CLI가 시스템에 로컬 웹 서버를 만들고 다음을 통해 Decentraland 데스크톱 클라이언트에서 씬을 실행합니다: decentraland:// 딥링크. 데스크톱 클라이언트가 기본 미리보기 대상입니다.

대신 브라우저 탭에서 미리 보려면 다음을 추가하세요: -- --web (또는 -- --bevy-web)을 추가하여 다음에서 Bevy Web 클라이언트로 씬을 여세요: decentraland.org/bevy-web/.

씬을 변경할 때마다 미리보기가 자동으로 다시 로드되고 업데이트되므로, 명령을 다시 실행할 필요가 없습니다.

📔 참고: 일부 씬은 사용자 지정 로직을 수행하거나 데이터를 저장하고 불러오기 위해 외부 서버와의 통신에 의존합니다. 이런 씬을 미리 볼 때는 다른 포트에서 서버도 로컬로 실행해야 할 가능성이 큽니다. 서버와 씬을 모두 시작하는 방법은 씬의 readme에서 확인하세요.

미리보기 명령의 매개변수

다음 플래그를 npm run start 명령에 추가하여 동작을 변경할 수 있습니다:

  • -- --web (별칭 -- --bevy-web) 다음에서 Bevy Web 브라우저 클라이언트로 미리보기를 엽니다: decentraland.org/bevy-web/ 데스크톱 Explorer 대신 사용됩니다. Chromium 기반 브라우저(Chrome 142+)에서는 호스팅된 페이지가 로컬 미리보기 서버에 접근하려면 Local Network Access 권한이 필요합니다. 브라우저가 기기의 앱에 액세스하라고 요청하면 "허용"을 클릭하세요.

  • -- --mobile (별칭 -- -m) 터미널에 QR 코드를 표시하여 씬을 다음에서 열 수 있습니다: Decentraland 모바일 앱 같은 Wi‑Fi 네트워크에 연결된 휴대폰에서. 참고: 모바일에서 미리보기.

  • -- --skip-build 빌드를 건너뛰고 미리보기 모드에서 파일만 제공합니다.

  • -- --port (별칭 -- -p) 씬을 실행할 특정 포트를 지정합니다. 그렇지 않으면 사용 가능한 포트를 사용합니다.

  • -- --no-browser (별칭 -- -b) 미리보기가 새 브라우저 탭을 여는 것을 방지합니다.

  • -- -w 또는 -- --no-watch 파일 시스템 변경 사항을 감시하지 않고, 씬 코드가 변경될 때마다 핫 리로드가 발생하지 않도록 합니다.

  • -- --ci 원격 Unix 서버에서 parcel 미리보기 도구를 실행할 때 사용합니다.

  • -- --multi-instance 여러 Explorer 인스턴스를 동시에 실행할 수 있습니다.

  • -- --local-ab 최적화된 에셋 번들로 미리보기합니다. Desktop Explorer가 미리보기 중 씬의 에셋을 자체적으로 에셋 번들로 변환하여, 프로덕션에서 씬이 렌더링되는 방식과 일치시킵니다. 다음과 동일합니다: 에셋 최적화 Creator Hub의 옵션. 데스크톱 클라이언트에서만 사용할 수 있으며(Bevy Web에서는 불가), 참고: 최적화된 에셋으로 미리보기.

  • -- --no-client 모든 자동 실행(데스크톱 Explorer 딥링크, 브라우저 열기, 모바일 QR)을 억제합니다. 파일 감시자는 Explorer가 자체적으로 연결하면 여전히 데스크톱 Explorer에 알립니다. 외부 도구가 Explorer 프로세스를 관리할 때 유용합니다.

  • -- --mcp Explorer에서 MCP 서버를 활성화합니다(딥링크 매개변수로 전달됨).

  • -- --mcp-port Explorer의 MCP 서버 포트(딥링크 매개변수로 전달됨). 예: npm run start -- --mcp --mcp-port 3001.

📔 참고: 매개변수는 두 개의 대시를 사용해 추가해야 합니다. 예: npm run start -- --web3.

최적화된 에셋으로 미리보기

씬을 게시하면 Decentraland 서버가 모든 3D 모델을 에셋 번들로 변환합니다. 이는 로드와 렌더링이 훨씬 가벼운 최적화 형식입니다. 참고: 에셋 번들 변환. 기본적으로 로컬 미리보기에서는 이 단계를 건너뛰고 대신 원본 모델을 불러옵니다.

씬을 미리 볼 때 동일한 변환을 로컬에서 실행하려면 최적화된 에셋을 활성화하세요. 이렇게 하면 두 가지 이점이 있습니다:

  • 미리보기가 더 빨리 로드되고 더 부드럽게 실행됩니다. 특히 무거운 3D 모델이 있는 씬에서 그렇습니다.

  • 게시 후 플레이어가 보게 될 모습과 정확히 같은 모델을 보게 되므로, 게시 전에 에셋 압축 문제를 발견할 수 있습니다.

이 옵션은 로컬 미리보기에만 영향을 줍니다. 게시된 씬은 이 옵션 사용 여부와 상관없이 항상 서버에서 변환됩니다.

활성화하려면:

  • Creator Hub에서: 다음을 선택하세요: 에셋 최적화 옆에 있는 드롭다운 메뉴에서 미리보기 버튼.

  • CLI에서: 다음을 실행하세요: npm run start -- --local-ab.

이 옵션을 활성화하면 Decentraland explorer가 씬의 3D 모델을 로드하기 전에 기기에서 에셋 번들로 변환합니다. 대부분의 씬에서는 변환이 거의 즉시 이루어지지만, 매우 무거운 에셋이 있는 씬은 첫 미리보기에 더 오래 걸릴 수 있습니다. 변환된 모델은 캐시되므로 이후 미리보기에서는 새로 추가되거나 수정된 에셋만 변환하면 됩니다.

💡 팁: 어떤 이유로든 에셋 변환이 실패하면, 일반 미리보기처럼 원본 3D 모델을 로드하는 방식으로 되돌아갑니다.

씬을 Decentraland에 업로드

씬이 만족스러우면 이를 업로드하고 Decentraland에 게시할 수 있습니다. 이를 위해서는 LAND, Decentraland NAME, 또는 ETH ENS 이름을 소유하고 있거나, 해당 권한을 가진 사람에게서 권한을 받아야 합니다. 참고: 게시 그 방법에 대한 안내를 보세요.

씬 크기 미리보기

미리보기에 표시되는 씬 크기는 씬 설정을 기준으로 합니다.

Scene Editor의 씬 메뉴 두 번째 탭에서 이를 편집할 수 있습니다.



드롭다운을 사용하고 다음을 클릭하세요: 레이아웃 적용 씬의 크기를 변경합니다. 각 개별 구획을 클릭하여 레이아웃에서 제외할 수도 있습니다.



다음도 편집할 수 있습니다: scene.json 파일에서 "parcels" 필드에 여러 구획을 나열할 수 있습니다. 참고: 명령줄로 구획 설정 자세한 내용은.

💡 팁: 미리보기를 실행하는 동안에는 구획 좌표가 실제 씬에서 사용할 좌표와 일치할 필요가 없습니다. 서로 인접해 있고 같은 모양으로 배열되어 있기만 하면 됩니다. 나중에 다음을 할 때 이 좌표를 실제 좌표로 바꿔야 합니다: 씬을 배포할 때.

씬 콘솔 보기

다음을 클릭하여 콘솔을 여세요:  오른쪽 상단 모서리의 아이콘. 여기에서 오류 메시지를 볼 수 있고, 씬이 다음을 통해 콘솔에 출력하는 텍스트도 볼 수 있습니다: console.log().

다음을 눌러서도 열 수 있습니다: ` 키보드의 키. 또한 Shift + ` 를 눌러 콘솔을 더 넓게 열 수 있습니다. 더 많은 텍스트를 봐야 할 때 유용합니다.

Creator Hub 콘솔

Creator Hub에서도 편집기를 벗어나지 않고 같은 출력을 볼 수 있습니다. 다음을 켜세요: 디버그 콘솔 열기 미리보기 옵션에서 켠 다음 미리보기를 실행하세요. 하나의 콘솔 탭이 다음 옆에 나타납니다: 파일 시스템 및 에셋 팩 편집기 하단 패널에 있습니다.

콘솔을 치워두려면 헤더의 팝아웃 아이콘을 클릭하세요. 이 아이콘에는 다음이 표시되어 있습니다: 콘솔을 별도 창에서 열기. 콘솔은 다음 제목의 별도 창으로 열립니다: 콘솔, 이를 두 번째 모니터로 옮겨 편집하는 동안 계속 보이게 둘 수 있습니다.

별도 창에는 다음이 있습니다: 콘솔 지우기 버튼과 편집기에 다시 도킹 버튼이 있으며, 이를 누르면 콘솔이 하단 패널로 돌아갑니다. 한편 콘솔 편집기 탭에는 다음이 표시됩니다: 콘솔이 별도 창에서 열림 그리고 다음을 제공합니다: 여기로 다시 도킹 버튼이 있으며, 같은 작업을 수행합니다.

💡 팁: 콘솔은 분리된 동안에도 출력을 계속 수집하므로, 다시 도킹해도 아무것도 잃지 않습니다. 미리보기가 실행 중이지 않으면 다음이 표시됩니다: 씬을 실행하여 디버그 출력 보기.

멀티플레이어 씬을 로컬에서 테스트

씬 미리보기를 실행하고 서로 다른 Explorer 창 두 개(또는 그 이상)에서 열면, 각 창은 별도의 플레이어로 해석되며 모의 통신 서버가 이 플레이어들을 동기화합니다.

한 창에서 씬과 상호작용한 다음 다른 창으로 전환하면, 그 상호작용의 결과도 그곳에 표시되는 것을 볼 수 있습니다.

Creator Hub를 사용하여 미리보기 버튼을 한 번 더 클릭하면 두 번째 Decentraland explorer 창이 열립니다. 두 창 모두 서로 다른 주소로 연결해야 합니다. 씬이 다시 로드되어도 같은 세션이 계속 열려 있습니다.



대신 다음을 브라우저 URL에 입력하여 두 번째 Decentraland explorer 창을 열 수도 있습니다:

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

고급: 원격 에셋 번들로 빠른 반복

💡 팁: 대부분의 씬에서 에셋 번들로 미리 보는 가장 간단한 방법은 다음을 활성화하는 것입니다: 최적화된 에셋, 로컬에서 모델을 변환하며 항상 최신 버전을 반영합니다. 아래 모드는 서버에 이미 게시된 번들을 재사용하는 대안입니다.

3D 모델이 많은 무거운 씬에서는 다음을 재사용하여 씬 로드 및 재로드를 더 빠르게 할 수 있습니다: 에셋 번들 Decentraland 서버에 이미 게시된 번들을 사용하여, 최적화되지 않은 원본 3D 모델을 로드하는 대신 사용합니다. 코드만 변경하며 반복 작업할 때 특히 유용합니다.

이 모드를 활성화하려면 다음 인수로 Decentraland Desktop 클라이언트를 실행하세요:

다음 <ab-source> 인수는 씬이 이미 게시된 위치에 따라 달라집니다:

  • Genesis City에서: --lsd-remote-ab-server Genesis

  • 월드에서: --lsd-remote-ab-world <world-name>.dcl.eth

예를 들어, 이미 월드에 배포된 씬의 로컬 복사본을 미리 보려면:

두 경우 모두, --realm http://127.0.0.1:8000/ 클라이언트를 로컬 미리보기 서버로 연결합니다(다음을 실행하여 시작: npm run start 먼저 --local-scene true 는 클라이언트가 그곳에서 씬 코드를 로드하도록 합니다.

📔 중요: 이 모드를 사용할 때는 다음을 권장합니다: 모든 아트가 모두 이미 게시되어 있고, 콘텐츠 서버에서 에셋 번들이 완전히 처리된 상태여야 합니다. 새 에셋을 추가했다면, 일반 미리보기처럼 원본 gltf 파일로 로드되므로 최적화된 로딩의 이점을 누리지 못합니다. 하지만 이미 게시된 에셋을 같은 파일 이름으로 로컬 수정했다면, 해당 에셋의 이전 게시 버전이 보이게 됩니다.

그 경우 먼저 씬을 다시 배포하고, 에셋 번들이 생성될 때까지 몇 분 기다린 다음(참고: 에셋 번들 변환)

이전개발 워크플로
다음CLI 사용하기

마지막 업데이트