用途
本技能用于在 Bevy 引擎中使用 ECS 方式构建粒子效果。适用时机:添加一次性的爆发粒子(burst)、拖尾(trail)或 GPU 粒子效果之前。资料明确指出:粒子效果需要开发者自己在 ECS 中搭建,不要自行发明一个粒子插件。
主要能力与 ECS 形态
- Components:
Particle拥有每个微粒,Emitter拥有每个发射器,Sprite是可见的 quad(方块)。 - Resources:无。爆发原点与速率存储在发射器实体上。
- Systems:一个系统负责生成微粒,一个系统负责积分计算并销毁已死亡的微粒。
- Schedule:两者都运行在
FixedUpdate上,并链式(chained)执行,使本步生成的微粒在下一步被积分。
从 Godot 迁移的对照
| Godot 概念 | Bevy 惯用法 |
|---|---|
| CPU 粒子 | 带有 Particle、Sprite 和 Transform 的实体 |
| GPU 粒子 | 同样的实体,由 sprite 管线绘制 |
| 一次性爆发 | 生成固定数量,然后在 life 归零时销毁 |
范围说明
Bevy 不附带粒子模块。一次爆发是对 Sprite 实体的生成循环;一条拖尾是一个消耗速率累加器的发射器组件。
使用方式(示例要点)
依赖配置示例使用 bevy = "0.20" 与 rand = "0.9"。
- 一次性爆发:在循环中生成 24 个微粒,使用随机角度(0 到 TAU)与随机速度(1.0 到 4.0),每个微粒带随机生命(0.3 到 0.8),并附带颜色为
Color::srgba(1.0, 0.45, 0.1, 1.0)、尺寸为 6.0 的Sprite和初始Transform。每个微粒存储速度与剩余生命。 - 积分模拟:在
Fixed时钟的时间步中,先扣减life,若小于等于 0 则 despawn 并跳过;然后对 Y 施加重力(velocity.y -= 6.0 * dt),按速度更新transform.translation,并根据生命值 clamp 设置 sprite 透明度。 - 发射器 / 拖尾:
Emitter持有rate与accumulator。每步累加rate * dt,当累加器达到 1.0 时生成一个微粒并减去 1.0;微粒的位置取自发射器当前的Transform,初速度带随机小范围,生命固定为 0.6。示例最后用ParticlePlugin在FixedUpdate上注册(emit, simulate).chain()。
专家知识要点(Bevy 0.20+)
核心 ECS 类型包括 Component、Resource、Query、Commands、Startup、Update、Fixed / FixedMain(bevy::time)、.chain()、Plugin、DefaultPlugins、MinimalPlugins。消息与观察者属于另一个所有权槽位,其 API 参见 bevy-events-messaging。除非用 .chain() 排序相互冲突的系统,否则系统并行运行。
状态归属
| 内容 | 所有者 | 谁可修改 | Schedule |
|---|---|---|---|
| 单个实体上的数据 | Component |
一个系统通过 Query |
Update 或 FixedMain |
| 全应用唯一的值 | Resource |
一个系统 | Startup 插入,随后读取它的 schedule |
| 生成 | Commands |
执行生成的系统 | 初始世界用 Startup;运行时生成用后续 schedule |
| 不能竞争的次序 | .chain() |
仅被链接的系统 | 同一 schedule |
| 插件边界 | Plugin |
build 注册系统与资源 |
应用运行之前 |
借用规则:两个系统若都可变查询同一组件,必须排序(.chain())或拆分到只有一个写入者;不相关的系统保持并行。
决策表
| 如果需要 | 这样做 | 不要 |
|---|---|---|
| 逐实体数据 | Component + Query |
Godot 节点脚本 |
| 应用级配置或时钟 | Resource |
把值复制到每个实体 |
| 稳定的模拟步长 | FixedMain 与 Fixed 时钟 |
把模拟绑定到原始帧 Update |
| 启动生成 | Startup 中的 Commands |
从渲染系统生成 |
| 非共享状态的跨系统通知 | bevy-events-messaging 中的消息或观察者槽位 |
在本文件中新造的 event 类型 |
| 文档集合之外的 API | 先查官方文档 | 自造的 crate 或 API |
限制与禁止事项
- 不要在文档 URL 中固定
/0.20.0/;链接保持在latest,0.20 目标在正文中说明一次即可。 - 不要从两个未排序的系统可变查询同一组件。
- 不要在此发明物理、导航、网络或 XR crate;本技能只使用已文档化的 Bevy crate 与模块。
- 不引入 Godot 粒子节点类型;Bevy 代码保持惯用 ECS,仅使用文档化的 Bevy API。
- 不指定某个具名粒子 crate 作为解决方案。
- 不引入自造 API 或未具名的第三方 crate 作为求解器。
参考资料
官方文档:bevy crate(API 参考与 Cargo feature 列表)、Assets(官方资源目录,未选定第三方 crate)、Examples(latest 分支示例树)、ECS 快速入门、Plugins 快速入门。
相关技能:前置为 bevy-master(枢纽与 schedule)、bevy-ecs-composition(组件与系统);互补为 bevy-shaders(材质不等于粒子系统)、godot-particles(等价的 Godot 技能);下游消费者暂未提供;bevy-master 为 Bevy 路由器。
关于具体性能开销、平台支持范围、收费与价格、实际视觉效果等信息,资料未提供。