游戏引擎 / 系统课时
处理碰撞回调与伤害
处理碰撞回调与伤害
子弹碰到敌人后,物理系统只负责报告接触,不会自动决定扣多少血、怎样击退或何时销毁对象。本课使用 Cocos Creator 3.8 的二维物理系统,将首次碰撞事件转换为扣血、击退与对象清理规则,并解决重复命中的问题。
学习目标
- 理解二维碰撞回调的触发条件与事件参数。
- 使用
Contact2DType.BEGIN_CONTACT实现扣血和击退。 - 正确处理重复命中、节点销毁与事件退订。
搭建可触发碰撞的场景
先建立一个最小战斗场景:子弹从左侧向右飞行,接触敌人后造成 10 点伤害。敌人初始生命为 30,连续命中三次后销毁。
本例使用 Box2D 二维物理后端。进入项目设置的功能裁剪页面,确认启用了二维 Box2D 物理模块。不要将本课使用的 Collider2D、RigidBody2D 与三维物理组件混用。
在场景中准备两个节点:
- 创建
Enemy节点,添加Sprite、RigidBody2D和BoxCollider2D。刚体类型设为Dynamic,GravityScale设为 0,FixedRotation开启,LinearDamping可设为 4,碰撞体的Sensor关闭。 - 创建
Bullet节点,添加Sprite、RigidBody2D和CircleCollider2D。刚体类型设为Dynamic,GravityScale设为 0,初始LinearVelocity可设为(240, 0),表示向右飞行。 - 将子弹碰撞体的
Tag设为 7,开启Sensor。这样接触会产生回调,但子弹不会依靠物理碰撞响应推动敌人。 - 将子弹放在敌人左侧,调整碰撞体大小,使两者运动路径相交,并确认碰撞矩阵允许它们接触。
敌人的刚体需要启用 EnabledContactListener,才能接收对应的二维接触回调。后面的脚本也会主动设置这一属性。
从接触事件到伤害规则
Cocos Creator 3.8 使用 Collider2D.on() 注册二维接触事件。最常用的两个事件是:
Contact2DType.BEGIN_CONTACT:两个碰撞体开始接触时触发,适合单次命中、拾取或进入区域。Contact2DType.END_CONTACT:两个碰撞体结束接触时触发,适合离开区域、恢复状态或清理接触记录。
Box2D 还支持 PRE_SOLVE 和 POST_SOLVE,但它们可能在连续接触期间反复触发,不适合直接作为单次扣血入口。
碰撞回调会提供 selfCollider、otherCollider 和 contact。前两者分别表示自身与对方碰撞体,contact 包含接触相关信息。只判断敌人是否受到子弹攻击时,通过 otherCollider.tag 识别子弹即可,不需要计算复杂的接触点。

这里有一条重要边界:物理事件只负责提供事实,伤害系统负责决定结果。 即使两个对象发生接触,也可能因为阵营、无敌状态、攻击类型或重复命中而不产生伤害。
实现扣血、击退与清理
创建 TypeScript 脚本 EnemyDamage.ts,挂载到 Enemy 节点。脚本读取同节点的刚体和碰撞体,在启用时订阅事件,并在停用时退订。
import {
_decorator,
Component,
Collider2D,
Contact2DType,
RigidBody2D,
Vec2,
isValid,
} from 'cc';
const { ccclass, property } = _decorator;
@ccclass('EnemyDamage')
export class EnemyDamage extends Component {
@property
maxHp = 30;
private hp = 0;
private collider: Collider2D | null = null;
private body: RigidBody2D | null = null;
private hitIds = new Set<string>();
onLoad() {
this.hp = this.maxHp;
this.collider = this.getComponent(Collider2D);
this.body = this.getComponent(RigidBody2D);
if (!this.collider || !this.body) {
console.error('EnemyDamage 需要 Collider2D 和 RigidBody2D');
return;
}
// 开启刚体的接触事件监听。
this.body.enabledContactListener = true;
}
onEnable() {
this.collider?.on(
Contact2DType.BEGIN_CONTACT,
this.onContact,
this
);
}
onDisable() {
this.collider?.off(
Contact2DType.BEGIN_CONTACT,
this.onContact,
this
);
this.hitIds.clear();
}
private onContact(_self: Collider2D, other: Collider2D) {
if (!this.body || other.tag !== 7 || this.hp <= 0) {
return;
}
const bullet = other.node;
// 同一子弹对当前敌人只结算一次。
if (this.hitIds.has(bullet.uuid)) {
return;
}
this.hitIds.add(bullet.uuid);
this.hp = Math.max(0, this.hp - 10);
console.log(`敌人剩余生命:${this.hp}`);
// 根据子弹和敌人的相对位置决定水平击退方向。
const right = this.node.worldPosition.x >= bullet.worldPosition.x;
this.body.applyLinearImpulseToCenter(
new Vec2(right ? 8 : -8, 0),
true
);
// 延后销毁,避免在接触回调中直接修改物理对象。
this.scheduleOnce(() => {
if (isValid(bullet)) {
bullet.destroy();
}
if (this.hp === 0 && isValid(this.node)) {
this.node.destroy();
}
}, 0);
}
}预期输出:让三个独立子弹依次命中初始生命为 30 的敌人,控制台依次显示:
敌人剩余生命:20
敌人剩余生命:10
敌人剩余生命:0预期可见结果是:每次命中后子弹消失,敌人受到水平方向的击退;第三次命中后敌人节点被销毁。击退的实际距离取决于刚体质量、阻尼及其他物理条件,不能仅凭冲量数值直接推断位移。
代码中的三个设计点尤其重要。
首先,使用 Math.max(0, ...) 限制生命下界,避免生命值变成负数。生命已经归零时直接退出,不再重复执行伤害逻辑。
其次,使用 hitIds 记录已经命中的子弹节点标识,防止同一子弹因多个接触形状等情况对当前敌人重复扣血。这里的判重范围仅限单个敌人;如果设计要求一颗子弹最多命中一个敌人,还需要在子弹自身维护已消耗状态。
最后,使用 scheduleOnce() 延后销毁。物理回调发生在物理求解过程中,不应在其中反复创建、移除或重建大量物理组件。destroy() 本身也存在延迟销毁语义,后续访问节点前应检查有效性。
验证与排查异常
按以下顺序检查功能:
- 单颗子弹命中:敌人生命从 30 变为 20,子弹被销毁。
- 连续三颗子弹命中:生命依次变为 20、10、0,敌人死亡后不再处理伤害。
- 将子弹碰撞体的
Tag改成其他数字:应不再产生扣血结果。 - 禁用敌人上的伤害脚本:再次启用后应恢复监听,不因重复注册而多次扣血。
如果完全没有输出,优先检查二维物理后端、碰撞矩阵、碰撞体是否重叠、刚体类型以及接触监听是否启用。特别注意,本例使用的是 Collider2D 的接触回调,不是三维 Collider 的触发事件。
如果生命值正确下降但没有明显击退,检查敌人是否为 Dynamic 刚体,是否冻结了位置,以及密度、阻尼是否过大。applyLinearImpulseToCenter() 适用于动态刚体,不应依靠直接修改节点位置来模拟真实受力。
如果采用对象池复用敌人,需要在对象重新投入使用时重置生命、命中记录及死亡状态,不能只重新激活节点。持续伤害区域则应另外设计接触期间的计时机制,而不是让 BEGIN_CONTACT 每帧扣血。
完成这套规则后,碰撞检测、伤害计算、物理击退和生命周期清理就形成了清晰的边界。后续加入护盾、暴击、阵营过滤或受击动画时,可以继续扩展业务判定,而不必改变底层接触事件的使用方式。