SuperAPI AI 工具集

bevy-procedural-generation

编程与开发

查看项目

更新于 10-16 10:38

技能介绍

用途

当关卡、掉落表或地图需要能够从种子复现,并且你需要对应的 ECS 结构时,使用本技能。生成完成的布局通过 Commands 在 Startup 或你已在使用的后续调度中生成。保存种子属于 bevy-save-load 的职责。

主要能力

  • ECS 结构:组件(Components)是你定义的格子事实,用 Commands 生成;资源(Resources)用单个 RunSeed 表示整局运行,生成器读取它,而不自行发明 Bevy 的 RNG 类型,rand 0.9 提供 StdRng;系统(Systems)在 Startup 插入种子,然后依据该数据生成,用 .chain() 保证生成系统能看到种子;调度(Schedule)上,一次性地图用 Startup,流式地图用后续的 Update 系统,但仍读取同一个种子。
  • 依赖:bevy = "0.20"、rand = "0.9"。
  • 种子化随机游走:种子是资源,游走是普通数据,实体只在种子存在后才生成。示例中 insert_seed 插入 RunSeed(42),spawn_walk 用 StdRng::seed_from_u64 生成 24 个 FloorCell 并附带 Transform,通过 DungeonPlugin 在 Startup 中以 .chain() 顺序执行。
  • 高度采样:高度样本保存在资源中,同一种子总是重建同一网格,采样只发生一次而非每帧。示例提供 hash_unit 哈希函数与 build_heights 系统,把 16×16 的采样写入 HeightGrid 资源。
  • 房间雕刻:房间是刻入你自己网格的矩形,只为地板格子生成标记。示例提供 Room 结构、carve 函数与 spawn_rooms 系统。

使用方式

按“谁拥有状态”的表格选择归属:种子化运行由你定义的持有种子的 Resource 负责;区块或地牢网格由你的组件配合 Commands 生成;哈希、房间或游走由你基于 RunSeed 的函数实现,rand::rngs::StdRng 是种子化生成器;地板格子是由网格生成的实体,瓦片地图属于 tile 技能;生成后的导航烘焙属于 bevy-navigation。

ECS 所有权规则:单个实体上的数据用 Component,由单个系统通过 Query 修改,运行在 Update 或 FixedMain;整个应用共享的一个值用 Resource,由单个系统修改,Startup 插入后由读取它的调度使用;生成用 Commands,由生成系统负责,初始世界在 Startup,运行时生成在后续调度;不能竞态的顺序用 .chain(),仅约束被链式的系统,处于同一调度;插件边界用 Plugin,build 在应用运行前注册系统与资源。借用规则:两个都可变查询同一组件的系统必须排序(.chain())或拆分到只有一个写入,无关系统保持并行。

适用场景

需要可复现的种子化关卡、地牢、地形高度或掉落表,并且希望保持 Bevy 惯用 ECS 写法的场景。

限制

  • 上述种子化游走与房间雕刻使用 rand 0.9 和你自己的网格,Bevy 不附带地牢求解器。
  • 在主调度上构建网格,然后再生成;Commands 留在该处运行的系统上。
  • 生成地图后的导航重烘焙属于 bevy-navigation。
  • 不要在两个无序系统中可变查询同一组件,因为调度会并行运行系统,除非用 .chain() 排序。
  • 不要在本技能中发明物理、导航、网络或 XR crate;不要引入 Godot 的噪声、瓦片或线程池类型;不要发明噪声、波函数或区块 API;不要把具名第三方生成 crate 作为选定工具。
  • 文档 URL 不要固定 /0.20.0/,链接保持在 latest,0.20 目标只在正文中说明一次。
  • 目标版本为 Bevy 0.20+。核心 ECS 类型包括 Component、Resource、Query、Commands、Startup、Update、Fixed / FixedMain(bevy::time)、.chain()、Plugin、DefaultPlugins、MinimalPlugins。消息与观察者属于另一个所有权槽位,其 API 见 bevy-events-messaging。

参考

官方文档:Assets、Examples、ECS、Resources。相关技能:前置为 bevy-master、bevy-data-resources、bevy-ecs-composition;互补为 bevy-asset-scenes、bevy-save-load、bevy-navigation、godot-procedural-generation;主技能为 bevy-master。