游戏客户端架构 / 系统课时

角色下坡为什么会持续弹起

角色下坡为什么会持续弹起

角色沿斜坡向下移动时,如果不断离地、下落、重新碰撞并再次弹起,通常说明接地检测、坡面移动、重力或碰撞修正之间存在反馈循环。本课以 Unity CharacterController 为例,通过最小可运行控制器复现并分析下坡问题,建立一套可验证的修复方法。

学习目标

  • 解释下坡时角色反复失去接地状态的原因。
  • 理解坡面法线、重力和贴地速度之间的关系。
  • 实现并验证基础的斜坡移动与接地处理。

为什么下坡比上坡更容易离地

在平地上,角色水平移动时地面的高度基本不变;但在下坡时,下一帧角色脚下的地面会更低。如果移动控制器只执行水平位移,角色可能暂时悬在坡面上方。

随后重力让角色下落,碰撞系统使角色重新贴近地面。如果接地后立即把竖直速度清零,而移动逻辑又继续忽略坡面方向,下一次水平移动仍可能造成新的离地间隙。

问题由此形成循环:水平位移造成离地、重力加速下落、重新接触坡面、竖直速度重置,再次水平位移。表现出来就是角色沿坡面连续小幅跳动。

下坡接地状态反复切换示意图

需要注意,CharacterController.isGrounded 表示上一次 Move 调用期间控制器是否接触到下方地面,并非持续实时检测的传感器。如果一帧调用多次 Move,最后一次调用的结果也可能改变后续接地判断。

坡面法线如何影响移动方向

要让角色沿坡面移动,需要知道坡面的朝向。通过向下射线检测可以得到 RaycastHit.normal,也就是碰撞表面的单位法线。

将预期水平移动方向投影到坡面切平面,可以得到沿坡面的移动方向:

csharp
Vector3 slopeDirection = Vector3.ProjectOnPlane(inputDirection, groundNormal);

这是片段示例:inputDirection 是世界空间中的期望水平方向,groundNormal 是有效坡面法线,完整上下文见后面的控制器代码。

投影结果在下坡方向上通常包含向下的竖直分量,使角色更自然地跟随下降坡面。

坡面法线与移动方向投影关系

不过,不能把射线命中的所有表面都当作可行走地面。墙面、陡坡和台阶边缘也可能产生法线,投影前应检查坡面角度是否处于控制器允许的范围内。

同时,射线检测与 CharacterController 自身的胶囊碰撞求解并不完全相同。射线用于估计坡面朝向,不应该无条件覆盖实际碰撞结果。

实现一个可验证的下坡控制器

在 Unity 3D 场景中创建地面和斜坡,为地形保留 Collider,并创建带 CharacterController 组件的角色对象。这个示例使用旧版 Input API,需要在项目的 Active Input Handling 中启用 Input Manager 或 Both。

将以下脚本保存为 DownhillController.cs 并挂到角色根节点,角色移动由该脚本统一管理,不要同时挂载另一个移动脚本或 Rigidbody 驱动脚本。

csharp
using UnityEngine;

[RequireComponent(typeof(CharacterController))]
public class DownhillController : MonoBehaviour
{
    [SerializeField] private float speed = 4f;
    [SerializeField] private float gravity = -20f;
    [SerializeField] private float groundStickSpeed = -2f;
    [SerializeField] private float probeDistance = 0.5f;
    [SerializeField] private LayerMask groundMask = ~0;

    private CharacterController controller;
    private float verticalSpeed;

    private void Awake()
    {
        controller = GetComponent<CharacterController>();
    }

    private void Update()
    {
        float x = Input.GetAxisRaw("Horizontal");
        float z = Input.GetAxisRaw("Vertical");
        Vector3 input = Vector3.ClampMagnitude(new Vector3(x, 0f, z), 1f);
        Vector3 worldDirection = transform.TransformDirection(input);

        // 射线起点抬高,减少起点恰好位于地面内部的情况。
        Vector3 origin = transform.position + Vector3.up * 0.2f;
        bool foundGround = Physics.Raycast(
            origin, Vector3.down, out RaycastHit hit,
            controller.height * 0.5f + probeDistance,
            groundMask, QueryTriggerInteraction.Ignore);

        Vector3 moveDirection = worldDirection;
        if (foundGround)
        {
            float angle = Vector3.Angle(hit.normal, Vector3.up);
            if (angle <= controller.slopeLimit)
            {
                // 只在可行走坡面上沿切平面修正移动方向。
                moveDirection = Vector3.ProjectOnPlane(worldDirection, hit.normal);
                if (moveDirection.sqrMagnitude > 0.0001f)
                    moveDirection = moveDirection.normalized * input.magnitude;
            }
        }

        // 接地时保留小幅向下速度,减少坡面下降导致的离地间隙。
        if (controller.isGrounded && verticalSpeed < 0f)
            verticalSpeed = groundStickSpeed;
        else
            verticalSpeed += gravity * Time.deltaTime;

        Vector3 velocity = moveDirection * speed + Vector3.up * verticalSpeed;
        CollisionFlags flags = controller.Move(velocity * Time.deltaTime);

        if ((flags & CollisionFlags.Below) != 0 && verticalSpeed < 0f)
            verticalSpeed = groundStickSpeed;
    }
}

这个实现只负责基础地面行走,不包含跳跃、滑坡、移动平台和台阶吸附。groundStickSpeed 是接地时使用的轻微向下速度,不是向上弹跳的补偿值;groundMask 应只包含可作为地面的碰撞层,避免射线命中角色自身或无关障碍物。

代码将坡面投影速度与重力速度合并后调用一次 Move,避免多个控制模块分别移动同一个 CharacterController。但投影可能已经包含竖直分量,因此在陡坡或复杂地形中,还需检查叠加后的下降速度与期望移动速度是否一致。

预期结果:运行后使用方向键或 WASD 控制角色,在坡度小于 Slope Limit、碰撞体设置合理的斜坡上,角色应能向下移动,并显著减少因水平位移而反复离地的现象。此示例没有主动输出日志,验收依据是 Scene 视图中的接地轨迹和角色移动表现。

接地检测与碰撞修正的边界

即使加入坡面投影和贴地速度,也不意味着所有下坡弹跳都会消失。控制器底部的胶囊形状、Skin Width、Step Offset 和地形几何形状都会影响最终碰撞结果。

排查时应区分以下情况:

现象 可能原因 优先处理
只在坡面开始下降时短暂悬空 没有沿坡移动或缺乏贴地速度 检查坡面投影和接地处理
下坡时接地状态连续切换 检测距离过短、胶囊边界不合适 检查射线范围与 CharacterController 尺寸
坡度较大时角色被不断推出 超过允许坡度或穿入碰撞体 检查 Slope Limit 和碰撞几何
到坡面接缝处突然弹起 接缝台阶、碰撞网格不连续 检查 MeshCollider 和地形连接
修改贴地速度后异常加剧 下降速度过大、碰撞修正反复发生 降低贴地速度并检查单次 Move 的结果

特别要避免将 isGrounded 为 false 直接等同于角色正在跳跃。在坡面边缘、下降地形和物理接触尚未恢复时,短时间的离地状态可能只是正常运动结果。

实际项目可以进一步增加短距离地面探测和短暂接地宽限,但应明确地面检测是对状态的估计,而不是直接修改 Transform 高度的理由。

验证修复是否真正稳定

建议准备平地、缓坡、接近 Slope Limit 的斜坡以及含有接缝的坡面,保持相同移动速度完成对照测试。

  1. 在平地上静止并移动,确认角色没有额外下沉或漂移。
  2. 沿缓坡连续向下移动,观察脚部与地面的距离是否稳定。
  3. 沿同一坡面向上移动,检查投影逻辑是否引入异常速度。
  4. 在陡坡和边缘停止输入,检查是否出现持续碰撞修正。
  5. 使用不同帧率重复测试,确认没有明显的帧率依赖。

如果问题仍然存在,先关闭坡面投影,只保留重力与单次 Move,再逐项恢复投影、接地检测和贴地速度。一次只改变一个条件,才能确定是哪一个反馈环节造成异常。

下坡移动稳定性的关键不是将角色强制吸附到地面,而是让移动方向、接地估计与碰撞求解彼此协调。保持单一移动入口、合理的坡面法线判断以及适度的向下速度,才能在不破坏跳跃和边缘行为的前提下减少弹跳。

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

目录与阅读设置

阅读设置

17

记录一个想法

角色下坡为什么会持续弹起

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

登录哪都通