Particle Editor

Basics

The Particle Editor is used to create and edit the components a particle is made of:

  • Emitter
  • Particles

The Inspector window is required to use this edit mode. Two tabs are shown for each of these components.

Inspector window in Particle Editor mode Inspector window in Particle Editor mode

The average workflow to create new particles is to first create a new Emitter and then the related Particle. When entering this edit mode, a temporary particle emitter is placed in front of the camera to convieniently be able to see any changes without having to place an emitter manually. This is removed once leaving the edit mode.

Emitter

The Emitter is the object that fires the particles. In this tab you can find all the properties that determine its dynamics.

Emitter tab Emitter tab

At the top of this tab is a dropdown menu to select which emitter to display. To the right of this are the buttons to create a new emitter and save changes (either to its own file, or into the the current level’s folder)

Property
Description
Property
ejectionPeriodMS
Description
Time between each particle ejection, in miliseconds
Property
periodVarianceMS
Description
Randomize ejection period by this value, in miliseconds
Property
ejectionVelocity
Description
Particle ejection velocity
Property
velocityVariance
Description
Randomize ejection speed by this value
Property
ejectionOffset
Description
Distance along the emitter’s Z axis from which to eject the particles
Property
ejectionOffsetVariance
Description
Randomize the ejection offset by this value
Property
thetaMin/thetaMax
Description
Minimum and maximum angle on the horizontal plane to eject particles from
Property
phiReferenceVel
Description
Angle on the vertical plane to eject particles from
Property
phiVariance
Description
Randomize angle on the vertical plane by this value
Property
softnessDistance
Description
Distance at which the particles will be faded based on the distance between the particle and scene geometry
Property
ambientFactor
Description
Amount of ambient lighting affecting the particle
Property
overrideAdvance
Description
If false, particles emitted in the same frame have their position adjusted to prevent clumping
Property
orientParticles
Description
If true, particles will be oriented to face the camera
Property
orientOnVelocity
Description
If true, particles will be oriented in the direction they are moving
Property
particles
Description
Particle datablock the emitter will use. Only one datablock is officially supported
Property
lifetimeMS
Description
Lifetime of each particle (from spawn to removal), in miliseconds
Property
lifetimeVarianceMS
Description
Randomize the particle’s lifetime by this value
Property
useEmitterSizes
Description
If true, the particle’s size will depend on the emitter’s scale
Property
useEmitterColors
Description
If true, the particle’s color will depend on the emitter’s color
Property
blendStyle
Description
Blend mode to use for the particle
Property
softParticles
Description
If true, particles are sorted from furthest to nearest
Property
reverseOrder
Description
If true, particles are rendered from oldest to newest
Property
textureName
Description
Optional texture to use for the particle, will override the texture set on the particle
Property
alignParticles
Description
If true, particles will be oriented toward the direction set in the alignDirection property
Property
alignDirection
Description
Defines a direction particles should allign with, if alignParticles is enabled
Property
highResOnly
Description
If disabled, particles are drawn at half resolution. Disabling this could decrease performance for large amount of particles
Property
renderReflection
Description
If true, particles will appear in water’s dynamic reflections
Property
backLighting
Description
Amount of backlight the particle receives
Property
useLighting
Description
Enable dynamic lighting on the particle

Particle

In this tab you can find all the properties that determine the particles' dynamics.

Emitter tab Emitter tab

At the top of this tab is a dropdown menu to select which particle to display. To the right of this are the buttons to create a new particle and save changes.

Property
Description
Property
dragCoefficient
Description
Amount of physical drag
Property
windCoefficient
Description
Amount of physical wind effect
Property
gravityCoefficient
Description
Amount of physical gravity effect
Property
inheritedVelFactor
Description
Amount of emitter velocity to add to the particle
Property
constantAcceleration
Description
Constant acceleration to apply to this particle
Property
lifetimeMS
Description
Lifetime of each particle (from spawn to removal), in miliseconds
Property
lifetimeVarianceMS
Description
Randomize the particle’s lifetime by this value
Property
spinSpeed
Description
Speed at which to spin the particle
Property
spinRandomMin/spinRandomMax
Description
Speed range to use for spinSpeed
Property
useInvAlpha
Description
If false, particles will use the additive blend mode. Can be overriden by the blendStyle property of the emitter
Property
animateTexture
Description
If true, particle texture can be animated by a sprite. Not officially supported
Property
framesPerSec
Description
Framerate of animateTexture
Property
textureCoords [0-3]
Description
Defines the UV coordinates for the particle’s texture mapping. Use, for example, if the texture contains multiple particles packed together
Property
textureName
Description
Texture to use for the particle
Property
animTexName
Description
Animated texture to use for the particle (if animateTexture is enabled
Property
colors [0-3]
Description
Colors to use for the particle at given times
Property
sizes [0-3]
Description
Size to use for the particle at given times
Property
times [0-3]
Description
Time keys used for the colors and sizes properties
Last modified: 7/12/2021 19:55
On this page:

Any further questions?

Join our discord