游戏引擎 / 系统课时

处理根运动和脚本位移冲突

处理根运动和脚本位移冲突

角色同时接受动画根运动和移动脚本控制时,容易出现速度翻倍、攻击漂移、转身错位或穿过碰撞体的问题。本课使用 Unity 6 的 Animator 与 CharacterController,明确角色根节点的位移归属,给出可运行的脚本驱动方案,并通过移动、攻击和转身测试确认动画不会额外推动角色。

学习目标

  • 区分 Root Motion 与脚本位移的控制范围,解释双重位移的原因。
  • 配置 Animator 和动画片段,使 CharacterController 成为角色的主要位移来源。
  • 通过实际位移、碰撞和动画状态测试定位角色漂移。

确定角色位移的唯一控制者

Root Motion(根运动)是从动画中提取的角色根节点位移与旋转。例如,一段持续 1 秒的前冲动画可能携带向前 2 米的根运动。启用 Animator 的 Apply Root Motion 后,动画系统可以把这些变化应用到角色对象上。

脚本驱动位移则由移动组件根据输入、速度和碰撞结果更新角色位置。使用 CharacterController.Move 时,传入的是本帧位移增量,而不是目标世界坐标。

比较项目 Root Motion 脚本驱动位移
位移来源 动画片段中的根运动 输入与运动组件计算结果
速度控制 受动画内容和播放速度影响 直接使用米/秒等参数
转向控制 可以使用动画根旋转 脚本计算目标朝向
碰撞处理 需要与碰撞组件正确集成 CharacterController.Move 直接约束位移
典型用途 精确编排的攀爬、特殊处决 第三人称自由移动、普通战斗

本项目选择脚本驱动:PlayerRoot 持有 CharacterController,负责世界坐标、朝向和碰撞;子对象 Model 持有 Animator,只负责骨骼姿态。Animator 可以播放带位移感的攻击动作,但不得自动改变 PlayerRoot 的位置。

角色移动组件、Animator 与模型姿态之间的位移控制关系

假设移动脚本每帧推动角色 0.07 米,而动画又额外推动 0.06 米。若两者都被应用,同一帧可能累计移动 0.13 米。以每秒 60 帧估算,预期速度 4.2 米/秒会变成约 7.8 米/秒。实际碰撞可能限制最终距离,但错误的位移来源仍会造成表现不稳定。

配置 Animator 与动画片段

以下操作适用于 Unity 6 的 Mecanim 动画系统,使用 Humanoid 动画时可直接检查所述根变换导入选项。

  1. 在 Hierarchy 中选择角色根节点 PlayerRoot,确认 CharacterController 位于该节点,Animator 通常位于其子对象 Model。
  2. 选择带 Animator 的对象,在 Inspector 的 Animator 组件中取消勾选 Apply Root Motion,并将 Update Mode 设为 Normal。
  3. 在 Animator Controller 中添加 Float 参数 Speed,让 Idle、Walk、Run 等移动动画由实际水平速度驱动。
  4. 在 Project 中选中来源 FBX,打开 Inspector 的 Animation 页签,选择需要检查的动画片段。
  5. 对应当原地播放的 Idle、Walk、Run 以及普通站立攻击片段,检查 Root Transform Position (XZ) 的 Bake Into Pose。若片段需要保持根节点不移动,可启用该选项并应用导入设置。
  6. 检查 Root Transform Rotation:对于原地直线移动等适合固定根朝向的片段,可以使用 Bake Into Pose;对于带实际转向的片段,应根据其动作设计单独处理,不要盲目统一烘焙。

Bake Into Pose 控制动画导入时根变换和姿态之间的分配方式;Apply Root Motion 控制 Animator 是否自动应用根运动。两者不是同一个开关。关闭自动根运动后,若模型内部的根骨骼仍有明显位移曲线,可继续检查导入设置及骨骼层级。

对于 Generic 动画,还应在模型导入的 Rig 设置中核对根节点选择。角色模型如果把带有大幅位移的骨骼错误地作为根节点,仍可能出现网格相对碰撞胶囊偏移的问题。

使用 CharacterController 驱动实际移动

创建 ScriptDrivenCharacterMotion.cs,挂在包含 CharacterController 与 PlayerInput 的 PlayerRoot 上。以下完整示例使用 Unity 6 的 Input System,不依赖旧版 Input.GetAxis。

使用前确认 PlayerInput 已关联 Input Actions 资源,启用了包含 Move 动作的默认 Action Map;Move 的 Action Type 为 Value、Control Type 为 Vector2。Animator Controller 必须有名为 Speed 的 Float 参数。

csharp
using UnityEngine;
using UnityEngine.InputSystem;

[RequireComponent(typeof(CharacterController), typeof(PlayerInput))]
public sealed class ScriptDrivenCharacterMotion : MonoBehaviour
{
    [SerializeField] private Transform cameraTransform;
    [SerializeField, Min(0f)] private float moveSpeed = 3.5f;
    [SerializeField, Min(0f)] private float turnSpeed = 540f;

    private CharacterController controller;
    private Animator animator;
    private InputAction moveAction;
    private float verticalSpeed;

    private static readonly int SpeedId = Animator.StringToHash("Speed");

    private void Awake()
    {
        controller = GetComponent<CharacterController>();
        animator = GetComponentInChildren<Animator>();
        moveAction = GetComponent<PlayerInput>()
            .actions.FindAction("Move", true);

        if (cameraTransform == null && Camera.main != null)
            cameraTransform = Camera.main.transform;

        if (animator == null)
        {
            Debug.LogError("角色缺少 Animator", this);
            enabled = false;
            return;
        }

        // 世界位移由 CharacterController 独占。
        animator.applyRootMotion = false;
    }

    private void Update()
    {
        float dt = Time.deltaTime;
        Vector2 input = moveAction.ReadValue<Vector2>();

        Vector3 forward = cameraTransform != null
            ? cameraTransform.forward : transform.forward;
        Vector3 right = cameraTransform != null
            ? cameraTransform.right : transform.right;

        forward.y = 0f;
        right.y = 0f;
        forward.Normalize();
        right.Normalize();

        // 限制斜向移动长度,避免速度超过设定值。
        Vector3 desired = Vector3.ClampMagnitude(
            forward * input.y + right * input.x, 1f);

        if (desired.sqrMagnitude > 0.0001f)
        {
            Quaternion target = Quaternion.LookRotation(desired);
            transform.rotation = Quaternion.RotateTowards(
                transform.rotation, target, turnSpeed * dt);
        }

        // CharacterController.Move 不会自动施加重力。
        if (controller.isGrounded && verticalSpeed < 0f)
            verticalSpeed = -2f;

        verticalSpeed += Physics.gravity.y * dt;
        Vector3 displacement =
            (desired * moveSpeed + Vector3.up * verticalSpeed) * dt;

        controller.Move(displacement);

        // 用碰撞后的水平速度反馈动画,而非输入期望速度。
        Vector3 actualVelocity = controller.velocity;
        actualVelocity.y = 0f;
        animator.SetFloat(SpeedId, actualVelocity.magnitude, 0.1f, dt);
    }
}

预期结果:进入 Play 模式后,输入 Move 时角色沿相机水平朝向移动,并逐渐转向移动方向;松开输入后角色停止水平位移。Animator 的 Speed 参数跟随 CharacterController 的实际水平速度变化,动画不会额外推动角色根节点。

该示例覆盖普通水平移动、基础重力和转向,不包含跳跃、攻击锁定或冲刺。如果项目已有完整运动组件,应将根运动关闭和实际速度反馈逻辑整合进现有组件,而不是让两套移动脚本同时调用 Move。

特别注意:示例使用 Camera.main 作为未手动指定相机时的后备引用。若项目采用跟随镜头,应在 Inspector 中将 cameraTransform 指向实际渲染相机,并确保主相机的 Tag 正确。

验证移动、攻击和转身是否漂移

验收需要分别观察角色根节点和可视模型。Scene 视图中的模型看似移动,不一定代表 PlayerRoot 的 Transform 发生了变化。

建议准备平坦地面、至少 10 米的无遮挡通道、一面带 Collider 的墙,以及 Idle、移动、普通攻击和原地转身动画。以下阈值为本项目建议的验收容差,并非 Unity 引擎固定标准。

测试场景 操作条件 预期结果
静止测试 不输入,等待 5 秒 PlayerRoot 水平漂移小于 0.02 米
直线移动 速度 3.5 米/秒,保持同一方向 2 秒 无碰撞且方向固定时约移动 7 米
站立攻击 无 Move 输入,连续播放攻击 3 次 PlayerRoot 水平位移累计小于 0.02 米
原地转身动画 不输入 Move,播放转身片段 若无脚本转向命令,PlayerRoot 不出现额外偏航
贴墙移动 持续向墙输入 2 秒 胶囊体不穿墙,实际水平速度受碰撞约束

检查时可以在 Inspector 中观察 PlayerRoot 的 Transform,也可以使用 Scene 视图工具比较开始和结束位置。测试攻击时,还应关注 Model 相对 PlayerRoot 的位置:即使根节点未漂移,网格也不应在动画结束后留下持续累积的偏移。

对于原地转身,区分两种情况:如果动画只是原地转身姿态,应确保模型在状态结束时回到合理的根朝向;如果设计要求角色真正转过 90 度,则需要由运动组件同步更新 PlayerRoot 的旋转,而不是偷偷启用根旋转。

在无碰撞的直线测试中,距离可以用速度乘时间核对:3.5 米/秒持续 2 秒,对应 7 米。若明显超过这个数值,优先检查是否存在第二个位移来源;若距离不足,再检查输入归一化、碰撞约束和其他移动限制。

定位并修复典型冲突

发现漂移后,不应马上调低 moveSpeed 或动画播放速度。这可能只是在掩盖两个系统同时施加位移的问题。

  • 攻击时根节点自己移动:检查 Animator 的 Apply Root Motion,以及是否存在自定义 OnAnimatorMove、Timeline 或其他直接修改 Transform 的逻辑。Unity 中实现 OnAnimatorMove 后,applyRootMotion 开关不会按普通自动根运动方式生效,因此必须单独检查回调内容。
  • PlayerRoot 不动但模型逐渐偏离胶囊体:检查来源动画的 Root Transform 导入选项、骨骼根节点和 Model 的局部 Transform。不要通过每帧强制把模型位置归零来掩盖有意设计的局部动画位移。
  • 移动速度明显偏快:确认同一帧没有同时执行根运动、重复的 CharacterController.Move 或额外的 Transform 平移。普通移动应集中到一个运动组件统一计算。
  • 原地转身结束后突然弹回:检查动画根旋转是否与脚本朝向重复或相互矛盾。可让 Animator 只播放转身姿态,由脚本按明确的角速度控制角色根节点。
  • 贴墙时仍显示全速跑步:不要直接把输入向量长度映射为 Speed。使用 CharacterController.Move 后的实际水平速度反馈动画,才能反映碰撞限制。

如果以后需要一次带固定前冲距离的攻击,例如 0.2 秒内前进 1.2 米,仍可坚持脚本位移方案:由攻击状态向统一运动组件提交冲刺请求,再通过 CharacterController.Move 执行并接受碰撞约束。不要同时让攻击动画和冲刺脚本各自增加 1.2 米位移。

完成验收后,应能明确指出角色每一帧的世界位移来自哪个组件。对于本项目,这个组件就是 CharacterController 所在的运动脚本;Animator 根据运动结果播放姿态,不再成为第二个隐藏的位移来源。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理根运动和脚本位移冲突

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

登录哪都通