Index
Basic Structure Overview
Particle effects consist of basic render parameters, and a set of components. Components can be placed in any order. Outline:Component Concept
The particle system is component based. What this means is that particle effects are composed via a set of components. In order for an effect to do something, you add a component that handles that aspect of the effect. For example, an emitter usually needs to have rules for its lifetime, thus the effect should have one or more lifetime components that handle lifetime duties for the emitter and emitted particles.The idea is that new components can be added later, and one can combine components (where it makes sense) to get different behaviors. A particle might have a Dynamic component for moving around, and a Collision component for handling interaction with the terrain, for example.Think of components as telling the particle system what you want the emitter or particle to do, rather than exposing a list of particle parameters and having to wrangle those parameters to get the desired behavior.Back to topCurrent Component List
For fields in these components, the following shorthand is used:Emitter Components
Emitter Lifetime Components
Emitter Lifetime Events component
Allows for lifetime events on the emitter to trigger certain events.Emitter Lifetime Expression component
Emitter will turn 'on' when the activation expression is non-zero, and will turn 'off' when it's zero. This is useful for situations like driving an entity-attached emitter from an entity variable.Emitter Lifetime Looping component
Emitter will loop until it is removed.Emitter Lifetime Once component
Emitter will execute once, and once the lifetime ends or the number of particles allowed to emit have emitted, the emitter expires.Emitter Rate Components
Emitter Rate Instant component
All particles come out at once, then no more unless the emitter loops.Emitter Rate Manual component
Particle emission will occur only when the emitter is told to emit via the game itself. This is mostly used by legacy particle effects.Emitter Rate Steady component
Particles come out at a steady or Molang rate over time.Emitter Shape Components
Shape controls both where the particles are emitted from and the initial direction of the particles.Emitter Disc component
This component spawns particles using a disc shape, particles can be spawned inside the shape or on its outer perimeter.Emitter Shape Box component
All particles come out of a box of the specified size from the emitter.Emitter Shape Custom component
All particles are emitted based on a specified set of Molang expressions.