用途
Bevy Metroidvania 是一个类型路由(genre router)技能,用于 Bevy 引擎下的类银河恶魔城(Metroidvania)游戏。它的触发场景是:当你需要实现「能力解锁式探索(ability-gated exploration)」以及「由房间组成的地图」时加载本技能。
本技能自身不实现领域逻辑,具体工作被路由到下方列出的 Bevy 技能中。
主要能力与 ECS 形态
文档以 ECS 结构描述该类型的数据组织方式:
- Components(组件):以纯数据形式承载该类型在每个实体上的标记。文档说明本文件不命名新的引擎类型。
- Resources(资源):通过 bevy-data-resources 保存整局计数器(如分数、波次索引、随机种子)。
- Systems(系统):在
Update或来自 bevy-master 的固定时间步上读取这些组件;当后续系统必须看到前一个系统的结果时,用.chain()排序。 - Schedule(调度):玩法模式切换经由 bevy-state-machines。能力标记、已访问格子以及地图迷雾由组件加一个资源构成。
使用方式
文档给出依赖声明示例:
[dependencies]
bevy = "0.20"
玩法要点:移动能力是玩家身上的一组标记;闸门(Gate)保存它所需的能力标记;地图保存哪些格子已被揭示。输入、闸门检查与迷雾共享 AbilitySet 和 MapFog,因此这些系统需要 .chain() 串联。
示例中定义了 Ability 枚举(Dash、WallClimb、DoubleJump)、AbilitySet 组件(含 has 与 grant 方法)、Gate 组件(requires 与 open)、MapCell 组件(坐标与 visited)以及 MapFog 资源(revealed 计数)。启动系统 boot 插入 MapFog 资源并生成玩家、闸门与地图格子;grant_dash 在按下 E 键时授予冲刺;open_gates 根据玩家能力设置闸门开启状态;reveal_cell 标记格子已访问并累加迷雾揭示计数;install 将启动系统与链式更新系统注册到 App。
另一个示例展示捷径开启条件:当玩家同时拥有 Dash 与 WallClimb 时,shortcut_open 返回 true。
场景形态对照表:类型内容对应实体加下方链接的领域技能;整局导演对应一个 Resource;循环通知对应 bevy-events-messaging。
路由
- bevy-ability-system:移动能力。
- bevy-character-movement:运动。
- bevy-save-load:地图标记。
- bevy-mechanic-secrets:可选房间。
适用场景
需要以能力作为门槛来解锁探索路径、并维护房间地图与迷雾揭示状态的 Bevy 项目。
限制与约束
文档中的 Scope 说明:能力标记存放在 AbilitySet 上,闸门与已访问格子是组件,MapFog 统计已揭示格子数;Bevy 没有地图图(map-graph)类型,示例中的写法即为数据本身。
专家知识目标为 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。
NEVER 条款
- 不要在文档 URL 中固定
/0.20.0/:链接保持latest,0.20 目标在正文中说明一次。 - 不要在两个未排序系统中可变查询同一组件:调度默认并行运行,除非
.chain()排序。 - 不要在此发明物理、导航、网络或 XR crate:本技能只命名有文档的 Bevy crate 与模块。
- Bevy 代码中不使用其他引擎类型。
- 不发明类型专属 API。
- 不在此选择物理或网络 crate。
参考
官方页面使用不带版本号的永久链接;bevy-master 上的库版本固定为 0.20。官方文档包括 Assets、Examples(latest 分支)、ECS(Component、系统、Query、Startup、Update、.chain())、Plugins(Plugin、DefaultPlugins、MinimalPlugins、add_plugins)。
前置技能:bevy-master(ECS 所有权与调度)、bevy-ecs-composition(生成与查询形态)。互补技能:godot-genre-metroidvania(同类型的对等技能)、bevy-ability-system、bevy-character-movement、bevy-save-load、bevy-mechanic-secrets。下游消费者:无,本路由不拥有第二套实现。主技能:bevy-master(Bevy 路由器)。
暂未提供
资料未提供收费、价格、平台支持、实际使用效果或具体安装步骤等信息。