Skip to content
Roblox API Reference

ParticleEmitter

A special object that emits customizable 2D particles into the world.
Memory category
Instances
Own members
44
Inherited members
75
Subclasses
0
Siblings
608

Properties62

Inherited fromObject2

Property categoryData

Inherited fromInstance21

Property categoryBehavior

Property categoryData

Property categoryPermissions

Defined byParticleEmitter39

Property categoryAppearance

  • ParticleEmitter.Brightness: number = 1
    Scales the light emitted from the emitter when ParticleEmitter.LightInfluence is 0.
    • Read capabilities: Basic
  • ParticleEmitter.Color: ColorSequence = 0 1 1 1 0 1 1 1 1 0
    Determines the color of all active particles over their individual lifetimes.
    • Read capabilities: Basic
  • ParticleEmitter.LightEmission: number = 0
    Determines how much particles' colors are blended with the colors behind them.
    • Read capabilities: Basic
  • ParticleEmitter.LightInfluence: number = 0
    Determines how much particles are influenced by the environmental light.
    • Read capabilities: Basic
  • ParticleEmitter.LocalTransparencyModifier: number = 0
    Determines a multiplier for ParticleEmitter.Transparency that is only visible to the local client.
    • Hidden
    • Not replicated
    • Read capabilities: Basic
  • Specifies how to orient particles.
    • Read capabilities: Basic
  • ParticleEmitter.Size: NumberSequence = 0 1 0 1 1 0
    Determines the world size over individual particles' lifetimes.
    • Read capabilities: Basic
  • ParticleEmitter.Squash: NumberSequence = 0 0 0 1 0 0
    Allows for non-uniform scaling of particles, curve-controlled over their lifetime.
    • Read capabilities: Basic
  • ParticleEmitter.Texture: string = "rbxasset://textures/particles/sparkles_main.dds"
    Determines the image rendered on particles.
    • Read capabilities: Basic
  • ParticleEmitter.TextureContent: Content
    The image rendered on particles. Supports asset URIs (opens in a new tab).
    • Capabilities: Basic
  • ParticleEmitter.Transparency: NumberSequence = 0 0 0 1 0 0
    Determines the transparency of particles over their individual lifetimes.
    • Read capabilities: Basic
  • ParticleEmitter.ZOffset: number = 0
    Determines the forward-backward render position of particles; used to control what particles render on top/bottom.
    • Read capabilities: Basic

Property categoryEmission

  • ParticleEmitter.EmissionDirection: Enum.NormalId = Enum.NormalId.Top
    Determines the face of the object that particles emit from.
    • Read capabilities: Basic
  • ParticleEmitter.Enabled: boolean = true
    Determines if particles emit from the emitter.
    • Read capabilities: Basic
  • ParticleEmitter.Lifetime: NumberRange = NumberRange.new(5, 10)
    Defines a random range of ages for newly emitted particles.
    • Read capabilities: Basic
  • ParticleEmitter.Rate: number = 20
    Determines the number of particles emitted per second.
    • Read capabilities: Basic
  • ParticleEmitter.Rotation: NumberRange = NumberRange.new(0)
    Determines the range of rotations in degrees for newly emitted particles.
    • Read capabilities: Basic
  • ParticleEmitter.RotSpeed: NumberRange = NumberRange.new(0)
    Determines the range of angular speeds of emitted particles, measured in degrees per second.
    • Read capabilities: Basic
  • ParticleEmitter.Speed: NumberRange = NumberRange.new(5)
    Determines a random range of velocities (minimum to maximum) at which new particles will emit, measured in studs per second.
    • Read capabilities: Basic
  • ParticleEmitter.SpreadAngle: Vector2 = Vector2.zero
    Determines the angles at which particles may be randomly emit, measured in degrees.
    • Read capabilities: Basic
  • ParticleEmitter.VelocitySpread: number = 0
    Deprecated: This property has been superseded by ParticleEmitter.SpreadAngle which should be used in all new work.
    Determines how offset a particle can be fired from the local emitter direction of its parent.
    • Deprecated
    • Not replicated
    • Read capabilities: Basic
    • Load only

    Use SpreadAngle instead.

Property categoryEmitterShape

Property categoryFlipbook

  • ParticleEmitter.FlipbookBlendFrames: boolean = true
    Determines whether the flipbook frames are blended between.
    • Capabilities: Basic
  • ParticleEmitter.FlipbookFramerate: NumberRange = NumberRange.new(1)
    Determines how fast the flipbook texture animates in frames per second.
    • Read capabilities: Basic
  • ParticleEmitter.FlipbookIncompatible: string = "Particle texture must be 1024 by 1024 to use flipbooks."
    The error message to display if the Texture is incompatible for a flipbook.
    • Read capabilities: Basic
  • Determines the layout of the flipbook texture. Must be None, Grid2x2, Grid4x4, Grid8x8 or Custom.
    • Read capabilities: Basic
  • Determines the type of the flipbook animation. Must be Loop, OneShot, PingPong, or Random.
    • Read capabilities: Basic
  • ParticleEmitter.FlipbookSizeX: number = 1
    Defines the number of horizontal frames in a custom flipbook layout.
    • Read capabilities: Basic
  • ParticleEmitter.FlipbookSizeY: number = 1
    Defines the number of vertical frames in a custom flipbook layout.
    • Read capabilities: Basic
  • ParticleEmitter.FlipbookStartRandom: boolean = false
    Determines whether the animation starts at a random frame chosen per particle instead of always starting at frame zero.
    • Read capabilities: Basic

Property categoryMotion

  • ParticleEmitter.Acceleration: Vector3 = Vector3.zero
    Determines the global-axis acceleration of all active particles, measured in studs per second squared.
    • Read capabilities: Basic

Property categoryParticles

  • ParticleEmitter.Drag: number = 0
    Determines the rate at which particles will lose half their speed through exponential decay.
    • Read capabilities: Basic
  • ParticleEmitter.LockedToPart: boolean = false
    Determines whether the particles rigidly move with the part they're being emitted from.
    • Read capabilities: Basic
  • ParticleEmitter.TimeScale: number = 1
    Value between 0 and 1 that controls the speed of the particle effect.
    • Read capabilities: Basic
  • ParticleEmitter.VelocityInheritance: number = 0
    Determines how much of the parent's velocity is inherited by particles when emitted.
    • Read capabilities: Basic
  • ParticleEmitter.WindAffectsDrag: boolean = false
    Whether emitted particles follow the Workspace.GlobalWind vector.
    • Read capabilities: Basic

Methods45

Inherited fromObject3
  • Get an event that fires when a given property of the object changes.
    Parameters
    ParameterDescription
    property: string
    The property to connect to.
    Returns
    TypeDescription
    RBXScriptSignal
    A signal that fires whenever the property changes.
  • Object:IsA(className: string): boolean
    Returns true if an object's class matches or inherits from a given class.
    • Custom Lua state
    • Thread safe
    Parameters
    ParameterDescription
    className: string
    The class against which the Object's class will be checked. Case-sensitive.
    Returns
    TypeDescription
    boolean
    Describes whether the Object's class matched or is a subclass of the given class.
  • Object:isA(className: string): boolean
    Deprecated: This deprecated function is a variant of Object:IsA() which should be used instead.
    • Deprecated
    • Custom Lua state
    Parameters
    Parameter
    className: string
    Returns
    Type
    boolean

    Use IsA instead.

Inherited fromInstance39
Defined byParticleEmitter3
  • ParticleEmitter:Clear()
    Clears all particles that have been emitted.
    • Capabilities: Basic
  • ParticleEmitter:Emit(particleCount: number? = 16)
    Emits a given number of particles.
    • Capabilities: Basic
    Parameters
    ParameterDescription
    particleCount: number? = 16
    The number of particles to emit.
  • ParticleEmitter:FastForward(numFrames: number)
    • Roblox script security
    • Capabilities: Basic
    Parameters
    Parameter
    numFrames: number

Events12

Inherited fromObject1
Inherited fromInstance9
Defined byParticleEmitter2
  • ParticleEmitter.OnClearRequested: RBXScriptSignal<()>
    • Hidden
    • Capabilities: Basic
  • ParticleEmitter.OnEmitRequested: RBXScriptSignal<(particleCount: number)>
    • Hidden
    • Capabilities: Basic
    Parameters
    Parameter
    particleCount: number