SuperAPI AI 工具集

bevy-genre-open-world

编程与开发

查看项目

更新于 10-16 10:37

技能介绍

用途

这是一个 Bevy 开放世界(Open world)的“类型路由”(thin router)技能,用于流式加载区域和远处角色(distant actors)。它本身不实现具体领域逻辑,而是把领域工作路由到其他 Bevy 技能。核心场景是:区域归属(region membership)是一个组件,玩家所在单元格(player cell)是一个资源,激活逻辑在单元格写入之后于同一条链中运行。

主要能力

  • 以 ECS 方式组织开放世界:组件保存每个实体的标志数据,资源保存全局计数器(如分数、波次索引、种子),系统在 Update 或固定时间步上读取组件。
  • 通过 .chain() 排序系统,确保后续系统能看到前一个系统的结果。
  • 区域流式加载:用 Resident 组件记录单元格,用 Active 组件标记激活状态,由一条链式系统根据玩家单元格插入或移除 Active。
  • 远处角色仅在 Active 存在时移动(例如围绕 home 点游荡)。
  • 游戏模式变化通过 bevy-state-machines 处理,不自行发明类型插件。

使用方式

在 Cargo.toml 中依赖 bevy = "0.20"。定义 Player、Resident { cell: i32 }、Active 组件,以及 PlayerCell(i32) 资源。track_cell 系统根据玩家 Transform 计算单元格并写入 PlayerCell;activate 系统在 Resident.cell 与 PlayerCell 差值绝对值不超过 1 时插入 Active;deactivate 系统在差值大于 1 时移除 Active。三者通过 .chain() 排序。远处角色用 Wander { home, angle } 组件,仅在带 Active 时更新位置。玩家和一圈居民在 Startup 中生成。

适用场景

  • 需要按单元格激活/停用远处角色的 Bevy 开放世界。
  • 区域场景、世界组装、环境角色、任务目标等可分别路由到 bevy-asset-scenes、bevy-3d-world-building、bevy-ai-navigation、bevy-quest-system。

限制

  • 目标为 Bevy 0.20+。
  • 区域归属和激活距离是自有组件;网格 LOD 属于 bevy-3d-world-building。
  • 不在此处发明物理、导航、网络或 XR crate;不发明世界分区类型或类型插件。
  • 不要从两个无序系统可变查询同一组件;不要使用场景树类型;不要发明类型 API。
  • 文档 URL 不要固定 /0.20.0/,链接保持在 latest。
  • 本技能不拥有第二套实现,下游消费者为空。