SuperAPI AI 工具集

bevy-economy-system

通用与其它

查看项目

更新于 10-16 12:41

技能介绍

用途:为 Bevy 游戏提供钱包、价格表、购买与转账等经济机制。物品身份由 bevy-inventory-system 负责,本技能只管数字变化。钱包的持久化归属 bevy-save-load。

主要能力:

  • 钱包:自定义货币数量组件。
  • 价格行:集中存放在一个资源(PriceTable)中。
  • 交易:用 Purchase、Transfer 消息表达;一次购买只有一个系统写买家钱包。
  • 库存:Vendor 组件列出物品与库存,购买消息只携带物品 id,系统拒绝空货架。
  • 并行安全:两个系统若可变查询同一组件,必须用 .chain() 排序,或拆分到只有一个写入;无冲突的系统保持并行。

使用方式:

  • 依赖 bevy = "0.20"。
  • 用 Plugin 的 build 注册资源、消息和系统,例如 insert_resource、add_message::<Purchase>()、add_systems(Update, buy)。
  • 需要在扣钱包前先减库存时,将 take_stock 链在 buy 之前。
  • 两个钱包间转账用一次可变查询 get_many_mut([from, to]) 完成两次写入,避免竞争;金额为 0 或 from == to 时跳过。
  • 状态归属:单实体数据用 Component + Query,全应用配置用 Resource,启动生成用 Startup 中的 Commands,模拟步进用 FixedMain 与 Fixed 时钟。

限制与注意:

  • 目标为 Bevy 0.20+,仅使用文档化的 Bevy crate 与 API,不引入物理、导航、网络或 XR crate。
  • 不要从两个无序系统可变查询同一组件。
  • 不要把 .chain() 当成系统集 API。
  • 文档 URL 不要固定 /0.20.0/,链接保持 latest。
  • 具体收费、平台等信息暂未提供。