游戏引擎 / 系统课时

用刚体完成跳跃与落地

用刚体完成跳跃与落地

这一课在 Cocos Creator 3.8 中让角色按空格起跳、受重力下落,并在脚底再次接触地面后恢复跳跃资格。重点不是让节点瞬间升高,而是让刚体负责速度和碰撞,用独立的脚底检测区判断是否真正落地。

学习目标

  • 为角色配置动态刚体、实体碰撞体与脚底触发器。
  • 保留水平速度,只修改竖直速度完成起跳。
  • 用进入、离开地面事件限制空中重复跳跃。

搭建可落地的物理场景

先在项目中启用 3D 物理,选用 Bullet、cannon.js 或 PhysX 等支持刚体动力学的后端;builtin 仅做轻量碰撞检测,不适合本例的重力跳跃。场景采用 Y 轴向上,地面放在角色下方。

  1. 创建 Ground 节点,添加 BoxCollider,保持 Is Trigger 关闭;地面不必添加 RigidBody。
  2. 创建 Player 节点,添加 RigidBody 和 CapsuleCollider。刚体类型设为 DYNAMIC,启用 Use Gravity,质量大于 0;胶囊体保持实体碰撞。
  3. 在 Player 下建立 FootProbe 子节点,添加较扁的 BoxCollider,勾选 Is Trigger。探针放在胶囊底部,站立时与地面略微重叠,但不要伸到角色腰部。
  4. 为 Player 挂载下面的 JumpByRigidBody 脚本,将 Player 的刚体和 FootProbe 的碰撞体拖到对应属性槽。

若不希望物理碰撞使角色翻倒,将刚体的 Angular Factor 设为 (0, 0, 0)。还要确认碰撞矩阵允许角色、脚底探针与地面交互。

刚体跳跃与脚底触发器的空间关系及状态变化

通过速度控制一次起跳

新建 JumpByRigidBody.ts。脚底触发器只承担“是否碰到地面”的检测,胶囊实体碰撞体负责真正挡住地面。示例约定地面碰撞体所在节点名为 Ground,并用集合处理同时踩到多个地面碰撞体的情况。

ts
import {
  _decorator, Component, Collider, EventKeyboard,
  ITriggerEvent, Input, KeyCode, RigidBody, Vec3, input
} from 'cc';

const { ccclass, property } = _decorator;

@ccclass('JumpByRigidBody')
export class JumpByRigidBody extends Component {
  @property(RigidBody) body: RigidBody | null = null;
  @property(Collider) footProbe: Collider | null = null;
  @property jumpSpeed = 6;

  private readonly groundHits = new Set<Collider>();
  private readonly velocity = new Vec3();

  onEnable() {
    if (!this.body || !this.footProbe) {
      console.warn('未绑定刚体或脚底探针');
      return;
    }
    this.footProbe.on('onTriggerEnter', this.onGroundEnter, this);
    this.footProbe.on('onTriggerExit', this.onGroundExit, this);
    input.on(Input.EventType.KEY_DOWN, this.onKeyDown, this);
  }

  onDisable() {
    this.footProbe?.off('onTriggerEnter', this.onGroundEnter, this);
    this.footProbe?.off('onTriggerExit', this.onGroundExit, this);
    input.off(Input.EventType.KEY_DOWN, this.onKeyDown, this);
    this.groundHits.clear();
  }

  private onGroundEnter(event: ITriggerEvent) {
    if (event.selfCollider !== this.footProbe ||
        event.otherCollider.node.name !== 'Ground') return;
    if (this.groundHits.size === 0) console.log('已落地');
    this.groundHits.add(event.otherCollider);
  }

  private onGroundExit(event: ITriggerEvent) {
    if (event.selfCollider !== this.footProbe) return;
    this.groundHits.delete(event.otherCollider);
  }

  private onKeyDown(event: EventKeyboard) {
    if (event.keyCode !== KeyCode.SPACE || !this.body ||
        this.groundHits.size === 0) return;

    // 只重设Y速度,保留原有XZ平面移动。
    this.body.getLinearVelocity(this.velocity);
    this.velocity.y = this.jumpSpeed;
    this.body.setLinearVelocity(this.velocity);
    this.groundHits.clear(); // 本次起跳后锁住再次输入
    console.log('起跳');
  }
}

预期输出(角色先站在地上,按一次空格,再自然落地):

text
已落地
起跳
已落地

这是事件打印顺序,不是逐帧轨迹;重力大小、起跳高度与落地耗时取决于物理配置。jumpSpeed = 6 只是入门调试值。getLinearVelocity 先读取现有速度,再修改 y,避免把行走时的 x/z 速度清零。

理解接地状态与调试顺序

跳跃许可来自 groundHits 是否非空,而不是检测角色的世界坐标是否等于某个固定高度。脚底区域离开地面时移除对应碰撞体;重新进入时加入集合。按空格后立即清空集合,可以避免同一次落地期间重复按键触发第二次跳跃。

这里的地面识别是为了教学使用的节点名约定,正式项目应改用地面专用组件或碰撞分组,避免误把道具当作地面。地面间有缝隙或高速移动时,也应结合射线、接触法线或短暂的接地宽限时间处理边缘情况。

如果运行后没有跳跃,按顺序检查:控制台有无“未绑定”警告、RigidBody 是否为 DYNAMIC、物理后端能否模拟刚体、探针是否勾选触发器且与 Ground 重叠、碰撞矩阵是否放行。若出现穿地,先检查实体 CapsuleCollider 是否误勾选 Is Trigger。不要在 update 中反复用 setPosition 覆盖动态刚体位置,否则会与物理模拟争夺控制权。

最终验收应是:第一次按键上升、空中连按无效、落地后可以再次起跳,并且落下时实体胶囊体不会穿过地面。

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

目录与阅读设置

阅读设置

17

记录一个想法

用刚体完成跳跃与落地

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

登录哪都通