游戏引擎 / 系统课时

加入重力与跳跃条件

加入重力与跳跃条件

使用 CharacterController.Move 控制角色时,水平移动可以正常工作,但角色不会自动受重力影响。本课把垂直速度、跳跃初速度与接地判断接入同一帧更新,让角色能跳起、落下,而且不能在空中反复起跳。

学习目标

  • 区分重力加速度、垂直速度与每帧实际位移。
  • 仅在接地时触发跳跃,并正确处理落地和头顶碰撞。
  • 在 Unity 场景中验证单次跳跃与连续移动。

先把竖直运动和水平输入分开

CharacterController.Move 接收的是本帧位移,并不自动计算重力。水平速度可以由 WASD 输入得到,竖直速度却必须跨帧保存:每帧用 gravity * Time.deltaTime 更新 verticalSpeed,再把水平、竖直速度相加,乘 Time.deltaTime 交给 Move。

本例约定世界 Y 轴向上,因此重力值为负数,例如 -20,单位是米每二次方秒。跳跃时不是直接提高 transform.position.y,而是给竖直速度一个向上的初值。代码使用 Mathf.Sqrt(2f * jumpHeight * -gravity) 计算初速度;在忽略碰撞与离散帧误差的情况下,起跳高度约为 jumpHeight。

水平输入做长度限制是为了避免同时按两个方向键时移动速度变快。这里沿世界 XZ 平面移动;如果项目已有相机相对的水平移动逻辑,只需替换水平向量,重力计算不用改。

接地、上升与下落如何衔接

接地时按下 Space,角色进入上升;重力不断降低正的竖直速度,降到零后转为下落;碰到地面,再恢复可跳跃状态。触发条件必须同时满足 isGrounded 和 GetKeyDown,而不是在每帧持续按键时重复赋予起跳速度。

角色接地、上升、下落与再次起跳的状态转换

isGrounded 表示 CharacterController 最近一次调用 Move 后的接地结果,不是任意时刻重新执行的物理查询。为了让角色在斜坡和地面附近维持接触,落地时把负的竖直速度重设为一个很小的向下值(本例 -2);它不是新的重力加速度。

编写完整的移动与跳跃脚本

在场景中创建带有 Collider 的地面和一个 Player 对象。给 Player 添加 CharacterController,把胶囊底部放在地面之上,不要再用 Rigidbody 或直接修改 Transform 来驱动这套移动。保存以下代码为 GravityJumpMover.cs 并挂到 Player。

示例使用旧版 Input Manager 的 Horizontal、Vertical 和 Space 按键,项目需启用 Input Manager (Old) 或 Both;如果只启用新 Input System,应改用对应输入动作读取输入值。

csharp
using UnityEngine;

[RequireComponent(typeof(CharacterController))]
public class GravityJumpMover : MonoBehaviour
{
    [SerializeField] private float moveSpeed = 5f;
    [SerializeField] private float jumpHeight = 1.5f;
    [SerializeField] private float gravity = -20f;

    private CharacterController controller;
    private float verticalSpeed;

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

    private void Update()
    {
        bool grounded = controller.isGrounded;
        if (grounded && verticalSpeed < 0f)
            verticalSpeed = -2f;

        Vector3 input = new Vector3(
            Input.GetAxisRaw("Horizontal"), 0f,
            Input.GetAxisRaw("Vertical"));
        Vector3 horizontal = Vector3.ClampMagnitude(input, 1f) * moveSpeed;

        // 只有上一帧确认接地,才允许本帧发起跳跃
        if (grounded && Input.GetKeyDown(KeyCode.Space))
            verticalSpeed = Mathf.Sqrt(2f * jumpHeight * -gravity);

        verticalSpeed += gravity * Time.deltaTime;
        Vector3 motion = (horizontal + Vector3.up * verticalSpeed)
            * Time.deltaTime;
        CollisionFlags flags = controller.Move(motion);

        // 碰到头顶就停止上升;落地后保留轻微向下速度
        if ((flags & CollisionFlags.Above) != 0 && verticalSpeed > 0f)
            verticalSpeed = 0f;
        if ((flags & CollisionFlags.Below) != 0 && verticalSpeed < 0f)
            verticalSpeed = -2f;
    }
}

预期结果(Game 视图中的表现,而非 Console 日志):

text
按 WASD:沿世界 XZ 平面移动,斜向移动不会更快
接地后按 Space:跳起、到达最高点、再落回地面
空中再次按 Space:不会重新获得跳跃初速度
落地后再次按 Space:可以发起下一次跳跃

验证与修正常见异常

依次测试原地跳跃、边移动边跳跃、空中连续按 Space、落地后重新跳跃,再在头顶放一块带 Collider 的挡板,确认上升碰到挡板后会下落。可以在 Inspector 中小幅调节 jumpHeight 和 gravity:更负的重力意味着升降更快,相同目标高度下所需起跳初速度也更大。

出现“空中无限跳”时,先查是否误用 GetKey 持续设置起跳速度,或是否没有检查接地;出现“不落地”时,查是否漏掉重力累积;出现“穿地”时,查地面 Collider、碰撞层和是否仍在直接修改 Transform。不要把速度和位移混用,也不要对同一份 motion 重复乘 Time.deltaTime。

这套写法适合使用 CharacterController 的基础第三人称控制器。若需要离地缓冲、坡面法线或复杂台阶判断,应另设地面探测,并把“允许起跳”与“实际碰撞接触”分别验证。

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

目录与阅读设置

阅读设置

17

记录一个想法

加入重力与跳跃条件

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

登录哪都通