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.

Everything I do in the editor or project manager appears delayed by one 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.

The grid disappears and meshes turn black when I rotate the 3D camera in the 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.

The editor or project takes a very long time to start

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.

The Godot editor appears frozen after clicking the system console

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.

Some text such as "NO DC" appears in the top-left corner of the project manager and editor window

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.

The project window appears blurry, unlike the 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.

The project window doesn't appear centered when I run the project

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.

The editor/project freezes or displays glitched visuals after resuming the PC from suspend

This is a known issue on Linux with NVIDIA graphics when using the proprietary driver. There is no definitive fix yet, as suspend on Linux + NVIDIA is often buggy when OpenGL is involved.

The NVIDIA driver offers an experimental option to preserve video memory after suspend which may resolve this issue. This option has been reported to work better with more recent NVIDIA driver versions.

To avoid losing work, save scenes in the editor before putting the PC to sleep.

The project works when run from the editor, but fails to load some files when running from an exported copy

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.