bevy-genre-stealth 是面向 Bevy 游戏引擎的潜行(Stealth)类型薄路由技能(thin Bevy genre router)。其关键词为 Bevy、Stealth、genre、ECS、router。按照文档的描述,它是一个「类型路由」:具体的领域工作由下方链接的 Bevy 相关技能承担,本文件本身不拥有第二套实现。
【用途与适用时机】 文档说明,当你需要自行实现视野锥(vision cones)与警戒状态(alert states)时,可以加载此技能。也就是说,它面向以 Bevy ECS 方式构建潜行玩法逻辑的场景。
【ECS 结构】
- Component:保存该类型下每个实体的标记,作为普通数据。文件不命名新的引擎类型。
- Resource:通过 bevy-data-resources 保存全局运行计数器(分数、波次索引、随机种子)。
- System:在 Update 或来自 bevy-master 的固定时间步上读取这些组件;当后续系统必须看到前一步结果时,用 .chain() 进行排序。
- Schedule:玩法模式的变化通过 bevy-state-machines 处理。文档明确要求不要发明新的类型插件。
【从 Godot 迁移的对照】
- Godot 的 Genre scene tree → Bevy 的 Entities 加上下方链接的领域技能。
- Godot 的 Autoload director → Bevy 的 Resource,而不是单例节点。
- Godot 中用于主循环的 Signal bus → bevy-events-messaging。
【路由到相关技能】
- bevy-ai-navigation:巡逻(Patrol)。
- bevy-state-machines:代理上的警戒枚举(Alert enum)。
- bevy-3d-lighting:黑暗环境下的可读性。
- bevy-spatial-queries:视线(Line of sight)。
【范围说明】 视野锥、暴露度(exposure)与警戒计量条(alert meters)属于你自行拥有的组件。必须在实体几何体上停止的射线应交给 bevy-spatial-queries。关节(Joints)与空间索引属于你自己添加的物理插件;本文件不调用这些类型。
【示例代码】 文档提供了 Cargo 依赖示例:bevy = "0.20"。并给出若干 Rust 代码片段,包括:守卫对玩家的头部、躯干、脚部进行采样,只有当采样点位于视野锥内时警戒计量条才上升、离开后衰减;听觉使用传播距离而非原始半径,墙体拉长距离使同一声脚步穿过几何体后更轻;光照决定计量条填充速度,蹲伏且低暴露的玩家比聚光灯下冲刺的玩家填充更慢;以及生成守卫实体的代码示例。这些代码片段的内容不得修改,此处仅作概述。
【专家知识要点】 目标为 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 时钟;启动生成用 Startup 中的 Commands;非共享状态的跨系统通知使用 bevy-events-messaging 的消息或观察者槽位;文档集之外的 API 应先查官方文档。
【NEVER 条目】
- 不要在文档 URL 中固定 /0.20.0/;链接保持在 latest,0.20 目标只在正文中陈述一次。
- 不要从两个无序系统可变查询同一组件。
- 不要在此发明物理、导航、网络或 XR crate;此技能只命名有文档的 Bevy crate 与模块。
- Bevy 代码中不得出现 Godot 类型。
- 不得发明类型 API。
- 不要在此挑选物理或网络 crate。
【参考与相关技能】 库固定版本为 0.20.0。官方文档包括 bevy crate、Assets、Examples、ECS、Plugins。前置技能为 bevy-master(ECS 归属与调度)与 bevy-ecs-composition(生成与查询形态)。互补技能包括 godot-genre-stealth、bevy-ai-navigation、bevy-state-machines、bevy-3d-lighting、bevy-spatial-queries。下游消费者为无(此路由不拥有第二套实现)。主技能为 bevy-master。
资料未提供收费、价格、平台、实际效果或使用步骤等信息。