SuperAPI AI 工具集

bevy-combat-system

编程与开发

查看项目

更新于 10-16 13:41

技能介绍

用途

该技能用于在 Bevy 引擎中实现 ECS 战斗系统的伤害与生命值流程。资料给出的适用时机是:当“命中需要改变生命值”时加载本技能。重叠检测等待 bevy-spatial-queries 与尚未选定的物理求解器;在没有求解器时,用 Transform 上的 reach 检测即可。

主要能力

  • 组件:Health(含 current 与 max,字段自定义)与 team id 由使用者自行定义,不使用引擎自带战斗组件。
  • 资源:运行期共享表格放在 Resource 中(关联 bevy-data-resources)。
  • 系统:在 Update 或固定时间步上修改组件;当伤害必须先于死亡生效时使用 .chain() 排序。
  • 消息:一次性事实(命中、拾取、任务推进)通过 bevy-events-messaging 传递;本文件不新增事件类型名。
  • 范围:生命值、伤害、无敌与队伍 id 均为组件;命中是生命系统消费的消息。体积重叠检测归 bevy-physics-2d 与 bevy-physics-3d 负责;尚无求解器时,Transform 上的 reach 检测已足够。

使用方式

示例 Cargo 依赖为 bevy = "0.20",edition 2021。概念上:Health 与 Team 挂在 actor 上;在一段链式系统中先应用命中、再销毁死亡实体,使死亡判定看到新的生命值。示例包含:apply_hits 读取 Hit 消息,跳过同队、无敌中或非正伤害,扣减生命并设置 0.25 秒无敌;tick_invuln 按固定时钟 delta 递减无敌时间;despawn_dead 在生命值小于等于 0 时销毁实体;CombatPlugin 注册消息并在 FixedUpdate 上以 (tick_invuln, apply_hits, despawn_dead).chain() 运行。近战部分:Melee 组件含 reach、damage、active,melee_hits 按 translation 距离判断是否在 reach 内并写入 Hit;物理体积可在求解器接管形状后替换该查询。生成示例中 fighter 带有满血 Health、Team 与 Invuln。

适用场景

命中需要先扣血再判死亡的战斗逻辑;需要队伍区分与短暂无敌窗口的角色;在没有物理求解器前需要先跑通近战 reach 判定的原型。

限制与边界

  • 目标为 Bevy 0.20+。
  • 不得在文档 URL 中固定 /0.20.0/,链接保持 latest,0.20 目标在正文中声明一次。
  • 不得从两个未排序的系统可变查询同一组件:除非 .chain() 排序,调度会并行运行系统。
  • 不得在本技能中发明物理、导航、网络或 XR crate,只使用官方文档中的 Bevy crate 与模块。
  • 不使用场景树节点或信号总线实现该机制。
  • 不使用未记载的 API 或未具名第三方 crate 作为选定求解器。
  • 官方文档链接包括 Assets、Examples、ECS、Plugins;相关技能包含 bevy-master、bevy-ecs-composition、bevy-spatial-queries、bevy-rpg-stats、bevy-data-resources、bevy-events-messaging,互补项为 bevy-state-machines,下游消费者暂无。