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

Pré-visualize sua cena

O que você pode ver na pré-visualização de uma cena

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

Usando o Scene Editor no Creator Hub

Certifique-se de que você tenha instalado o Creator Hub.

  1. Abra o seu projeto de scene.

  2. Clique no Preview botão no canto superior direito. Isso abrirá uma nova janela com o Decentraland Desktop Explorer, executando apenas a sua scene. Lá, você pode se mover pela scene e interagir com 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 flag da CLI.

  • Open Debug Console: Mostra a saída do console da scene dentro do Creator Hub enquanto o preview é executado. Isso é útil para depurar erros na scene. Veja O console do Creator Hub.

  • Skip Auth Screen: Ignora a tela de seleção de conta e faz login automaticamente com a conta em que você já está logado. Isso está desativado por padrão; ative-o se quiser testar várias contas.

  • Landscape Terrain Enabled: Ativa ou desativa a paisagem ao redor da scene. Isso está ativado por padrão; desative-o para reduzir o uso de memória da scene.

  • Enable MCP Server: Inicia 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 oferece suporte a isso. Veja Vibe Coding com IA para ver o fluxo completo.

  • Optimize Assets: Pré-visualiza a scene com asset bundles gerados localmente, correspondendo a como ela é renderizada em produção após conversão de asset bundles. A primeira execução converte todos os assets, o que pode levar vários minutos em scenes grandes. Disponível apenas com o Desktop Client (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 scene no aplicativo mobile do 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 fazer preview da sua scene diretamente no aplicativo mobile do 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 fazer preview de uma scene, execute o seguinte comando na pasta principal da scene:

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

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

Sempre que você fizer alterações na scene, o preview recarrega e atualiza automaticamente, então não é necessário executar o comando novamente.

📔 Nota: Algumas scenes dependem de se comunicar com um servidor externo para executar lógica personalizada ou armazenar e recuperar dados. Ao fazer preview de uma dessas scenes, você provavelmente também terá que executar o servidor localmente em outra porta. Verifique o readme da scene para instruções sobre como iniciar o servidor e a scene.

Parâmetros do comando preview

Você pode adicionar os seguintes flags 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 o seu servidor local de preview — quando o navegador pedir acesso a apps no seu dispositivo, clique "Allow".

  • -- --mobile (alias -- -m) Exibe um código QR no terminal que abre sua scene no aplicativo mobile do Decentraland em um celular conectado à mesma rede Wi-Fi. Veja Preview no mobile.

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

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

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

  • -- -w ou -- --no-watch para não observar alterações no sistema de arquivos e evitar hot-reload sempre que o código da scene 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 scene em asset bundles por conta própria durante o preview, correspondendo a como a scene é renderizada em produção. Equivalente à Optimize Assets opção no Creator Hub. Disponível apenas com o Desktop Client (não com Bevy Web). Veja Preview com assets otimizados.

  • -- --no-client Suprime todos os auto-inícios (deeplink do Desktop Explorer, abertura do navegador, QR mobile). O observador 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 do servidor MCP no Explorer (encaminhado como um parâmetro de deep link). Por exemplo: npm run start -- --mcp --mcp-port 3001.

📔 Nota: Os parâmetros precisam ser adicionados com dois conjuntos de hífens, por exemplo npm run start -- --web3.

Preview com assets otimizados

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

Ative assets otimizados para executar essa mesma conversão localmente quando você fizer preview da sua scene. Isso traz dois benefícios:

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

  • Você vê os modelos exatamente como os players os verão após a publicação, então pode detectar qualquer problema com a compressão dos assets antes de publicar.

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

Para ativá-la:

  • No Creator Hub: marque Optimize 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 do Decentraland converte os modelos 3D da scene em asset bundles na sua máquina antes de carregá-los. A conversão é quase instantânea para a maioria das scenes, mas o primeiro preview pode demorar mais se a scene 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 um preview normal.

Enviar uma scene para o Decentraland

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

Tamanho do preview da scene

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

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



Use os menus suspensos e clique em Apply Layout para alterar as dimensões da sua scene. Você também pode clicar em cada parcel individual para desativá-la no 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 do parcel não precisam corresponder às que a sua scene realmente usará, desde que sejam adjacentes e estejam organizadas na mesma forma. Você terá de substituí-las pelas coordenadas reais mais tarde, quando você implantar a scene.

Ver o console da scene

Abra o console clicando no  ícone no canto superior direito. Aqui você pode ver quaisquer mensagens de erro e também qualquer texto que a sua scene 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 ver mais texto.

O console do Creator Hub

O Creator Hub pode mostrar a mesma saída sem sair do editor. Ative Open Debug Console nas opções de preview e, em seguida, execute um preview. Uma CONSOLE aba aparece ao lado de FILE SYSTEM e ASSET PACKS no painel na parte inferior do editor.

Para mover o console para fora do caminho, clique no ícone de pop-out no cabeçalho, rotulado Open console in a separate window. O console se abre como sua própria janela intitulada Console, que você pode mover para um segundo monitor e manter visível enquanto edita.

A janela separada tem um Clear console botão, e um Dock back in the editor botão que retorna o console ao painel inferior. Enquanto isso, a CONSOLE aba no editor mostra Console opened in a separate window e oferece um Dock back here botão que faz a mesma coisa.

💡 Dica: O console continua coletando saída enquanto está desacoplado, então encaixá-lo de volta não faz perder nada. Quando nenhum preview está em execução, ele mostra Execute uma scene para ver a saída de debug.

Teste uma scene multiplayer localmente

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

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

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



Como alternativa, você pode abrir uma segunda janela do Decentraland Explorer 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 scenes, a maneira mais simples de fazer preview com asset bundles é ativar assets otimizados, 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 scenes pesadas com muitos modelos 3D, você pode acelerar o carregamento e o recarregamento da scene reutilizando os asset bundles que já estão publicados nos servidores do Decentraland, em vez de carregar os modelos 3D brutos não otimizados. Isso é especialmente útil ao iterar em mudanças apenas de código.

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

O <ab-source> argumento muda dependendo de onde a scene 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 fazer preview de uma cópia local de uma scene que já foi implantada em um World:

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

📔 Importante: Ao usar este modo, recomenda-se que todos os seus assets de arte já estejam publicados, com seus asset bundles totalmente processados pelos content servers. Se você adicionou algum asset novo, você perderá 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 verá a versão publicada antiga desse asset.

Nesse caso, faça o redeploy da scene primeiro, aguarde alguns minutos para que os asset bundles sejam gerados (veja Conversão de asset bundle), e então volte a usar esse modo para iteração apenas de código.

AnteriorFluxo de trabalho de desenvolvimento
PróximoUsando a CLI

Atualizado