游戏引擎 / 系统课时

拆分玩家、敌人和关卡的职责

拆分玩家、敌人和关卡的职责

当玩家移动、敌人巡逻和碰撞结算全部写在一个 Scene 中时,修改一种行为很容易影响其他功能。本课将这些职责拆成独立模块,让玩家管理输入与移动、敌人管理行为、关卡场景负责创建对象和执行游戏规则,最终完成一个可以直接运行的 Phaser 4 小型关卡。

学习目标

  • 划分 Player、Enemy 和 LevelScene 的职责及依赖关系。
  • 使用 ES Module 封装玩家移动与敌人巡逻行为。
  • 在关卡场景中统一创建对象、调度更新、处理碰撞,并验证场景重启。

明确三个模块的职责边界

假设正在制作一个 800×450 的俯视角关卡:玩家使用方向键移动,敌人在两个端点之间巡逻,碰到敌人后重新开始。可以把功能分成三个模块。

模块 自己负责 不应该负责
Player 读取方向键、计算速度、控制玩家物理体 创建敌人、决定关卡胜负
Enemy 巡逻范围、移动方向、巡逻速度 读取玩家按键、切换关卡
LevelScene 创建角色、注入配置、调用更新、注册碰撞与结算规则 逐帧编写玩家移动和敌人巡逻算法

这里采用组合方式:Player 和 Enemy 是普通 JavaScript 类,内部持有 Phaser 游戏对象;LevelScene 才继承 Phaser.Scene。角色构造函数接收所在 Scene,以便访问对象工厂和 Arcade Physics,但角色不主动调用 scene.restart()。

玩家、敌人与关卡场景的模块职责和调用关系

推荐遵循以下依赖方向:场景知道角色模块,角色模块不需要知道其他角色模块。例如,未来把碰撞后的重启改为扣除一格生命值,只需要修改关卡规则,而不必改变玩家和敌人的移动逻辑。

创建最小可运行工程

示例使用 Phaser 4.2.1、JavaScript ES Module 和 Vite,不需要角色图片素材。玩家和敌人都使用 Phaser 内置矩形对象绘制,避免素材加载干扰模块拆分练习。

在满足当前 Vite Node.js 版本要求的环境中执行:

bash
npm create vite@latest phaser-roles -- --template vanilla
cd phaser-roles
npm install
npm install phaser@4.2.1

预期结果:创建 phaser-roles 工程,根目录包含 index.html、package.json 和 src/main.js,Phaser 4.2.1 被安装到项目依赖中。安装命令应正常结束,具体安装日志与耗时因环境不同而变化。

后续保留 Vite 默认的 index.html,它提供 ID 为 app 的挂载容器。在 src 目录中创建以下三个文件,并替换原有的 src/main.js:

  1. src/Player.js:玩家控制模块。
  2. src/Enemy.js:敌人巡逻模块。
  3. src/LevelScene.js:关卡场景与规则。
  4. src/main.js:Phaser 游戏入口。

这四个文件共同构成一个完整示例。下面单独列出的模块均是需要与其他文件组合运行的片段示例,不能直接使用 Node.js 独立执行。

封装玩家移动与输入

玩家模块只需要知道自己的位置、移动速度和输入状态。把方向键处理放入 Player.update(),可以避免每增加一个关卡,就复制一次移动判断代码。

在 src/Player.js 中写入以下完整模块。

js
export class Player {
  constructor(scene, x, y, speed = 220) {
    this.speed = speed;
    this.view = scene.add.rectangle(x, y, 32, 32, 0x0d9488);
    scene.physics.add.existing(this.view);

    // 俯视角移动不使用重力,角色不能越过世界边界。
    this.view.body.setAllowGravity(false);
    this.view.body.setCollideWorldBounds(true);
    this.cursors = scene.input.keyboard.createCursorKeys();
  }

  update() {
    const { left, right, up, down } = this.cursors;
    const dx = Number(right.isDown) - Number(left.isDown);
    const dy = Number(down.isDown) - Number(up.isDown);

    // 对角线归一化,避免同时按两个方向时移动过快。
    const factor = dx !== 0 && dy !== 0 ? Math.SQRT1_2 : 1;
    this.view.body.setVelocity(
      dx * this.speed * factor,
      dy * this.speed * factor
    );
  }
}

这里的 view 是 Phaser 的 Rectangle 游戏对象,view.body 是通过 scene.physics.add.existing() 创建的 Arcade 动态物理体。颜色值 0x0d9488 只是用于显示玩家,不参与行为判断。

方向计算采用右减左、下减上的方式,得到每个坐标轴上的 -1、0 或 1。不按方向键时,两个值都为零,因此每帧都会把速度恢复为零,不会产生松开按键后继续滑动的问题。

移动速度为每秒 220 像素。如果同时按下右键和下键,需要乘以约 0.7071 的归一化系数;两个方向上的速度各约为 155.6 像素/秒,合成速度仍约为 220 像素/秒。

封装敌人的往返巡逻

敌人的巡逻逻辑可以独立于玩家输入。这里把敌人起点、左右端点和移动速度作为构造参数,由同一个类生成不同巡逻范围的敌人。

在 src/Enemy.js 中写入以下完整模块。

js
export class Enemy {
  constructor(scene, x, y, minX, maxX, speed = 110) {
    this.view = scene.add.rectangle(x, y, 30, 30, 0xf97316);
    scene.physics.add.existing(this.view);
    this.view.body.setAllowGravity(false);

    this.minX = minX;
    this.maxX = maxX;
    this.speed = speed;
    this.direction = 1;
  }

  update() {
    // 到达右端点后向左,到达左端点后向右。
    if (this.view.x >= this.maxX) {
      this.direction = -1;
    } else if (this.view.x <= this.minX) {
      this.direction = 1;
    }

    this.view.body.setVelocityX(this.speed * this.direction);
  }
}

这个模块采用水平巡逻:minX 和 maxX 是世界坐标中的左右端点,direction 的 1 表示向右,-1 表示向左。物理引擎根据速度推进实际位置,update() 只负责判断是否需要反向。

例如,敌人从 x=450 出发,在 minX=300 和 maxX=690 之间以 110 像素/秒巡逻。从起点到右端点的理论移动时间约为 2.18 秒,经过右端点后再到左端点约为 3.55 秒。实际反向位置可能因为帧步长而略微超过端点,这是逐帧阈值判断的正常现象。

这里使用速度驱动物理体,而不是每帧直接写 this.view.x += speed。后一种写法不仅忽略了时间单位,还可能造成显示位置与物理体位置更新顺序不一致。若将来需要精确停在端点,可以在反向时增加位置校正。

在关卡场景中组合与调度

关卡场景需要完成三个任务:根据关卡参数创建角色、每帧调用角色更新、根据角色之间的交互执行游戏规则。当前使用一个常量 LEVEL 保存配置,方便后续拆分到独立关卡配置文件。

在 src/LevelScene.js 中写入以下完整模块。

js
import Phaser from 'phaser';
import { Player } from './Player.js';
import { Enemy } from './Enemy.js';

const LEVEL = {
  player: { x: 90, y: 230, speed: 220 },
  enemy: {
    x: 450,
    y: 230,
    minX: 300,
    maxX: 690,
    speed: 110
  }
};

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

  create() {
    this.cameras.main.setBackgroundColor('#f8fafc');
    this.add.text(16, 16, '方向键移动,碰到敌人重新开始', {
      fontFamily: 'Arial',
      fontSize: '20px',
      color: '#243746'
    });

    const p = LEVEL.player;
    const e = LEVEL.enemy;
    this.player = new Player(this, p.x, p.y, p.speed);
    this.enemy = new Enemy(
      this, e.x, e.y, e.minX, e.maxX, e.speed
    );
    this.finished = false;

    // 碰撞结算属于关卡规则,不放进角色模块。
    this.physics.add.overlap(
      this.player.view,
      this.enemy.view,
      () => {
        if (this.finished) return;
        this.finished = true;
        this.scene.restart();
      }
    );

    // 重启或停止场景时清除普通对象的引用。
    this.events.once(Phaser.Scenes.Events.SHUTDOWN, () => {
      this.player = null;
      this.enemy = null;
    });
  }

  update() {
    if (this.finished) return;
    this.player.update();
    this.enemy.update();
  }
}

create() 负责一次性创建对象和注册碰撞关系,update() 只做角色更新调度。这样 LevelScene 不需要知道方向键怎样变成速度,也不需要知道敌人在哪个位置转向。

碰撞检测使用 this.physics.add.overlap(),只判断物理体是否重叠,不执行物理分离。回调中的 finished 标志用于阻止一次接触导致重复结算。调用 scene.restart() 后,Phaser 会关闭当前场景并重新启动它,重新创建玩家、敌人及本次关卡状态。

此处没有把角色实例放入全局变量。Scene 停止时,Phaser 会清理场景管理的显示对象及相关资源;SHUTDOWN 回调用来清空自定义的角色引用。如果以后订阅全局事件总线,仍需在场景关闭时主动取消对应订阅。

最后将 src/main.js 替换为游戏入口代码。

js
import Phaser from 'phaser';
import { LevelScene } from './LevelScene.js';

new Phaser.Game({
  type: Phaser.AUTO,
  parent: 'app',
  width: 800,
  height: 450,
  physics: {
    default: 'arcade',
    arcade: {
      gravity: { y: 0 },
      debug: false
    }
  },
  scene: [LevelScene]
});

这段入口配置指定了 800×450 的游戏画面、零重力的 Arcade Physics,以及唯一的 LevelScene。它依赖 Vite 默认页面中的 app 容器和前面三个模块,四个文件保存完整后才能运行。

运行验证与典型错误

在项目根目录启动开发服务器。

bash
npm run dev

预期结果:Vite 在终端提供本地访问地址,通常类似 http://localhost:<PORT>/。其中 <PORT> 是实际使用的端口,可能因端口占用而变化。使用浏览器打开终端给出的地址,应看到浅色背景、青绿色玩家方块、橙色敌人方块和操作提示文字。

按以下顺序验收模块行为:

  1. 玩家移动:按方向键,青绿色方块向对应方向移动;松开按键后停止。按住两个相邻方向键时,移动合速度应与单方向基本一致。
  2. 敌人巡逻:不操作玩家,橙色方块也会独立向右移动,到达约 x=690 时折返,到达约 x=300 时再次折返。
  3. 碰撞重启:控制玩家碰到敌人,两个角色都重新回到配置中的出生位置;玩家为 (90,230),敌人为 (450,230)。
  4. 配置隔离:把 LEVEL.enemy.speed 从 110 改为 160,保存后观察敌人巡逻变快,玩家操作和速度不受影响。

如果运行时出现异常,先检查下面几种常见情况。

现象 可能原因 修正方法
Cannot read properties of undefined,涉及 physics 入口没有启用 Arcade Physics 检查 physics.default: 'arcade'
画面正常但玩家不动 没调用玩家模块的 update() 检查 LevelScene.update() 的调度
提示找不到模块 文件名或导入路径不一致 对照 ./Player.js 和 ./Enemy.js,注意大小写
碰到敌人没有重启 没给对象创建物理体或未注册 overlap 检查两个构造函数的 physics.add.existing() 与碰撞注册
场景反复启动后事件执行多次 自定义外部事件监听没有解绑 在 SHUTDOWN 阶段移除自行注册的外部监听器

还可以进行一次职责隔离检查:修改 Enemy.update() 的反向条件,只应该影响敌人;修改 Player.update() 的按键映射,只应该影响玩家;修改碰撞后的结算规则,只应该改动 LevelScene。如果某项修改需要同时改动三个模块,说明职责边界可能仍然存在耦合。

当关卡数量增加时,可以继续把 LEVEL 移入独立配置模块,并让多个场景或关卡实例复用 Player 和 Enemy。需要持久化的生命、分数和关卡进度则应由专门的共享状态或存档模块管理,不应依赖角色对象在 scene.restart() 后继续存在。

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

目录与阅读设置

阅读设置

17

记录一个想法

拆分玩家、敌人和关卡的职责

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

登录哪都通