🍩 Sprinkles

Sprinkles is a GPU-accelerated particle system for the Bevy game engine with a built-in dedicated visual editor.

⛹️ Check out all the examples here!

Usage

Add bevy_sprinkles to your project:

[dependencies]
bevy_sprinkles = "0.2"

Add the plugin to your Bevy app:

use bevy::prelude::*;
use bevy_sprinkles::prelude::*;

fn main() {
    App::new()
        .add_plugins((DefaultPlugins, SprinklesPlugin))
        .run();
}

Spawn a particle system from a RON asset file:

fn setup(mut commands: Commands, asset_server: Res<AssetServer>) {
    commands.spawn(ParticleSystem3D {
        handle: asset_server.load("my_effect.ron"),
    });
}

Editor

Sprinkles comes with a visual editor for designing particle systems. To run it from the repository:

cargo editor

Or install the editor globally:

cargo install bevy_sprinkles_editor

Then run it from anywhere with the sprinkles command.

Documentation

Documentation is available at docs.rs.

Bevy version table

Features

• GPU particle simulation & sorting
• Fully fledged built-in visual editor
• 3D support (2D is planned)
• PBR material support (custom shaders is planned)
• Automatic GPU instancing across emitters & systems
• Particle collision
• Curl noise turbulence
• Billboard & velocity-aligned transform modes
• Sub-emitters

Acknowledgements

Godot's particle system is a huge source of inspiration for Sprinkles, and we aim to reach feature parity at some point. Thank you for all it's contributors.

Brackeys' video on making VFX with Godot was what inspired me to work on a similar system for Bevy and adapt some of those VFXs to it.

All bundled textures are provided by the very talented and generous Kenney.

License

Licensed under either of

• Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
• MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)

at your option.

Project examples and bundled textures are licensed under CC0.

The editor includes two icon sets:

• Remix Icon, licensed under Remix Icon License v1.0
• Blender icons, licensed under CC BY-SA 4.0 by Andrzej Ambroż. ^[source]

The donut icon is an edited version of the Noto Emoji, licensed under Apache 2.0.