SuperAPI AI 工具集

phaser

通用与其它

查看项目

更新于 10-16 08:06

技能介绍

用途:该资料是使用 Phaser 3 构建 2D 浏览器游戏的开发规范,面向通过 game-creator 插件创建或扩展游戏的项目,要求产出结构清晰、可维护且视觉打磨过的游戏。

主要能力与约定:核心循环优先(boot→preload→create→update),先实现最小玩法、胜负与计分,再考虑视觉和音效;TypeScript 优先;每个游戏画面为一个 Scene;使用官方 Vite + TypeScript 模板;组合优于继承;数据驱动设计;跨场景通信必须走 EventBus;游戏需可安全重启,GameState.reset() 恢复干净状态。所有玩家操作与游戏事件需发出 Spectacle 事件(entrance、action、hit、combo、streak、near_miss)。物理可选 Arcade Physics 或 Matter.js,不可混用。性能上要求纹理图集、对象池、按 delta 计算移动、避免深层容器嵌套。

使用方式:以 npx degit phaserjs/template-vite-ts my-game 初始化,目录包含 core(EventBus、GameState、Constants)、scenes、objects、systems、ui、audio 等。默认无标题页、无独立计分 HUD,适配 Play.fun 安全区,移动端需提供可见触控按钮,交互实体需满足最小尺寸要求。

限制与注意事项:避免在 update 中无池化创建对象、硬编码数值、场景间直接引用、未在 shutdown() 清理监听器,以及把交互对象设为透明后叠加图形导致按钮失效等反模式。开发完成后需通过重启、输入、构建、控制台无报错等验收检查。