Debug no Preview
Como pode fazer debug da sua scene enquanto a executa localmente no Preview
Executar uma preview fornece algumas informações úteis de debugging e ferramentas para ajudar você a entender como a scene é renderizada.
Se a scene não puder ser compilada, você verá apenas o ground vazio, sem nada renderizado nele. Se isso ocorrer, há vários lugares onde você pode procurar mensagens de erro para ajudá-lo a entender o que deu errado:
Verifique seu editor de código para se certificar de que ele não marcou nenhum erro de sintaxe ou lógica.
Verifique o console na janela de preview para quaisquer mensagens de erro. Abra o console clicando no
ícone no canto superior direito.Se você executou a scene usando o Creator Hub, verifique a janela com a saída do console da scene. Se você executou a scene usando a CLI, verifique a saída da linha de comando onde você executou
npm run start
💡 Dica: Antes de publicar sua scene no ambiente de produção, você pode publicá-la em um Decentraland World para testá-la em um contexto muito mais próximo da produção.
Use o console
Abra o console clicando no ícone no canto superior direito.
Você também pode alterná-lo pressionando a tecla backtick no teclado: **. Esta tecla fica à esquerda da tecla 1 na maioria dos teclados em inglês. Ou, alternativamente, pressione Shift + **\ para abrir uma visualização mais ampla do console, caso precise ver mais texto.
Exiba mensagens no console (usando console.log()). Você pode então visualizar essas mensagens conforme são geradas ao abrir o console da scene.
O console também mostra mensagens de erro; elas são marcadas em vermelho.
O painel de debug
Abra o console de debug clicando no 
ícone no canto superior direito.
Isso abre um painel no canto inferior direito com informações sobre o renderer engine e é atualizado em tempo real à medida que as coisas mudam.
Scene atual
A SCENE ATUAL aba inclui informações sobre a scene em que você está atualmente. Isso inclui:
O número de parcels na scene
A altura máxima em que você pode construir (que é proporcional ao número de parcels na scene)
Você também pode verificar a Mostrar limites da scene opção para ver paredes vermelhas ao redor da scene, que marcam os limites da scene.
Memória
A MEMÓRIA seção exibe a memória usada pela Decentraland. Tente sempre manter esse valor abaixo dos Memory Budget Thresholds. Se esse valor crescer demais, há risco de travar o app para os jogadores que visitarem sua scene. Tenha em mente que, em produção, a scene pode ser carregada junto com outras scenes ao redor e jogadores, o que pode contribuir para elevar o consumo de memória acima do que você vê na preview.
Desempenho
A DESEMPENHO aba inclui vários campos relacionados a FPS (Frames Per Second). Esse valor tende a ser menor conforme a scene cresce em complexidade, certifique-se de sempre manter esse valor acima de 25 FPS, para garantir uma boa experiência para seus jogadores. O FPS vai variar dependendo da máquina em que você executar isso.
O valor mais importante aqui é o Average FPS, que arredonda o FPS dos últimos 1000 frames.
📔 Nota: O FPS do renderer não é o mesmo que as atualizações da lógica da scene por segundo. A lógica da scene é limitada a 30 FPS, o FPS do renderer pode chegar a 60 ou mais.
Hiccups referem-se a pausas momentâneas na taxa de frames, que podem ter pouco impacto no número geral de FPS, mas podem ser muito perceptíveis para o jogador. Isso normalmente pode ocorrer quando assets pesados são carregados ou algo semelhante.
Requisições Web
A REQUISIÇÕES WEB seção permite que você abra a aba Network do Chrome Devtools, que exibe o número de web requests feitas pela scene e seu conteúdo. Isso é útil para saber se a scene está fazendo requisições demais para servidores, o que pode impactar o desempenho da scene.
Se a sua scene interage com um servidor de terceiros, muitas vezes é útil ver quais dados entram e saem. Clique em Abrir Chrome Devtools para abrir uma nova janela do Chrome com a aba Network aberta.
📔 Nota: Para usar este recurso, primeiro você deve instalar o Creator Hub, pois as dependências necessárias vêm incluídas nessa instalação.
Você não precisa ter o Creator Hub aberto nem executar a preview da sua scene pelo Creator Hub para usar este recurso; ele também pode ser usado se você estiver usando a CLI para executar a preview da sua scene.
Como alternativa, há várias ferramentas gratuitas que você pode executar na sua máquina que mostram todos os dados que entram e saem da aplicação Decentraland. Por exemplo Charles ou Wireshark.
Recarregamento rápido
Sempre que você fizer alterações na scene, a preview recarrega e atualiza automaticamente, então não há necessidade de abrir e fechar a janela de preview.
Se você precisar recarregar a scene em que está, clique no Recarregar scene botão no canto superior esquerdo da janela de preview.
Você também pode recarregar a scene escrevendo o seguinte no chat e pressionando enter:
/reload
Relatar um bug
Se você encontrar um problema que não esteja na sua scene, mas sim no SDK da Decentraland em geral, consulte Relatar um bug.
Versões das dependências
Certifique-se de usar sempre as versões mais recentes de todas as dependencies na sua scene, pois qualquer problema que você esteja enfrentando talvez já tenha sido corrigido em versões mais novas. O Creator Hub irá notificá-lo quando houver atualizações para instalar na sua scene da Decentraland.
Você também pode atualizar manualmente as dependencies pela linha de comando. Executar uma scene da Decentraland localmente depende de duas bibliotecas principais: @dcl/sdk e @dcl/js-runtime, que é instalado em cada pasta do projeto. Certifique-se de que ambos estejam atualizados. Você pode executar os seguintes comandos para atualizar manualmente ambas as bibliotecas para a versão estável mais recente:
Se a sua scene usa smart items, ela também pode estar usando a @dcl/asset-packs biblioteca, que você pode atualizar via:
Se você estiver usando qualquer uma das bibliotecas utilitárias certifique-se de que elas também estejam atualizadas, pois versões mais antigas dessas bibliotecas podem não ser compatíveis com versões mais novas de @dcl/sdk.
Condições de iluminação
A hora do dia no world tem um grande impacto em como os modelos 3D ficam. A cor da fonte de luz muda sutilmente, ficando com um tom azulado à noite e um tom avermelhado durante o nascer e o pôr do sol. A direção da luz também se move pelo céu, lançando sombras em diferentes direções.
Verifique se a sua scene fica boa em todos os horários do dia alternando o relógio do jogo para valores diferentes. Clique no horário do skybox ícone no painel esquerdo da tela para definir qualquer horário de sua preferência. Se esse controle deslizante estiver acinzentado, certifique-se de que a Auto opção esteja desativada.
Os materials do seu modelo 3D podem não parecer os mesmos que pareciam na ferramenta de modelagem com a qual você o criou. Isso é esperado, pois todos os rendering engines 3D têm diferenças sutis na forma como lidam com a luz e os materials.
Você também pode configurar sua scene para que a hora do dia fique fixa e a iluminação não mude. Veja controle do Skybox para mais detalhes.
Testes multiplayer
Se você iniciar uma preview de scene 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ções simulado manterá esses jogadores sincronizados.
Interaja com a scene 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 em ambas as janelas com endereços diferentes. As mesmas sessões permanecerão abertas enquanto a scene recarrega. Talvez você precise sair e entrar novamente na segunda janela para selecionar uma conta diferente.
Ambos os jogadores verão um ao outro e poderão interagir entre si. Se a scene tiver qualquer lógica multiplayer, ela funcionará como esperado e será sincronizada entre os dois jogadores.
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
Usando a testnet da Ethereum
Ao testar sua scene, para evitar transferir MANA real ou outras moedas, você pode usar a rede de teste Sepolia da Ethereum e transferir MANA falsa da testnet em vez disso.
Para usar a rede de teste, você deve configurar a extensão MetaMask do Chrome para usar a testnet Sepolia em vez da rede principal. Você também deve possuir MANA na blockchain Sepolia, que você pode obter gratuitamente na Decentraland.
💡 Dica: Para executar a transação de transferir MANA Sepolia para sua wallet, você precisará pagar uma taxa de Gas em Sepolia Ether.
Quaisquer transações que você aceitar enquanto visualiza a scene neste modo ocorrerão apenas na testnet e não afetarão o saldo de MANA na sua wallet real.
Para pré-visualizar sua scene usando a testnet, cole a seguinte URL em uma aba do navegador. Isso abrirá a scene no cliente desktop da Decentraland:
decentraland://realm=http://127.0.0.1:8000&local-scene=true&debug=true&dclenv=zone&position=0,0
💡 Dica: Altere o parâmetro position para as coordenadas da sua scene, para carregar diretamente na sua scene.. Quaisquer transações que você aceitar enquanto visualiza a scene neste modo ocorrerão apenas na testnet e não afetarão o saldo de MANA na sua wallet real.
Se você precisar testar transações na Polygon Testnet e precisar ter MANA nessa testnet, você precisará trocar MANA para essa rede depois de obtê-la em Sepolia. Para fazer bridge da MANA Sepolia para a Polygon Testnet, visite a página da sua conta na Decentraland em Sepolia e clique em ‘swap’ no lado da MANA Ethereum.
Atualizado