Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Paramètres du projet

Il y a des dizaines de paramètres que vous pouvez modifier pour contrôler l'exécution d'un projet, y compris la physique, le rendu et les paramètres de fenêtre. Ces paramètres peuvent être changés à partir de la fenêtre Paramètres du projet, à partir du code, ou en éditant manuellement le fichier project.godot. Vous pouvez voir une liste complète des paramètres dans la classe ProjectSettings.

En interne, Godot stocke les paramètres d'un projet dans un fichier project.godot, un fichier texte en format INI. Bien que cela soit facilement lisible et pratique pour le contrôle de version, il n'est pas le plus pratique à éditer. Pour cette raison, la fenêtre Paramètres du projet est disponible pour modifier ces paramètres. Pour ouvrir les paramètres du projet, sélectionnez Projet > Paramètres du projet dans le menu principal.

La fenêtre des Paramètres de l'éditeur

La fenêtre Paramètres du Projet est principalement utilisée pour modifier les paramètres dans l'onglet Général. De plus, il y a des onglets pour le Mappage d'Entrée, la Localisation, les Globaux, les Plugins, et Importer Par Défaut. L'utilisation de ces autres onglets est documentée ailleurs.

Changer les paramètres du projet

L'onglet Général de la fenêtre de paramètres du projet fonctionne beaucoup comme l'inspecteur. Il affiche une liste de paramètres du projet que vous pouvez modifier, tout comme les propriétés d'inspecteur. Il y a une liste de catégories sur la gauche, que vous pouvez utiliser pour sélectionner des groupes de paramètres associés. Vous pouvez également rechercher un paramètre spécifique avec le champ Filtrer les paramètres.

Chaque paramètre a une valeur par défaut. Les paramètres peuvent être réinitialisés à leurs valeurs par défaut en cliquant sur la bouton à flèche circulaire Réinitialiser à côté de chaque propriété.

Changer les paramètres du projet depuis le code

Vous pouvez utiliser set_setting() pour modifier la valeur d'un paramètre à partir du code :

GDScriptC#

ProjectSettings.set_setting("application/run/max_fps", 60)
ProjectSettings.set_setting("display/window/size/mode", DisplayServer.WINDOW_MODE_WINDOWED)

Cependant, de nombreux paramètres de projet ne sont lus qu'une fois, lorsque le jeu commence. Après cela, changer le réglage avec set_setting() n'aura aucun effet. Au lieu de cela, la plupart des paramètres ont une propriété ou une méthode correspondante sur une classe d’exécution comme Engine ou DisplayServer :

GDScriptC#

Engine.max_fps = 60
DisplayServer.window_set_mode(DisplayServer.WINDOW_MODE_WINDOWED)

En général, les paramètres du projet sont dupliqués à l'exécution dans les classes Engine, PhysicsServer2D, PhysicsServer3D, RenderingServer, Viewport ou Window. Dans la référence de classe de ProjectSettings, les paramètres sont reliés à leur propriété ou méthode équivalente durant l'exécution.

Lire les paramètres du projet

Vous pouvez lire les paramètres du projet avec get_setting() ou get_setting_with_override() :

GDScriptC#

var max_fps = ProjectSettings.get_setting("application/run/max_fps")
var window_mode = ProjectSettings.get_setting("display/window/size/mode")

Comme de nombreux paramètres de projet ne sont lus qu'une seule fois, au démarrage, la valeur dans les paramètres du projet peut ne plus être exacte. Dans ces cas, il est préférable de lire la valeur depuis la méthode ou la propriété d'exécution équivalente :

GDScriptC#

var max_fps = Engine.max_fps
var window_mode = DisplayServer.window_get_mode()

Éditer manuellement project.godot

Vous pouvez ouvrir le fichier project.godot à l'aide d'un éditeur de texte et modifier manuellement les paramètres du projet. Notez que si le fichier project.godot n'a pas de valeur stockée pour un paramètre particulier, il utilise implicitement la valeur par défaut de ce paramètre. Cela signifie que si vous modifiez le fichier manuellement, vous devrez peut-être écrire à la fois le nom du paramètre et sa valeur.

En général, il est recommandé d'utiliser la fenêtre Paramètres du Projet plutôt que de modifier manuellement project.godot.

Paramètres du projet avancés

Les paramètres du projet avancés

Par défaut, seuls certains paramètres du projet sont affichés. Pour voir tous les paramètres du projet, cochez la case Paramètres avancés.