用途
本技能用于在 Bevy 引擎中实现“秘密与发现标记”机制。当玩家发现可选秘密、需要把这些标记持久保存时,可以加载本技能。关键词包括 Bevy、secrets、discovery、flags、ECS。
主要能力
- 用组件表示秘密 id,用资源保存“已发现”的 id 集合。
- 在
Update或固定时间步中修改这些组件;当伤害必须先于死亡结算时使用.chain()排序。 - 一次性事实(命中、拾取、任务推进)通过 bevy-events-messaging 处理;本文件不新增事件类型名称。
- 提供从 Godot 迁移的对照:Godot 的 Secret id 对应世界对象上的组件,Found set 对应 id 资源,Persist 交给 bevy-save-load。
- 范围包括:秘密 id、已发现集合、注视检查、限时输入序列,这些组件和资源由使用者自己拥有;该集合的持久化属于 bevy-save-load。
使用方式
依赖示例:
[dependencies]
bevy = "0.20"
serde = { version = "1", features = ["derive"] }
发现秘密时插入其 id 一次,后续系统可以把 Discovered 交给保存技能。文档给出多段 Rust 示例:
- 距离发现:遍历带
Seeker的实体与带Secret的实体,当距离小于等于秘密半径时把 id 插入Discovered。 - 注视发现:计算前方向与目标方向的点积,当距离在 0.001 到 6.0 之间且点积大于 0.98 时记录发现。
- 序列匹配:维护滚动窗口,经典的上上下下左右左右模式在窗口过期前尾部匹配时解锁。
- 进度解锁:当已清除比例达到 80% 时解锁并插入 id 9001。
- 插件:
SecretsPlugin在build中初始化资源并添加系统。
适用场景
- 玩家发现隐藏要素、彩蛋、可选标记并需要跨运行保存。
- 需要注视检测或限时按键序列解锁的玩法。
- 需要按进度百分比解锁秘密的场景。
限制
- 目标版本为 Bevy 0.20+。
- 不要在文档 URL 中固定
/0.20.0/,链接保持latest,0.20 目标只在正文说明一次。 - 不要从两个无序系统可变查询同一组件;除非用
.chain()排序,调度会并行运行系统。 - 不要在本技能中发明物理、导航、网络或 XR crate;本技能只命名有文档的 Bevy crate 和模块。
- 本机制不使用 Godot 节点、资源或信号类型;Bevy 代码保持地道 ECS,只使用有文档的 Bevy API。
- 不要发明 API 或把未命名的第三方 crate 作为选定方案。
- 库在 bevy-master 上的固定版本保持 0.20.0。
参考
官方文档包括 bevy crate、Assets、Examples、ECS、Plugins。相关技能包括前置的 bevy-master、bevy-ecs-composition、bevy-save-load、bevy-data-resources、bevy-events-messaging;互补的 bevy-state-machines、godot-mechanic-secrets;下游消费者暂无;主技能为 bevy-master。