用途
当关卡、掉落表或地图需要能够从种子复现,并且你需要对应的 ECS 结构时,使用本技能。生成完成的布局通过 Commands 在 Startup 或你已在使用的后续调度中生成。保存种子属于 bevy-save-load 的职责。
主要能力
- ECS 结构:组件(Components)是你定义的格子事实,用
Commands生成;资源(Resources)用单个RunSeed表示整局运行,生成器读取它,而不自行发明 Bevy 的 RNG 类型,rand0.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 写法的场景。
限制
- 上述种子化游走与房间雕刻使用
rand0.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。