游戏引擎 / 系统课时

用 Collider 阻挡墙体和平台

用 Collider 阻挡墙体和平台

角色与墙体同屏出现,并不意味着物理系统会自动阻挡。本课以 Phaser 4.2.1 建立动态角色、静态地面与墙体之间的 Collider,做出可移动、可跳跃的碰撞演示,并学会区分碰撞回调、视觉外形和实际刚体边界。

学习目标

  • 正确创建动态刚体、静态刚体,并用 Collider 实现阻挡。
  • 知道碰撞回调何时执行,以及 collider 与 overlap 的区别。
  • 使用调试边框、setSize 和接地方向检查碰撞是否正确。

Collider 如何让角色停在平台上

Arcade Physics 只对拥有物理刚体(Body)的对象做碰撞检测。角色需要受重力和速度影响,使用动态 Body;墙体、地面与固定平台不应被推走,使用静态 StaticBody。仅把矩形画在画布上,双方仍然可以穿过彼此。

this.physics.add.collider(a, b) 会注册持续检查:每个物理步检测双方刚体是否相交,必要时分离并调整运动状态。如果只检测接触而不阻挡,例如拾取金币,应使用 this.physics.add.overlap(a, b)。Collider 的第三个参数可以接收碰撞回调,但不传回调也会产生阻挡。

动态角色与静态墙体、平台的碰撞关系及可视区域和刚体边界对比

搭建可运行的阻挡场景

准备 Node.js 和 npm。以下以 Vite 的 Vanilla JavaScript 模板作为最小工程,不依赖图片素材;地面、墙体与角色都用矩形绘制。终端依次执行:

bash
npm create vite@latest collider-demo -- --template vanilla
cd collider-demo
npm install
npm install phaser@4.2.1
npm run dev

预期输出(节选,端口可能不同):

text
Local: http://localhost:<PORT>/

<PORT> 是开发服务器分配的端口,以终端实际地址为准。将工程中的 src/main.js 完整替换为以下代码;模板自带的 index.html 已有 id="app" 的挂载元素,无需准备额外素材。

js
import Phaser from 'phaser';

class CollisionScene extends Phaser.Scene {
  constructor() {
    super('CollisionScene');
  }

  create() {
    this.add.text(16, 12, '← → 移动,↑ 跳跃', {
      fontSize: '18px', color: '#1f2937'
    });
    this.status = this.add.text(16, 42, '最近碰撞:无', {
      fontSize: '16px', color: '#0f766e'
    });

    this.player = this.add.rectangle(130, 180, 40, 56, 0x0d9488);
    this.physics.add.existing(this.player);
    // 角色视觉为 40×56,碰撞框缩到 32×52 并居中
    this.player.body.setSize(32, 52);
    this.player.body.setCollideWorldBounds(true);

    const floor = this.add.rectangle(400, 570, 800, 60, 0x64748b);
    const platform = this.add.rectangle(280, 420, 220, 24, 0x64748b);
    const wall = this.add.rectangle(640, 460, 28, 160, 0xf59e0b);
    const obstacles = [floor, platform, wall];

    // 固定地形采用静态刚体,不受重力及碰撞推挤
    for (const obstacle of obstacles) {
      this.physics.add.existing(obstacle, true);
      obstacle.body.updateFromGameObject();
    }

    this.physics.add.collider(this.player, obstacles, (player, obstacle) => {
      const label = obstacle === wall ? '墙体' :
        obstacle === platform ? '高台' : '地面';
      // 持续接触会重复回调,这里只更新提示,不反复扣血
      this.status.setText(`最近碰撞:${label}`);
    });

    this.cursors = this.input.keyboard.createCursorKeys();
  }

  update() {
    const body = this.player.body;
    body.setVelocityX(this.cursors.left.isDown ? -190 :
      this.cursors.right.isDown ? 190 : 0);

    if (Phaser.Input.Keyboard.JustDown(this.cursors.up) &&
        body.blocked.down) {
      body.setVelocityY(-520);
    }
  }
}

new Phaser.Game({
  type: Phaser.AUTO,
  parent: 'app',
  width: 800,
  height: 600,
  backgroundColor: '#f8fafc',
  physics: {
    default: 'arcade',
    arcade: { gravity: { x: 0, y: 900 }, debug: true }
  },
  scene: CollisionScene
});

预期结果:打开开发服务器地址,青绿色角色自动落到灰色地面;用左右方向键以 190 像素/秒移动,按上方向键在着地时跳跃。跳到左侧高台后可站稳,走到右侧橙色墙体前会被挡住。左上角的“最近碰撞”会在接触对象变化时更新,调试线框显示实际物理范围。

分清碰撞回调与接触方向

collider 的回调参数是参与碰撞的两个游戏对象,示例通过第二个对象识别地面、高台或墙体。它不是“首次接触事件”:角色停在平台上时,回调可能连续多次触发,因此不能直接在其中每次扣除生命值。需要一次性触发效果时,应自行记录上一帧的接触状态并检测从未接触到接触的变化。

本例用 body.blocked.down 判断角色是否被静态地形或世界边界向下阻挡,只有此时按下上方向键才允许跳跃。body.touching 提供当前物理步的接触方向,body.wasTouching 保存上一步的信息;它们都不是碰撞回调次数。不要把视觉上“脚碰到平台”当成着地条件,也不要只看 player.y 判断。

对齐刚体并排查穿墙

物理检测依据 Body 的矩形,不依据绘制颜色或透明区域。示例中的角色显示范围为 40×56,但 setSize(32, 52) 将物理框设得更窄、更矮;打开 debug: true 后,应该能看到线框与角色边缘之间的空隙。这说明碰撞回调正确触发,也不代表两张可见图形的边缘恰好贴合。

遇到异常时按下列顺序检查:

  1. 角色穿过平台:确认双方调用过 physics.add.existing,并且调用的是 physics.add.collider,不是 overlap;静态物体应传入 true。
  2. 角色悬空或陷入边缘:检查 body.setSize(width, height) 与 body.setOffset(x, y),对照调试线框修正,而不是盲目改角色坐标。
  3. 移动平台后挡板仍在原处:静态 Body 不会随游戏对象的位置、缩放自动同步。修改后调用该对象的 body.updateFromGameObject();会持续移动的平台通常应另选合适的动态刚体方案。
  4. 接触后回调刷屏:这是持续碰撞检测的正常结果。只在状态切换时播放音效、扣血或生成粒子,不要把每次回调当成一次新撞击。

最后进行三次验收:角色自由落下时被地面接住;水平移动时在墙体外侧停止;从地面跳上高台后不会穿透,并且调试线框与预期的碰撞区域一致。完成这些检查后,再把 debug 改为 false 用于正常游戏画面。

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

目录与阅读设置

阅读设置

17

记录一个想法

用 Collider 阻挡墙体和平台

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

登录哪都通