> 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/troubleshooting.md).

# Solução de problemas

## Problemas ao executar a pré-visualização

#### Problema: não consigo executar nenhuma pré-visualização da scene, a mensagem de erro menciona **Permissões negadas** ou **EACCES**

O seu sistema operacional não permite editar permissões na pasta onde você quer executar o projeto. Ao executar a scene, algumas dependências precisam ser instaladas, mas isso é proibido. Você precisa configurar as permissões da pasta para permitir que a sua conta de usuário do Windows/Mac/Linux edite arquivos nela.

Recursos úteis:

* [docs.npmjs](https://docs.npmjs.com/resolving-eacces-permissions-errors-when-installing-packages-globally)
* [letscodepare](https://letscodepare.com/blog/npm-resolving-eacces-permissions-denied)

#### Problema: não consigo executar a pré-visualização de uma scene específica, o erro diz **Erro: erro ao construir o projeto**

Se você estiver executando uma scene que foi compartilhada com você, certifique-se de que essa scene não tenha sido compartilhada contendo uma `node_modules` ou `pasta bin` ou um `package-lock.json` arquivo. Esses arquivos contêm dependências que usam versões específicas do seu sistema operacional e da sua máquina; eles devem ser gerados ao executar a scene pela primeira vez. Exclua essas pastas e arquivo manualmente e, em seguida, execute `npm run start` novamente.

#### Problema: executar `npm run start` executa, não há mensagem de erro, mas nenhuma janela do navegador se abre e não há nenhuma URL na saída para abrir a pré-visualização

Certifique-se de que a sua versão do Node esteja atualizada. Ela deve ser 16 ou mais recente.

#### Problema: executar `npm run start` abre uma aba no navegador, mas a tela de carregamento nunca termina de carregar, ou vejo um banner de erro vermelho que diz "critical error".

* Certifique-se de que você tenha a versão mais recente do Decentraland SDK instalada no seu projeto. Execute:

  `npm i @dcl/sdk"latest`

#### Problema: a scene executa, no console eu vejo `Dependências cíclicas` avisos.

Isso se refere a arquivos na sua scene que fazem referência mútua entre si. Isso não é necessariamente um problema, mas não é um padrão recomendável para escrever software, pois pode levar a condições de corrida difíceis de depurar e outros problemas. Sua scene provavelmente funcionará bem apesar desses avisos.

Idealmente, o carregamento do código na sua scene deve seguir uma ordem sequencial clara. Código com dependências cíclicas pode sofrer do problema do ovo e da galinha, em que o compilador não sabe qual iniciar primeiro. Muitas vezes isso é resolvido sem problemas, mas é uma boa prática evitar.

Para corrigir essas dependências, muitas vezes você precisa recorrer a chamadas de funções ou construtores de objetos passando referências a entidades/objetos já instanciados nos argumentos da função; em vez de codificar referências a essas entidades/objetos na função, que podem ou não já estar instanciadas.

## Problemas ao fazer deploy

#### Problema: você não tem permissões para fazer deploy nesses parcels

* Certifique-se de que o `scene.json` arquivo da sua scene liste corretamente as coordenadas onde você quer fazer deploy.
* Certifique-se de que o Metamask esteja configurado corretamente para usar a wallet certa para assinar a transação. Pode ser a wallet que possui os tokens LAND, ou pode ter permissões de operador concedidas pelo proprietário.

#### Problema: executar `npm run deploy` falha

* Verifique os spawn points da sua scene; todas as três coordenadas x, y, z de um spawn point devem ser um número ou um intervalo. Ou todas as três são números, ou todas as três são intervalos. Não há suporte para ter intervalos em algumas e números em outras.

  Por exemplo, isto não é suportado:

  `"position": {"x": [1,4], "y": 0, "z": [1,4]}`

  Isto é suportado:

  `"position": {"x": [1,4], "y": [0,0], "z": [1,4]}`
* O servidor catalyst padrão para o qual você foi atribuído para fazer deploy pode estar fora do ar ou com problemas. Você pode forçar o `npm run deploy` comando para fazer deploy em um servidor catalyst específico em vez disso. Para fazer deploy em um servidor específico no Decentraland Editor:

  1. Abra a sua scene e clique **Publish**
  2. Selecione a opção **Publish to a different server** na parte inferior.
  3. No menu suspenso, selecione **Custom Server**
  4. Digite o endereço do servidor, por exemplo `peer-testing.decentraland.org`
  5. Clique em **Publicar em servidor personalizado**
  6. Aprove a transação como em um deploy normal.

  Para fazer isso via CLI:

  `npm run deploy -- --target-content <nome-do-servidor>`

  Por exemplo:

  `npm run deploy -- --target-content peer-ec1.decentraland.org`

  Consulte [catalyst-monitor](https://decentraland.github.io/catalyst-monitor/) para verificar o status de todos os servidores na rede catalyst. Você também pode copiar os endereços de cada um, a partir do topo de cada card.
* Verifique o `package.json`da sua scene. Um problema comum é que há um `bundleDependencies` e também uma seção `bundledDependencies` (d extra). Isso às vezes pode resultar da execução de diferentes versões do Node no mesmo projeto em momentos diferentes, ou do compartilhamento do projeto entre pessoas que o executaram com diferentes versões do Node instaladas. Exclua `bundleDependencies`, que se relaciona com versões mais antigas do Node.

Além disso, certifique-se de que sua versão do Node esteja atualizada, pelo menos a versão 16.

#### Problema: executar `npm run deploy` ou `npm run build` reporta erros de tipo

Sua scene pode ter erros de tipo reportados pelo TypeScript, por exemplo informando que uma determinada variável pode ser do tipo `qualquer` ou que `undefined` ou `null` não são permitidos. Ao executar `npm run deploy`, ele também executa `npm run build`, que é um pouco mais rigoroso com essas verificações do que `npm run start`.

Ao contrário do JavaScript, o TypeScript impõe tipagem rígida para todas as variáveis. Mesmo que sua scene seja escrita de forma que, por exemplo, um determinado valor nunca será `undefined`, o TypeScript precisa saber o que aconteceria nesse cenário, ou você precisa esclarecer explicitamente que o valor só pode ser, por exemplo, uma string.

Como alternativa, você pode executar `npm run deploy --skip-build` para ignorar a execução de `npm run build`e impedir que essas verificações sejam executadas.

#### Problema: fiz deploy da minha scene, mas não vejo as alterações quando entro no Decentraland

* Lembre-se de que pode levar alguns minutos para que o novo conteúdo seja propagado por todos os servidores da rede catalyst; espere um pouco.
* Consulte [Verificar sucesso do deploy](/creator/content-creator-pt/scenes-sdk7/comecar/preview-scene.md#verify-deployment-success) para instruções sobre como garantir que o conteúdo foi propagado corretamente para todos os servidores.

#### Problema: depois do deploy, alguns modelos 3D estão ausentes

* Certifique-se de que todos os modelos 3D estejam dentro dos limites da scene, inclusive suas caixas delimitadoras. Se qualquer parte dos seus modelos se estender além desses limites ao executar uma pré-visualização, essas partes serão cortadas e não serão renderizadas, tanto na pré-visualização quanto na scene publicada.

#### Problema: depois do deploy, meus modelos 3D parecem diferentes

* Se as texturas parecerem diferentes, lembre-se de que as texturas em modelos 3D têm tamanho máximo limitado a 512x512 pixels. Essa conversão é realizada para garantir que o Decentraland funcione sem problemas para todos.
* Se os modelos parecerem diferentes, pode haver um problema com a conversão dos modelos para asset bundles. Leia mais sobre compressão de asset bundle [aqui](/creator/content-creator-pt/scenes-sdk7/otimizacao/performance-optimization.md#asset-bundle-conversion).

  Para validar isso, tente executar a scene com o parâmetro de URL `&DISABLE_ASSET_BUNDLES`. Se os modelos estiverem corretos com essa flag, o problema deve estar relacionado a um bug na conversão do modelo.

  Observe que a geração de versões compactadas de asset bundle dos seus modelos é um processo que leva tempo nos servidores (cerca de uma hora). Você pode verificar se os modelos estão sendo carregados como asset bundles compactados ou não escrevendo o seguinte comando na janela de chat `/detectabs`. Modelos compactados são tingidos de verde; os não compactados, de vermelho.

#### Problema: minha scene tem FPS baixo em produção, mesmo funcionando sem problemas na pré-visualização.

O desempenho da sua scene pode ser afetado por scenes vizinhas que seguem más práticas, já que também são executadas em paralelo. Você pode validar se esse é o caso abrindo as configurações e definindo a linha de visão para um mínimo, de modo que apenas 1 parcel ao redor da sua scene atual seja carregado.

Você pode reduzir ainda mais a linha de visão executando sua scene com o parâmetro `&LOS=0`, para não carregar nenhuma scene ao redor.

Se você acabou de fazer deploy da sua scene, a carga ao carregar a scene também pode ser reduzida assim que os servidores converterem os modelos 3D da scene em asset bundles compactados. Você pode verificar se os modelos estão sendo carregados como asset bundles compactados ou não escrevendo o seguinte comando na janela de chat `/detectabs`. Modelos compactados são tingidos de verde; os não compactados, de vermelho.

### Reportar um bug

Se você encontrar um problema que não é com sua scene, mas sim com o SDK da Decentraland em geral, consulte [Reportar um bug](/creator/content-creator-pt/scenes-sdk7/depuracao/report-bug.md).


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/depuracao/troubleshooting.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.