用途
Bevy Roguelike 是一个“类型路由器”(thin router)技能,面向 Bevy 0.20。它用于处理跑局种子(run seed)、房间生成与永久死亡(permadeath)标记等 roguelike 通用问题。它本身不承载领域实现,具体工作由下列 Bevy 子技能承担,因此适合作为搭建 roguelike 骨架时的入口指引。
主要能力与 ECS 形态
- 组件(Component):以纯数据形式保存该类型游戏的按实体标记;该文件不命名新的引擎类型。
- 资源(Resource):通过 bevy-data-resources 保存跑局级计数器(分数、波次索引、种子)。
- 系统(System):在
Update或来自 bevy-master 的固定时间步上读取这些组件;当后续系统必须看到前一个系统的结果时,用.chain()排序。 - 调度(Schedule):玩法模式切换经由 bevy-state-machines 完成,不自行发明类型插件。
路由去向:
- bevy-procedural-generation:种子与生成。
- bevy-turn-system:跑局为回合制时的回合顺序。
- bevy-inventory-system:跑局掉落物。
- bevy-rpg-stats:跑局属性。
使用方式(示例要点)
依赖项示例:
[dependencies]
bevy = "0.20"
rand = "0.9"
跑局种子是一个资源。房间是实体。StdRng 在系统内部构建,使种子保留在资源上。示例中定义了 RunSeed(u64) 资源与 Room { x, y } 组件,carve 系统按种子生成 8 个房间,并通过 install_run 在 Startup 中插入资源并添加系统。
永久死亡是角色上的标记加上跑局级资源,由一个系统同时写入两者:Actor { hp } 组件与 RunOver(bool) 资源,permadeath 系统在 hp 不大于 0 时将 hp 归零并置 RunOver 为真。
回合能量累积在资源上,行动消耗它。由于两个系统都写入 TurnClock,需要用 .chain() 串联:TurnClock { energy: f32 },charge 系统按 time.delta_secs() 累积能量并上限为 1.0,spend 在能量不足 1.0 时直接返回,否则清零并对所有存活角色扣减 hp,install_turns 在 Update 上以 (charge, spend).chain() 添加系统。
地面掉落物是一个可被角色按格子距离拾取的实体:Loot { value }、GridPos { x, y }、Actor 组件与 RunSeed 资源,pickup 系统在角色与掉落物坐标相同时累加数值并 despawn 该掉落物。说明指出 pickup 中的 RunSeed 仅作为占位计数器以便示例停留在单一资源内;金币钱包应属于 bevy-economy-system;permadeath 与 spend 都写入 Actor,两者同时运行时需要串联。
适用场景
需要在 Bevy 中搭建可复现房间布局、回合制跑局、掉落拾取与跑局终止判定等 roguelike 基础机制时适用。范围说明:噪声与更大地图路由到 bevy-procedural-generation;背包堆叠路由到 bevy-inventory-system。
限制与约束(NEVER 规则)
- 不要在文档 URL 中固定
/0.20.0/,链接保持latest,0.20 目标在正文中说明一次即可。 - 不要从两个无序系统对同一组件做可变查询;除非用
.chain()排序,调度会并行运行系统。 - 不要在此发明物理、导航、网络或 XR crate;该技能只命名已文档化的 Bevy crate 与模块。
- 不要每帧用新种子重建
StdRng;跑局种子保留在RunSeed上以保证房间布局可复现。 - 不要让
permadeath与spend在没有.chain()的情况下都写入Actor;对同一组件的无序可变查询会冲突。 - 不要发明类型 API;Bevy 代码保持地道 ECS 并只使用已文档化的 Bevy API。
专家知识要点
目标版本为 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,不要从渲染系统生成;需要非共享状态的跨系统通知使用 bevy-events-messaging 中的消息或观察者槽位,不要在此文件发明新事件类型;需要文档集之外的 API 时使用本技能中的示例,不要使用虚构的 crate 或 API。
参考信息
官方文档包括:Assets(官方资源目录,未选择第三方 crate)、Examples(位于 latest 分支的示例树)、ECS(Component、系统、Query、Startup、Update 与 .chain())、Plugins(Plugin、DefaultPlugins、MinimalPlugins 与 add_plugins)。相关技能分为前置(bevy-master、bevy-ecs-composition)、互补(godot-genre-roguelike、bevy-procedural-generation、bevy-turn-system、bevy-inventory-system、bevy-rpg-stats)与主控(bevy-master)。下游消费者:无,该路由器不拥有第二套实现。bevy-master 的库固定版本保持 0.20.0,官方页面保持在无版本的 latest 分支。
收费、价格与平台支持情况:暂未提供。