Debugger panel

Many of Godot’s debugging tools, including the debugger, can be found in the debugger panel at the bottom of the screen. Click on Debugger to open it.

../../_images/overview_debugger.png

The debugger panel is split into several tabs, each focusing on a specific task.

Débogueur

The Debugger tab opens automatically when the GDScript compiler reaches a breakpoint in your code.

Cela vous donne une trace d’appels, des informations sur l’état de l’objet, et des boutons servant à contrôler l’exécution du programme.

You can use the buttons in the top-right corner to:

  • Ignorer tous les points d’arrêt. Cela permet de garder les points d’arrêt pour un futur débogage.
  • Copier le message d’erreur en cours.
  • Step Into. Ce bouton vous amène à la prochaine ligne de code, et si c’est une fonction, elle est exécutée ligne par ligne.
  • Step Over. Ce bouton vous amène à la prochaine ligne de code, mais sans entrer dans les fonctions.
  • Break. Ce bouton met en pause l’exécution du jeu.
  • Continue. Ce bouton relance le jeu après un point d’arrêt(breakpoint) ou à l’endroit où le jeu a été mis en pause.

Erreurs

This is where error and warning messages are printed while running the game.

You can disable specific warnings in Project Settings > Debug > GDScript.

Profileur

Le débogueur est fourni avec trois profileurs : un pour le processeur, un pour les échanges via le réseau, et un pour la mémoire vidéo.

Le profileur est utilisé pour pourquoi chaque image prend tant de temps pour être traitée et rendue.

Contrairement aux autres outils de débogage, le profileur ne démarre pas automatiquement. Il peut être démarré à tout moment pendant le jeu en appuyant sur le bouton de démarrage. Vous pouvez même démarrer le profileur avant l’ouverture du jeu pour profiler les performances de démarrage. Il peut également être démarré et arrêté pendant le jeu sans perdre les informations relatives à la dernière exécution du jeu. Les informations qu’il enregistre ne disparaissent que si vous cliquez sur effacer, ou si vous fermez le jeu, le rouvrez et redémarrez le profileur.

After starting and stopping the profiler, you should see things being kept track of on the left and a graph on the right. The items listed on the left are everything that contributes to frame time, and they should each have a value for time and calls for the current frame you are looking at.

Le numéro de l’image en haut à droite vous indique quelle image vous regardez actuellement. Vous pouvez le modifier en utilisant les flèches vers le haut ou vers le bas, en saisissant le numéro de l’image ou en cliquant sur le graphique.

If you want to add something to your graph or think it looks too cluttered, you can check and uncheck the box next to an item to add or remove it from the graph.

Profileur réseau

Le Network Profiler contient une liste de tous les nœuds qui communiquent via l’API multijoueur et, pour chacun d’entre eux, des compteurs sur la quantité d’interactions réseau entrantes et sortantes. Il comporte également un compteur de bande passante qui affiche l’utilisation totale de la bande passante à un moment donné.

Moniteurs

Les moniteurs sont des graphiques de plusieurs aspects du jeu pendant son déroulement, tels que les FPS, l’utilisation de la mémoire, le nombre de nœuds dans une scène et plus encore. Tous les moniteurs suivent les statistiques automatiquement, de sorte que même si un moniteur n’est pas ouvert pendant le jeu, vous pouvez l’ouvrir plus tard et voir comment les valeurs ont changé.

Video RAM

The Video RAM tab shows the video RAM usage of the game while it is running. It provides a list of every resource using video RAM by resource path, the type of resource it is, what format it is in, and how much Video RAM that resource is using. There is also a total video RAM usage number at the top right of the panel.

../../_images/video_ram.png

Divers

L’onglet Misc contient des outils permettant d’identifier les nœuds de contrôle sur lesquels vous cliquez pendant de l’exécution :

  • Clicked Control vous indique où se trouve le nœud cliqué dans l’arbre des scènes.
  • Clicked Control Type vous indique le type du nœud sur lequel vous avez cliqué.