미리보기에서 디버그
미리보기에서 로컬로 실행하는 동안 씬을 디버그하는 방법
미리보기를 실행하면 장면이 어떻게 렌더링되는지 이해하는 데 도움이 되는 유용한 디버깅 정보와 도구를 제공합니다.
장면을 컴파일할 수 없으면, 아무것도 렌더링되지 않은 빈 지면만 보게 됩니다. 이런 경우, 무엇이 잘못되었는지 이해하는 데 도움이 되는 오류 메시지를 찾을 수 있는 몇 군데가 있습니다:
코드 편집기를 확인하여 구문 또는 논리 오류를 표시하지 않았는지 확인하세요.
미리보기 창의 콘솔에서 오류 메시지가 있는지 확인하세요. 다음을 클릭하여 콘솔을 엽니다.
오른쪽 상단 모서리의 아이콘.Creator Hub를 사용하여 장면을 실행했다면 장면의 콘솔 출력이 있는 창을 확인하세요. CLI를 사용하여 장면을 실행했다면, 실행한 명령줄의 출력을 확인하세요
npm run start
콘솔 사용
다음을 클릭하여 콘솔을 엽니다. 오른쪽 상단 모서리의 아이콘.
키보드의 백틱 키를 눌러서도 토글할 수 있습니다: **. 이 키는 대부분의 영어 키보드에서 1 키 왼쪽에 있습니다. 또는 Shift + **\를 누르세요. 콘솔의 더 넓은 보기를 열어 더 많은 텍스트를 볼 수 있습니다.
콘솔에 메시지를 출력합니다( console.log()). 그러면 장면 콘솔을 열어 생성되는 메시지를 볼 수 있습니다.
콘솔에는 오류 메시지도 표시되며, 이러한 메시지는 빨간색으로 표시됩니다.
디버그 패널
다음을 클릭하여 디버그 콘솔을 엽니다. 
오른쪽 상단 모서리의 아이콘.
그러면 오른쪽 아래 모서리에 렌더러 엔진에 대한 정보가 있는 패널이 열리며, 상황이 변할 때마다 실시간으로 업데이트됩니다.
현재 장면
이 현재 장면 탭에는 현재 서 있는 장면에 대한 정보가 포함되어 있습니다. 여기에는 다음이 포함됩니다:
장면의 패널 수
건설이 허용되는 최대 높이(각 장면당 330미터)
다음도 확인할 수 있습니다. 장면 경계 표시 옵션을 선택하면 장면 주위에 빨간 벽이 표시되어 장면의 경계를 나타냅니다.
메모리
이 메모리 섹션에는 Decentraland가 사용하는 메모리가 표시됩니다. 이 값은 항상 다음 값보다 낮게 유지하도록 하세요. 메모리 예산 임계값. 이 값이 너무 커지면 장면을 방문하는 플레이어의 앱이 충돌할 위험이 있습니다. 운영 환경에서는 장면이 주변의 다른 장면과 플레이어와 함께 로드될 수 있으며, 이들 모두가 미리보기에서 보는 것보다 메모리 사용량을 더 높이는 데 기여할 수 있다는 점을 염두에 두세요.
성능
이 성능 탭에는 다음과 관련된 여러 필드가 포함됩니다. FPS (초당 프레임 수). 장면이 복잡해질수록 이 값은 낮아지는 경향이 있으므로, 플레이어에게 좋은 경험을 제공할 수 있도록 항상 이 값을 25 FPS 이상으로 유지하세요. FPS는 실행하는 기기에 따라 달라집니다.
여기서 가장 중요한 값은 평균 FPS , 마지막 1000프레임의 FPS를 반올림한 값입니다.
끊김은 프레임 속도의 순간적인 멈춤을 의미하며, 전체 FPS 수치에는 큰 영향을 주지 않을 수 있지만 플레이어에게는 매우 눈에 띌 수 있습니다. 이는 일반적으로 무거운 에셋이 로드될 때 등 발생할 수 있습니다.
웹 요청
이 웹 요청 섹션을 사용하면 Chrome DevTools의 Network 탭을 열 수 있으며, 여기에는 장면이 만든 웹 요청 수와 그 내용이 표시됩니다. 이는 장면이 서버에 너무 많은 요청을 보내고 있는지 확인하는 데 유용하며, 이는 장면의 성능에 영향을 줄 수 있습니다.
장면이 서드파티 서버와 상호작용하는 경우, 들어오고 나가는 데이터가 무엇인지 보는 것이 종종 유용합니다. 다음을 클릭하세요 Chrome DevTools 열기 를 눌러 Network 탭이 열린 새 Chrome 창을 엽니다.
대안으로, Decentraland 애플리케이션으로 들어오고 나가는 모든 데이터를 보고하는, 여러분의 기기에서 실행할 수 있는 여러 무료 도구가 있습니다. 예를 들어 Charles 또는 Wireshark.
빠른 다시 로드
장면에 변경 사항을 만들 때마다 미리보기는 자동으로 다시 로드되고 업데이트되므로, 미리보기 창을 열고 닫을 필요가 없습니다.
서 있는 장면을 다시 로드해야 한다면, 다음을 클릭하세요 장면 다시 로드 미리보기 창의 왼쪽 상단 모서리 버튼.
또한 채팅에 다음을 입력하고 Enter를 눌러 장면을 다시 로드할 수 있습니다:
/reload
버그 신고
문제가 여러분의 장면에 있는 것이 아니라 Decentraland SDK 자체에 있는 경우, 다음을 참조하세요. 버그 신고.
종속 항목 버전
장면의 모든 종속 항목은 항상 최신 버전을 사용하세요. 겪고 있는 문제가 이미 새 버전에서 수정되었을 수 있기 때문입니다. Creator Hub는 여러분의 Decentraland 장면에 설치할 업데이트가 있을 때 알려줍니다.
명령줄을 통해 종속 항목을 수동으로 업데이트할 수도 있습니다. 로컬에서 Decentraland 장면을 실행하려면 두 개의 주요 라이브러리에 의존합니다: @dcl/sdk 과 @dcl/js-runtime, 이는 각 프로젝트 폴더에 설치됩니다. 이 둘 모두 최신 상태인지 확인하세요. 다음 명령을 실행하여 이 두 라이브러리를 최신 안정 버전으로 수동 업데이트할 수 있습니다:
장면이 스마트 아이템을 사용한다면, 다음도 사용 중일 수 있습니다. @dcl/asset-packs 라이브러리를 사용하며, 다음을 통해 업데이트할 수 있습니다:
다음을 사용 중이라면 유틸 라이브러리 이들 라이브러리의 이전 버전은 다음의 새 버전과 호환되지 않을 수 있으므로, 이들 역시 최신 상태인지 확인하세요. @dcl/sdk.
조명 조건
세계 내 시간대는 3D 모델의 모습에 큰 영향을 줍니다. 광원의 색상은 미묘하게 바뀌어 밤에는 푸른빛을 띠고, 일출과 일몰에는 붉은빛을 띱니다. 빛의 방향도 하늘을 가로질러 이동하여 서로 다른 방향으로 그림자를 드리웁니다.
게임 시계를 다른 값으로 전환하여 하루 중 모든 시간대에서 장면이 잘 보이는지 확인하세요. 다음을 클릭하세요 스카이박스 시간 화면의 왼쪽 패널 아이콘을 눌러 원하는 시간을 설정하세요. 이 슬라이더가 회색으로 표시되어 있다면 다음이 비활성화되어 있는지 확인하세요. 자동 옵션이 비활성화되어 있습니다.
3D 모델의 재질은 제작에 사용한 모델링 도구에서 보였던 것과 같지 않을 수 있습니다. 모든 3D 렌더링 엔진은 빛과 재질을 처리하는 방식에 미묘한 차이가 있기 때문에 이는 예상되는 동작입니다.
또한 하루 중 시간이 고정되어 조명이 바뀌지 않도록 장면을 설정할 수도 있습니다. 다음을 참조하세요 스카이박스 제어 자세한 내용은.
멀티플레이어 테스트
장면 미리보기를 실행하고 이를 두 개 이상의 서로 다른 Explorer 창에서 열면, 열린 각 창은 별도의 플레이어로 해석되며, 모의 통신 서버가 이 플레이어들을 동기화 상태로 유지합니다.
한 창에서 장면과 상호작용한 다음 다른 창으로 전환하여 해당 상호작용의 결과가 그곳에도 표시되는지 확인하세요.
Creator Hub를 사용하면 Preview 버튼을 두 번째로 클릭하여 두 번째 Decentraland explorer 창을 열 수 있습니다. 두 창 모두 서로 다른 주소로 연결해야 합니다. 같은 세션은 장면이 다시 로드되는 동안 계속 열려 있습니다. 다른 계정을 선택하려면 두 번째 창에서 로그아웃한 뒤 다시 로그인해야 할 수 있습니다.
두 플레이어는 서로를 볼 수 있으며 서로 상호작용할 수 있습니다. 장면에 멀티플레이어 로직이 있다면 예상대로 작동하고 두 플레이어 사이에 동기화됩니다.
대안으로, 브라우저 URL에 다음을 입력하여 두 번째 Decentraland explorer 창을 열 수 있습니다:
decentraland://realm=http://127.0.0.1:8000&local-scene=true&debug=true&multi-instance=true
이더리움 테스트 네트워크 사용
장면을 테스트할 때 실제 MANA나 다른 통화를 전송하는 것을 피하려면, 이더리움 Sepolia 테스트 네트워크를 사용하고 대신 가짜 테스트넷 MANA를 전송할 수 있습니다.
테스트 네트워크를 사용하려면 Metamask Chrome 확장을 다음으로 설정해야 합니다. Sepolia 테스트 네트워크 대신 메인 네트워크. 또한 Sepolia 블록체인에서 MANA를 보유하고 있어야 하며, 이는 Decentraland에서 무료로 받을 수 있습니다.
이 모드에서 장면을 보면서 승인한 거래는 테스트 네트워크에서만 발생하며 실제 지갑의 MANA 잔액에는 영향을 주지 않습니다.
테스트 네트워크를 사용하여 장면을 미리 보려면 다음 URL을 브라우저 탭에 붙여넣으세요. 그러면 Decentraland 데스크톱 클라이언트에서 장면이 열립니다:
decentraland://realm=http://127.0.0.1:8000&local-scene=true&debug=true&dclenv=zone&position=0,0
Polygon Testnet에서 거래를 테스트해야 하고 그 테스트넷에 MANA가 있어야 한다면, Sepolia에서 MANA를 받은 뒤 해당 네트워크로 스왑해야 합니다. Sepolia MANA를 Polygon Testnet으로 브리징하려면, Sepolia에서 Decentraland 계정 페이지를 방문한 다음 Ethereum MANA 쪽의 ‘swap’을 클릭하세요.
마지막 업데이트