游戏引擎 / 系统课时

排查角色穿墙和碰撞失效

排查角色穿墙和碰撞失效

穿墙可能来自形状没参与检测,也可能来自直接改位置、高速离散步进或不合适的刚体类型。本节先显示真实物理轮廓,再用最小场景区分“完全没有接触”和“高速时偶发漏检”。

学习目标

  • 通过调试形状检查实际参与检测的对象
  • 按后端、分组和运动方式缩小故障范围
  • 评估固定步长与 bullet 的作用和成本

保留能复现的最小组合

复制问题场景,只保留 Player、一面足够厚的静态墙、相机和必要控制脚本。记录 Creator 版本、2D 后端、刚体类型、分组、速度、墙厚与异常时的帧时长。先关闭位置动画和多余控制器,保证只有物理系统推进 Player。

没有形状时查 Collider2D 是否启用、节点是否激活、碰撞器尺寸是否为零以及图片与碰撞器是否位于不同父节点。有形状却没有接触时查分组矩阵和刚体配对条件。sensor 会通知接触但不阻挡,不能靠添加更多事件监听把它变成墙。

开启并恢复调试绘制

保存 PhysicsDebugProbe.ts,挂到临时调试节点。项目选择 Box2D,场景含动态 Player 和静态 Wall;Player 上的 RigidBody2D 开启接触监听,另用日志确认接触是否发生。本例只控制调试显示,不修改全局步长或速度。

ts
import { _decorator, Component, PhysicsSystem2D, EPhysics2DDrawFlags } from 'cc';
const { ccclass } = _decorator;

@ccclass('PhysicsDebugProbe')
export class PhysicsDebugProbe extends Component {
    private previous = 0;
    onEnable(): void {
        const physics = PhysicsSystem2D.instance;
        this.previous = physics.debugDrawFlags;
        physics.debugDrawFlags = EPhysics2DDrawFlags.Shape | EPhysics2DDrawFlags.Aabb;
        // 查看实际形状,不用 Sprite 外观猜测碰撞范围
        console.log('physics-step:' + physics.fixedTimeStep.toFixed(4));
    }
    onDisable(): void {
        // 临时诊断退出后恢复原设置
        PhysicsSystem2D.instance.debugDrawFlags = this.previous;
    }
}

预期结果:支持调试绘制的预览中出现碰撞形状与包围盒线框,日志显示当前固定步长。常见 1/60 秒设置会显示约 physics-step:0.0167,实际输出以项目配置为准;没有预先指定步长时不能硬性要求这个数值。

穿墙问题的分阶段诊断

根据速度改变复现条件

若低速稳定、高速穿墙,比较一个物理步长内的移动距离与墙厚,逐步降速、加厚墙体并记录结果。直接设置 position 的瞬移可能跨过整面墙,求解器没有机会沿途检测;应先修正运动入口,而不是只降低渲染帧率。

Box2D 的 bullet 选项面向高速动态刚体与其他运动刚体的连续检测,成本更高,且不是所有后端、类型和运动方式都适用。静态与运动学障碍的连续检测规则另有约束,不能把 bullet 解释成任意瞬移都不会穿墙的万能开关。只为实际需要的少量高速对象启用,并重新测试接触与性能。

减小固定时间步长可能增加求解次数,最大子步数则限制卡顿后追赶的工作量;二者须结合目标设备预算设置。不要在一个脚本里手动 step,又让系统自动模拟,导致重复推进。改变设置后用同一速度、墙厚和输入重跑,证明问题是否真正减少。

最后检查碰撞回调中是否直接销毁或修改物理结构,导致锁定期异常后逻辑中断。调试线框、接触日志、最终位置三者应一致;只看到事件日志并不能证明角色被正确阻挡。

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

目录与阅读设置

阅读设置

17

记录一个想法

排查角色穿墙和碰撞失效

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

登录哪都通