Dépannage

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

Voir aussi

See Using the Web editor for caveats specific to the HTML5 version of the Godot editor.

Tout ce que je fais dans l'éditeur ou le manager de projet semble retardé d'une image.

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.

La grille disparaît et les maillages deviennent noires quand je fais tourner la caméra 3D dans l'éditeur.

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.

L'éditeur ou le projet prend beaucoup de temps à démarrer.

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.

L'éditeur Godot apparaît figé après avoir cliqué sur la console système.

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.

This is caused by the NVIDIA graphics driver injecting an overlay to display information.

To disable this overlay on Windows, restore your graphics driver settings to the default values in the NVIDIA Control Panel.

To disable this overlay on Linux, open nvidia-settings, go to X Screen 0 > OpenGL Settings then uncheck Enable Graphics API Visual Indicator.

La fenêtre du projet apparaît floue, contrairement à l'éditeur.

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.

La fenêtre du projet n'apparaît pas centrée lorsque j'éxécute le projet.

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.

Le projet fonctionne lorsqu'il est exécuté à partir de l'éditeur, mais ne parvient pas à charger certains fichiers lorsqu'il est exécuté à partir d'une copie exportée.

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 Mode d'exportation 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.