用途
bevy-genre-shooter 是一个射击游戏“类型路由器”(thin router)。它面向 Bevy 0.20 的 2D 或俯视角射击循环,负责把瞄准、开火、伤害、敌人波次、空间查询等具体工作分派给对应的 Bevy 专项技能,自身不承担这些领域的实现细节。
主要能力
技能围绕 Bevy ECS 给出射击游戏的组织范式:
- 组件(Components):保存该类型的逐实体标记,作为普通数据使用。资料中出现的示例组件包括
Ship、Projectile(含velocity与damage)、Health(i32)、Enemy。资料明确说明该文件不命名新的引擎类型。 - 资源(Resources):保存运行期全局计数,如分数、波次索引、随机种子,并引用 bevy-data-resources。
- 系统(Systems):在
Update或来自 bevy-master 的固定时间步上读取这些组件;当下游系统必须看到上游结果时,用.chain()排序。 - 调度(Schedule):玩法模式变化经由 bevy-state-machines 处理,不发明类型插件。
技能还提供了若干可直接参考的 Rust 示例:
- 投射物作为带速度的实体:
fire系统在鼠标左键按下时按Ship的变换生成带有Projectile与Transform的实体;fly系统按time.delta_secs()对速度积分更新位置。示例通过install_shots把两者加入Update,并说明两者触碰不同数据所以可并行。 - Hitscan:通过在范围内比较平移距离选出最近目标,在读取循环结束后再施加伤害(示例中范围阈值为 240.0_f32,伤害为 1),使用
Without<Ship>区分射击方与目标。 - 碰撞后消除:当投射物与目标距离小于 16.0 时扣减
Health并通过commands.entity(shot_entity).despawn()消除投射物;说明在同一调度内两者都写投射物实体时,应把collide链在fly之后。 - 波次预算:
Wave { index, budget }作为资源,spawn_wave按 budget 数量生成Enemy与Health(3),随后把 budget 置零并递增 index,与 bevy-game-loop-waves 保持一致。
使用方式
该技能的定位是路由器,使用时应先加载它来确定射击类型的整体结构,再按下述路由转到专项技能:
- bevy-input-handling:瞄准与开火
- bevy-combat-system:伤害
- bevy-game-loop-waves:生成
- bevy-spatial-queries:射击与空间查询
依赖声明示例为:
[dependencies]
bevy = "0.20"
技能中给出 ECS 状态归属表,区分逐实体数据(Component,单系统经 Query 修改)、全局单值(Resource,Startup 插入后由读取它的调度使用)、生成(Commands)、必须避免竞态的排序(.chain())与插件边界(Plugin)。借用规则为:两个都可变查询同一组件的系统必须排序或拆分,只让一个写入;无关系统保持并行。
适用场景
适用于使用 Bevy 0.20 构建 2D 或俯视角射击游戏循环时的开发辅助与代码参考,包括投射物实体建模、hitscan 选靶、碰撞消除与波次预算分配等任务的组织与路由。
限制与边界
- 本技能是类型路由器,不拥有第二套实现;领域工作由上述 Bevy 专项技能承担。
- 瞄准路由与命名动作属于 bevy-input-handling。
- 面向大量实体的空间索引属于 bevy-spatial-queries;示例中的距离范围检查只适用于少量目标。
- 文档 URL 不固定到
/0.20.0/,链接保持在latest,0.20 目标只在正文中说明一次。 - 不在此处发明物理、导航、网络或 XR crate;只命名有文档的 Bevy crate 与模块。
- 不要从可变查询同一投射物的循环内部 despawn 该投射物;despawn 通过 Commands 执行,
collide以不可变方式读取 shots,并在另一个查询上写Health。 - 当
fire与fly触碰不同数据时不要将它们链在一起;只有在同一调度内运行且射击必须先移动再做范围检测时,才把collide链在fly之后。 - 不发明类型化 API,Bevy 代码保持惯用 ECS。
目标版本与参考
技能目标为 Bevy 0.20+。核心 ECS 类型包括 Component、Resource、Query、Commands、Startup、Update、Fixed / FixedMain(bevy::time)、.chain()、Plugin、DefaultPlugins、MinimalPlugins。消息与观察者属于另一个归属槽位,其 API 见 bevy-events-messaging。bevy-master 上的库固定版本为 0.20.0,官方页面保持在未版本化的 latest 分支。官方文档参考包括 Assets、Examples、ECS 与 Plugins 页面。相关技能包括前置的 bevy-master 与 bevy-ecs-composition,互补的 godot-genre-shooter、bevy-input-handling、bevy-combat-system、bevy-game-loop-waves、bevy-spatial-queries。