Particle emitters

ParticleEmitter is an object that emits customizable 2D images (particles) into the world, useful for simulating special effects like fire, smoke, and sparks.

You can parent a ParticleEmitter to an Attachment or an object of the BasePart class. When parented to a BasePart, particles spawn randomly within the part's bounding box or shape; when parented to an Attachment, particles spawn from the attachment's position.

Additionally, the EmissionDirection property determines the face (Enum.NormalId) of emission when the emitter is parented to a BasePart. When you change this property, you consequently change the particle emission direction as well.

Customize particles

By experimenting with the following properties, you can customize a particle's visual appearance to make unique gameplay elements like bursting volcanos, magical dust, and dust motes.

Texture

The Texture property renders the image that each particle displays. By default, particle emitters have particles with a white sparkle texture, but you can change it to any texture to achieve interesting effects.

Three similar particle emitters with different Texture assets

If you're creating an image to use as a particle texture, it's best to use .png format with a transparent background. If your texture is grayscale with no alpha channel, try setting the particle emitter's LightEmission property to 1 to hide the darker regions.

Color

The Color property tints each particle's texture to either a specific hue, or to a color gradient across its lifetime.

In a script, set a ColorSequence for the emitter's Color property:

local emitter = Instance.new("ParticleEmitter")
-- Constant color
emitter.Color = ColorSequence.new(Color3.fromRGB(255, 0, 40))
-- Gradient sequence
emitter.Color = ColorSequence.new{
ColorSequenceKeypoint.new(0, Color3.fromRGB(255, 0, 0)),
ColorSequenceKeypoint.new(0.5, Color3.fromRGB(255, 125, 0)),
ColorSequenceKeypoint.new(1, Color3.fromRGB(255, 200, 0))
}

Size

The Size property sets the size of each particle to a consistent size, or to a numerical sequence across its lifetime.

In a script, set a NumberSequence for the emitter's Size property:

local emitter = Instance.new("ParticleEmitter")
-- Constant size
emitter.Size = NumberSequence.new(3)
-- Numerical sequence
emitter.Size = NumberSequence.new{
NumberSequenceKeypoint.new(0, 1),
NumberSequenceKeypoint.new(0.2, 4),
NumberSequenceKeypoint.new(1, 0)
}

Transparency

The Transparency property sets the opacity of each particle as a consistent value, or as an opacity sequence across its lifetime. Opacity can range from 0 (totally opaque) to 1 (fully clear). For details on how to set particles to either a specific opacity or to a number sequence, follow the process in customizing Size but use the emitter's Transparency property field instead.

Static transparency vs. fading in/out

Lifetime

The Lifetime property sets the lifetime of a particle in seconds. You can set this property either as a consistent value, or provide a Min and Max range from which a random lifetime will be chosen for each particle.

Speed

The Speed property determines a random range of velocities (minimum to maximum) at which new particles will emit, measured in studs per second. Each particle's velocity is chosen upon emission and it applies in the EmissionDirection. Negative values cause particles to travel in reverse.

Note that changing Speed does not affect active particles and they retain whatever speed they already have. However, Acceleration, Drag, and VelocityInheritance can be used to affect the speed of active particles over their lifetime.

Rate

The Rate property sets the number of particles that emit per second. A single particle emitter can create up to 400 particles per second (100 per second on mobile). For best performance, keep the particle rate as low as possible and experiment with size and other properties to achieve the desired visual effect.

Orientation

The Orientation property determines which orientation mode to use for an emitter's particle geometry.

OrientationParticle behavior
FacingCameraStandard camera-facing billboard quad; default behavior.
FacingCameraWorldUpFacing the camera, but rotating only on the vertical upward world Y axis.
VelocityParallelAligned parallel to their direction of movement.
VelocityPerpendicularAligned perpendicular to their direction movement.
Expected outcome of particle orientation

LightEmission

The LightEmission property determines the blending of particle Texture colors with the colors behind them. A value of 0 uses normal blending mode while a value of 1 uses additive blending. Higher values can make particles glow even in environments with low lighting.

SpreadAngle

The SpreadAngle property has an X and a Y value which determine the range of angles from which a particle can emit. The range is calculated from both sides around the axes; for example, a value of (45, 0) emits particles in a range of 0° to 45° away from the EmissionDirection across the X axis.

WindAffectsDrag

If you've enabled global wind in a game, particles will follow the global wind vector as long as the emitter's WindAffectsDrag property is enabled and its Drag property is greater than 0.

Shape

The Shape property sets the shape of the particle emitter to either a Box, Sphere, Cylinder, or Disc.

After you select a shape for your particle emitter, you can experiment with the ShapeStyle, ShapeInOut, and ShapePartial properties to further customize particle emission.

ShapeStyle

The ShapeStyle property sets the emission type to either:

  • Volume — Particles emit anywhere within the shape.
  • Surface — Particles only emit from the outside of the shape.

ShapeInOut

The ShapeInOut property sets the emission as follows:

ShapePartial

The ShapePartial property is a factor you can use to further modify Cylinder, Disc, and Sphere shapes.

For cylinders, ShapePartial multiplies the radius of the cylinder on the side of its EmissionDirection.

Squash

The Squash property allows for non-uniform scaling of particles, curve-controlled over their lifetime. Values greater than 0 cause particles to both shrink horizontally and grow vertically, while values less than 0 cause particles to both grow horizontally and shrink vertically. For details on how to set the squash amount to either a constant or to a NumberSequence, follow the process in customizing Size but use the emitter's Squash property field instead.

Squash is especially useful for rain. Stretching a particle makes its texture much less recognizable, so even the default sparkle texture can pass as a falling raindrop. For details, see simulate rain.

Flipbooks

Particle flipbook textures let you animate a particle's texture over its lifetime.

The flipbook texture can have a frame layout of 2×2, 4×4, 8×8, or custom. For example, the following 1024×1024 image has an 8×8 layout, so it's suitable for a 64‑frame animation.

Sample texture for particle flipbooks

Once you've specified a valid flipbook texture for the emitter's Texture property, the FlipbookLayout property determines the layout of the texture. It can be any value of the Enum.ParticleFlipbookLayout enum:

  • None — Disable flipbook features and use the texture as a single static texture over the particle's lifetime.
  • Grid2x2 — 2×2 frames for a 4-frame animation.
  • Grid4x4 — 4×4 frames for a 16-frame animation.
  • Grid8x8 — 8×8 frames for a 64-frame animation.
  • Custom — A custom grid size defined by FlipbookSizeX and FlipbookSizeY.

To further customize the flipbook behavior, you can adjust the following properties:

The FlipbookFramerate property determines how fast the flipbook texture animates in frames per second. Like Lifetime, you can set a minimum and maximum range to randomize the framerate of the flip book, with a maximum of 30 frames per second.

Other properties

To further customize particles, consider the following emitter properties, and click through to the ParticleEmitter reference page for more details.

The following appearance properties are in addition to color, light emission, orientation, size, texture, transparency, squash, and flipbooks.

PropertyDescription
LightInfluenceDetermines how much environmental light affects the color of individual particles.
BrightnessScales the light emitted from the emitter when LightInfluence is 0.
ZOffset Determines the forward-backward render position of particles, in studs, without changing their size on the screen. This allows for multiple emitters to be layered, or to render particles in front of or behind the parent object.

Simulate rain

Simulating every raindrop isn't practical, but particle emitters can create a convincing illusion of rain in a 3D world:

  1. Insert a Part above the area where you want rain to fall. Anchor it, set its Transparency to 1, and disable CanCollide.

  2. Insert a ParticleEmitter into the part and set its EmissionDirection to Bottom. A single emitter can create a limited number of particles per second (see Rate), so heavier rain or a larger area requires many parts with emitters arranged in a grid over the desired area.

  3. Set Squash to a positive value, such as 3, to stretch each particle into a streak. Higher values make particles thinner, so you might need to increase size as well.

  4. Darken Color, increase LightInfluence so that the rain reacts to the lighting around it, increase Speed, and decrease Lifetime so that particles disappear near the ground.

  5. To angle the rain, set a small Rotation or enable WindAffectsDrag so that particles follow global wind. Drag slows the fall in addition to applying the wind, so you might need to increase the downward Acceleration to keep the rain falling quickly.

To show rain landing, place transparent parts on the ground with emitters whose EmissionDirection is Top. Splash particles aren't stretched like falling rain, so they usually need a custom texture and a transparency sequence that makes each splash appear to dissipate. Splashes only look right on surfaces where you've placed them carefully. If you can't place them by hand, low-lying mist is much more forgiving.

Manage particle limits

Rain that covers a large area reaches particle limits quickly, and mobile devices have much lower limits than desktops. If particles flicker in the distance, reduce how many are on screen at once:

  • Place the emitter parts lower in the air and shorten Lifetime to match.
  • Decrease Rate to turn a downpour into a lighter shower.
  • Cover a smaller area with fewer emitter parts.

Rain examples

©2026 Roblox Corporation. Roblox, the Roblox logo and Powering Imagination are among our registered and unregistered trademarks in the U.S. and other countries.