SuperAPI AI 工具集

bevy-game-loop-collection

编程与开发

查看项目

更新于 10-16 11:39

技能介绍

用途

本技能用于 Bevy 0.20 中「收集循环」类玩法的搭建:一局游戏的目标是拾取若干物件并达到指定数量,达标即结束或获胜。文档明确指出:当运行逻辑围绕拾取物件并达到某个计数时加载本技能。

主要能力

  • 可收集物:以标记组件(marker component)表示。
  • 配额:以资源(Resource)保存计数。
  • 胜利:通过状态变更实现,引用 bevy-state-machines。
  • 单次计分保证:每个实体在一轮遍历中只被标记一次,避免第二个收集者重复为同一拾取物计分。
  • 距离判定:重叠在物理技能提供接触信息之前,由使用者自行进行距离检查。

ECS 结构约定

  • 组件:一个已收集标记和由你定义的配额资源。
  • 资源:整局共享的表放在资源中(bevy-data-resources),而非 autoload。
  • 系统:在 Update 或固定时间步上修改这些组件;当伤害必须先于死亡结算时使用 .chain()。
  • 消息:一次性事实(命中、拾取、任务推进)走 bevy-events-messaging;本文件不新增事件类型名。

Godot 与 Bevy 概念对照

Godot 概念 Bevy 惯用法
Pickup 一个组件标记。检测等待空间查询。
Quota 一个资源计数。
Win 经由 bevy-state-machines 的状态变更。

使用方式

依赖声明:

[dependencies]
bevy = "0.20"

核心示例(距离拾取 + 达标切状态)。要点包括:用 HashSet 记录本轮已计分的实体;距离小于等于 1.0 时加分并 despawn;达到配额后通过 NextState 切换到 Won;插件在 Startup 生成实体、在 Update 上以 .chain() 串联 collect_by_distance 与 reach_quota。

另提供一套以组件与资源统计的替代写法:用 Remaining(u32) 组件与 Quota 资源(collected、need),tally 系统递减并累加,quota_met 判断是否 collected >= need 且 need > 0。

适用场景

适用于以拾取物件、达到数量为目标的一局制关卡或探索玩法,需要在收集完成后切换到胜利状态的情形。

限制与约束

  • 目标版本为 Bevy 0.20+。
  • 文档 URL 不要钉住 /0.20.0/,链接保持在 latest;0.20 目标只在正文中说明一次。
  • 不要在两个未排序的系统里可变查询同一组件,因为除非用 .chain() 排序,调度会并行运行系统。
  • 不要在同一系统内把 NextState::set 当作已生效,状态调度在本系统返回后才执行转换。
  • 不要在同一轮中让两个收集者分别为同一拾取物计分,因为 despawn 是延迟的,实体仍在查询中。
  • 不要在本技能中自造物理、导航、网络或 XR crate;本技能只命名有文档的 Bevy crate 与模块。
  • 该机制中不使用 Godot 的节点、资源或信号类型;Bevy 代码保持地道 ECS,只使用有文档的 Bevy API。
  • 不使用未命名第三方 crate 或自造 API 作为求解方案。

参考

官方文档:ECS 页面(Component、系统、Query、Startup、Update、.chain())、States 页面(States、NextState、init_state)、Examples 示例树(latest 分支)。

相关技能:前置有 bevy-master、bevy-ecs-composition、bevy-state-machines、bevy-data-resources、bevy-events-messaging;互补有 bevy-state-machines、godot-game-loop-collection;下游消费者暂无;主入口为 bevy-master。

状态归属与决策表

文档给出「谁拥有状态」表:单个实体上的数据由 Component 拥有、单系统经 Query 修改,调度为 Update 或 FixedMain;整个应用的一个值由 Resource 拥有、单系统修改,用 Startup 插入后由读取它的调度使用;生成由 Commands 拥有、由生成系统执行,初始世界用 Startup,运行时生成用后续调度;不能竞态的顺序只由 .chain() 链式系统控制,同一调度内;插件边界由 Plugin 拥有,build 在应用运行前注册系统与资源。借用规则:两个系统若都要可变查询同一组件,必须排序(.chain())或拆分到只有一个写入;不相关的系统保持并行。

决策表:需要每实体数据用 Component + Query,而非 Godot 节点脚本;需要应用级配置或时钟用 Resource,而非把值复制到每个实体;需要稳定模拟步用 FixedMain 与 Fixed 时钟,而非把模拟绑到原始帧 Update;需要启动生成用 Startup 中的 Commands,而非从渲染系统生成;需要跨系统通知且非共享状态时使用 bevy-events-messaging 中的消息或观察者槽位,而非在本文件中自造事件类型;需要本技能之外的 API 时加载拥有它的技能,而非自造 crate 或 API。