用途:在 Bevy 引擎中搭建 3D 关卡,把网格、灯光和碰撞体放入场景。适用时机是放置网格、灯光与碰撞体;场景生成机制归 bevy-asset-scenes,物理体归 bevy-physics-3d。
主要能力:以 ECS 实体组织关卡。基础体(Cuboid、Sphere、Cylinder)转成 Mesh,并搭载 Mesh3d 与 MeshMaterial3d。灯光用带 Transform 的 DirectionalLight 实体;雾效是相机实体上的 DistanceFog。场景通过 bevy_scene 和 bevy_gltf 特性支持。系统用 Resource 记录已加载单元格,用 Commands 在 Update 中生成单元格。示例给出 spawn_level、spawn_prop、stream_cells 三类写法,道具为普通实体并由辅助函数返回实体 id 以便后续挂载标记。
使用方式:依赖项为 bevy = "0.20",目标版本 Bevy 0.20+。核心类型包括 Component、Resource、Query、Commands、Startup、Update、Fixed/FixedMain、.chain()、Plugin、DefaultPlugins、MinimalPlugins。规划需求时可对照:打包关卡走场景资产,组合道具用带 Mesh3d 与 MeshMaterial3d 的实体,氛围用 DirectionalLight、DistanceFog 与相机实体。
限制:高度图需自行填充 Mesh 后用同样方式生成;碰撞体创作归属 bevy-physics-3d,且物理求解器尚未选定。禁止在文档 URL 中固定 /0.20.0/;禁止两个无序系统可变查询同一组件,否则需用 .chain() 排序或拆分;不得虚构物理、导航、网络或 XR crate,也不得使用未命名的第三方求解器;Bevy 代码中不得出现 CSG、网格地图或世界环境节点类型。未提供的具体结论明确暂未提供。