SuperAPI AI 工具集

bevy-navigation

编程与开发

查看项目

更新于 10-16 10:38

技能介绍

用途

Bevy navigation 是一个面向 Bevy ECS 的导航技能,用于在智能体添加 crate 之前,为其在可行走空间上规划一条路径。它聚焦于“路径本身”:在网格上做搜索并生成路径点,供后续移动系统消费。

主要能力

  • 以 ECS 结构组织导航:组件存储单个智能体的目标格与路径点列表;资源持有可行走网格(宽度、高度、阻挡格);系统在 Update 中搜索,在 FixedUpdate 中沿路径步进。
  • 使用 .chain() 保证新路径在运动之前可见。
  • 提供网格、广度优先搜索与跟随者的实现示例,足以处理可行走单元格。
  • 明确所有权划分:智能体是带有目标与路径点列表的实体;可行走空间是包含阻挡格的 WalkGrid 资源;避让(分离)归属 bevy-ai-navigation;下一个路径点由 AgentPath 在 FixedUpdate 中步进。

使用方式

技能给出 Rust 代码示例,展示如何定义 WalkGrid 资源、GoalCell 与 AgentPath 组件,以及 search、plan_paths、follow_paths 系统,并通过 NavigationPlugin 注册资源与系统。示例依赖 bevy = "0.20"。标记某格为阻挡并给智能体一个目标后,由于网格资源发生变化,规划会重新运行。

适用场景

  • 需要在可行走单元格上为智能体生成路径。
  • 使用 Bevy ECS 组织导航数据与系统。
  • 作为更上层行为(追逐、巡逻、重新选目标)的路径基础。

限制

  • 范围限于网格、广度优先搜索与跟随者;导航网格烘焙与群体半径不在本技能内。
  • 路径点存在后的角色移动归属 bevy-character-movement。
  • 追逐、巡逻与重新选目标策略归属 bevy-ai-navigation。
  • 不引入其他引擎的导航类型,不指定第三方导航 crate 作为求解器,不发明烘焙、避让或路径查询 API。
  • 目标为 Bevy 0.20+;文档 URL 不固定 /0.20.0/,链接保持在 latest。
  • 不得从两个无序系统可变查询同一组件,除非用 .chain() 排序。

相关技能

前置:bevy-master(ECS 所有权)、bevy-character-movement(路径点存在后角色如何移动)。互补:bevy-ai-navigation(追逐、巡逻与重新选目标策略,而非网格)。