Communitygithub.com

Godot アニメーション

Godot 4.x ゲームをアニメーション化 - AnimationPlayer のクリップとライブラリ、AnimationTree のステートマシンとブレンドスペース、スプライトアニメーション、Tween(4.4 のサブトゥイーンと 4.7 の tween_await を含む)、アニメーションセクションとマーカー、3D スケルタルアニメーション、リターゲット、4.6 の IK フレームワーク(TwoBoneIK3D、FABRIK3D、CCDIK3D、SplineIK3D)に対応。キャラクターアニメーション、UI モーション、カットシーン、プロシージャルモーション、ゲームプレイ状態へのアニメーション連携に使用。godot-mcp の godot_animation_* ツールと組み合わせて使用。

Godot アニメーション とは?

このスキルは、Godot 4.x ゲームエンジンにおけるアニメーション全般をプロフェッショナルに実装・管理するための総合ガイドです。AnimationPlayer を使ったオーサリング済みクリップの管理(ライブラリ、キー、マーカー、セクション)、AnimationTree によるステートマシンやブレンドスペースの構築、Tween を用いたコードベースの軽量アニメーション(4.4 のサブトゥイーン、4.7 の tween_await を含む)など、幅広い手法をカバーします。さらに、3D スケルタルアニメーションでは、glTF インポート、ヒューマノイド間のリターゲット、4.6 で導入された IK フレームワーク(TwoBoneIK3D、FABRIK3D、CCDIK3D、SplineIK3D)の具体的な使用方法を提供します。このスキルは、godot-mcp ツールスイートの godot_animation_* ツールとシームレスに連携し、AI エージェントがシーン全体をコード生成、検証、実行、視覚確認できるように設計されています。デバッグテクニックやベストプラクティスも豊富に含まれており、キャラクターアニメーションから UI の微動、カットシーン、プロシージャルモーションまで、あらゆるアニメーション要件に対応します。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Godot アニメーション は何をしますか?

ツールの選択

ニーズ使用するツール
コードからの使い捨てモーション(UI ポップ、ノックバック、フェード)Tween(create_tween())
オーサリング済みクリップ(歩行サイクル、ドア、カットシーン)AnimationPlayer
フレーム単位の 2D スプライトAnimatedSprite2D + SpriteFrames、または AnimationPlayer で Sprite2D.frame をキー入力
ブレンドとステートロジック(待機↔走る↔ジャンプ、8方向移動)ステートマシンまたはブレンドスペースを使用した AnimationTree
プロシージャルボーン照準、足場設置、リーチSkeletonModifier3D ファミリー(IK、LookAt、制約)

godot-mcp アニメーションツール

タスクツール
シーンに AnimationPlayer/AnimationTree の足場を追加godot_animation_setup_scene
クリップの作成、一覧表示、読み取りgodot_animation_create_clip、godot_animation_list_clips、godot_animation_read_clip
キーの追加または削除godot_animation_add_keyframe、godot_animation_remove_keyframe
AnimationTree ステートマシンまたはブレンドスペースの計画godot_animation_build_state_machine_plan、godot_animation_build_blend_space_plan

引数のテンプレートについては godot_help tool="<name>" を使用してください。godot_validate_scene で検証したら、シーンを実行してモーションを確認します。シーンツリーの証拠だけではアニメーションが正しいとは限りません。ランタイムのスクリーンショットか手動チェック(godot-interactive を参照)を使用してください。

AnimationPlayer

  • クリップは AnimationLibraries に格納されます。デフォルトライブラリは空の名前 "" を持つため、play("walk") は play("/walk") の短縮形であり、他のライブラリでは play("combat/slash") のように使用します。
  • トラックパスは root_node(デフォルトは ..、つまりプレイヤーの親)を基準とします: NodePath("Sprite2D:frame")、NodePath(".:position")。
  • アニメーション化されたすべてのプロパティの初期値を持つ RESET アニメーションを保持してください。エディタはこれを使用して状態を復元し、シーンの差分を汚染しないようにします。
  • Call Method トラックからメソッドを呼び出します(足音、ヒットボックス生成など)。コードで時間をポーリングする代わりに使用します。
  • セクションまたはマーカーで再生(4.4+): play_section_with_markers("attack", &"windup_end", &"recover_start") を使用して、クリップの一部をループまたはスキップします。
  • animation_finished(anim_name) は非ループクリップに対して発火します。4.7 では current_animation_changed の引数名が anim_name に変更されました。Callable で接続すれば変更は問題になりません。
  • 4.6: get_queue() は Array[StringName] を返し、is_animation_active() が追加されました。
@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 (速度による待機/歩き/走り)
    ├── Jump, Fall, Land
    └── Attack (AnimationNodeBlendTree による OneShot)
@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")
  • パラメータパスはツリーから取得します。インスペクタでパラメータにホバーすると正確なパスをコピーできます。
  • データ駆動型トランジションにはトランジション advance_conditions または式(advance_expression)を使用し、コード駆動型トランジションには travel() を使用します。
  • ワンショット(攻撃、ヒット)の場合は、parameters/<OneShot>/request を AnimationNodeOneShot.ONE_SHOT_REQUEST_FIRE に設定します。
  • AnimationNodeExtension(4.4、実験的)を使用すると、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)

# 並列ステップ
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+: 再利用可能なトゥイーンをネスト
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+: Engine.time_scale が遅くなってもアニメーションを継続(ヒットストップ、スローモーション中の UI)
create_tween().set_ignore_time_scale().tween_property(ui, "modulate:a", 1.0, 0.2)

# 4.7+: シグナルが発火するまでシーケンスを一時停止
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)

ルール:

  • create_tween() でノードにバインドされたトゥイーンは、そのノードとともに破棄されます。競合するトゥイーンを開始する前に、以前のトゥイーンを強制終了します: if _t and _t.is_valid(): _t.kill()。
  • ポーズされたツリーは、set_pause_mode(Tween.TWEEN_PAUSE_PROCESS) が設定されていない限り、トゥイーンをポーズします。
  • 物理ボディを動かすトゥイーンには set_process_mode(Tween.TWEEN_PROCESS_PHYSICS) を使用します。

3D スケルタルアニメーション

  • glTF(.glb)からアニメーションをインポートします。ループモードとクリップの分割は、インポート後の編集ダイアログではなく、詳細インポートダイアログで設定します。
  • リターゲット: インポート時に SkeletonProfileHumanoid の BoneMap を使用して、ヒューマノイドモデル間でアニメーションを共有します。RetargetModifier3D(4.4+)は、実行時にスケルトン間でポーズをコピーします。
  • SkeletonModifier3D スタック(Skeleton3D の子、順番に処理):
    • LookAtModifier3D(4.4+): 角度制限付きの頭部と目のトラッキング。
    • SpringBoneSimulator3D(4.4+): 髪、尻尾、布のような揺れ。SpringBoneCollision*3D と併用。
    • AimModifier3D、CopyTransformModifier3D、ConvertTransformModifier3D(4.5+): ボーン制約。
    • IK(4.6+): TwoBoneIK3D(腕と脚、決定論的)、FABRIK3D/CCDIK3D/JacobianIK3D(反復チェーン)、SplineIK3D(Path3D に沿った脊椎や触手)。JointLimitationCone3D による制限、BoneTwistDisperser3D と LimitAngularVelocityModifier3D により自然な結果を得られます。古い SkeletonIK3D は非推奨です。
    • ModifierBoneTarget3D(4.5+): ボーンに追従する Node3D。IK ターゲットやアタッチメントとして便利です。
  • フット IK のレシピ: 各足から下方向にレイキャストし、マーカー ModifierBoneTarget3D をヒットポイントに移動、各脚を TwoBoneIK3D で駆動し、最も低い足の差分だけ腰をオフセットします。

デバッグ

  1. クリップが再生されるが何も動かない: トラックパスが root_node を基準として間違っているか、AnimationTree がアクティブでプレイヤーをオーバーライドしている。
  2. プロパティが元に戻る: 別のトラックや RESET が同じプロパティをキー入力しているか、トゥイーンとアニメーションが競合している。
  3. ステートマシンがスタックする: トランジション条件と switch_mode を確認し、playback.get_current_node() を監視する。
  4. 3D でジッターが発生する: 物理補間を有効にするか、動きと同じプロセスモードでアニメーションする。

関連スキル