Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Nœuds et scènes

Dans Aperçu des concepts clés de Godot, nous avons vu qu'un jeu Godot est un arbre de scènes et que chaque scène est un arbre de nœuds. Dans cette leçon, nous en expliquons un peu plus à leur sujet. Vous allez également créer votre première scène.

Nœuds

Les nœuds sont les éléments fondamentaux de votre jeu. Ils sont comme les ingrédients d'une recette. Il en existe des dizaines de types qui peuvent afficher une image, jouer un son, représenter une caméra, et bien plus encore.

All nodes have the following characteristics:

• Un nom.

• Propriétés modifiables.

• Ils reçoivent des callbacks pour mettre à jour chaque image.

• Vous pouvez les étendre avec de nouvelles propriétés et fonctions.

• Vous pouvez les ajouter à un autre nœud en tant qu’enfant.

The last characteristic is important. Together, nodes form a tree, which is a powerful feature to organize projects. Since different nodes have different functions, combining them produces more complex behavior. As we saw before, you can build a playable character the camera follows using a CharacterBody2D node, a Sprite2D node, a Camera2D node, and a CollisionShape2D node.

Les scènes

Lorsque vous organisez des nœuds dans un arbre, comme notre personnage, nous appelons cette construction une scène. Une fois enregistrées, les scènes fonctionnent comme de nouveaux types de nœuds dans l'éditeur, où vous pouvez les ajouter comme enfant d'un nœud existant. Dans ce cas, l'instance de la scène apparaît comme un nœud unique dont les éléments internes sont cachés.

Les scènes vous permettent de structurer le code de votre jeu comme vous le souhaitez. Vous pouvez composer des nœuds pour créer des types de nœuds personnalisés et complexes, comme un personnage de jeu qui court et saute, une barre de vie, un coffre avec lequel vous pouvez interagir, et plus encore.

L'éditeur Godot est essentiellement un éditeur de scènes. Il dispose de nombreux outils pour éditer des scènes 2D et 3D, ainsi que des interfaces utilisateur. Un projet Godot peut contenir autant de ces scènes que vous le souhaitez. Le moteur n'en requiert qu'une seule, la scène principale de votre application. Il s'agit de la scène que Godot charge en premier lorsque vous ou un joueur lance le jeu.

On top of acting like nodes, scenes have the following characteristics:

1. Ils ont toujours un nœud racine, comme le "Character" dans notre exemple.

2. You can save them to your local drive and load them later.

3. Vous pouvez créer autant d’instances d’une scène que vous le souhaitez. Vous pouvez avoir cinq ou dix personnages dans votre jeu, créés à partir de votre scène Character.

Créer votre première scène

Let's create our first scene with a single node. To do so, you will need to create a new project first. After opening the project, you should see an empty editor.

In an empty scene, the Scene dock on the left shows several options to add a root node quickly. "2D Scene" adds a Node2D node, "3D Scene" adds a Node3D node, and "User Interface" adds a Control node. These presets are here for convenience; they are not mandatory. "Other Node" lets you select any node to be the root node. In an empty scene, "Other Node" is equivalent to pressing the "Add Child Node" button at the top-left of the Scene dock, which usually adds a new node as a child of the currently selected node.

We're going to add a single Label node to our scene. Its function is to draw text on the screen.

Appuyez sur le bouton « Ajouter un nœud enfant » ou « Autre nœud » pour créer un nœud racine.

La boîte de dialogue Créer un Nœud s'ouvre et affiche la longue liste des nœuds disponibles.

Sélectionnez le nœud Label. Vous pouvez taper son nom pour filtrer la liste.

Cliquez sur le nœud Label pour le sélectionner et cliquez sur le bouton Créer en bas de la fenêtre.

Il se passe beaucoup de choses lorsque vous ajoutez le premier nœud d’une scène. La scène passe à l'espace de travail 2D car le Label est un type de nœud 2D. Le Label apparaît, sélectionnée, dans le coin supérieur gauche de la fenêtre d'affichage. Le nœud apparaît dans le dock scène, à gauche, et les propriétés du nœud apparaissent dans le dock de l'inspecteur, à droite.

Modification des propriétés d'un nœud

L'étape suivante consiste à modifier la propriété "Text" du Label. Changeons-la en "Hello World".

Allez dans le dock de l'inspecteur à droite de la fenêtre d'affichage. Cliquez dans le champ situé sous la propriété Text et tapez "Hello World".

Vous verrez le texte se dessiner dans la fenêtre d'affichage au fur et à mesure que vous tapez.

Voir aussi

You can edit any property listed in the Inspector as we did with the Text. For a complete reference of the Inspector dock, see The Inspector.

Vous pouvez déplacer votre nœud Label dans la fenêtre d'affichage en sélectionnant l'outil de déplacement dans la barre d'outils.

Lorsque Label est sélectionné, cliquez et glissez n'importe où dans la fenêtre d'affichage pour le déplacer au centre de la vue délimitée par le rectangle.

Exécution de la scène

Tout est prêt pour lancer la scène ! Appuyez sur le bouton Lancer la Scène en haut à droite de l'écran ou appuyez sur F6 (Cmd + R sur macOS).

A popup invites you to save the scene, which is required to run it. Click the Save button in the file browser to save it as label.tscn.

Note

La boîte de dialogue Enregistrer la scène sous, comme les autres boîtes de dialogue de fichiers de l'éditeur, ne permet d'enregistrer des fichiers qu'à l'intérieur du projet. Le chemin res:// en haut de la fenêtre représente le répertoire racine du projet et signifie "resource path". Pour plus d'informations sur les chemins de fichiers dans Godot, voir Le système de fichiers.

L'application doit s'ouvrir dans une nouvelle fenêtre et afficher le texte "Hello World".

Close the window or press F8 (Cmd + . on macOS) to quit the running scene.

Mise en place de la scène principale

Pour exécuter notre scène de test, nous avons utilisé le bouton Jouer la scène. Un autre bouton à côté vous permet de définir et de lancer la scène principale du projet. Vous pouvez appuyer sur F5 (Cmd + B on macOS) pour le faire.

Une fenêtre popup apparaît et vous invite à sélectionner la scène principale.

Click the Select button, and in the file dialog that appears, double click on label.tscn.

La démo devrait fonctionner à nouveau. À l'avenir, chaque fois que vous exécuterez le projet, Godot utilisera cette scène comme point de départ.

Note

The editor saves the main scene's path in a project.godot file in your project's directory. While you can edit this text file directly to change project settings, you can also use the "Project -> Project Settings" window to do so. For more information, see Paramètres du projet.

Dans la prochaine partie, nous aborderons un autre concept clé dans les jeux et dans Godot : la création d'instances d'une scène.