游戏引擎 / 系统课时
拆分玩家、敌人和关卡的职责
拆分玩家、敌人和关卡的职责
当玩家移动、敌人巡逻和碰撞结算全部写在一个 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 版本要求的环境中执行:
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:
src/Player.js:玩家控制模块。src/Enemy.js:敌人巡逻模块。src/LevelScene.js:关卡场景与规则。src/main.js:Phaser 游戏入口。
这四个文件共同构成一个完整示例。下面单独列出的模块均是需要与其他文件组合运行的片段示例,不能直接使用 Node.js 独立执行。
封装玩家移动与输入
玩家模块只需要知道自己的位置、移动速度和输入状态。把方向键处理放入 Player.update(),可以避免每增加一个关卡,就复制一次移动判断代码。
在 src/Player.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 中写入以下完整模块。
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 中写入以下完整模块。
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 替换为游戏入口代码。
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 容器和前面三个模块,四个文件保存完整后才能运行。
运行验证与典型错误
在项目根目录启动开发服务器。
npm run dev预期结果:Vite 在终端提供本地访问地址,通常类似 http://localhost:<PORT>/。其中 <PORT> 是实际使用的端口,可能因端口占用而变化。使用浏览器打开终端给出的地址,应看到浅色背景、青绿色玩家方块、橙色敌人方块和操作提示文字。
按以下顺序验收模块行为:
- 玩家移动:按方向键,青绿色方块向对应方向移动;松开按键后停止。按住两个相邻方向键时,移动合速度应与单方向基本一致。
- 敌人巡逻:不操作玩家,橙色方块也会独立向右移动,到达约
x=690时折返,到达约x=300时再次折返。 - 碰撞重启:控制玩家碰到敌人,两个角色都重新回到配置中的出生位置;玩家为
(90,230),敌人为(450,230)。 - 配置隔离:把
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() 后继续存在。