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で駆動し、最も低い足の差分だけ腰をオフセットします。
デバッグ
- クリップが再生されるが何も動かない: トラックパスが
root_nodeを基準として間違っているか、AnimationTree がアクティブでプレイヤーをオーバーライドしている。 - プロパティが元に戻る: 別のトラックや RESET が同じプロパティをキー入力しているか、トゥイーンとアニメーションが競合している。
- ステートマシンがスタックする: トランジション条件と
switch_modeを確認し、playback.get_current_node()を監視する。 - 3D でジッターが発生する: 物理補間を有効にするか、動きと同じプロセスモードでアニメーションする。