Was macht godot-animation?
Das richtige Werkzeug wählen
| Bedarf | Werkzeug |
|---|---|
| „Feuer-und-vergiss“-Bewegung aus Code (UI-Pop, Rückstoß, Ausblenden) | Tween (create_tween()) |
| Erstellte Clips (Laufzyklus, Tür, Zwischensequenz) | AnimationPlayer |
| 2D-Sprites Bild für Bild | AnimatedSprite2D + SpriteFrames oder AnimationPlayer, der Sprite2D.frame einrastet |
| Überblendung und Zustandslogik (Idle↔Laufen↔Springen, 8-Richtungs-Bewegung) | AnimationTree mit Zustandsautomat oder Blend Space |
| Prozedurale Zielausrichtung von Knochen, Fußplatzierung, Greifen | Familie SkeletonModifier3D (IK, LookAt, Einschränkungen) |
godot-mcp-Animationstools
| Aufgabe | Werkzeug |
|---|---|
| AnimationPlayer/AnimationTree-Grundgerüst zu einer Szene hinzufügen | godot_animation_setup_scene |
| Clips erstellen, auflisten oder lesen | godot_animation_create_clip, godot_animation_list_clips, godot_animation_read_clip |
| Keyframes hinzufügen oder entfernen | godot_animation_add_keyframe, godot_animation_remove_keyframe |
| Zustandsautomaten oder Blend Space des AnimationTree planen | godot_animation_build_state_machine_plan, godot_animation_build_blend_space_plan |
Verwende godot_help tool="<Name>" für Argumentvorlagen. Validiere mit godot_validate_scene, führe dann die Szene aus, um die Bewegung zu sehen. Nur der Szenenbaum belegt noch nicht, dass eine Animation richtig aussieht; verwende einen Laufzeit-Screenshot oder eine manuelle Überprüfung (siehe godot-interactive).
AnimationPlayer
- Clips leben in AnimationLibraries. Die Standardbibliothek hat den leeren Namen
"", daher istplay("walk")eine Kurzform fürplay("/walk"), und andere Bibliotheken werden mitplay("combat/slash")aufgerufen. - Track-Pfade sind relativ zu
root_node(Standard.., das übergeordnete Element des Players):NodePath("Sprite2D:frame"),NodePath(".:position"). - Behalte eine
RESET-Animation mit dem Ruhewert jeder animierten Eigenschaft bei. Der Editor verwendet sie, um den Zustand wiederherzustellen und um schmutzige Szenen-Diffs zu vermeiden. - Rufe Methoden über Call Method-Tracks auf (Schrittgeräusche, Hitbox spawnen), anstatt die Zeit im Code abzufragen.
- Abspielen nach Abschnitt oder Markern (4.4+):
play_section_with_markers("attack", &"windup_end", &"recover_start"), um einen Teil eines Clips zu loopen oder zu überspringen. animation_finished(anim_name)wird für nicht-loopende Clips ausgelöst. 4.7 hat das Argumentcurrent_animation_changedinanim_nameumbenannt; verbinde per Callable, sodass die Änderung keine Rolle spielt.- 4.6:
get_queue()gibtArray[StringName]zurück, undis_animation_active()wurde hinzugefügt.
@onready var anim: AnimationPlayer = $AnimationPlayer
func angriff() -> void:
anim.play("angriff")
await anim.animation_finished
anim.play("idle")
AnimationTree
AnimationTree (anim_player = ../AnimationPlayer, active = true)
└── tree_root: AnimationNodeStateMachine
├── Fortbewegung: AnimationNodeBlendSpace2D (idle/gehen/rennen nach Geschwindigkeit)
├── Springen, Fallen, Landen
└── Angriff (OneShot über AnimationNodeBlendTree)
@onready var tree: AnimationTree = $AnimationTree
@onready var playback: AnimationNodeStateMachinePlayback = tree.get("parameters/playback")
func _physics_process(_delta: float) -> void:
tree.set("parameters/Fortbewegung/blend_position", velocity / max_speed)
if not is_on_floor() and velocity.y > 0.0:
playback.travel("Fallen")
- Parameter-Pfade stammen vom Baum. Fahre mit der Maus über einen Parameter im Inspektor, um den genauen Pfad zu kopieren.
- Verwende Fortschrittsbedingungen für Übergänge oder Ausdrücke (
advance_expression) für datengesteuerte Übergänge undtravel()für codegesteuerte. - Für One-Shots (Angriffe, Treffer) setze
parameters/<OneShot>/requestaufAnimationNodeOneShot.ONE_SHOT_REQUEST_FIRE. AnimationNodeExtension(4.4, experimentell) erlaubt es, benutzerdefinierte Blend-Knoten in GDScript zu schreiben.
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)
# Parallele Schritte
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+: Verschachteln eines wiederverwendbaren Tweens
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+: Animation fortsetzen, während Engine.time_scale verlangsamt ist (Treffer-Stopp, UI in Zeitlupe)
create_tween().set_ignore_time_scale().tween_property(ui, "modulate:a", 1.0, 0.2)
# 4.7+: Sequenz pausieren, bis ein Signal ausgelöst wird
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)
Regeln:
- Tweens, die mit
create_tween()an einem Knoten gebunden sind, sterben mit diesem Knoten. Töte den vorherigen Tween, bevor du einen widersprüchlichen startest:if _t and _t.is_valid(): _t.kill(). - Angehaltene Bäume pausieren Tweens, es sei denn, es wurde
set_pause_mode(Tween.TWEEN_PAUSE_PROCESS)gesetzt. - Verwende
set_process_mode(Tween.TWEEN_PROCESS_PHYSICS)für Tweens, die Physik-Körper bewegen.
3D-Skelett-Animation
- Importiere Animationen aus glTF (
.glb). Setze Loop-Modi und teile Clips im Dialog „Erweiterter Import“, nicht nach dem Import. - Retargeting: Verwende eine
SkeletonProfileHumanoid-BoneMap beim Import, um Animationen zwischen humanoiden Modellen zu teilen.RetargetModifier3D(4.4+) kopiert Posen zur Laufzeit zwischen Skeletten. - SkeletonModifier3D-Stapel (Kinder von
Skeleton3D, in Reihenfolge verarbeitet):LookAtModifier3D(4.4+): Kopf- und Augenverfolgung mit Winkelbegrenzungen.SpringBoneSimulator3D(4.4+): Haare, Schwänze, stoffähnliches Wackeln, mitSpringBoneCollision*3D.AimModifier3D,CopyTransformModifier3D,ConvertTransformModifier3D(4.5+): Knochen-Einschränkungen.- IK (4.6+):
TwoBoneIK3D(Arme und Beine, deterministisch),FABRIK3D/CCDIK3D/JacobianIK3D(iterative Ketten),SplineIK3D(Wirbelsäulen und Tentakel entlang einesPath3D), mitJointLimitationCone3D-Grenzen undBoneTwistDisperser3DundLimitAngularVelocityModifier3Dfür natürliche Ergebnisse. Der alteSkeletonIK3Dist zugunsten dieser veraltet. ModifierBoneTarget3D(4.5+): ein Node3D, das einem Knochen folgt, nützlich als IK-Ziel oder Anhang.
- Fuß-IK-Rezept: Raycast von jedem Fuß nach unten, ein Ziel-Marker3D zum Treffpunkt bewegen,
TwoBoneIK3Dfür jedes Bein antreiben und die Hüfte um den niedrigsten Fuß-Delta versetzen.
Fehlerbehebung
- Ein Clip wird abgespielt, aber nichts bewegt sich: Der Track-Pfad ist relativ zu
root_nodefalsch, oder ein AnimationTree ist aktiv und überschreibt den Player. - Eine Eigenschaft springt zurück: Ein anderer Track oder die RESET-Animation setzt dieselbe Eigenschaft, oder ein Tween und eine Animation streiten sich darum.
- Ein Zustandsautomat hängt fest: Überprüfe die Übergangsbedingungen und den
switch_modeund beobachteplayback.get_current_node(). - Ruckeln in 3D: Aktiviere Physik-Interpolation oder animiere im gleichen Prozessmodus wie die Bewegung.