Machines d'état de l'éditeur de graphes

*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

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.

  1. Dans l'éditeur de graphes, faites un clic droit et sélectionnez Insérer un nœud ⟩ Machine d'état.

    Menu contextuel de l'éditeur de graphes avec le sous-menu Insérer un nœud ouvert et Machine d'état sélectionnée.
  2. 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.

    Vue de la machine d'état avec le bouton Créer un état et les nœuds d'état d'entrée et de tout.
  3. 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.

    Nœuds IdleRunBlend, Fall et LandIdle connectés aux entrées Locomotion, Fall et LandIdle d'un nœud de machine d'état, dont la sortie est connectée à la sortie de graphe.
  4. 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.

    Nœud d'entrée connecté à l'état de locomotion.
  5. 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.

  6. 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.
    Paramètres de transition pour LandIdle à Locomotion, avec Longueur définie sur 0.2, Courbe sur Linéaire, Attendre pour sur Terminé, et Quand sur Avant Terminé.
  7. 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.

  8. 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.

  9. É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éTypeDescription
EntryStateObjectValueUn 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éTypeDescription
FromObjectValueUn 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).
ToObjectValueUn ObjectValue dont le Value pointe vers le AnimationNodeDefinition pour l'état de destination.
WaitForEnum.AnimationNodeWaitForDé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.
WhenEnum.AnimationNodeTransitionWhenDisponible 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.
ExpressionStringDisponible 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.
PriorityNumberL'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.
DurationNumberLe temps, en secondes, pour se fondre dans l'état de destination. La valeur par défaut est de 0,15 secondes.
CurveEnum.PoseEasingStyleL'assouplissement utilisé pendant la fusion. Seules Linear et CubicV2 sont prises en charge. La valeur par défaut est Linear.
©2026 Société Roblox. Roblox, le logo Roblox et Powering Imagination font partie de nos marques déposées aux États-Unis et dans d'autres pays.