组件化的游戏对象
库对外导出 `Game`、`Scene`、`Container`、`Text`、`Rectangle` 等组件,分别对应引擎中的游戏实例、场景、容器与常用显示对象。
phavuer · laineus/phavuer
Phavuer 是一个将 Phaser 4 与 Vue 3 集成的封装库,让开发者通过 Vue 组件以声明式渲染的方式控制 Phaser 游戏引擎,例如在模板中用 Game、Scene、Text、Rectangle 等组件组织游戏内容。仓库语言标注为 Vue,主题标签包含 game-engine、...
Phavuer 是一个面向 Web 游戏开发的封装库(wrapper library),作用是把 Phaser 与 Vue 3 连接起来。它并没有重新实现一套引擎,而是在 Phaser 之上提供一层 Vue 组件接口,让开发者可以用 Vue 的模板语法去描述 Phaser 的显示对象与场景结构,把游戏内容的组织方式从命令式调用转为声明式渲染。
换句话说,原本需要 new Phaser.Game(...)、逐个创建 Text、Rectangle、Container 并手动管理生命周期的代码,可以改写成一段嵌套的 Vue 模板,由库负责把组件树映射到引擎对象树上。README 中的定位描述为“seamlessly combining”,强调这是一层薄而顺滑的集成,而不是替代品。
需要说明的是,仓库的 GitHub 简短描述里出现过 Phaser 3 的表述,而 README 顶部徽章与正文明确标注 Phaser 4.x + Vue 3.x。实际使用时建议以官方文档站点的版本说明为准。
库对外导出 `Game`、`Scene`、`Container`、`Text`、`Rectangle` 等组件,分别对应引擎中的游戏实例、场景、容器与常用显示对象。
示例中用 `v-for="(n, i) in count"` 遍历一个 `ref` 计数来批量生成 `Container`,说明视图会随响应式数据的变化而更新。
`<Text text="Add a Rectangle" @pointerdown="onClick" />` 展示了把 Phaser 的指针交互绑定到普通 Vue 方法上的写法。
`x`、`y`、`width`、`height`、`origin`、`fill-color`、`text`、`name` 等写在模板属性上,直接对应引擎对象的配置项,语义直观。
示例中 `<MyCustomComponent />` 被放进 `Container` 内部,意味着业务代码可以自行拆分封装成 `.vue` 文件并复用。
示例整体使用 `<script setup>` 与 `ref` 编写,符合 Vue 3 的现代写法习惯。
Phavuer 的核心思路是“场景树即组件树”。示例里 Game 包住 Scene,Scene 里放 Text 与 Container,Container 里再放 Rectangle、Text 和自定义组件,这种嵌套关系与 Phaser 的显示列表层级保持一致,因此开发者可以用阅读 DOM 结构的方式去理解游戏画面结构。
声明式带来的另一个直接收益是状态驱动:示例中点击文本后 count.value++,列表即增加一组矩形与文字,无需手写增删对象的逻辑。这正是 README 所说的“through declarative rendering”的含义。
另外,README 的示例对比项提到了一份“Phavuer vs Phaser's plane API”的 CodePen,用同一个样例 UI 分别用原生 Phaser 写法和 Phavuer 写法实现,是最直观理解这层封装价值的方式。至于内部实现(虚拟节点如何映射为引擎对象、更新粒度如何控制),README 未展开,属于待核验内容。
README 明确列出的资料入口包括:
phavuer-example(简易射击示例)、phavuer-rpg-example(RPG 风格示例)libra(“The Dream Libra had”,少女在濒死梦境世界中游走的 RPG)、letter-to-neml(AI 阅读玩家信件并分叉剧情的短篇 ADV)、succubus-club(由 @thomasWajs 制作,在浏览器中玩“Vampire: The Eternal Struggle”卡牌游戏)这些作品分别覆盖了 RPG、文字冒险与卡牌三类形态,可作为评估该库适用范围的实际参考。包的安装方式 README 未给出步骤,仅通过 npm 徽章表明已发布为 phavuer 包,具体引入方式请以文档站点为准。
README 提供了 Discord 服务器邀请链接(https://discord.gg/W9xJNWQZQv),用于提问与交流。项目采用开源许可证,徽章指向仓库内的 LICENSE 文件。
Phavuer 介于“引擎”与“前端框架”之间,学习路径建议分两步走:先补齐 Phaser 的基础概念——Game 实例、Scene 生命周期、显示对象与容器、指针事件;再回到 Vue 3 一侧,熟悉 <script setup>、ref、v-for 与自定义组件注册。两边都熟悉之后,README 里的那段示例几乎可以对照着读通。
上手顺序上,可以先跑官方 CodePen 对比样例感受两种写法的差异,再从 phavuer-example(射击)过渡到 phavuer-rpg-example(RPG),最后参考真实游戏项目理解工程组织方式。若目标是把已有 Phaser 项目迁移过来,建议先小范围替换某个场景内的 UI 层,而非一次性重写。
本页信息基于仓库 README 与公开描述整理,示例之外的 API 细节、体积与运行表现尚未实测,请以官方文档与仓库最新提交为准。
该仓库为 Java 语言项目,名称 BuildGDX 由「Build」与「GDX」组合,推测与 B...
id Software 以 GPL 许可证发布的《雷神之锤3竞技场》(Quake III Arena)源...
NBlood 是用 EDuke32 引擎技术与开发思路对 Build 引擎游戏所做的逆向工程移...
Frogatto & Friends 是一款 2D 横版动作冒险游戏,主角是一只青蛙;开发团队...