Godot 動畫
選擇工具
| 需求 | 使用工具 |
|---|---|
| 從程式碼觸發的「發射後不理」運動(UI 彈跳、擊退、淡出) | Tween(create_tween()) |
| 編制好的片段(走路循環、門、過場動畫) | AnimationPlayer |
| 逐幀 2D 精靈 | AnimatedSprite2D + SpriteFrames,或使用 AnimationPlayer 設定 Sprite2D.frame 關鍵幀 |
| 混合與狀態邏輯(待機↔跑步↔跳躍、八方向移動) | 搭配狀態機或混合空間的 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="<名稱>" 取得參數模板。使用 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_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+:巢狀可重複使用的 tween
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()綁定到節點的 Tween 會隨著該節點一起銷毀。在開始衝突的 Tween 之前,先終止前一個 Tween:if _t and _t.is_valid(): _t.kill()。 - 暫停的樹狀結構會暫停 Tween,除非設定了
set_pause_mode(Tween.TWEEN_PAUSE_PROCESS)。 - 對於移動物理物體的 Tween,請使用
set_process_mode(Tween.TWEEN_PROCESS_PHYSICS)。
3D 骨架動畫
- 從 glTF(
.glb)匯入動畫。在「進階匯入」對話框中設定循環模式和分割片段,而不是在匯入之後。 - 重定目標: 在匯入時使用
SkeletonProfileHumanoidBoneMap,可在人體模型之間共享動畫。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 配方:從每隻腳向下發射射線,將目標 Marker3D 移動到撞擊點,為每條腿驅動
TwoBoneIK3D,並根據最低腳部差值偏移臀部。
除錯
- 片段播放但沒有任何移動:軌道路徑相對於
root_node是錯誤的,或者 AnimationTree 正在活動並覆蓋了播放器。 - 屬性彈回:另一個軌道或 RESET 動畫設定了相同屬性的關鍵幀,或者 Tween 和動畫之間存在衝突。
- 狀態機卡住:檢查轉換條件和
switch_mode,並監控playback.get_current_node()。 - 3D 中的抖動:啟用物理插值,或在與移動相同的處理模式下設定動畫。