Pré-visualize Sua Cena

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

Uma vez que você tenha construído uma nova cena ou baixado um exemplo de cena você pode pré-visualizá‑la localmente.

Usando o Scene Editor no Creator Hub

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

1. Abra seu projeto de cena.

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

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

• Abrir Janela do Console Durante a Visualização: 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 sua conta atualmente conectada. Isso está desativado por padrão; habilite se quiser testar múltiplas contas.

• Terreno Landscape Habilitado: Alterna a paisagem ao redor da cena. Isso está habilitado por padrão; desative para reduzir a pegada de memória da cena.

Usando o CLI

Para pré-visualizar uma cena execute o seguinte comando na pasta principal da cena:

npm run start -- --explorer-alpha

Qualquer dependência que estiver faltando será instalada e então o CLI abrirá a cena em uma nova aba do navegador automaticamente. Ele cria um servidor web local no seu sistema e aponta a aba do navegador para esse endereço local.

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

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

Parâmetros do comando de visualização

Você pode adicionar as seguintes flags ao npm run start comando para alterar seu comportamento:

• -- --web3 Conecta a visualização à carteira do navegador para usar o avatar e a conta associados.

• -- --no-debug Desativa o painel de debug, que mostra estatísticas da cena e de desempenho.

• -- --explorer-alpha Executa a visualização no novo cliente Decentraland Desktop.

• -- --skip-version-checks Evita verificar se a versão do framework SDK da cena corresponde à sua versão do CLI, e lança a visualização mesmo assim.

• -- --port para atribuir uma porta específica para executar a cena. Caso contrário, será usada qualquer porta disponível.

• -- --no-browser para evitar que a visualização abra uma nova aba do navegador.

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

• -- --c ou -- --ci Para executar o parcel previewer em um servidor unix remoto

📔 Nota: Parâmetros precisam ser adicionados com duas séries de traços, por exemplo npm run start -- --web3.

Enviar uma cena para Decentraland

Uma vez que você esteja satisfeito com sua cena, você pode enviá‑la e publicá‑la no Decentraland. Para isso você deve possuir LAND, um NAME da Decentraland, ou um nome ENS em ETH, ou ter permissões dadas por alguém que possua. Veja publicação para instruções sobre como fazer isso.

Tamanho da cena na visualização

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

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

Use os menus suspensos e clique Aplicar Layout para alterar as dimensões da sua cena. Você também pode clicar em cada parcela individual para desativá‑la do seu layout.

Você também pode editar o scene.json arquivo para listar múltiplas parcelas no campo "parcels". Veja definir parcelas via linha de comando para mais detalhes.

💡 Tip: Enquanto a visualização estiver em execução, as coordenadas das parcelas não precisam coincidir com aquelas que sua cena realmente usará, desde que sejam adjacentes e estejam organizadas na mesma forma. Você terá que substituí‑las pelas coordenadas reais mais tarde quando fazer o deploy da cena.

Ver o console da cena

Pressione a ` tecla no seu teclado para abrir o console da cena. 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 pressionar Shift + ` para abrir o console ainda mais largo, caso precise visualizar mais texto.

Testar uma cena multiplayer localmente

Se você iniciar uma pré-visualização da cena e abri-la em duas (ou mais) janelas diferentes do Explorer, cada janela aberta será interpretada como um jogador separado, e um servidor de comunicação simulado manterá esses jogadores sincronizados.

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

Usando o Creator Hub, clique no botão Visualizar uma segunda vez, e isso abrirá uma segunda janela do Decentraland explorer. Você deve conectar‑se em ambas as janelas com endereços diferentes. As mesmas sessões permanecerão abertas conforme a cena 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