游戏引擎 / 系统课时
按角色状态切换动画
按角色状态切换动画
角色已经能走动和跳跃,模型却可能一直停留在待机动作。本课用 Godot 4 的 AnimationTree 将水平速度与着地结果转换为 Idle、Run、Jump,并在物理移动完成后切换状态,让起步、腾空和落地都有清楚、连续的视觉反馈。
学习目标
- 建立运动数据与动画状态之间的映射,明确离地时的判断优先级。
- 配置三态动画树及其过渡,用脚本驱动切换。
- 验证起步、跳跃、落地的动画表现,并排除常见抖动。
配好动画树和过渡
场景根节点使用 Player(CharacterBody3D),包含 CollisionShape3D、带 AnimationPlayer 的角色模型,以及直接挂在 Player 下的 AnimationTree。模型至少准备待机、奔跑和空中姿态三个动作。AnimationTree 不存储动画本身,而是引用 AnimationPlayer 的资源负责混合和过渡。
在 AnimationTree 的 Animation Player 属性中指定模型的 AnimationPlayer,将 Tree Root 设为 AnimationNodeStateMachine,创建 Idle、Run、Jump 三个动画状态,名称需与后面脚本完全一致。建立 Idle 与 Run、Idle 与 Jump、Run 与 Jump 之间的双向过渡。把由脚本调用的过渡设为 Enabled、Switch Mode 设为 Immediate,交叉淡化时间可先用 0.12 秒。
Idle 与 Run 的动画应循环;本例的 Jump 应使用能覆盖整个离地阶段的空中循环姿态。若只有一次性起跳动画,之后应拆分起跳与滞空状态,而不是在长时间下落时反复重播起跳。

用物理结果驱动切换
状态判断顺序应是“离地优先、其次移动、最后待机”。玩家可以一边跑一边跳;如果先检查水平速度,腾空时仍会播放 Run。因此先执行 move_and_slide(),再读取 is_on_floor(),避免拿到上一物理帧的落地结果。
在项目的 Input Map 中建立 move_left、move_right、move_forward、move_back 与 jump,分别绑定 WASD 和空格。下面是挂在 Player 上的完整脚本;运行前须按上节创建并连接动画资源与节点。
extends CharacterBody3D
const MOVE_SPEED := 5.0
const JUMP_SPEED := 4.5
const RUN_THRESHOLD := 0.15
var gravity: float = ProjectSettings.get_setting("physics/3d/default_gravity")
var current_state := ""
@onready var animation_tree: AnimationTree = $AnimationTree
@onready var playback: AnimationNodeStateMachinePlayback = animation_tree.get("parameters/playback")
func _ready() -> void:
animation_tree.active = true
playback.start("Idle")
current_state = "Idle"
func _physics_process(delta: float) -> void:
var axis := Input.get_vector("move_left", "move_right", "move_forward", "move_back")
var direction := Vector3(axis.x, 0.0, axis.y)
velocity.x = direction.x * MOVE_SPEED
velocity.z = direction.z * MOVE_SPEED
if not is_on_floor():
velocity.y -= gravity * delta
elif Input.is_action_just_pressed("jump"):
velocity.y = JUMP_SPEED
move_and_slide()
# 先判定是否离地,避免跑跳同时发生时误播 Run。
var next_state := "Idle"
if not is_on_floor():
next_state = "Jump"
elif Vector2(velocity.x, velocity.z).length() > RUN_THRESHOLD:
next_state = "Run"
# 仅在状态变化时发起过渡,避免反复重启动画。
if next_state != current_state:
playback.travel(next_state)
current_state = next_state预期结果:静止时播放 Idle,按方向键播放 Run,起跳或走下平台后播放 Jump;落地后,仍按方向键切回 Run,否则切回 Idle。示例使用世界坐标方向移动,不包含相机相对移动;若已有移动控制器,只移植状态判断部分,不要并行运行两套移动逻辑。
检查切换中的异常
先在平地完成“静止→奔跑→静止”,再测试“奔跑→跳跃→落地”以及从平台直接下落。重点观察状态切换是否与接地瞬间一致,以及动画混合是否平顺。
- 一直播放
Idle:检查AnimationTree.active、Animation Player指向和三个状态名称;确认物理脚本确实在运行。 Jump期间误播Run:检查is_on_floor()是否在move_and_slide()之后判断,并确保离地分支优先。- 动画突然跳帧:检查各状态间是否有有效过渡和淡化时间;
travel()找不到连通路径时可能直接跳转。 - 角色停下仍像在跑:区分输入意图和实际速度;若使用惯性移动,应以真实水平速度与阈值决定
Run。
动画状态应反映角色的运动事实,而不是重复猜测玩家按了哪个键。后续加入攻击或受击动作时,也应先明确哪些状态有更高的切换优先级。