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

Pré-visualize sua scene

O que você pode ver na preview de uma scene

Depois de você ter criado uma nova cena ou baixado um exemplo de cena você pode visualizá-la localmente.

Usando o Scene Editor no Creator Hub

Certifique-se de que você instalou o Creator Hub.

  1. Abra o seu projeto de cena.

  2. Clique no Preview botão no canto superior direito. Isso abrirá uma nova janela com o Decentraland Desktop Explorer, executando apenas a sua cena. Lá você pode se mover pela cena e interagir com os itens interativos.



Configure diferentes opções de preview no menu suspenso ao lado do Preview botão:

  • Preview com: Escolha entre Desktop Client (o Decentraland Explorer padrão) e Bevy (Web), que abre o preview no seu navegador usando o cliente Bevy Web. A opção Bevy Web é equivalente ao --web sinalizador CLI.

  • Abrir janela do console durante o preview: Abre uma nova janela com a saída do console da cena. Isso é útil para depurar erros na cena.

  • Pular tela de autenticação: Ignora a tela de seleção de conta e faz login automaticamente com a conta com a qual você está atualmente conectado. Isso está desativado por padrão; ative-o se quiser testar várias contas.

  • Terreno paisagístico ativado: Alterna a paisagem ao redor da cena. Isso está ativado por padrão; desative-o para reduzir o consumo de memória da cena.

  • Ativar servidor MCP: Abre o Explorer com o servidor de automação MCP ativado, para que agentes de IA possam ver e controlar o preview em execução. Só fica visível quando a versão do SDK do seu projeto o suporta. Veja Vibe Coding com IA para ver o fluxo de trabalho completo.

  • Otimizar assets: Visualiza a cena com asset bundles gerados localmente, correspondendo à forma como ela é renderizada em produção após conversão em asset bundles. A primeira execução converte todos os assets, o que pode levar vários minutos em cenas grandes. Disponível apenas com o cliente Desktop (não com Bevy Web). Veja Preview com assets otimizados.

  • Mostrar código QR para mobile: Exibe um código QR que abre o preview da sua cena no aplicativo mobile da Decentraland. Escaneie o código com um celular na mesma rede Wi-Fi que o seu computador. Veja Preview no mobile para mais detalhes.

Dica: Você também pode visualizar sua cena diretamente no aplicativo mobile da Decentraland. Use a Mostrar código QR para mobile opção no Creator Hub, ou execute npm run start -- --mobile na CLI. Veja Preview no mobile para mais detalhes.

Usando a CLI

Para visualizar uma cena, execute o seguinte comando na pasta principal da cena:

Quaisquer dependências ausentes são instaladas e então a CLI cria um servidor web local no seu sistema e inicia a cena no cliente Desktop da Decentraland via um decentraland:// deeplink. O cliente Desktop é o destino padrão do preview.

Para visualizar em uma aba do navegador em vez disso, adicione -- --web (ou -- --bevy-web) para abrir a cena no cliente Bevy Web em decentraland.org/bevy-web/.

Toda vez que você faz alterações na cena, o preview recarrega e atualiza automaticamente, então não há necessidade de executar o comando novamente.

📔 Observação: Algumas cenas dependem de comunicação com um servidor externo para executar lógica personalizada ou armazenar e recuperar dados. Ao visualizar uma dessas cenas, você provavelmente também precisará executar o servidor localmente em outra porta. Consulte o readme da cena para obter instruções sobre como iniciar o servidor e a cena.

Parâmetros do comando de preview

Você pode adicionar os seguintes sinalizadores ao npm run start comando para alterar seu comportamento:

  • -- --web (alias -- --bevy-web) Abre o preview no cliente de navegador Bevy Web em decentraland.org/bevy-web/ em vez do Desktop Explorer. Navegadores baseados em Chromium (Chrome 142+) exigem a permissão Local Network Access para que a página hospedada alcance seu servidor local de preview — quando o navegador pedir acesso a apps no seu dispositivo, clique "Allow".

  • -- --mobile (alias -- -m) Mostra um código QR no terminal que abre sua cena no aplicativo mobile da Decentraland em um telefone conectado à mesma rede Wi-Fi. Veja Preview no mobile.

  • -- --skip-build Pule a build e sirva apenas os arquivos no modo de preview.

  • -- --port (alias -- -p) para atribuir uma porta específica para executar a cena. Caso contrário, usará qualquer porta disponível.

  • -- --no-browser (alias -- -b) para impedir que o preview abra uma nova aba do navegador.

  • -- -w ou -- --no-watch para não monitorar alterações no sistema de arquivos e evitar hot-reload sempre que o código da cena mudar.

  • -- --ci Para executar o previewer do Parcel em um servidor Unix remoto.

  • -- --multi-instance Permite executar várias instâncias do Explorer simultaneamente.

  • -- --local-ab Preview com asset bundles otimizados. O Desktop Explorer converte os assets da cena em asset bundles por conta própria durante o preview, correspondendo à forma como a cena é renderizada em produção. Equivalente à Otimizar assets opção no Creator Hub. Disponível apenas com o cliente Desktop (não com Bevy Web). Veja Preview com assets otimizados.

  • -- --no-client Suprime todos os lançamentos automáticos (deeplink do desktop Explorer, abertura no navegador, QR mobile). O monitor de arquivos ainda notifica um desktop Explorer se ele se conectar por conta própria. Útil quando uma ferramenta externa controla o processo do Explorer.

  • -- --mcp Ativa o servidor MCP no Explorer (encaminhado como um parâmetro de deep link).

  • -- --mcp-port Porta para o servidor MCP no Explorer (encaminhada como um parâmetro de deep link). Por exemplo: npm run start -- --mcp --mcp-port 3001.

📔 Observação: Os parâmetros precisam ser adicionados com dois pares de hífens, por exemplo npm run start -- --web3.

Preview com assets otimizados

Quando você publica uma cena, os servidores da Decentraland convertem todos os seus modelos 3D em asset bundles, um formato otimizado que é muito mais leve para carregar e renderizar. Veja Conversão de asset bundles. Por padrão, os previews locais pulam essa etapa e carregam os modelos brutos em vez disso.

Ative assets otimizados para executar essa mesma conversão localmente quando você visualizar sua cena. Isso tem dois benefícios:

  • O preview carrega mais rápido e roda com mais fluidez, especialmente em cenas com modelos 3D pesados.

  • Você vê os modelos exatamente como os jogadores os verão após a publicação, então pode identificar quaisquer problemas com a compressão dos assets antes de publicar.

Essa opção afeta apenas o seu preview local. A cena publicada é sempre convertida nos servidores, independentemente de você usar ou não essa opção.

Para ativá-la:

  • No Creator Hub: marque Otimizar assets no menu suspenso ao lado do Preview botão.

  • Na CLI: execute npm run start -- --local-ab.

Com essa opção ativada, o Explorer da Decentraland converte os modelos 3D da cena em asset bundles na sua máquina antes de carregá-los. A conversão é quase instantânea para a maioria das cenas, mas o primeiro preview pode demorar mais se a cena tiver assets muito pesados. Os modelos convertidos ficam em cache, então em previews posteriores apenas os assets novos ou modificados precisam ser convertidos.

💡 Dica: Se a conversão de um asset falhar por qualquer motivo, o preview volta a carregar os modelos 3D brutos, assim como em um preview normal.

Fazer upload de uma cena para a Decentraland

Quando estiver satisfeito com sua cena, você pode fazer upload dela e publicá-la na Decentraland. Para isso, você deve ser dono de LAND, de um NAME da Decentraland ou de um nome ENS da ETH, ou ter permissões concedidas por alguém que os tenha. Veja publicação para instruções sobre como fazer isso.

Tamanho da cena no preview

O tamanho da cena mostrado no preview é baseado na configuração da cena.

Edite isso na segunda aba do menu da cena no Scene Editor.



Use os menus suspensos e clique em Aplicar layout para alterar as dimensões da sua cena. Você também pode clicar em cada parcel individual para removê-la do seu layout.



Você também pode editar o scene.json arquivo para listar vários parcels no campo "parcels". Veja definir parcels via a linha de comando para mais detalhes.

💡 Dica: Enquanto o preview estiver em execução, as coordenadas dos parcels não precisam corresponder às que sua cena realmente usará, contanto que sejam adjacentes e estejam organizadas na mesma forma. Você terá que substituí-las pelas coordenadas reais depois, quando você implantar a cena.

Ver o console da cena

Abra o console clicando no  ícone no canto superior direito. Aqui você pode ver quaisquer mensagens de erro e também qualquer texto que sua cena imprima no console via console.log().

Você também pode abri-lo pressionando a ` tecla no seu teclado. Você também pode pressionar Shift + ` para abrir o console ainda mais amplo, caso precise visualizar mais texto.

Testar uma cena multiplayer localmente

Se você iniciar um preview de cena e abri-lo em duas (ou mais) janelas diferentes do Explorer, cada janela aberta será interpretada como um jogador separado, e um servidor de comunicações simulado manterá esses jogadores sincronizados.

Interaja com a cena em uma janela e depois mude para a outra para ver que os efeitos dessa interação também ficam visíveis lá.

Usando o Creator Hub, clique no botão Preview uma segunda vez, e isso abre uma segunda janela do Explorer da Decentraland. Você deve se conectar nas duas janelas com endereços diferentes. As mesmas sessões permanecerão abertas enquanto a cena recarrega.



Como alternativa, você pode abrir uma segunda janela do Explorer da Decentraland escrevendo o seguinte em uma URL do navegador:

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

Avançado: iteração rápida com asset bundles remotos

💡 Dica: Para a maioria das cenas, a maneira mais simples de fazer preview com asset bundles é ativar assets otimizados, o que converte seus modelos localmente e sempre reflete a versão mais recente deles. O modo abaixo é uma alternativa que reutiliza os bundles já publicados nos servidores.

Para cenas pesadas com muitos modelos 3D, você pode acelerar o carregamento e o recarregamento da cena reutilizando os asset bundles que já estão publicados nos servidores da Decentraland, em vez de carregar os modelos 3D brutos e não otimizados. Isso é especialmente útil ao iterar em alterações apenas de código.

Para ativar esse modo, inicie o cliente Desktop da Decentraland com os seguintes argumentos:

O <ab-source> argumento muda dependendo de onde a cena já está publicada:

  • Em Genesis City: --lsd-remote-ab-server Genesis

  • Em um World: --lsd-remote-ab-world <world-name>.dcl.eth

Por exemplo, para visualizar uma cópia local de uma cena que já foi implantada em um World:

Em ambos os casos, --realm http://127.0.0.1:8000/ aponta o cliente para o seu servidor local de preview (execute npm run start primeiro para iniciá-lo), e --local-scene true instrui o cliente a carregar o código da cena a partir daí.

📔 Importante: Ao usar esse modo, é recomendado que todos o seu conteúdo artístico já esteja publicado, com seus asset bundles totalmente processados pelos content servers. Se você adicionou assets novos, você não terá o carregamento otimizado, pois eles serão carregados como arquivos gltf brutos, como acontece quando você executa um preview normalmente. Mas se você modificou localmente um asset que já estava publicado, mantendo o mesmo nome de arquivo, então você verá a versão publicada antiga desse asset.

Nesse caso, reimplante a cena primeiro, aguarde a geração dos asset bundles (veja Conversão de asset bundles), e depois retome o uso desse modo para iteração apenas de código.

AnteriorFluxo de trabalho de desenvolvimento
PróximoUsando o CLI

Atualizado