SuperAPI AI 工具集

bevy-genre-shooter

编程与开发

查看项目

更新于 10-16 11:40

技能介绍

用途

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 示例:

  1. 投射物作为带速度的实体:fire 系统在鼠标左键按下时按 Ship 的变换生成带有 Projectile 与 Transform 的实体;fly 系统按 time.delta_secs() 对速度积分更新位置。示例通过 install_shots 把两者加入 Update,并说明两者触碰不同数据所以可并行。
  2. Hitscan:通过在范围内比较平移距离选出最近目标,在读取循环结束后再施加伤害(示例中范围阈值为 240.0_f32,伤害为 1),使用 Without<Ship> 区分射击方与目标。
  3. 碰撞后消除:当投射物与目标距离小于 16.0 时扣减 Health 并通过 commands.entity(shot_entity).despawn() 消除投射物;说明在同一调度内两者都写投射物实体时,应把 collide 链在 fly 之后。
  4. 波次预算: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。