SuperAPI AI 工具集

bevy-turn-system

编程与开发

查看项目

更新于 10-16 14:42

技能介绍

用途

该技能用于在 Bevy 0.20 中实现回合制推进:当游戏按回合前进而不是按连续时间逐帧模拟时加载它。时间仍然存在,只是选择不每帧步进模拟。关键词包括 Bevy、回合、先攻、TurnClock、chain、ECS。

主要能力(ECS 结构)

  • 组件:先攻值,以及你自定义的当前行动实体 id。
  • 资源:当前行动实体与回合数位于同一个 Resource(bevy-data-resources)。
  • 系统:在 Update 或固定时间步上修改这些组件。当伤害必须先于死亡结算落地时使用 .chain()。
  • 消息:一次性事实(命中、拾取、任务推进)通过 bevy-events-messaging 处理;本文件不新增事件类型名。

回合归属

事实 归属
先攻 一个组件数值,在回合开始时排序。
当前行动者 TurnClock.order[index]。
回合数 同一资源上的一个计数器,在链式的结束系统中推进。

使用方式与范围

  • 先攻是一个组件。当前实体与回合计数器是同一个资源,因此单个系统即可推进二者。
  • 只在回合开始或速度属性变化时重建队列,不要在每个动作上重新排序。
  • bevy::state 用于应用模式,不是先攻队列,参见 bevy-state-machines。

示例依赖:

[dependencies]
bevy = "0.20"

资料包含三段示例代码:定义 Fighter(speed、tie_break、action_points)与 TurnClock(round、order、index)并生成对局;构建顺序时排序一次,速度相同时用稳定 id 兜底以保证回放确定性;take_action 在成本检查通过后才花费点数并设置 end_requested,end_turn 在标志置位时补充点数并推进索引,两个系统都可变使用 TurnClock 与 Fighter,因此需要 .chain(),否则标志与点数会产生竞争。示例还包括 TurnPlugin 通过 add_systems(Update, (take_action, end_turn).chain()) 注册系统。

专家知识要点

目标版本为 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 修改,调度于 Update 或 FixedMain;整个应用的一个值由 Resource 承载,一个系统修改,Startup 插入后由读取它的调度使用;生成由 Commands 完成,Startup 用于初始世界,运行时生成使用后续调度;不可竞争的顺序由 .chain() 约束,仅链式系统使用,同一调度;插件边界由 Plugin 的 build 在应用运行前注册系统与资源。借用规则:两个系统若都可变查询同一组件,必须排序(.chain())或拆分使只有一个写入;无关系统保持并行。

决策表要点

  • 每实体数据用 Component + Query,不要存到世界之外的字段。
  • 应用级配置或时钟用 Resource,不要复制到每个实体。
  • 稳定模拟步用 FixedMain 与 Fixed 时钟,不要把模拟绑到原始帧 Update。
  • 启动生成用 Startup 中的 Commands,不要从渲染系统生成。
  • 先攻队列用回合开始时构建的 TurnClock 顺序,不要用 States 或每个动作排序。
  • 先花费后结束用 take_action 再 end_turn 配 .chain(),不要用两个无序系统写 Fighter 与 TurnClock。
  • 跨系统通知且非共享状态时,使用 bevy-events-messaging 中的消息或观察者槽位,不要在本文件发明新事件类型。
  • 文档集之外的 API 应查官方文档,不要使用虚构 crate 或 API。

限制与禁止事项

  • 不要在文档 URL 中固定 /0.20.0/:链接保持在 latest,0.20 目标在正文中说明一次。
  • 不要从两个无序系统可变查询同一组件:调度会并行运行系统,除非 .chain() 排序。
  • 不要在此发明物理、导航、网络或 XR crate:本技能只命名有文档的 Bevy crate 与模块。
  • 不要在每个动作上排序先攻:队列在回合开始或速度变化时重建,以保持回放稳定。
  • 不要把 bevy::state 当作先攻队列:states 是应用模式,当前实体是 TurnClock。
  • 不要使用虚构 API 或未命名的第三方 crate 作为求解器。

参考资料与相关技能

官方文档链接保持在无版本号的 latest 页面;bevy-master 的库版本固定为 0.20.0。官方文档包括 Assets、Examples(latest 分支)、ECS(Component、系统、Query、Startup、Update、.chain())、Plugins(Plugin、DefaultPlugins、MinimalPlugins、add_plugins)。前置技能包括 bevy-master(枢纽与调度)、bevy-ecs-composition(组件与系统)、bevy-state-machines(应用模式不是回合顺序)、bevy-data-resources(表与定义)、bevy-events-messaging(一次性事实)。互补技能包括 bevy-state-machines(模式标志)与 godot-turn-system(Godot 的回合顺序包)。下游消费者暂无。