Solução de problemas

Esta página lista problemas comuns ao usar o Godot e possíveis soluções.

Ver também

Veja Utilizando o editor Web para detalhes importantes específicos para a versão HTML5 do editor do Godot.

Tudo que eu faço no editor ou no gerenciador de projeto aparece atrasado em um frame.

Este é um bug conhecido em drivers gráficos da Intel no Windows. Atualizar os drivers para sua última versão fornecida pela Intel deve resolver o problema.

Você deve usar os drivers gráficos fornecidos pela Intel ao invés do entregue pela fabricante do seu desktop ou laptop porque geralmente este está desatualizado.

A grade desaparece e as malhas ficam pretas quando eu rotaciono a câmera 3D no editor.

Este é um bug conhecido em drivers gráficos da Intel no Windows.

A única solução, por enquanto, é mudar para o renderizador GLES2. Você pode alternar o renderizador no canto superior direito do editor ou nas Configurações do Projeto.

Se você usa um computador que permite trocar sua placa gráfica, como o NVIDIA Optimus, pode usar a placa gráfica dedicada para executar o Godot.

O editor ou projeto leva muito tempo para iniciar.

Esse é um bug conhecido no Windows quando você tem periféricos USB específicos conectados. Em particular, o software iCUE da Corsair parece causar o bug. Tente atualizar os drivers dos seus periféricos USB para a última versão. Se o bug persistir, você precisa desconectar os periféricos com defeito antes de abrir o editor. Após isso, você pode conectá-lo novamente.

O editor do Godot parece congelar após clicar no console do sistema.

Ao executar o Godot no Windows com o console do sistema aberto, você pode acidentalmente habilitar o modo de seleção clicando dentro da janela de comando. Esse comportamento específico do Windows pausa o aplicativo para que você selecione o texto dentro do console do sistema. O Godot não pode ignorar esse comportamento específico do sistema.

Para resolver isto, selecione a janela do console do sistema e pressione Enter para sair do modo de seleção.

Textos como "NO DC" aparecem no canto superior esquerdo do gerenciador de projetos e na janela do editor.

Isso é devido ao driver gráfico da NVIDIA injetando um overlay para mostrar informações.

Para desabilitar esse overlay no Windows, restaure suas configurações do driver gráfico para os valores padrões no Painel de Controle NVIDIA.

Para desabilitar esse overlay no Linux, abra nvidia-settings, vá até X Screen 0 > OpenGL Settings e desmarque Enable Graphics API Visual Indicator.

A janela do projeto aparece embaçada, ao contrário do editor.

Diferente do editor, o projeto não está marcado como DPI-aware por padrão. Isto é feito para melhorar o desempenho, especialmente em gráficos integrados, onde a renderização de cenas 3D em hiDPI é lenta.

Para resolver isso, abra Projeto > Configurações do Projeto e ative Exibição > Janela > Dpi > Permitir Hidpi. Além disso, verifique se o seu projeto está configurado para suportar múltiplas resoluções.

A janela do projeto não aparece centralizada quando eu executo o projeto.

Este é um bug conhecido. Para resolvê-lo, Abra Projeto > Configurações do Projeto e ative Exibição > Janela > Dpi > Permitir Hidpi. Além disso, verifique se o seu projeto está configurado para suportar múltiplas resoluções.

O projeto funciona quando executado a partir do editor, mas falha ao carregar alguns arquivos ao executar a partir de uma cópia exportada.

Isso é geralmente causado ao esquecer de especificar um filtro para arquivos sem recursos no diálogo Exportar. Por padrão, Godot somente incluirá recursos presentes no arquivo PCK. Alguns arquivos comumente usados, como arquivos JSON, não são considerados recursos. Por exemplo, se você carregar test.json no projeto exportado, você precisa especificar *.json no filtro de exportação sem recursos. Veja Opções de recursos para mais informação.

No Windows, isso também pode ser devido a problemas de sensibilidade de maiúsculas e minúsculas. Se você fizer referência a um recurso em seu script com maiúsculas e minúsculas diferentes das do sistema de arquivos, o carregamento falhará quando você exportar o projeto. Isso ocorre porque o sistema de arquivos PCK virtual diferencia maiúsculas de minúsculas, enquanto o sistema de arquivos do Windows não diferencia maiúsculas de minúsculas por padrão.