游戏引擎 / 系统课时

按角色状态切换动画

按角色状态切换动画

角色已经能走动和跳跃,模型却可能一直停留在待机动作。本课用 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 应使用能覆盖整个离地阶段的空中循环姿态。若只有一次性起跳动画,之后应拆分起跳与滞空状态,而不是在长时间下落时反复重播起跳。

水平速度和着地状态驱动 Idle、Run、Jump 动画切换

用物理结果驱动切换

状态判断顺序应是“离地优先、其次移动、最后待机”。玩家可以一边跑一边跳;如果先检查水平速度,腾空时仍会播放 Run。因此先执行 move_and_slide(),再读取 is_on_floor(),避免拿到上一物理帧的落地结果。

在项目的 Input Map 中建立 move_left、move_right、move_forward、move_back 与 jump,分别绑定 WASD 和空格。下面是挂在 Player 上的完整脚本;运行前须按上节创建并连接动画资源与节点。

gdscript
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。

动画状态应反映角色的运动事实,而不是重复猜测玩家按了哪个键。后续加入攻击或受击动作时,也应先明确哪些状态有更高的切换优先级。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

按角色状态切换动画

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通