Dépannage

Cette page énumère les problèmes courants rencontrés lors de l'utilisation de Godot et les solutions possibles.

Voir aussi

Voir Utilisation de l’éditeur Web pour les avertissements spécifiques à la version HTML5 de l'éditeur Godot.

Everything I do in the editor or project manager appears delayed by one frame

Il s'agit d'un bug connu" sur les pilotes graphiques Intel sous Windows. La mise à jour vers la dernière version du pilote graphique fourni par Intel devrait résoudre le problème.

Vous devriez utiliser le pilote graphique fourni par Intel plutôt que celui fourni par le fabricant de votre ordinateur de bureau ou de votre ordinateur portable, car leur version est souvent dépassée.

The grid disappears and meshes turn black when I rotate the 3D camera in the editor

Il s'agit d'un bug connu sur les pilotes graphiques Intel sous Windows.

La seule solution, pour l'instant, est de passer au moteur de rendu GLES2. Vous pouvez changer de moteur de rendu dans le coin supérieur droit de l'éditeur ou dans les paramètres du projet.

Si vous utilisez un ordinateur vous permettant de changer de carte graphique, comme NVIDIA Optimus, vous pouvez utiliser la carte graphique dédiée pour faire tourner Godot.

The editor or project takes a very long time to start

Il s'agit d'un bug connu sur Windows lorsque vous avez des périphériques USB spécifiques connectés. En particulier, le logiciel iCUE de Corsair semble être à l'origine du bug. Essayez de mettre à jour les pilotes de vos périphériques USB avec leur dernière version. Si le bogue persiste, vous devez déconnecter les périphériques défectueux avant d'ouvrir l'éditeur. Vous pouvez ensuite reconnecter le périphérique.

The Godot editor appears frozen after clicking the system console

Lorsque vous exécutez Godot sous Windows avec la console système activée, vous pouvez accidentellement activer le mode sélection en cliquant dans la fenêtre de commande. Ce comportement spécifique à Windows met l'application en pause pour vous permettre de sélectionner du texte dans la console système. Godot ne peut pas passer outre ce comportement spécifique au système.

Pour résoudre ce problème, sélectionnez la fenêtre de la console système et appuyez sur la touche Entrée pour quitter le mode de sélection.

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

Cela est dû au fait que le pilote graphique NVIDIA injecte un overlay pour afficher des informations.

Pour désactiver cet overlay sous Windows, rétablissez les paramètres de votre pilote graphique aux valeurs par défaut dans le panneau de configuration NVIDIA.

Pour désactiver cet overlay sous Linux, ouvrez nvidia-settings, allez dans X Screen 0 > OpenGL Settings puis décochez Enable Graphics API Visual Indicator.

The project window appears blurry, unlike the editor

Contrairement à l'éditeur, le projet n'est pas marqué par défaut comme étant compatible DPI. Ceci est fait pour améliorer les performances, en particulier sur les cartes graphiques intégrés, où le rendu des scènes 3D en hiDPI est lent.

Pour résoudre ce problème, ouvrez Projet > Paramètres du projet et activez Display > Window > Dpi > Allow Hidpi. En plus de cela, assurez-vous que votre projet est configuré pour supporter multiple résolutions.

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

Il s'agit d'un bug connu. Pour résoudre ce problème, ouvrez Projet > Paramètres du projet et activez Display > Window > Dpi > Allow Hidpi. En plus de cela, assurez-vous que votre projet est configuré pour supporter multiple résolutions.

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

Cela est généralement dû au fait d'avoir oublié de spécifier un filtre pour les fichiers non-ressource dans la boîte de dialogue Exporter. Par défaut, Godot n'inclura que les ressources réelles dans le fichier PCK. Certains fichiers couramment utilisés, tels que les fichiers JSON, ne sont pas considérés comme des ressources. Par exemple, si vous chargez test.json` dans le projet exporté, vous devez spécifier *.json dans le filtre d'exportation des fichiers non-ressource. Voir Options de ressources pour plus d'informations.

Sous Windows, cela peut également être dû à des problèmes de sensibilité à la casse. Si vous faites référence à une ressource dans votre script avec une casse différente de celle du système de fichiers, le chargement échouera une fois que vous aurez exporté le projet. Cela est dû au fait que le système de fichiers PCK virtuel est sensible à la casse, alors que le système de fichiers de Windows est insensible à la casse par défaut.