bevyparticlesystems

A native and WASM-compatible 2D particle system plugin for bevy

Note: This crate is still under development and its API may change between releases.

Example

The above was captured running a release build of the basic example, cargo run --example basic --release, and ran at 190-200 FPS on a 2019 Intel i9 MacBook Pro, rendering about 10k particles.

INFO bevy diagnostic: frame_time : 5.125810ms (avg 5.211673ms) INFO bevy diagnostic: fps : 206.027150 (avg 204.176718) INFO bevy diagnostic: entity_count : 11358.713999 (avg 11341.450000)

Usage

1. Add the [ParticleSystemPlugin] plugin.

```rust use bevy::prelude::*; use bevyparticlesystems::ParticleSystemPlugin;

fn main() { App::new() .addplugins((DefaultPlugins, ParticleSystemPlugin::default())) // <-- Add the plugin // ... .addsystems(Startup, spawnparticlesystem) .run(); }

fn spawnparticlesystem() { /* ... */ } ```

1. Spawn a particle system whenever necessary. ```rust use bevy::prelude::; use bevy_particle_systems::;

fn spawnparticlesystem(mut commands: Commands, assetserver: Res) { commands // Add the bundle specifying the particle system itself. .spawn(ParticleSystemBundle { particlesystem: ParticleSystem { maxparticles: 10000, texture: ParticleTexture::Sprite(assetserver.load("myparticle.png")), spawnratepersecond: 25.0.into(), initialspeed: JitteredValue::jittered(3.0, -1.0..1.0), lifetime: JitteredValue::jittered(8.0, -2.0..2.0), color: ColorOverTime::Gradient(Gradient::new(vec![ ColorPoint::new(Color::WHITE, 0.0), ColorPoint::new(Color::rgba(0.0, 0.0, 1.0, 0.0), 1.0), ])), looping: true, systemdurationseconds: 10.0, ..ParticleSystem::default() }, ..ParticleSystemBundle::default() }) // Add the playing component so it starts playing. This can be added later as well. .insert(Playing); } ```

Bevy Versions

|bevy_particle_systems|bevy| |:--|:--| |0.10|0.11| |0.9|0.10| |0.6 - 0.8|0.9| |0.5|0.8| |0.4|0.7|