游戏引擎 / 系统课时
用刚体完成跳跃与落地
用刚体完成跳跃与落地
这一课在 Cocos Creator 3.8 中让角色按空格起跳、受重力下落,并在脚底再次接触地面后恢复跳跃资格。重点不是让节点瞬间升高,而是让刚体负责速度和碰撞,用独立的脚底检测区判断是否真正落地。
学习目标
- 为角色配置动态刚体、实体碰撞体与脚底触发器。
- 保留水平速度,只修改竖直速度完成起跳。
- 用进入、离开地面事件限制空中重复跳跃。
搭建可落地的物理场景
先在项目中启用 3D 物理,选用 Bullet、cannon.js 或 PhysX 等支持刚体动力学的后端;builtin 仅做轻量碰撞检测,不适合本例的重力跳跃。场景采用 Y 轴向上,地面放在角色下方。
- 创建
Ground节点,添加BoxCollider,保持Is Trigger关闭;地面不必添加RigidBody。 - 创建
Player节点,添加RigidBody和CapsuleCollider。刚体类型设为DYNAMIC,启用Use Gravity,质量大于 0;胶囊体保持实体碰撞。 - 在
Player下建立FootProbe子节点,添加较扁的BoxCollider,勾选Is Trigger。探针放在胶囊底部,站立时与地面略微重叠,但不要伸到角色腰部。 - 为
Player挂载下面的JumpByRigidBody脚本,将Player的刚体和FootProbe的碰撞体拖到对应属性槽。
若不希望物理碰撞使角色翻倒,将刚体的 Angular Factor 设为 (0, 0, 0)。还要确认碰撞矩阵允许角色、脚底探针与地面交互。

通过速度控制一次起跳
新建 JumpByRigidBody.ts。脚底触发器只承担“是否碰到地面”的检测,胶囊实体碰撞体负责真正挡住地面。示例约定地面碰撞体所在节点名为 Ground,并用集合处理同时踩到多个地面碰撞体的情况。
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('起跳');
}
}预期输出(角色先站在地上,按一次空格,再自然落地):
已落地
起跳
已落地这是事件打印顺序,不是逐帧轨迹;重力大小、起跳高度与落地耗时取决于物理配置。jumpSpeed = 6 只是入门调试值。getLinearVelocity 先读取现有速度,再修改 y,避免把行走时的 x/z 速度清零。
理解接地状态与调试顺序
跳跃许可来自 groundHits 是否非空,而不是检测角色的世界坐标是否等于某个固定高度。脚底区域离开地面时移除对应碰撞体;重新进入时加入集合。按空格后立即清空集合,可以避免同一次落地期间重复按键触发第二次跳跃。
这里的地面识别是为了教学使用的节点名约定,正式项目应改用地面专用组件或碰撞分组,避免误把道具当作地面。地面间有缝隙或高速移动时,也应结合射线、接触法线或短暂的接地宽限时间处理边缘情况。
如果运行后没有跳跃,按顺序检查:控制台有无“未绑定”警告、RigidBody 是否为 DYNAMIC、物理后端能否模拟刚体、探针是否勾选触发器且与 Ground 重叠、碰撞矩阵是否放行。若出现穿地,先检查实体 CapsuleCollider 是否误勾选 Is Trigger。不要在 update 中反复用 setPosition 覆盖动态刚体位置,否则会与物理模拟争夺控制权。
最终验收应是:第一次按键上升、空中连按无效、落地后可以再次起跳,并且落下时实体胶囊体不会穿过地面。