Communitygithub.com

godot-animation

Anime les jeux Godot 4.x : clips et bibliothèques AnimationPlayer, machines d'état et espaces de mélange AnimationTree, animations de sprites, Tweens (sous-tweens 4.4 et tween_await 4.7), sections et marqueurs d'animation, animation squelettique 3D, retargeting, et le framework IK 4.6 (TwoBoneIK3D, FABRIK3D, CCDIK3D, SplineIK3D). Utilisez-le pour les animations de personnages, l'interface utilisateur, les cinématiques, les animations procédurales ou le lien entre animation et état du jeu. Fonctionne avec les outils godot_animation_* de godot-mcp.

Qu'est-ce que godot-animation ?

Cette compétence pour agents IA (Claude Code, Cursor, etc.) fournit des directives complètes pour l'animation dans Godot 4.x. Elle couvre AnimationPlayer (clips, sections, marqueurs, méthodes Call), AnimationTree (machines d'état, espaces de mélange, one-shots), Tweens (transitions, parallélisme, sous-tweens, ignore_time_scale, tween_await), l'animation squelettique 3D (import glTF, retargeting avec SkeletonProfileHumanoid, SkeletonModifier3D dont l'IK 4.6), et le débogage d'animations. Chaque section inclut des exemples GDScript concrets et des règles d'utilisation. Un tableau de sélection rapide aide à choisir l'outil adapté à chaque besoin. La compétence s'appuie sur les outils godot-mcp (godot_animation_setup_scene, godot_animation_create_clip, godot_animation_add_keyframe, etc.) pour interagir directement avec l'éditeur Godot. Elle est utile pour tout développeur souhaitant créer des animations riches, des menus aux cinématiques, en passant par les déplacements de personnages et les effets procéduraux.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Yuki-az-23/noit-godot-skills/tree/HEAD/skills/godot-animation

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Animation Godot

Choisir l'outil

BesoinUtiliser
Mouvement 'tire-et-oublie' depuis le code (pop UI, recul, fondu)Tween (create_tween())
Clips préfabriqués (cycle de marche, porte, cinématique)AnimationPlayer
Sprites 2D frame par frameAnimatedSprite2D + SpriteFrames, ou AnimationPlayer avec clé sur Sprite2D.frame
Mélange et logique d'état (repos↔course↔saut, mouvement 8 directions)AnimationTree avec machine d'état ou espace de mélange
Visée procédurale d'os, placement de pied, atteinteFamille SkeletonModifier3D (IK, LookAt, contraintes)

Outils d'animation godot-mcp

TâcheOutil
Ajouter l'infrastructure AnimationPlayer/AnimationTree à une scènegodot_animation_setup_scene
Créer, lister ou lire des clipsgodot_animation_create_clip, godot_animation_list_clips, godot_animation_read_clip
Ajouter ou supprimer des clésgodot_animation_add_keyframe, godot_animation_remove_keyframe
Planifier une machine d'état ou un espace de mélange AnimationTreegodot_animation_build_state_machine_plan, godot_animation_build_blend_space_plan

Utilisez godot_help tool="<nom>" pour les modèles d'arguments. Validez avec godot_validate_scene, puis exécutez la scène pour voir le mouvement. Les preuves issues de l'arbre de scène ne suffisent pas à prouver qu'une animation est correcte ; utilisez une capture d'écran à l'exécution ou une vérification manuelle (voir godot-interactive).

AnimationPlayer

  • Les clips vivent dans des AnimationLibraries. La bibliothèque par défaut a le nom vide "", donc play("walk") est l'abréviation de play("/walk"), et les autres bibliothèques s'utilisent comme play("combat/slash").
  • Les chemins de piste sont relatifs à root_node (par défaut .., le parent du lecteur) : NodePath("Sprite2D:frame"), NodePath(".:position").
  • Gardez une animation RESET avec la valeur de repos de chaque propriété animée. L'éditeur l'utilise pour restaurer l'état et éviter les diffs de scène sales.
  • Appelez des méthodes via les pistes Call Method (sons de pas, apparition de hitbox) plutôt que de scruter le temps dans le code.
  • Jouez par section ou marqueurs (4.4+) : play_section_with_markers("attack", &"windup_end", &"recover_start") pour boucler ou sauter une partie d'un clip.
  • animation_finished(anim_name) se déclenche pour les clips non bouclants. 4.7 a renommé l'argument current_animation_changed en anim_name ; connectez-vous par Callable pour que le changement n'ait pas d'importance.
  • 4.6 : get_queue() retourne Array[StringName], et is_animation_active() a été ajouté.
@onready var anim: AnimationPlayer = $AnimationPlayer

func attack() -> void:
    anim.play("attack")
    await anim.animation_finished
    anim.play("idle")

AnimationTree

AnimationTree (anim_player = ../AnimationPlayer, active = true)
└── tree_root: AnimationNodeStateMachine
    ├── Locomotion: AnimationNodeBlendSpace2D (repos/marche/course selon la vélocité)
    ├── Saut, Chute, Atterrissage
    └── Attaque (OneShot via AnimationNodeBlendTree)
@onready var tree: AnimationTree = $AnimationTree
@onready var playback: AnimationNodeStateMachinePlayback = tree.get("parameters/playback")

func _physics_process(_delta: float) -> void:
    tree.set("parameters/Locomotion/blend_position", velocity / max_speed)
    if not is_on_floor() and velocity.y > 0.0:
        playback.travel("Fall")
  • Les chemins de paramètres proviennent de l'arbre. Survolez un paramètre dans l'inspecteur pour copier son chemin exact.
  • Utilisez les conditions d'avancement de transition ou les expressions (advance_expression) pour les transitions pilotées par les données, et travel() pour celles pilotées par le code.
  • Pour les one-shots (attaques, coups), définissez parameters/<OneShot>/request sur AnimationNodeOneShot.ONE_SHOT_REQUEST_FIRE.
  • AnimationNodeExtension (4.4, expérimental) permet d'écrire des nœuds de mélange personnalisés en GDScript.

Tweens

var t := create_tween().set_trans(Tween.TRANS_BACK).set_ease(Tween.EASE_OUT)
t.tween_property(self, "scale", Vector2.ONE * 1.2, 0.12)
t.tween_property(self, "scale", Vector2.ONE, 0.12)

# Étapes parallèles
t = create_tween().set_parallel()
t.tween_property(sprite, "modulate:a", 0.0, 0.3)
t.tween_property(sprite, "position:y", sprite.position.y - 20.0, 0.3)
t.chain().tween_callback(queue_free)

# 4.4+ : imbriquer un tween réutilisable
var shake := create_tween()
for i in 4:
    shake.tween_property(camera, "offset", Vector2(randf_range(-6, 6), randf_range(-6, 6)), 0.03)
var seq := create_tween()
seq.tween_subtween(shake)
seq.tween_property(camera, "offset", Vector2.ZERO, 0.05)

# 4.4+ : continuer l'animation même si Engine.time_scale est ralenti (hit-stop, UI au ralenti)
create_tween().set_ignore_time_scale().tween_property(ui, "modulate:a", 1.0, 0.2)

# 4.7+ : mettre en pause une séquence jusqu'à ce qu'un signal se déclenche
var intro := create_tween()
intro.tween_property(title, "modulate:a", 1.0, 0.5)
intro.tween_await(dialogue_box.closed)
intro.tween_property(title, "modulate:a", 0.0, 0.5)

Règles :

  • Les Tweens liés par create_tween() sur un nœud meurent avec ce nœud. Tuez le tween précédent avant d'en démarrer un conflictuel : if _t and _t.is_valid(): _t.kill().
  • Les arbres en pause mettent en pause les tweens, sauf si set_pause_mode(Tween.TWEEN_PAUSE_PROCESS).
  • Utilisez set_process_mode(Tween.TWEEN_PROCESS_PHYSICS) pour les tweens qui déplacent des corps physiques.

Animation squelettique 3D

  • Importez les animations depuis glTF (.glb). Définissez les modes de boucle et divisez les clips dans la boîte de dialogue d'import avancé, pas après l'import.
  • Retargeting : utilisez un BoneMap SkeletonProfileHumanoid à l'import pour partager des animations entre modèles humanoïdes. RetargetModifier3D (4.4+) copie les poses entre squelettes à l'exécution.
  • Pile SkeletonModifier3D (enfants de Skeleton3D, traités dans l'ordre) :
    • LookAtModifier3D (4.4+) : suivi de la tête et des yeux avec limites d'angle.
    • SpringBoneSimulator3D (4.4+) : cheveux, queues, oscillations tissulaires, avec SpringBoneCollision*3D.
    • AimModifier3D, CopyTransformModifier3D, ConvertTransformModifier3D (4.5+) : contraintes d'os.
    • IK (4.6+) : TwoBoneIK3D (bras et jambes, déterministe), FABRIK3D/CCDIK3D/JacobianIK3D (chaînes itératives), SplineIK3D (épines et tentacules le long d'un Path3D), avec limites JointLimitationCone3D, BoneTwistDisperser3D et LimitAngularVelocityModifier3D pour des résultats naturels. L'ancien SkeletonIK3D est déprécié au profit de ces nouveaux.
    • ModifierBoneTarget3D (4.5+) : un Node3D qui suit un os, utile comme cible IK ou point d'attache.
  • Recette IK pour les pieds : lancez un rayon vers le bas depuis chaque pied, déplacez un Marker3D cible vers le point d'impact, pilotez TwoBoneIK3D pour chaque jambe, et décalez les hanches du delta du pied le plus bas.

Débogage

  1. Un clip est joué mais rien ne bouge : le chemin de la piste est incorrect par rapport à root_node, ou un AnimationTree est actif et écrase le lecteur.
  2. Une propriété revient brusquement à sa valeur : une autre piste ou la clé RESET anime la même propriété, ou un tween et une animation se battent pour elle.
  3. Une machine d'état est bloquée : vérifiez les conditions de transition et le switch_mode, et surveillez playback.get_current_node().
  4. Saccades en 3D : activez l'interpolation physique, ou animez dans le même mode de processus que le mouvement.

Skills associés