用途
Bevy Party 是一个面向 Bevy 0.20 的“薄路由”技能,用于本地派对游戏(local party game)的小游戏切换与共享计分。它把本地座位、共享计分板和当前小游戏都视为普通 ECS 数据,本身不实现完整的游戏逻辑,而是把领域工作交给关联的 Bevy 技能。
主要能力
- 本地座位:用
LocalSeat组件保存每个座位的index与score,通过Query读取和修改。 - 共享计分板:用
PartyBoard资源保存active(当前活跃座位)、round(回合数)和award_pending(待结算标记)。计分通过award_pending标志一次性结算,避免每帧重复加分。 - 小游戏切换:用
CurrentMinigame资源保存当前小游戏模式(如 Hub、Race、Score),通过按键触发切换。 - 回合推进:在计分模式结束时递增
round、轮换active座位、重置award_pending并返回 Hub。 - 座位加入:通过按键为本地玩家生成新的
LocalSeat,最多 4 个座位。
使用方式
依赖 Bevy 0.20:
[dependencies]
bevy = "0.20"
核心 ECS 结构包括:
- Components 保存每个实体的标志数据,本文件不命名新的引擎类型。
- Resources 保存运行期计数器(分数、波次索引、种子),通过 bevy-data-resources 管理。
- Systems 在
Update或来自 bevy-master 的固定时间步上读取这些组件;当后续系统需要看到结果时用.chain()排序。 - Schedule:游戏模式变更通过 bevy-state-machines 处理;本文件只注册座位分数和小游戏切换。
示例代码展示了 ScorePlugin、MinigamePlugin 和 JoinPlugin 的注册方式,以及 award、open_race、advance_round、join_seat 等系统。
适用场景
- 需要本地座位(local seats)的派对游戏。
- 需要共享计分板(shared board)的多人小游戏合集。
- 需要在多个小游戏之间轮换(minigame swaps)的场景。
限制
- 本技能是薄路由层,不拥有第二套实现;模式状态机、输入设备、计时回合分别交给 bevy-state-machines、bevy-input-handling、bevy-game-loop-time-trial。
- 不在此处发明物理、导航、网络或 XR crate;只使用有文档的 Bevy crate 和模块。
- 不要在两个无序系统中可变查询同一组件;除非用
.chain()排序,否则调度会并行运行系统。 - 不要在文档 URL 中固定
/0.20.0/;链接保持在latest,0.20 目标只在正文中说明一次。 - 不要每帧给座位加分;计分板标志结算一次后清除。
关联技能
- 前置:bevy-master(ECS 所有权与调度)、bevy-ecs-composition(生成与查询形态)。
- 补充:bevy-state-machines(小游戏模式)、bevy-input-handling(本地设备,含手柄)、bevy-game-loop-time-trial(计时小游戏)。
- 下游/消费者:无。
官方文档
- Assets:https://bevy.org/assets/
- Examples:https://github.com/bevyengine/bevy/tree/latest/examples#examples
- ECS:https://bevy.org/learn/quick-start/getting-started/ecs/
- Plugins:https://bevy.org/learn/quick-start/getting-started/plugins/