用途
Bevy GenrE Action RPG 是一个面向 Bevy 0.20 的动作角色扮演游戏类型路由器(thin router)。它的职责是路由:把动作 RPG 中实时命中、属性、背包和任务等需求,映射到 ECS 的组件、资源与系统组合上,而具体的领域实现放在被链接的各个领域技能中。资料明确指出「Genre router. Domain work lives in the Bevy skills below.」当需要为一个动作 RPG 做整体路由时使用本技能。
主要能力与 ECS 组织方式
技能给出了动作 RPG 的 ECS 形态:
- 组件(Components)以纯数据形式持有该类型的每实体标志,本文件不定义新的引擎类型。
- 资源(Resources)通过 bevy-data-resources 持有整局级别的计数器(分数、波次索引、随机种子等)。
- 系统(Systems)在
Update或来自 bevy-master 的固定时间步上读取这些组件;当后续系统必须看到前一个系统的结果时,用.chain()排序。 - 调度:玩法模式变更走 bevy-state-machines,不新造类型插件。
技能还给出了 ECS 归属关系表,例如:受到的伤害量作为角色实体上的组件,应用后移除,在 Update 中先应用后清除并用 .chain() 排序;攻击距离与耐力作为角色上的组件,由技能技能读取,本路由器只负责生成它们;击杀计数为一个资源,在命中系统之后于 Update 执行;装备 id 作为角色上的组件,由背包技能写入,战斗不应同时写它。
与 Godot 的对照
资料提供了一张对照表:Godot 的类型场景树对应「实体加下方链接的领域技能」;Godot 的 Autoload 导演对应「一个资源,而不是单例节点」;用于游戏循环的信号总线对应 bevy-events-messaging。
路由目标
本路由器把领域工作分派到以下技能:bevy-character-movement(角色运动)、bevy-combat-system(命中)、bevy-rpg-stats(属性)、bevy-inventory-system(装备)、bevy-quest-system(任务目标)、bevy-ability-system(施法)。资料同时说明打击体积属于物理相关技能。
依赖与示例代码
依赖为 Bevy 0.20:
[dependencies]
bevy = "0.20"
资料给出了三段示例代码,分别演示:Vitality / IncomingHit 组件与 apply_hits、clear_hits 系统组成的 ActionHitPlugin;GearSlot 组件与 QuestFlags 资源组成的 ActionProgressPlugin;以及生成带 MeleeReach 和 Stamina 的角色的 ActionRpgPlugin。这些代码展示了组件、资源、系统排序与插件注册的基本写法。
状态所有权规则
资料给出了明确的所有权规则:单个实体的数据由组件持有,最多一个系统通过 Query 修改;整个应用共享的值由资源持有,由一个系统在 Startup 插入后由读取它的调度消费;生成(spawn)由 Commands 在 Startup 或运行时调度完成;必须避免竞态的先后关系用 .chain() 表达;插件边界由 Plugin 在应用运行前注册系统与资源。借用规则为:两个系统若都可变查询同一个组件,必须用 .chain() 排序或拆分到只有一个写入,不相关的系统保持并行。
适用场景
当你在 Bevy 0.20 中构建动作 RPG,需要为实时命中、属性、背包、任务等玩法确定 ECS 组合方式、系统排序与状态归属时,加载本技能做路由。
限制
本技能是薄路由器,不实现具体领域逻辑,领域实现位于被链接的技能中;不得在本技能内发明物理、导航、网络或 XR crate;不得使用 Godot 类型;不得发明类型 API。资料还列出了若干 NEVER 规则,例如不要在文档 URL 中固定 /0.20.0/、不要从两个无序系统可变查询同一组件、不要与读取 IncomingHit 的系统并行清除它。
参考
Bevy 版本目标为 0.20+,bevy-master 上的库固定为 0.20.0,官方页面保持无版本站点。官方文档包括 ECS、Plugins 与 Examples 页面。相关资料技能包括前置的 bevy-master、bevy-ecs-composition,以及互补的 godot-genre-action-rpg 与上述各 Bevy 领域技能;本路由器没有下游消费者。资料未提供收费、价格或平台信息。