SuperAPI AI 工具集

bevy-ability-system

编程与开发

查看项目

更新于 10-16 12:49

技能介绍

用途

本技能用于在 Bevy ECS 项目中实现技能(ability)相关的核心机制:技能的定义、授予、施放门控、冷却与充能。它明确划分职责——只负责技能本身的冷却、充能与技能目录,战斗伤害结算仍由 bevy-combat-system 承担。当需要处理某个角色授予技能、冷却技能或消耗技能时加载本技能。

主要能力

  • ECS 结构组织:施法者实体上放置技能 id、充能数(charges)与剩余冷却(cooldown remaining)等 Component;全局技能表放在 Resource 中;系统在 Update 或固定时间步上修改这些组件。
  • 冷却机制:使用 remaining 字段,在 FixedUpdate 中通过 Time<Fixed>::delta_secs 递减。
  • 充能与充能恢复:用 Charges 组件记录 current 与 max,并在冷却结束且未满时恢复。
  • 施放门控:在冷却与充能检查通过后,通过 MessageWriter<CastAccepted> 发出施放消息。
  • 技能目录:技能定义(id、冷却、消耗)作为 AbilityCatalog Resource 管理,运行时冷却状态仍留在实体上。
  • 全局冷却(GCD):共享锁放在 Resource 中,由单一系统持有,通过读取 CastAccepted 消息来设置。
  • 状态效果堆叠:以组件列表形式在 FixedUpdate 上推进(tick)。
  • 系统顺序控制:当伤害必须先于死亡落地时使用 .chain() 排序。

使用方式

技能以 Bevy 代码片段形式提供,包含 Cargo 依赖声明(bevy = "0.20", edition 2021)以及一个 AbilityPlugin 插件示例,插件在 build 中注册消息与系统:

app.add_message::<CastAccepted>()
    .add_systems(FixedUpdate, (tick_cooldowns, try_cast, recharge).chain());

示例涵盖:

  • Cooldown 与 Charges 组件定义;
  • CastAccepted 消息;
  • tick_cooldowns(冷却递减)、try_cast(施放判定)、recharge(充能恢复);
  • AbilityPlugin 插件注册;
  • AbilityCatalog 资源与前查找函数 lookup;
  • spawn_caster 生成示例;
  • GlobalCooldown 全局冷却及其 tick_gcd 与 arm_gcd 系统。

资料强调:注册 CastAccepted 时使用 add_message,并与 tick_gcd、arm_gcd 在同一个插件中注册。

适用场景

  • 需要为角色实现技能冷却、充能与技能目录的 Bevy 项目;
  • 需要按固定时间步驱动技能状态更新的动作或战斗类游戏逻辑;
  • 需要在施放成功时向其它系统广播一次性消息的场景(如命中、拾取、任务推进等由 bevy-events-messaging 处理)。

限制与约束

  • 目标版本为 Bevy 0.20+,仅使用有文档的 Bevy crate 与模块;不得自行引入物理、导航、网络或 XR crate,也不得发明 API 或使用未具名的第三方 crate。
  • 不得在文档 URL 中固定 /0.20.0/,链接保持在 latest,版本目标仅在正文中说明一次。
  • 不得从两个无序系统中可变查询同一组件,调度器默认并行运行系统,除非用 .chain() 排序。
  • 冷却不得存放在进程级全局静态中,冷却状态的归属是施法者的 Cooldown 组件与目录 Resource。
  • 本文件不新增事件类型名称,一次性事实统一走 bevy-events-messaging。

相关技能

前置包括 bevy-master、bevy-ecs-composition、bevy-combat-system、bevy-input-handling、bevy-data-resources、bevy-events-messaging;互补技能为 bevy-state-machines。资料的官方文档参考包含 Assets、Examples、ECS、Plugins 等 Bevy 官方链接。