Communitygithub.com

godot-animation

Animiert Godot 4.x-Spiele – AnimationPlayer-Clips und -Bibliotheken, AnimationTree-Zustandsautomaten und Blend Spaces, Sprite-Animation, Tweens (inkl. 4.4-Subtweens und 4.7-Tween_Await), Animationsabschnitte und Marker, 3D-Skelett-Animation, Retargeting und das 4.6-IK-Framework (TwoBoneIK3D, FABRIK3D, CCDIK3D, SplineIK3D). Verwendbar für Charakter-Animation, UI-Bewegung, Zwischensequenzen, prozedurale Bewegungen oder die Verknüpfung von Animationen mit dem Spielstatus. Kombiniert mit godot-mcp godot_animation_*-Tools.

Was ist godot-animation?

Diese Fähigkeit (Skill) ermöglicht es einem KI-Agenten, Animationen für Godot 4.x-Spiele zu erstellen, zu steuern und zu optimieren. Sie deckt alle wichtigen Animationssysteme ab: AnimationPlayer für erstellte Clips (z. B. Laufzyklen, Türen, Zwischensequenzen), AnimationTree für Zustandsautomaten und Blend Spaces (z. B. für idlende/laufende/springende Charaktere), Tweens für einmalige Bewegungen aus dem Code (z. B. UI-Einblendungen, Rückstoß) sowie 2D-Sprite-Animationen mit AnimatedSprite2D. Für 3D werden Skelett-Animation, Retargeting zwischen humanoiden Modellen und das IK-Framework (ab 4.6) unterstützt. Der Skill beschreibt detailliert die Nutzung der Godot-APIs, einschließlich grundlegender GDScript-Beispiele für alle Systeme, und verweist auf die entsprechenden MCP-Tools aus dem godot-mcp-Paket (z. B. `godot_animation_setup_scene`). Er erklärt, wie man Animationen testet, debuggt und mit dem Spielstatus verknüpft – von der Erstellung von RESET-Animationen über die Nutzung von Call-Method-Tracks bis hin zur Fuß-IK mittels Raycasts und TwoBoneIK3D. Besondere Features wie Abschnitts-Marker (4.4+), subtweens (4.4), das Ignorieren der Zeitverlangsamung (4.4) und `tween_await` (4.7) werden mit praktischen Beispielen erklärt.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht godot-animation?

Das richtige Werkzeug wählen

BedarfWerkzeug
„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 BildAnimatedSprite2D + 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, GreifenFamilie SkeletonModifier3D (IK, LookAt, Einschränkungen)

godot-mcp-Animationstools

AufgabeWerkzeug
AnimationPlayer/AnimationTree-Grundgerüst zu einer Szene hinzufügengodot_animation_setup_scene
Clips erstellen, auflisten oder lesengodot_animation_create_clip, godot_animation_list_clips, godot_animation_read_clip
Keyframes hinzufügen oder entfernengodot_animation_add_keyframe, godot_animation_remove_keyframe
Zustandsautomaten oder Blend Space des AnimationTree planengodot_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 ist play("walk") eine Kurzform für play("/walk"), und andere Bibliotheken werden mit play("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 Argument current_animation_changed in anim_name umbenannt; verbinde per Callable, sodass die Änderung keine Rolle spielt.
  • 4.6: get_queue() gibt Array[StringName] zurück, und is_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 und travel() für codegesteuerte.
  • Für One-Shots (Angriffe, Treffer) setze parameters/<OneShot>/request auf AnimationNodeOneShot.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, mit SpringBoneCollision*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 eines Path3D), mit JointLimitationCone3D-Grenzen und BoneTwistDisperser3D und LimitAngularVelocityModifier3D für natürliche Ergebnisse. Der alte SkeletonIK3D ist 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, TwoBoneIK3D für jedes Bein antreiben und die Hüfte um den niedrigsten Fuß-Delta versetzen.

Fehlerbehebung

  1. Ein Clip wird abgespielt, aber nichts bewegt sich: Der Track-Pfad ist relativ zu root_node falsch, oder ein AnimationTree ist aktiv und überschreibt den Player.
  2. Eine Eigenschaft springt zurück: Ein anderer Track oder die RESET-Animation setzt dieselbe Eigenschaft, oder ein Tween und eine Animation streiten sich darum.
  3. Ein Zustandsautomat hängt fest: Überprüfe die Übergangsbedingungen und den switch_mode und beobachte playback.get_current_node().
  4. Ruckeln in 3D: Aktiviere Physik-Interpolation oder animiere im gleichen Prozessmodus wie die Bewegung.

Verwandte Skills