SuperAPI AI 工具集

bevy-ai-navigation

编程与开发

查看项目

更新于 10-16 10:39

技能介绍

用途

当某个 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 导航模块。