用途
本技能是 Bevy 0.20 的恐怖题材路由(thin router),用于在构建恐怖游戏时,把题材相关的每实体状态以 ECS 数据形式组织起来。它的定位是题材路由:领域具体工作留在其链接的 Bevy 技能中,本文件只登记 sanity(理智)、suspicion(疑心)与 light(光源)系统。
主要能力
- 组件(Components):以普通数据持有题材的每实体标记,本文件不引入新的引擎类型。
- 资源(Resources):通过 bevy-data-resources 持有整局计数器(分数、波次索引、随机种子)。
- 系统(Systems):在
Update或来自 bevy-master 的固定时间步上读取这些组件;当后续系统必须看到前一系统结果时,用.chain()排序。 - 调度(Schedule):玩法模式切换经由 bevy-state-machines;本文件只注册 sanity、suspicion 与 light 系统。
使用方式
依赖为:
[dependencies]
bevy = "0.20"
示例包含三部分:
Sanity组件与SanityDrain资源,在FixedUpdate上按drain * delta_secs扣减理智,最低为 0,并以SanityPlugin注册。Stalker组件带有suspicion与sees_player;看到玩家时疑心按delta_secs上升至上限 1.0,否则按delta_secs * 0.25下降至 0,通过StalkerPlugin在FixedUpdate上注册。LightCell组件按delta_secs * 2.0消耗能量,spawn_player在Startup生成带有Sanity { value: 100.0 }与LightCell { energy: 40.0 }的玩家,HorrorSetupPlugin将二者分别注册到Startup与FixedUpdate。
路由指向的链接技能:bevy-3d-lighting(黑暗)、bevy-audio-systems(惊吓音效)、bevy-ai-navigation(跟踪者策略)、bevy-mechanic-secrets(剧情标记)。
适用场景
当你在恐怖游戏中把理智或侦测作为组件,并需要灯光与音频配合时加载本技能。典型调用:玩家处于脆弱状态时恐惧下降(Sanity 于 FixedUpdate);跟踪者拥有视线(Stalker.sees_player 与 suspicion);手持光源消耗能量(LightCell.energy)。
状态归属与决策要点
- 单个实体上的数据由
Component持有,一个系统通过Query修改,调度为Update或FixedMain。 - 整个应用的一个值由
Resource持有,由单个系统修改,Startup插入后由读取它的调度运行。 - 生成由
Commands负责,世界初始生成在Startup,运行时生成在后续调度。 - 不可竞争的顺序由
.chain()保证,仅限被链式的系统,且在同一调度内。 - 插件边界由
Plugin的build注册系统与资源,在应用运行前完成。 - 借用规则:两个系统都可变查询同一组件时必须排序(
.chain())或拆分使只有一个写入;不相关的系统保持并行。 - 稳定模拟步进应使用
FixedMain与Fixed时钟,而非原始帧Update。
限制
- 不在文档 URL 中固定
/0.20.0/;链接保持在 latest,0.20 目标只在正文中声明一次。 - 不要从两个无序系统中可变查询同一组件。
- 不要在此发明物理、导航、网络或 XR crate;本技能只命名有文档的 Bevy crate 与模块。
- 不要在原始
Update上扣减理智;恐惧与光源能量属于模拟,应在FixedUpdate上。 - 不发明题材 API;Bevy 代码保持惯用 ECS,只使用有文档的 Bevy API。
参考
官方文档:Assets、Examples(latest 分支)、ECS、Plugins。前置技能:bevy-master、bevy-ecs-composition。补充技能:bevy-3d-lighting、bevy-audio-systems、bevy-ai-navigation、bevy-mechanic-secrets。下游消费者:无,本路由不持有第二份实现。