> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/depuracao/debug-in-preview.md).

# Depurar na pré-visualização

Como pode depurar a sua cena enquanto a executa localmente na pré-visualização

Executar uma pré-visualização fornece informações e ferramentas de depuração úteis para ajudar a perceber como a cena é renderizada.

Se não for possível compilar a cena, verá apenas o terreno vazio, sem nada renderizado. Se isso acontecer, há vários locais onde pode procurar mensagens de erro que ajudem a perceber o que correu mal:

1. Verifique o seu editor de código para confirmar que não assinalou erros de sintaxe ou de lógica.
2. Verifique se há mensagens de erro na consola da janela de pré-visualização. Abra a consola clicando no ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a673f6b987216e9e471fdac882879c44fcf94652%2Fconsole-icon.png?alt=media\&token=1965a51b-d4b0-4caa-b9d5-d24d738c1fb8) ícone no canto superior direito.
3. Se executou a cena através do Creator Hub, verifique a janela com a saída da consola da cena. Se executou a cena através da CLI, verifique a saída da linha de comandos onde executou `npm run start`

{% hint style="info" %}
**💡 Sugestão**: antes de publicar a sua cena no ambiente de produção, pode publicá-la num [Decentraland World](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing-options.md#decentraland-worlds) para a experimentar num contexto muito mais próximo do ambiente de produção.
{% endhint %}

## Utilizar a consola

Abra a consola clicando no ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a673f6b987216e9e471fdac882879c44fcf94652%2Fconsole-icon.png?alt=media\&token=1965a51b-d4b0-4caa-b9d5-d24d738c1fb8) ícone no canto superior direito.

Também pode alternar a sua visibilidade premindo a tecla de acento grave no teclado: **`**. Esta tecla fica à esquerda da tecla 1 na maioria dos teclados ingleses. Em alternativa, prima Shift + **\`** para abrir uma vista mais ampla da consola, caso precise de ver mais texto.

Apresente mensagens na consola (utilizando `console.log()`). Depois, pode ver estas mensagens à medida que são geradas, abrindo a consola da cena.

A consola também apresenta mensagens de erro, assinaladas a vermelho.

## O painel de depuração

Abra a consola de depuração clicando no ![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-9af92d7a9edeb4111484adc136865c46bf27e9e1%2Fdebug-icon.webp?alt=media) ícone no canto superior direito.

É aberto um painel no canto inferior direito com informações sobre o motor de renderização, atualizado em tempo real à medida que os elementos mudam.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a66a852a3c9f55e2dd178b31e52601c8d79746d8%2Fdebug-panel.webp?alt=media)

### Cena atual

O separador **CURRENT SCENE** inclui informações sobre a cena onde se encontra. Estas informações incluem:

* O número de parcelas na cena
* A altura máxima a que pode construir (330 metros em todas as cenas)

Também pode selecionar a opção **Show Scene Bounds** para ver paredes vermelhas em redor da cena, que assinalam os limites da mesma.

### Memória

A secção **MEMORY** apresenta a memória utilizada pela Decentraland. Tente sempre manter este valor abaixo dos **Limiares do orçamento de memória**. Se este valor aumentar demasiado, a aplicação poderá falhar para os jogadores que visitam a sua cena. Tenha em conta que, em produção, a cena poderá ser carregada juntamente com outras cenas nas proximidades e com os respetivos jogadores, o que pode aumentar ainda mais o consumo de memória em relação ao que vê na pré-visualização.

### Desempenho

O separador **PERFORMANCE** inclui vários campos relacionados com *FPS* (fotogramas por segundo). Este valor tende a diminuir à medida que a cena se torna mais complexa. Certifique-se de que se mantém sempre acima de 25 FPS para garantir uma boa experiência aos jogadores. Os FPS variam consoante a máquina utilizada.

O valor mais importante é a **Média de FPS**, que corresponde à média dos FPS dos últimos 1000 fotogramas.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-27c0293cff82265d4eb7d6b6506e23e210d2b016%2Ffps-debug-panel.webp?alt=media)

{% hint style="warning" %}
**📔 Nota**: O ciclo de jogo da cena é executado à mesma velocidade que o renderizador. Os seus sistemas são executados uma vez por fotograma renderizado, pelo que os FPS apresentados aqui também indicam quantas vezes por segundo a lógica da cena é atualizada.
{% endhint %}

As interrupções são pausas momentâneas na frequência de fotogramas, que podem ter pouco impacto no número geral de FPS, mas ser bastante percetíveis para o jogador. Normalmente, podem ocorrer quando são carregados recursos pesados ou em situações semelhantes.

### Pedidos Web

A secção **PEDIDOS WEB** permite abrir o separador Network das Chrome DevTools, que apresenta o número de pedidos Web efetuados pela cena e os respetivos conteúdos. Isto é útil para perceber se a cena está a fazer demasiados pedidos aos servidores, o que pode afetar o desempenho da cena.

Se a sua cena interagir com um servidor de terceiros, muitas vezes é útil ver que dados entram e saem. Clique em **Abrir Chrome DevTools** para abrir uma nova janela do Chrome com o separador Network aberto.

{% hint style="warning" %}
**📔 Nota**: Para utilizar esta funcionalidade, tem de instalar primeiro o [Creator Hub](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/editor-installation.md), uma vez que as dependências necessárias estão incluídas nessa instalação.

Não precisa de ter o Creator Hub aberto nem de executar a pré-visualização da cena através do Creator Hub para utilizar esta funcionalidade. Também pode utilizá-la se estiver a usar a CLI para executar a pré-visualização da cena.
{% endhint %}

Em alternativa, existem várias ferramentas gratuitas que pode executar no seu computador para monitorizar todos os dados que entram e saem da aplicação Decentraland. Por exemplo, [Charles](https://www.charlesproxy.com/) ou [Wireshark](https://www.wireshark.org/).

## Recarregamento rápido

Sempre que faz alterações à cena, a pré-visualização é recarregada e atualizada automaticamente, pelo que não precisa de fechar e voltar a abrir a janela de pré-visualização.

Se precisar de recarregar a cena em que se encontra, clique no botão **Recarregar cena** no canto superior esquerdo da janela de pré-visualização.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-1ff6d67c0b7a28f78caa13019a9ccabeb3afe662%2Freload-button.webp?alt=media)

Também pode recarregar a cena escrevendo o seguinte no chat e premindo Enter:

`/reload`

## Comunicar um erro

Se encontrar um problema que não esteja relacionado com a sua cena, mas sim com o SDK da Decentraland em geral, consulte [Comunicar um erro](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/depuracao/report-bug.md).

## Versões das dependências

Certifique-se de que utiliza sempre as versões mais recentes de todas as dependências da sua cena, uma vez que os problemas que está a encontrar podem já ter sido corrigidos em versões mais recentes. O Creator Hub irá notificá-lo quando houver atualizações para instalar na sua cena da Decentraland.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-0ba6896aebac94a5ec9cc2365864a36e0e11e7dc%2Fnew-dependencies.webp?alt=media)

Também pode atualizar manualmente as dependências através da linha de comandos. A execução local de uma cena da Decentraland depende de duas bibliotecas principais: `@dcl/sdk` e `@dcl/js-runtime`, que é instalada na pasta de cada projeto. Certifique-se de que ambas estão atualizadas. Pode executar os seguintes comandos para atualizar manualmente estas duas bibliotecas para as versões estáveis mais recentes:

```
npm i @dcl/js-runtime@latest
npm i @dcl/sdk@latest
```

Se a sua cena utilizar smart items, poderá também utilizar a biblioteca `@dcl/asset-packs` , que pode atualizar com o comando:

```
npm i @dcl/asset-packs@latest
```

Se estiver a utilizar alguma das bibliotecas [utils](https://studios.decentraland.org/resources?sdk_version=SDK7\&resource_type=Library) certifique-se de que também estão atualizadas, uma vez que as versões mais antigas destas bibliotecas poderão não ser compatíveis com versões mais recentes de `@dcl/sdk`.

## Condições de iluminação

A hora do dia no mundo tem um grande impacto no aspeto dos modelos 3D. A cor da fonte de luz muda subtilmente, adquirindo um tom azulado à noite e um tom avermelhado ao nascer e ao pôr do sol. A direção da luz também muda ao longo do céu, projetando sombras em diferentes direções.

Verifique se a sua cena tem bom aspeto a todas as horas do dia, alterando o relógio do jogo para diferentes valores. Clique na **hora do skybox** ícone no painel esquerdo do ecrã para definir a hora que preferir. Se este controlo deslizante estiver desativado, certifique-se de que a opção **Auto** está desativada.

<figure><img src="https://github.com/decentraland/docs/blob/main/creator/images/daylight-settings.webp" alt="Dynamic skybox" width="300"><figcaption><p>Instruções no mundo</p></figcaption></figure>

Os materiais do seu modelo 3D podem não ter o mesmo aspeto que tinham na ferramenta de modelação em que o criou. Isto é esperado, uma vez que todos os motores de renderização 3D têm diferenças subtis na forma como lidam com a luz e os materiais.

Também pode configurar a sua Scene para que a hora do dia seja fixa e a iluminação não mude. Consulte [Controlo da Skybox](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/skybox-control.md) para mais informações.

## Testes multijogador

Se iniciar uma pré-visualização da Scene e a abrir 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á estes jogadores sincronizados.

Interaja com a Scene numa janela e, em seguida, mude para a outra para ver que os efeitos dessa interação também são visíveis nessa janela.

No Creator Hub, ative **Pré-visualização de várias instâncias** no submenu **Cliente de desktop** de **Opções de reprodução**, e depois clique novamente no botão **Reproduzir** para abrir uma segunda janela do Explorer do Decentraland. Tem de iniciar sessão nas duas janelas com endereços diferentes. As mesmas sessões permanecerão abertas quando a Scene for recarregada. Poderá ter de terminar sessão e voltar a iniciar sessão na segunda janela para selecionar uma conta diferente.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-10d53f215e20e8cf603bbf578d0b33df738d058f%2Fpreview-button.webp?alt=media)

Os dois jogadores verão um ao outro e poderão interagir entre si. Se a Scene tiver lógica multijogador, esta funcionará como esperado e será sincronizada entre os dois jogadores.

Em alternativa, pode abrir uma segunda janela do Explorer do Decentraland escrevendo o seguinte endereço num browser:

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

## Utilizar a rede de testes Ethereum

Durante os testes da sua Scene, para evitar transferir MANA real ou outras moedas, pode utilizar a rede de testes Ethereum Sepolia e transferir MANA de teste fictício.

Para utilizar a rede de testes, tem de configurar a extensão Metamask para Chrome para utilizar a *rede de testes Sepolia* em vez da *Rede principal*. Também tem de possuir MANA na blockchain Sepolia, que pode obter gratuitamente através do Decentraland.

{% hint style="info" %}
**💡 Dica**: para efetuar a transação de transferência de MANA Sepolia para a sua carteira, terá de pagar uma taxa de gas em Ether Sepolia.
{% endhint %}

Todas as transações que aceitar enquanto visualiza a Scene neste modo ocorrerão apenas na rede de testes e não afetarão o saldo de MANA na sua carteira real.

Para pré-visualizar a sua Scene utilizando a rede de testes, cole o seguinte URL num separador do browser. A Scene será aberta no cliente de desktop do Decentraland:

> decentraland://realm=<http://127.0.0.1:8000\\&local-scene=true\\&debug=true\\&dclenv=zone\\&position=0,0>

{% hint style="info" %}
**💡 Dica**: altere o parâmetro position para as coordenadas da sua Scene, para a abrir diretamente na sua Scene. Todas as transações que aceitar enquanto visualiza a Scene neste modo ocorrerão apenas na rede de testes e não afetarão o saldo de MANA na sua carteira real.
{% endhint %}

Se precisar de testar transações na rede de testes Polygon e de ter MANA nessa rede, terá de transferir MANA para essa rede depois de o obter na Sepolia. Para transferir MANA Sepolia para a rede de testes Polygon, visite a página da sua conta Decentraland na Sepolia e clique em ‘swap’ no lado do MANA Ethereum.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/depuracao/debug-in-preview.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
