用途
当某个 actor 需要追逐、巡逻或等待时加载本技能。它拥有行为意图和目标重选逻辑,并产出期望速度;路径规划不属于本技能。
策略写入 DesiredVelocity,不移动 Transform,也不查询导航网格(navmesh)。
主要能力
- 用枚举
Component表达行为模式(Brain:Wait/Patrol/Chase)。 - 用
Goal组件表示目标位置,用DesiredVelocity表示期望速度。 - 用
Timer资源在FixedUpdate上为 retarget 节流(示例为 0.4 秒重复)。 - 通过
.chain()保证策略系统在移动系统之前运行。
策略归属划分:
| 需求 | 归属 |
|---|---|
| 追逐 / 巡逻 / 等待 | 枚举 Component 加一个写入 Goal 的系统 |
| 目标重选节流 | 在 FixedUpdate 上滴答的 Timer 资源 |
| 群组与避让 | bevy-navigation |
| Bake 与障碍物 | bevy-navigation |
| 视线 | bevy-spatial-queries |
ECS 结构
- Components: 模式标志可以是枚举
Component;目标位置可以用你自己的组件。 - Resources: 共享巡逻表可以是你定义的
Resource。 - Systems: 读取模式并写入期望速度或路点,运行在
Update或Fixed上;用.chain()让策略先于移动。不要调用会写Transform的 agent 回调。 - Schedule: 当结果要喂给移动步骤时使用
Fixed/FixedMain。
使用方式
依赖:
[dependencies]
bevy = "0.20"
核心策略系统(tick_policy)在计时器到时后,根据 Brain 分支设置 Goal:Wait 保持当前位置,Patrol 在 PatrolRoute 路点间循环推进,Chase 取玩家位置。steer 系统根据 Goal 与当前 Transform 的偏移计算水平方向,并写入 DesiredVelocity(距离足够近则归零,否则按 3.0 速度缩放)。插件 NavPolicyPlugin 在 build 中插入 PatrolRoute 与 RetargetClock 资源,并在 FixedUpdate 上以 .chain() 注册 (tick_policy, steer)。示例还包含一个 spawn_patrol 生成函数与 hold_when_close 行为。
适用场景
- 敌人或 NPC 需要在追逐、巡逻、等待之间切换,且必须先决定目标再做移动。
- 需要稳定的固定步长模拟(
FixedMain),避免把模拟绑定到原始帧Update。
限制
- 本技能只写
Goal与DesiredVelocity,不移动Transform,不查询 navmesh,不做路径、bake 或避让。 - 不引入任何第三方导航或物理 crate,不使用其他引擎的导航 agent / nav-server 类型。
- 不虚构路径、bake 或避让 API;超出文档集合的 API 应先查官方文档。
- 两个无序系统不得同时可变查询同一组件,否则必须用
.chain()排序或拆分。 - 文档 URL 不固定
/0.20.0/,链接保持在latest,0.20 目标只在正文说明一次。 - 实体级巡逻模式不应使用 App states,实体级标志应保持为组件。
参考与相关技能
前置:bevy-master(ECS 归属)、bevy-navigation(路径与导航网格)、bevy-state-machines(模式标志的枚举组件)。
互补:bevy-character-movement(集成路点或速度)、bevy-spatial-queries(传感器与空间查询)。
官方文档:Assets、Examples(latest 分支示例树)、ECS 快速入门。
库 pin 保持 0.20.0;未打开任何 AI 导航模块。