Solução de problemas

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

Ver também

Veja Utilizando o editor Web para detalhes importantes específicos à versão HTML5 do editor da 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 deasparece 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 mudar o renderizador no canto superior-direito do editor ou nas Configurações do Projeto.

Se você usa um computador que lhe permite trocar sua placa gráfica, como NVIDIA Optimus, você pode usar a placa 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 está borrada, diferente 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 habilite Display > Window > Dpi > Allow 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 habilite Display > Window > Dpi > Allow 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 Resource options para mais informação.

No Windows, isso pode também ser devido aos problemas de sensibilidade de caixa. Se você referenciar um recurso em seu script com uma caixa diferente daquele no sistema de arquivos, o carregamento irá falhar uma vez que você exportar o projeto. Isto ocorre porque o sistema de arquivos PCK virtual é sensível à caixa, enquanto o sistema de arquivos do Windows não é sensível por padrão.