Animation Godot
Choisir l'outil
| Besoin | Utiliser |
|---|---|
| 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 frame | AnimatedSprite2D + 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, atteinte | Famille SkeletonModifier3D (IK, LookAt, contraintes) |
Outils d'animation godot-mcp
| Tâche | Outil |
|---|---|
| Ajouter l'infrastructure AnimationPlayer/AnimationTree à une scène | godot_animation_setup_scene |
| Créer, lister ou lire des clips | godot_animation_create_clip, godot_animation_list_clips, godot_animation_read_clip |
| Ajouter ou supprimer des clés | godot_animation_add_keyframe, godot_animation_remove_keyframe |
| Planifier une machine d'état ou un espace de mélange AnimationTree | godot_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
"", doncplay("walk")est l'abréviation deplay("/walk"), et les autres bibliothèques s'utilisent commeplay("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
RESETavec 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'argumentcurrent_animation_changedenanim_name; connectez-vous par Callable pour que le changement n'ait pas d'importance.- 4.6 :
get_queue()retourneArray[StringName], etis_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, ettravel()pour celles pilotées par le code. - Pour les one-shots (attaques, coups), définissez
parameters/<OneShot>/requestsurAnimationNodeOneShot.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, avecSpringBoneCollision*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'unPath3D), avec limitesJointLimitationCone3D,BoneTwistDisperser3DetLimitAngularVelocityModifier3Dpour des résultats naturels. L'ancienSkeletonIK3Dest 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
TwoBoneIK3Dpour chaque jambe, et décalez les hanches du delta du pied le plus bas.
Débogage
- 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. - 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.
- Une machine d'état est bloquée : vérifiez les conditions de transition et le
switch_mode, et surveillezplayback.get_current_node(). - Saccades en 3D : activez l'interpolation physique, ou animez dans le même mode de processus que le mouvement.