游戏引擎 / 系统课时

处理碰撞回调与伤害

处理碰撞回调与伤害

子弹碰到敌人后,物理系统只负责报告接触,不会自动决定扣多少血、怎样击退或何时销毁对象。本课使用 Cocos Creator 3.8 的二维物理系统,将首次碰撞事件转换为扣血、击退与对象清理规则,并解决重复命中的问题。

学习目标

  • 理解二维碰撞回调的触发条件与事件参数。
  • 使用 Contact2DType.BEGIN_CONTACT 实现扣血和击退。
  • 正确处理重复命中、节点销毁与事件退订。

搭建可触发碰撞的场景

先建立一个最小战斗场景:子弹从左侧向右飞行,接触敌人后造成 10 点伤害。敌人初始生命为 30,连续命中三次后销毁。

本例使用 Box2D 二维物理后端。进入项目设置的功能裁剪页面,确认启用了二维 Box2D 物理模块。不要将本课使用的 Collider2D、RigidBody2D 与三维物理组件混用。

在场景中准备两个节点:

  1. 创建 Enemy 节点,添加 Sprite、RigidBody2D 和 BoxCollider2D。刚体类型设为 Dynamic,GravityScale 设为 0,FixedRotation 开启,LinearDamping 可设为 4,碰撞体的 Sensor 关闭。
  2. 创建 Bullet 节点,添加 Sprite、RigidBody2D 和 CircleCollider2D。刚体类型设为 Dynamic,GravityScale 设为 0,初始 LinearVelocity 可设为 (240, 0),表示向右飞行。
  3. 将子弹碰撞体的 Tag 设为 7,开启 Sensor。这样接触会产生回调,但子弹不会依靠物理碰撞响应推动敌人。
  4. 将子弹放在敌人左侧,调整碰撞体大小,使两者运动路径相交,并确认碰撞矩阵允许它们接触。

敌人的刚体需要启用 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 节点。脚本读取同节点的刚体和碰撞体,在启用时订阅事件,并在停用时退订。

ts
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 的敌人,控制台依次显示:

text
敌人剩余生命:20
敌人剩余生命:10
敌人剩余生命:0

预期可见结果是:每次命中后子弹消失,敌人受到水平方向的击退;第三次命中后敌人节点被销毁。击退的实际距离取决于刚体质量、阻尼及其他物理条件,不能仅凭冲量数值直接推断位移。

代码中的三个设计点尤其重要。

首先,使用 Math.max(0, ...) 限制生命下界,避免生命值变成负数。生命已经归零时直接退出,不再重复执行伤害逻辑。

其次,使用 hitIds 记录已经命中的子弹节点标识,防止同一子弹因多个接触形状等情况对当前敌人重复扣血。这里的判重范围仅限单个敌人;如果设计要求一颗子弹最多命中一个敌人,还需要在子弹自身维护已消耗状态。

最后,使用 scheduleOnce() 延后销毁。物理回调发生在物理求解过程中,不应在其中反复创建、移除或重建大量物理组件。destroy() 本身也存在延迟销毁语义,后续访问节点前应检查有效性。

验证与排查异常

按以下顺序检查功能:

  1. 单颗子弹命中:敌人生命从 30 变为 20,子弹被销毁。
  2. 连续三颗子弹命中:生命依次变为 20、10、0,敌人死亡后不再处理伤害。
  3. 将子弹碰撞体的 Tag 改成其他数字:应不再产生扣血结果。
  4. 禁用敌人上的伤害脚本:再次启用后应恢复监听,不因重复注册而多次扣血。

如果完全没有输出,优先检查二维物理后端、碰撞矩阵、碰撞体是否重叠、刚体类型以及接触监听是否启用。特别注意,本例使用的是 Collider2D 的接触回调,不是三维 Collider 的触发事件。

如果生命值正确下降但没有明显击退,检查敌人是否为 Dynamic 刚体,是否冻结了位置,以及密度、阻尼是否过大。applyLinearImpulseToCenter() 适用于动态刚体,不应依靠直接修改节点位置来模拟真实受力。

如果采用对象池复用敌人,需要在对象重新投入使用时重置生命、命中记录及死亡状态,不能只重新激活节点。持续伤害区域则应另外设计接触期间的计时机制,而不是让 BEGIN_CONTACT 每帧扣血。

完成这套规则后,碰撞检测、伤害计算、物理击退和生命周期清理就形成了清晰的边界。后续加入护盾、暴击、阵营过滤或受击动画时,可以继续扩展业务判定,而不必改变底层接触事件的使用方式。

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

目录与阅读设置

阅读设置

17

记录一个想法

处理碰撞回调与伤害

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

登录哪都通