Particle Editor

Particle Editor

Torque 3D provides a full featured particle system with many parameters which can be manipulated to fine tune your particle effects. Particle effects are things such as fire balls, smoke, and water splashes that you create and place into your levels. The Torque 3D Particle Editor is the tool of choice for full control over the look and feel of your effects. At its most basic level a particle effect consists of: an emitter, a particle to be emitted from the emitter, and an image rendered to represent that particle.

The emitter controls: the creation of the particles; their movement; which directions the particles will travel, also referred to as the spread pattern and: how each particle blends into the world.

The particle controls its own life span, what image will be shown; how big the image is; what it’s color over time is; and some basic force settings.


The Particle Editor can be activated from the dmain menu by selecting Editors -> Particle Editor. Or alternately, click the Particle Icon from the Tool Selector bar.Whenever the Particle Editor is active the Particle Editor – Emitters pane will be present on the right side of the screen. This pane is further divided into two tabs:

  1. The Emitter tab contains properties about the currently selected emitter

  2. The Particles tab contains properties about the currently selected particle.

Select either the Emitter tab or particle tab depending upon which object you wish to work with. In adition to the tabs there are also two buttons within the header of the Particle Editor.

One Shot Effect Types

There are two types of particle effect:

  1. continuous effects, which constantly emit particles

  2. one-shot effects, which only produce particles for a short time and then stop

Continuous effects run constantly so your changes can be seen in real-time as you adjust the properties of the emitter and its particles. In order to see your changes for one-shot emitters you need to replay the emission. To replay a one-shot emitter click the arrow icon to the right of the tabs.

The Temporary Emitter

When you open the Particle Editor you may have noticed it creates a temporary particle emitter in your current view. This temporary emitter is very useful for quickly trying out different particle editor settings.If your view is changed and you no longer see temporary emitter, press the little camera icon to the right of the tabs to place it back into view. It will always be placed in the center of your current view. The temporary particle emitter can be moved, rotated, and scaled like any other shape using the Object Editor.

New Emitter / Particle

To create a new blank emitter or particle that is ready to be configured, press the new icon on the Emitter or Particle tab as appropriate.

Save Emitter / Particle

After editing an emitter or particle save the new settings by pressing the save icon on the Emitter or Particle tab as appropriate. Particle emitters are updated in real-time. Any changes to a particle or emitter will be reflected through out your level when changes are saved. Any instances of the emitter or particle that you are editing will also be changed. As with a lot of Torque 3D Editors the Particle Editor writes the resulting data to script files which the engine runs to create the particle emitter when you game is being played.

  • Emitters can be found in a file named: projectName/game/art/levels/levelName.mis

  • Particles can be found in a file named: projectName/game/art/shapes/particles/managedParticleData.cs

Emitter Properties

The Emitter tab contains the properties that define an Emitter. Properties are grouped into sections:


Basic properties affect the base emitter:

LifeThe time duration in ms that the effect will emit particles.Life (Random)Substitutes a random value for the life property.Infinite LoopWhen enabled this emitter will continuously produce particles. This setting effectively causes the Life and Random Life properties to have no affect on the emitter.AmountThe time in ms between each individual particle released from the emitter.Amount RandomRandom Variation amount to be applied to the amount setting.


These settings will affect the emitter spread pattern, speed, and particle image orientation:


These setting affect how the spread pattern will be dispersed:


This affect assigns which particle(s) will be emitted from this emitter:

Particle 1 - 4Select the particle from the drop down list to be used with this emitter. If at any time you need to remove a particle press the clear icon. Particle 1 can not be removed.


These setting affect how the particle(s) are rendered.

Particle Properties

The Particle tab contains the properties that define a Particle. Properties are grouped into sections:


Particle basic settings.

Texture MapThe image that will be used on the emitted particle. The Edit button will open a file browser to locate and select a particle image.Inverse AlphaInvert the alpha channel on the partice image (if one exists).LifeThe time in ms (milliseconds) after its creation that the particle will exist for.Life RandomRandom variation to the particle life span.


These settings affect the velocity of the particle.

Initial SpeedThe initial velocity, that the particle will travel at after being emitted. (Not to be confused with emitter spread speed.)AccelerationThe rate at which the particle’s velocity with increase or decrease. Positive values cause a particle to speed up over time after being emitted. Negative values cause a particle to slow down over time after being emitted.GravityThe gravitational force to be applied to particle. Positive values cause the particle to fall to the ground. Negative values cause the particle to rise from the ground.DragThe amount of force working against the particle velocity. Drag will slow a particle’s movement.


These settings affect if, and how, a particle rotates in degrees.

Spin MinThe minimum rotation to be applied to the particle.Spin MaxThe maximum rotation to be applied to the particle.Spin SpeedThe speed of particle’s rotation.


These settings affect the particle based upon how long it has been in existence for. Each particle can have up to four color and size settings, which can be set to change over time.

ColorsFour color swatches indicate the color phases which a particle can pass through. To set any color click that swatch. To set a color value you may: enter R (red), G (green), and B (blue) color values; click anywhere within the gradient on the left or; click anywhere in the vertical “rainbow” strip. Red, green and blue color values range from 0 to 255 and indicate the amount of that color present in the overall particle color. The alpha value which represents the transparency of the particle color can be set by entering a decimal number between 0.0 and 1.0 in the Alpha field or by moving the slider with the mouse. The higher the number the less transparent the color will be.Size 1-4Each slider sets the size for the particle during each time stage.Time 1-4Each slider sets the time for that stage.

Last updated