Learn
Engine Class
ParticleEmitter

Code Samples
Creating a Particle Emitter from Scratch
local emitter = Instance.new("ParticleEmitter")
-- Number of particles = Rate * Lifetime
emitter.Rate = 5 -- Particles per second
emitter.Lifetime = NumberRange.new(1, 1) -- How long the particles should be alive (min, max)
emitter.Enabled = true
-- Visual properties
emitter.Texture = "rbxassetid://1266170131" -- A transparent image of a white ring
-- For Color, build a ColorSequence using ColorSequenceKeypoint
local colorKeypoints = {
-- API: ColorSequenceKeypoint.new(time, color)
ColorSequenceKeypoint.new(0, Color3.new(1, 1, 1)), -- At t=0, White
ColorSequenceKeypoint.new(0.5, Color3.new(1, 0.5, 0)), -- At t=.5, Orange
ColorSequenceKeypoint.new(1, Color3.new(1, 0, 0)), -- At t=1, Red
}
emitter.Color = ColorSequence.new(colorKeypoints)
local numberKeypoints = {
-- API: NumberSequenceKeypoint.new(time, size, envelop)
NumberSequenceKeypoint.new(0, 1), -- At t=0, fully transparent
NumberSequenceKeypoint.new(0.1, 0), -- At t=.1, fully opaque
NumberSequenceKeypoint.new(0.5, 0.25), -- At t=.5, mostly opaque
NumberSequenceKeypoint.new(1, 1), -- At t=1, fully transparent
}
emitter.Transparency = NumberSequence.new(numberKeypoints)
emitter.LightEmission = 1 -- When particles overlap, multiply their color to be brighter
emitter.LightInfluence = 0 -- Don't be affected by world lighting
-- Speed properties
emitter.EmissionDirection = Enum.NormalId.Front -- Emit forwards
emitter.Speed = NumberRange.new(0, 0) -- Speed of zero
emitter.Drag = 0 -- Apply no drag to particle motion
emitter.VelocitySpread = NumberRange.new(0, 0)
emitter.VelocityInheritance = 0 -- Don't inherit parent velocity
emitter.Acceleration = Vector3.new(0, 0, 0)
emitter.LockedToPart = false -- Don't lock the particles to the parent
emitter.SpreadAngle = Vector2.new(0, 0) -- No spread angle on either axis
-- Simulation properties
local numberKeypoints2 = {
NumberSequenceKeypoint.new(0, 0), -- At t=0, size of 0
NumberSequenceKeypoint.new(1, 10), -- At t=1, size of 10
}
emitter.Size = NumberSequence.new(numberKeypoints2)
emitter.ZOffset = -1 -- Render slightly behind the actual position
emitter.Rotation = NumberRange.new(0, 360) -- Start at random rotation
emitter.RotSpeed = NumberRange.new(0) -- Do not rotate during simulation
-- Create an attachment so particles emit from the exact same spot (concentric rings)
local attachment = Instance.new("Attachment")
attachment.Position = Vector3.new(0, 5, 0) -- Move the attachment upwards a little
attachment.Parent = script.Parent
emitter.Parent = attachment

API Reference
Properties
Acceleration
Read Parallel
Capabilities: Basic
ParticleEmitter.Acceleration:Vector3

Brightness
Read Parallel
Capabilities: Basic
ParticleEmitter.Brightness:number

Color
Read Parallel
Capabilities: Basic
ParticleEmitter.Color:ColorSequence

Drag
Read Parallel
Capabilities: Basic
ParticleEmitter.Drag:number

EmissionDirection
Read Parallel
Capabilities: Basic
ParticleEmitter.EmissionDirection:Enum.NormalId

Enabled
Read Parallel
Capabilities: Basic
ParticleEmitter.Enabled:boolean

FlipbookBlendFrames
Read Parallel
Capabilities: Basic
ParticleEmitter.FlipbookBlendFrames:boolean

FlipbookFramerate
Read Parallel
Capabilities: Basic
ParticleEmitter.FlipbookFramerate:NumberRange

FlipbookIncompatible
Read Parallel
Capabilities: Basic
ParticleEmitter.FlipbookIncompatible:string

FlipbookLayout
Read Parallel
Capabilities: Basic
ParticleEmitter.FlipbookLayout:Enum.ParticleFlipbookLayout

FlipbookMode
Read Parallel
Capabilities: Basic
ParticleEmitter.FlipbookMode:Enum.ParticleFlipbookMode

FlipbookSizeX
Read Parallel
Capabilities: Basic
ParticleEmitter.FlipbookSizeX:number

FlipbookSizeY
Read Parallel
Capabilities: Basic
ParticleEmitter.FlipbookSizeY:number

FlipbookStartRandom
Read Parallel
Capabilities: Basic
ParticleEmitter.FlipbookStartRandom:boolean

Lifetime
Read Parallel
Capabilities: Basic
ParticleEmitter.Lifetime:NumberRange

LightEmission
Read Parallel
Capabilities: Basic
ParticleEmitter.LightEmission:number

LightInfluence
Read Parallel
Capabilities: Basic
ParticleEmitter.LightInfluence:number

LocalTransparencyModifier
Hidden
Not Replicated
Read Parallel
Capabilities: Basic
ParticleEmitter.LocalTransparencyModifier:number

LockedToPart
Read Parallel
Capabilities: Basic
ParticleEmitter.LockedToPart:boolean

Orientation
Read Parallel
Capabilities: Basic
ParticleEmitter.Orientation:Enum.ParticleOrientation

Rate
Read Parallel
Capabilities: Basic
ParticleEmitter.Rate:number

Rotation
Read Parallel
Capabilities: Basic
ParticleEmitter.Rotation:NumberRange

RotSpeed
Read Parallel
Capabilities: Basic
ParticleEmitter.RotSpeed:NumberRange

Shape
Read Parallel
Capabilities: Basic
ParticleEmitter.Shape:Enum.ParticleEmitterShape

ShapeInOut
Read Parallel
Capabilities: Basic
ParticleEmitter.ShapeInOut:Enum.ParticleEmitterShapeInOut

ShapePartial
Read Parallel
Capabilities: Basic
ParticleEmitter.ShapePartial:number

ShapeStyle
Read Parallel
Capabilities: Basic
ParticleEmitter.ShapeStyle:Enum.ParticleEmitterShapeStyle

Size
Read Parallel
Capabilities: Basic
ParticleEmitter.Size:NumberSequence

Speed
Read Parallel
Capabilities: Basic
ParticleEmitter.Speed:NumberRange

SpreadAngle
Read Parallel
Capabilities: Basic
ParticleEmitter.SpreadAngle:Vector2

Squash
Read Parallel
Capabilities: Basic
ParticleEmitter.Squash:NumberSequence

Texture
Read Parallel
Capabilities: Basic
ParticleEmitter.Texture:ContentId

TimeScale
Read Parallel
Capabilities: Basic
ParticleEmitter.TimeScale:number

Transparency
Read Parallel
Capabilities: Basic
ParticleEmitter.Transparency:NumberSequence

VelocityInheritance
Read Parallel
Capabilities: Basic
ParticleEmitter.VelocityInheritance:number

VelocitySpread
Deprecated

WindAffectsDrag
Read Parallel
Capabilities: Basic
ParticleEmitter.WindAffectsDrag:boolean

ZOffset
Read Parallel
Capabilities: Basic
ParticleEmitter.ZOffset:number

Methods
Clear
Capabilities: Basic
ParticleEmitter:Clear():()
Returns
()
Code Samples
ParticleEmitter Burst
local emitter = script.Parent
while true do
emitter:Clear()
emitter:Emit(10)
task.wait(2)
end

Emit
Capabilities: Basic
ParticleEmitter:Emit(particleCount:number):()
Parameters
particleCount:number
Default Value: 16
Returns
()
Code Samples
Emit Particles Over Distance
local RunService = game:GetService("RunService")
local emitter = script.Parent
local part = emitter.Parent
local PARTICLES_PER_STUD = 3
local lastPosition = part.Position
local distance = 0
local function onStep()
local displacement = part.Position - lastPosition
distance = distance + displacement.magnitude
local n = math.floor(distance * PARTICLES_PER_STUD)
emitter:Emit(n)
distance = distance - n / PARTICLES_PER_STUD
lastPosition = part.Position
end
RunService.Stepped:Connect(onStep)
emitter.Enabled = false
ParticleEmitter Burst
local emitter = script.Parent
while true do
emitter:Clear()
emitter:Emit(10)
task.wait(2)
end

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