CLI 사용

Decentraland CLI를 사용해 씬을 실행하고 배포합니다. Creator Hub는 대부분의 크리에이터에게 권장되는 도구이며, CLI는 고급 및 자동화 워크플로에 적합합니다.

💡 팁: AI 코딩 어시스턴트(예: Claude Code, Cursor, Copilot)와 함께 작업할 경우, 코드가 작성되기 전에 공식 Decentraland SDK Skills를 설치하여 검증된 SDK7 패턴을 알게 하세요:

npx skills add decentraland/sdk-skills

참조 AI와 함께하는 바이브 코딩 전체 AI 지원 워크플로를 확인하세요.

Decentraland용 씬을 빌드하려면 다음 중 하나를 사용할 수 있습니다:

• 이 크리에이터 허브

• 명령줄 인터페이스(CLI)

두 도구 모두 씬을 오프체인 개발 환경에서 컴파일하고 미리 볼 수 있게 해줍니다. 로컬에서 씬을 테스트한 뒤에는 콘텐츠를 콘텐츠 서버에 업로드하고, LAND 또는 WORLD와 연결할 수 있습니다.

Creator Hub의 씬 에디터는 사용하기 더 쉽지만, CLI는 더 많은 유연성을 제공하며 자동화된 프로세스에서도 쉽게 사용할 수 있습니다.

📔 참고: 씬 에디터는 내부적으로 동일한 명령줄 작업을 실행합니다.

💡 팁: 참조 설치 가이드 Creator Hub 설치 방법에 대한 지침입니다.

시작하기 전에

명령줄을 통해 씬을 다루려면, 해당 씬에 대해 CLI 명령을 실행하기 전에 다음 종속 항목을 설치하세요:

• Node.js (버전 20 이상)

새 프로젝트 시작

실행 npx @dcl/sdk-commands init Decentraland의 기본 파일로 채우기 위해 빈 폴더에서 씬 프로젝트를 생성하세요. 또한 Creator Hub의 새 씬 버튼을 사용하여 새 씬을 만들 수 있으며, 동일한 프로젝트 구조가 생성됩니다.

다른 종류의 프로젝트에서 시작하려면 --project 플래그를 사용하세요. 예를 들어, 다음을 만들려면 스마트 웨어러블 프로젝트:

npx @dcl/sdk-commands init --project smart-wearable

에 대해 사용할 수 있는 옵션은 --project 다음과 같습니다 scene-template (기본값), px-template, smart-wearable, 그리고 library.

씬의 SDK 버전 업데이트

씬 폴더에서 다음 명령을 실행하세요:

npm i @dcl/sdk@latest

다음 항목을 확인하면 작동했는지 확인할 수 있습니다 package.json 씬의 파일에서 다음 항목을 찾아보세요 @dcl/sdk 버전입니다.

미리보기 실행

실행 npm run start 씬, 작업 공간 또는 스마트 웨어러블 프로젝트의 루트 수준에서 실행하여 Decentraland 데스크톱 클라이언트에서 미리보기를 엽니다.

npm run start

씬을 Decentraland 모바일 앱 에서 미리 보려면 대신 npm run start -- --mobile (별칭 -- -m). CLI는 컴퓨터와 동일한 Wi‑Fi 네트워크에 연결된 휴대폰에서 씬을 여는 QR 코드를 출력합니다. 참조 모바일에서 미리보기 전체 가이드를 보려면.

npm run start -- --mobile

미리보기를 더 부드럽게 실행하고 게시 후 보이게 될 것과 동일하게 3D 모델을 렌더링하려면 --local-ab 플래그를 추가하세요. 참조 최적화된 에셋으로 미리보기.

npm run start -- --local-ab

참조 미리보기 씬 미리보기를 실행할 때의 자세한 내용과 특수 옵션을 확인하세요.

빌드

실행 npm run build 프로젝트를 빌드하세요. Decentraland 씬은 TypeScript로 작성되지만, 게시될 때는 축소된 JavaScript로 빌드됩니다. 참조 씬 코딩 자세한 내용은.

빌드 명령은 선택 사항입니다. 배포 전에 백그라운드에서도 실행되기 때문입니다(다만 건너뛰기 플래그를 추가할 수 있습니다).

빌드 명령은 npm run start와 함께 실행되는 것보다 더 엄격한 타입 검사를 실행하므로, 때로는 씬 디버깅에 도움이 될 수 있습니다.

씬 배포

실행 npm run deploy 를 실행하여 씬을 Decentraland에 게시하세요. 이 명령은 배포를 승인하기 위해 지갑으로 서명할 수 있는 브라우저 창을 엽니다.

참조 게시 씬을 게시할 때의 자세한 내용과 특수 옵션을 확인하세요.

문제 해결

문제가 발생하면 다음을 참조하세요. 문제 해결 섹션.