SuperAPI AI 工具集

bevy-genre-horror

编程与开发

查看项目

更新于 10-16 10:39

技能介绍

用途

本技能是 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"

示例包含三部分:

  1. Sanity 组件与 SanityDrain 资源,在 FixedUpdate 上按 drain * delta_secs 扣减理智,最低为 0,并以 SanityPlugin 注册。
  2. Stalker 组件带有 suspicion 与 sees_player;看到玩家时疑心按 delta_secs 上升至上限 1.0,否则按 delta_secs * 0.25 下降至 0,通过 StalkerPlugin 在 FixedUpdate 上注册。
  3. 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。下游消费者:无,本路由不持有第二份实现。