用途
该技能是一个游戏类型路由器,用于在 Bevy 0.20 引擎下组织放置点击类(idle clicker)玩法的实现。它本身不承担完整实现,而是把货币、点击、布局、离线进度等具体工作路由到对应的 Bevy 子技能。适合“货币在应用运行期间持续增长”的场景。
主要能力与 ECS 结构
- 组件(Component)以纯数据形式保存该类型的实体级标记;该文件不引入新的引擎类型。
- 资源(Resource)保存整局范围的计数器(分数、波次索引、种子等),由 bevy-data-resources 负责。
- 系统在 Update 或来自 bevy-master 的固定时间步上读取这些组件;当后续系统需要看到前一系统的结果时,用 .chain() 排序。
- 玩法模式切换经由 bevy-state-machines 处理,不自行发明类型插件。
- 单一 Wallet 资源保存 coins 与 per_second。Generator 实体持有 rate 与 owned,由系统汇总后写入钱包。
- 点击通过读取鼠标输入,在 Update 中给 Wallet 加币。
路由
- bevy-economy-system:货币。
- bevy-ui-layout:点击目标。
- bevy-input-handling:点击。
- bevy-save-load:离线进度。
使用方式
文档给出 Rust 代码示例。依赖为 bevy = "0.20" 与 serde(features = ["derive"])。示例包括:tick_income 按 Time::delta_secs 累加钱包;click 在按下左键时加币;install_income 插入 Wallet 资源并用 .chain() 串联 tick_income 与 click;generators_to_wallet 遍历 Generator 查询,计算总速率并写入钱包;IdleClock 资源保存 last_unix、per_second、banked,bank_offline 计算经过秒数并封顶 8 小时,claim 将 banked 加入钱包并清零。示例同时提醒:tick_income 与 generators_to_wallet 都写 Wallet,二者只能运行其一,或用 .chain() 串联。
适用场景
放置点击类游戏的核心循环:运行期间货币自动增长、点击产生即时收益、离线后结算收益。
限制与注意事项
- 离线时间必须在资源中封顶(示例为 8 小时),防止时钟跳变导致无上限铸币。
- 不得让两个无序系统同时对同一组件进行可变查询。
- 不在文档 URL 中固定 /0.20.0/ 版本;官方页面使用无版本的 latest 分支。
- 不在此处发明物理、导航、网络或 XR 相关 crate;只使用有文档的 Bevy crate 与模块。
- 货币、点击、布局路由到上述技能;持久化归属 bevy-save-load。
- 相关前置技能:bevy-master、bevy-ecs-composition;互补技能:godot-genre-idle-clicker、bevy-economy-system、bevy-ui-layout、bevy-input-handling、bevy-save-load。下游消费者:无。
目标引擎版本为 Bevy 0.20+;库版本锁定在 0.20.0。