SuperAPI AI 工具集

bevy-particles

编程与开发

查看项目

更新于 10-16 10:40

技能介绍

用途

本技能用于在 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"。

  1. 一次性爆发:在循环中生成 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。每个微粒存储速度与剩余生命。
  2. 积分模拟:在 Fixed 时钟的时间步中,先扣减 life,若小于等于 0 则 despawn 并跳过;然后对 Y 施加重力(velocity.y -= 6.0 * dt),按速度更新 transform.translation,并根据生命值 clamp 设置 sprite 透明度。
  3. 发射器 / 拖尾: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 路由器。

关于具体性能开销、平台支持范围、收费与价格、实际视觉效果等信息,资料未提供。