用途
Bevy fighting 是一个品类路由(genre router)。它本身不做完整的格斗游戏实现,而是作为入口,把本地格斗玩法的领域工作交给相关的 Bevy 子技能。
适合在以下情况加载:本地格斗玩法,涉及逐帧标志、以数据形式存在的判定框(hitboxes),以及回合状态(round state)。
范围与限制
Rollback 回滚网络同步不在本技能范围内。文档明确:本地帧数据就是 Fighter 组件(帧索引、有利帧 advantage、生命值)加上 RoundClock 资源。Bevy 没有内置的格斗游戏类型,上述示例即数据本身。
文档的 NEVER 条款还指出:不要在本技能中引入回滚或网络代码 crate、不要发明品类 API、不要在此挑选物理或网络 crate,原因是 Bevy 代码保持惯用 ECS 并只使用官方文档记录的 Bevy API。
ECS 结构
- Components:以纯数据形式保存该品类的按实体标志。本文件不新增引擎类型。
- Resources:保存运行期全局计数器(分数、波次索引、随机种子),通过 bevy-data-resources 处理。
- Systems:在
Update或来自 bevy-master 的固定时间步上读取这些组件;当后续系统必须看到前一个结果时,用.chain()排序。 - Schedule:玩法模式变化经由 bevy-state-machines 处理。
代码示例要点
依赖:
[dependencies]
bevy = "0.20"
每个格斗角色保存帧索引、有利帧和生命值,回合时钟是一个资源。输入、帧推进和命中结算共享 Fighter,因此它们在固定步上进行链式排序。
示例定义了 Fighter 组件(frame、advantage、health)、Hitbox 组件(active、damage、startup、active_until)与 RoundClock 资源(frames_left)。boot 在启动时插入回合资源并生成角色;open_hitbox 根据当前帧与起止帧开启判定框;advance_frames 推进每个角色的帧并递减回合时钟;apply_hits 汇总激活判定框的伤害并对其他角色扣血、设置有利帧;install 在 Startup 注册 boot,并在 FixedUpdate 上以 .chain() 串联 open_hitbox、advance_frames、apply_hits。
当回合计时归零或某条生命值归零时,回合结束;该判断系统只读取 Fighter 与 RoundClock。
路由
- bevy-state-machines:回合与角色模式。
- bevy-combat-system:打击结算。
- bevy-animation:动作片段。
- bevy-input-handling:逐帧输入。
目标版本与状态归属
目标为 Bevy 0.20+。核心 ECS 类型包括:Component、Resource、Query、Commands、Startup、Update、Fixed / FixedMain(bevy::time)、.chain()、Plugin、DefaultPlugins、MinimalPlugins。消息与观察者是归属槽位,其 API 见 bevy-events-messaging。除非 .chain() 对冲突系统排序,否则系统并行运行。
状态归属表说明:单一实体上的数据由 Component 持有,一个系统可通过 Query 修改;全应用单一值由 Resource 持有,一个系统修改;生成由 Commands 在生成系统中负责,初始世界在 Startup,运行时生成在后续调度;不得竞速的顺序由 .chain() 排序,仅限被链式连接的系统,位于同一调度;插件边界由 Plugin 负责,build 注册系统与资源,在应用运行前完成。
借用规则:两个系统若都对同一组件进行可变查询,必须排序(.chain())或拆分为只有一个写入者;无关系统保持并行。
决策表
- 按实体数据:用
Component+Query,不要用所有实体共享的一个可变块。 - 应用级配置或时钟:用
Resource,不要复制到每个实体。 - 稳定模拟步:用
FixedMain与Fixed时钟,不要把模拟绑到原始帧Update。 - 启动生成:在
Startup中用Commands,不要从渲染系统生成。 - 非共享状态的跨系统通知:使用
bevy-events-messaging中的消息或观察者槽位,不要在本文件发明新事件类型。 - 文档集合之外的 API:查阅 Bevy 官方页面,不要使用虚构的 crate 或 API。
参考
库固定版本保持 0.20.0,官方页面保持无版本站点。官方文档包含 Assets、Examples(latest 分支示例树)、ECS、Plugins 页面。相关技能中,前置为 bevy-master(ECS 归属与调度)与 bevy-ecs-composition(生成与查询形态);互补为 bevy-state-machines、bevy-combat-system、bevy-animation、bevy-input-handling;下游消费方为无,该路由不拥有第二套实现。