Une machine d'état combine des nœuds d'animation en états nommés, tels que Idle, Walk, Run et Jump. Elle joue l'état actif et se fond dans un autre état lorsque la condition de transition est évaluée à true. Utilisez une machine d'état pour définir quelles animations peuvent se suivre sans écrire de logique de transition en Luau.
Chaque état se connecte à une entrée de la machine d'état. Un état peut être un clip, un nœud de fusion ou une autre machine d'état. La machine d'état sort la pose d'animation active ou une fusion entre deux poses si elle est en transition, que vous connectez au nœud suivant dans le graphe.
Prérequis
Avant de créer une machine d'état, familiarisez-vous avec l'éditeur de graphes d'animation, y compris comment l'ouvrir et créer un graphe d'animation.
Créer une machine d'état
L'exemple suivant utilise trois états de JumpFallLandRunExample : Locomotion, Fall et LandIdle. Le personnage se déplace normalement, passe à une animation de chute lorsqu'il est en l'air, et joue une animation d'atterrissage avant de revenir à la locomotion. Ces étapes se concentrent sur la machine d'état ; commencez par des nœuds d'animation pour la locomotion, la chute et l'atterrissage.
Dans l'éditeur de graphes, faites un clic droit et sélectionnez Insérer un nœud ⟩ Machine d'état.

Sur le nœud de la machine d'état, cliquez sur Ouvrir. Dans la vue Machine d'état, utilisez Créer un état pour ajouter trois états nommés Locomotion, Fall et LandIdle.

Cliquez sur Retour au graphe et connectez vos nœuds d'animation aux entrées correspondantes de la machine d'état :
- Locomotion : Connectez votre animation de locomotion. Le graphe de référence utilise un Blend1DNode nommé IdleRunBlend pour mélanger les animations d'inactivité et de course en fonction de Speed.
- Fall : Connectez un ClipNode de chute et définissez Mode de lecture sur Enum.AnimationNodePlayMode|OnceAndHold, afin qu'il maintienne sa pose finale jusqu'à ce que le personnage atterrisse.
- LandIdle : Connectez un clip d'atterrissage et définissez Mode de lecture sur Enum.AnimationNodePlayMode|OnceAndHold, afin qu'il puisse se terminer et revenir à la locomotion.
Connectez la sortie de la machine d'état à l'entrée Pose de Sortie de graphe.

Ouvrez à nouveau la vue Machine d'état et faites glisser une transition de (Entrée) à Locomotion. La machine d'état commence dans cet état lorsque le graphe démarre.

Ajoutez un paramètre de graphe booléen nommé Grounded et définissez-le sur true. Ce paramètre indique si le personnage est au sol.
Ajoutez les transitions suivantes en faisant glisser une connexion de l'état source à l'état de destination, puis configurez chaque transition :
- Locomotion à Fall : Définissez Attendre pour sur Expression, Expression sur not Grounded, et Longueur sur 0.2 secondes. L'animation de chute commence lorsque le personnage quitte le sol.
- Fall à LandIdle : Définissez Attendre pour sur Expression, Expression sur Grounded, et Longueur sur 0.1 secondes. L'animation d'atterrissage commence lorsque le personnage touche le sol.
- LandIdle à Locomotion : Définissez Attendre pour sur Terminé, Quand sur Enum.AnimationNodeTransitionWhen|BeforeFinished, et Longueur sur 0.2 secondes. La machine d'état commence à se fondre de nouveau dans la locomotion pendant les 0.2 dernières secondes de l'animation d'atterrissage.

Laissez Courbe comme par défaut (Linear) pour les trois transitions. Prévisualisez le graphe et changez Grounded à false pour entrer dans Fall, puis revenez à true pour jouer LandIdle et revenir à Locomotion.
Mettez à jour Grounded depuis votre code de jeu lorsque le personnage quitte et touche le sol. Si votre mélange de locomotion utilise Speed, mettez à jour ce paramètre au fur et à mesure que le personnage se déplace. Pour le flux de travail des paramètres, voir intégration API.
Étendez la machine d'état avec des sauts et des états d'atterrissage supplémentaires pour créer le graphe de mouvement complet. JumpFallLandRunExample inclut des sauts séparés pour la position debout et la course, ainsi que différents atterrissages en fonction du mouvement et de la vitesse de chute.
Propriétés de la machine d'état
Propriétés du nœud de machine d'état
- Entrées
- State1...StateN : Les nœuds d'animation qui définissent chaque état. Le nom de l'état doit correspondre au nom de l'entrée du nœud de machine d'état.
- Propriétés
Propriété Type Description EntryState ObjectValue Un ObjectValue dont le Value pointe vers le AnimationNodeDefinition pour l'état qui est actif lorsque le graphe démarre. - Données d'événement
- Gestion des événements : Les événements de l'état actif passent avec leur poids inchangé.
- Émission d'événements : Ne passe que les événements de l'état actif. Pendant une transition, l'émission d'événements suit les règles d'événements globales.
Propriétés de transition
Une transition a un ou plusieurs états sources, un état de destination et une condition. Lorsque l'état actif correspond à un état source, la machine d'état vérifie la condition. Elle se fond dans l'état de destination lorsque la condition est évaluée à true.
Attendre pour détermine l'interface utilisateur de la condition de transition. Sélectionnez Expression (Enum.AnimationNodeWaitFor|Trigger) pour afficher une boîte Expression. Une Expression peut référencer directement un paramètre de graphe booléen, tel que ShouldJump, ou évaluer une condition, telle que Speed >= 12. Sélectionnez Terminé (Enum.AnimationNodeWaitFor|Finished) pour afficher le menu déroulant Quand.
Si plus d'une transition a une Expression vraie, la machine d'état évalue d'abord la transition avec la valeur de Priorité la plus élevée. Lorsque les priorités sont les mêmes, elle sélectionne une transition au hasard. Assignez des priorités différentes aux transitions concurrentes pour rendre le résultat prévisible.
| Propriété | Type | Description |
|---|---|---|
| From | ObjectValue | Un ObjectValue dont le Value pointe vers le AnimationNodeDefinition pour l'état qui peut commencer la transition. Laissez cette propriété non définie pour une transition (Tout). |
| To | ObjectValue | Un ObjectValue dont le Value pointe vers le AnimationNodeDefinition pour l'état de destination. |
| WaitFor | Enum.AnimationNodeWaitFor | Détermine quelle interface utilisateur de condition de transition apparaît. Enum.AnimationNodeWaitFor|Trigger affiche la boîte Expression. Enum.AnimationNodeWaitFor|Finished affiche le menu déroulant Quand. |
| When | Enum.AnimationNodeTransitionWhen | Disponible lorsque Attendre pour est Terminé. Sélectionnez Enum.AnimationNodeTransitionWhen|Finished pour commencer après que l'état source soit terminé, ou Enum.AnimationNodeTransitionWhen|BeforeFinished pour commencer à se fondre une Durée avant que l'état source ne se termine. |
| Expression | String | Disponible lorsque Attendre pour est Expression. Un paramètre de graphe booléen ou une expression qui, lorsqu'elle est évaluée à true, commence la transition. Voir Expression pour ce qui est pris en charge. |
| Priority | Number | L'ordre utilisé lorsque plus d'une Expression est vraie. Des valeurs plus élevées ont la priorité. Les valeurs valides vont de 0 à 65 535. |
| Duration | Number | Le temps, en secondes, pour se fondre dans l'état de destination. La valeur par défaut est de 0,15 secondes. |
| Curve | Enum.PoseEasingStyle | L'assouplissement utilisé pendant la fusion. Seules Linear et CubicV2 sont prises en charge. La valeur par défaut est Linear. |