#Particles

A ParticleSystem emits small squares that face the camera, move, fade and die: smoke, sparks, dust.

#Settings

Every field is listed in Components.

Colours above 1 bloom.

#Tuning

Particles play while you edit, so a system can be tuned by eye in the viewport.

#From a script

local particles = self.Entity.ParticleSystem
particles:Burst(30)   -- a puff, now

declare const entity: Entity;

const particles = entity.ParticleSystem!;
particles.Burst(30);   // a puff, now

A common pattern is a prefab with a system that does not loop and has one burst. A script places it where something happened and destroys it a second later:

Scene.Instantiate(self.BurstPrefab, position):Destroy(1.5)

declare const burstPrefab: AssetHandle;
declare const position: Vec3;

Scene.Instantiate(burstPrefab, position).Destroy(1.5);

Colours are set as a Vec3 with how solid they are beside them:

particles.StartColor = Vec3(4, 2, 1)
particles.EndAlpha = 0
particles.Blend = "Additive"

declare const particles: ParticleSystem;

particles.StartColor = Vec3(4, 2, 1);
particles.EndAlpha = 0;
particles.Blend = "Additive";