SuperAPI AI 工具集

bevy-mechanic-secrets

编程与开发

查看项目

更新于 10-16 10:38

技能介绍

用途

本技能用于在 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。