Usando o CLI

Como usar o Decentraland CLI para executar, implantar, etc

Para criar cenas para Decentraland você pode usar:

Ambas as ferramentas permitem compilar e visualizar sua cena em um ambiente de desenvolvimento "off-chain". Após testar sua cena localmente, você pode enviar seu conteúdo para o content server, vinculando-o ao seu LAND ou WORLD.

Embora o Scene Editor no Creator Hub seja mais fácil de usar, a CLI oferece mais flexibilidade e pode ser facilmente usada em processos automatizados.

circle-exclamation
circle-info

💡 Dica: Veja Guia de instalação para instruções sobre como instalar o Creator Hub.

Antes de começar

Para trabalhar com a cena via linha de comando, instale as seguintes dependências antes de executar comandos da CLI com a cena:

Iniciar um novo projeto

Execute npx @dcl/sdk-commands init em uma pasta vazia para preenchê-la com os arquivos padrão de um projeto Decentraland.

A CLI então solicita que você escolha que tipo de projeto, se deseja construir uma scene, um workspace ou um smart wearable. Se selecionar uma scene, a CLI perguntará qual projeto base usar como ponto de partida.

Atualizar a versão do SDK de uma scene

Execute o seguinte comando na pasta da scene:

Você pode confirmar que funcionou verificando o package.json arquivo da scene e procurando pela @dcl/sdk versão ali.

Executar uma pré-visualização

Execute npm run start no nível raiz de uma scene, workspace ou projeto de smart wearable para abrir uma pré-visualização em uma janela do navegador.

Veja pré-visualizar cenas para detalhes e opções especiais ao executar uma pré-visualização.

Build

Execute npm run build para construir seu projeto. As cenas de Decentraland são escritas em TypeScript, mas são compiladas para JavaScript minificado quando publicadas. Veja codificar cenasarrow-up-right para mais detalhes.

O comando de build é opcional, já que também é executado em segundo plano antes do deploy (embora você possa adicionar uma flag para pular isso).

O comando de build executa verificações de tipo mais rigorosas do que as que são executadas com npm run start, executá-lo pode às vezes ser útil para depurar uma scene.

Fazer deploy de uma scene

Execute npm run deploy para publicar sua scene em Decentraland. Este comando abre uma janela do navegador onde você pode assinar com sua wallet para autorizar o deploy.

Veja publicação para detalhes e opções especiais ao publicar uma scene.

Solução de problemas

Se você encontrar problemas, veja a solução de problemas seção.

Atualizado