Up to date

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

Scène Player et actions d'entrée

Dans les deux prochaines leçons, nous allons concevoir la scène du joueur, enregistrer des actions d'entrée personnalisées, et coder le mouvement du joueur. À la fin, vous aurez un personnage jouable qui se déplace dans huit directions.

Créez une nouvelle scène en allant dans le menu Scène en haut à gauche et en cliquant sur Nouvelle scène.

Créez un nœud CharacterBody3D comme racine

Nommez le CharacterBody3D en Player. Les corps des personnages sont complémentaires de la zone et des corps rigides utilisés dans le didacticiel du jeu 2D. Comme les corps rigides, ils peuvent se déplacer et entrer en collision avec l'environnement, mais au lieu d'être contrôlés par le moteur physique, vous dictez leur mouvement. Vous verrez comment nous utilisons les fonctionnalités uniques du nœud lorsque nous codons les mécanismes de saut et d'écrasement.

Voir aussi

Pour en savoir plus sur les différents types de nœuds de physique, consultez la Introduction à la physique.

Pour l'instant, nous allons créer un rig basique pour le modèle 3D de notre personnage. Ça nous permettra de faire pivoter le modèle plus tard depuis le code pendant qu'il joue une animation.

Ajoutez un noeud Node3D comme enfant de Player et nommez le Pivot

Ensuite, dans le dock Système de fichiers, développez le dossier art/ en double-cliquant dessus et faites glisser et déposez player.glb sur Pivot.

Cela devrait instancier le modèle comme enfant de Pivot. Vous pouvez le renommer en Character.

Note

The .glb files contain 3D scene data based on the open source glTF 2.0 specification. They're a modern and powerful alternative to a proprietary format like FBX, which Godot also supports. To produce these files, we designed the model in Blender 3D and exported it to glTF.

Comme avec tous les types de nœuds physiques, nous avons besoin d'une forme de collision pour que notre personnage puisse collisionner avec l'environnement. Sélectionnez le nœud Player à nouveau et ajoutez-lui un CollisionShape3D. Dans l'Inspecteur, assignez une nouvelle SphereShape3D à la propriété Shape.

L'armature filaire de la sphère apparaît sous le caractère.

Ce sera la forme que le moteur physique utilisera pour entrer en collision avec l'environnement, nous voulons donc qu'elle s'adapte mieux au modèle 3D. Agrandissez-la un peu en faisant glisser le point orange dans la fenêtre d'affichage. Ma sphère a un rayon d'environ 0,8 mètre.

Ensuite, déplacez la forme de collision vers le haut afin que son bas s'aligne à peu près avec le plan de la grille.

Pour faciliter le déplacement de la forme, vous pouvez basculer la visibilité du modèle en cliquant sur l'icône en forme d'œil à côté des nœuds Character ou Pivot.

Enregistrez la scène sous le nom player.tscn

Les nœuds étant prêts, nous pouvons presque commencer à coder. Mais d'abord, nous devons définir quelques actions d'entrée.

Création d'actions d'entrée

Pour déplacer le personnage, nous écouterons l'entrée du joueur, comme l'appui sur les touches fléchées. Dans Godot, plutôt que d'écrire toutes les liaisons dans le code, il y a un système puissant qui nous permet d'attribuer une étiquette à un ensemble de touches et de boutons. Cela simplifie nos scripts et les rend plus lisibles.

Ce système est l'Input Map ("Contrôles" en français). Pour accéder à son éditeur, allez dans le menu Projet et sélectionnez Paramètres du projet....

En haut, il y a plusieurs onglets. Cliquez sur Contrôles. Cette fenêtre vous permet d'ajouter de nouvelles actions en haut ; ce sont vos étiquettes. Dans la partie inférieure, vous pouvez lier des clés à ces actions.

Les projets Godot sont livrés avec des actions prédéfinies conçues pour la conception de l'interface utilisateur (voir la capture d'écran ci-dessus). Celles-ci deviendront visibles si vous activez le bouton Afficher les actions intégrées. Nous pourrions les utiliser ici, mais à la place, nous définissons les nôtres pour prendre en charge les manettes de jeu. Laissez Afficher les actions intégrées désactivé.

Nous allons nommer nos actions move_left, move_right, move_forward, move_back, et jump.

Pour ajouter une action, écrivez son nom dans la barre en haut et appuyez sur Entrée.

Créez les cinq actions suivantes :

Pour lier une touche ou un bouton à une action, cliquez sur le bouton "+" à sa droite. Faîtes-le pour move_left. Appuyez sur la touche flèche gauche et cliquez sur OK.

Liez également la touche A à l'action move_left.

Ajoutons maintenant le support du joystick gauche d'une manette. Cliquez encore sur le bouton "+", mais cette fois, sélectionnez Sélection manuelle -> Axes du joystick.

Sélectionnez l'axe X négatif du joystick gauche.

Laissez les autres valeurs par défaut et appuyez sur OK

Note

Si vous souhaitez que les contrôleurs aient des actions d'entrée différentes, vous devez utiliser l'option Périphériques dans les Options supplémentaires. Le périphérique 0 correspond à la première manette de jeu branchée, le périphérique 1 correspond à la deuxième manette de jeu branchée, et ainsi de suite.

Faîtes de même pour les autres actions. Par exemple, liez la flèche de droite, D, et l'axe positif du joystick gauche à move_right. Après avoir lié toutes les touches, votre interface devrait ressembler à ceci.

La dernière action à mettre en place est l'action jump. Associez la touche Espace et le bouton A de la manette.

Votre action d'entrée de saut devrait ressembler à ceci.

Voilà toutes les actions dont nous avons besoin pour ce jeu. Vous pouvez utiliser ce menu pour étiqueter tout groupe de touches et de boutons dans vos projets.

Dans la partie suivante, nous allons coder et tester le mouvement du joueur.