Aprenda
Classe do mecanismo
ParticleEmitter

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.


Amostras de código
Criando um Emissor de Partículas do Zero
local emitter = Instance.new("ParticleEmitter")
-- Número de partículas = Taxa * Tempo de Vida
emitter.Rate = 5 -- Partículas por segundo
emitter.Lifetime = NumberRange.new(1, 1) -- Quanto tempo as partículas devem viver (min, max)
emitter.Enabled = true
-- Propriedades visuais
emitter.Texture = "rbxassetid://1266170131" -- Uma imagem transparente de um anel branco
-- Para a cor, construa uma ColorSequence usando ColorSequenceKeypoint
local colorKeypoints = {
-- API: ColorSequenceKeypoint.new(tempo, cor)
ColorSequenceKeypoint.new(0, Color3.new(1, 1, 1)), -- Em t=0, Branco
ColorSequenceKeypoint.new(0.5, Color3.new(1, 0.5, 0)), -- Em t=.5, Laranja
ColorSequenceKeypoint.new(1, Color3.new(1, 0, 0)), -- Em t=1, Vermelho
}
emitter.Color = ColorSequence.new(colorKeypoints)
local numberKeypoints = {
-- API: NumberSequenceKeypoint.new(tempo, tamanho, envoltória)
NumberSequenceKeypoint.new(0, 1), -- Em t=0, totalmente transparente
NumberSequenceKeypoint.new(0.1, 0), -- Em t=.1, totalmente opaco
NumberSequenceKeypoint.new(0.5, 0.25), -- Em t=.5, principalmente opaco
NumberSequenceKeypoint.new(1, 1), -- Em t=1, totalmente transparente
}
emitter.Transparency = NumberSequence.new(numberKeypoints)
emitter.LightEmission = 1 -- Quando as partículas se sobrepõem, multiplique sua cor para que fique mais brilhante
emitter.LightInfluence = 0 -- Não seja afetado pela iluminação do mundo
-- Propriedades de velocidade
emitter.EmissionDirection = Enum.NormalId.Front -- Emitir para frente
emitter.Speed = NumberRange.new(0, 0) -- Velocidade zero
emitter.Drag = 0 -- Não aplicar arrasto ao movimento das partículas
emitter.VelocitySpread = NumberRange.new(0, 0)
emitter.VelocityInheritance = 0 -- Não herdar a velocidade do pai
emitter.Acceleration = Vector3.new(0, 0, 0)
emitter.LockedToPart = false -- Não travar as partículas no pai
emitter.SpreadAngle = Vector2.new(0, 0) -- Sem ângulo de dispersão em nenhum eixo
-- Propriedades de simulação
local numberKeypoints2 = {
NumberSequenceKeypoint.new(0, 0), -- Em t=0, tamanho de 0
NumberSequenceKeypoint.new(1, 10), -- Em t=1, tamanho de 10
}
emitter.Size = NumberSequence.new(numberKeypoints2)
emitter.ZOffset = -1 -- Renderizar ligeiramente atrás da posição real
emitter.Rotation = NumberRange.new(0, 360) -- Começar em rotação aleatória
emitter.RotSpeed = NumberRange.new(0) -- Não rotacionar durante a simulação
-- Criar uma anexação para que as partículas se emitam do mesmo local exato (anéis concêntricos)
local attachment = Instance.new("Attachment")
attachment.Position = Vector3.new(0, 5, 0) -- Mover a anexação um pouco para cima
attachment.Parent = script.Parent
emitter.Parent = attachment

Referência API
Propriedades
Acceleration
Ler Parallel
Recursos: Basic
ParticleEmitter.Acceleration:Vector3

Brightness
Ler Parallel
Recursos: Basic
ParticleEmitter.Brightness:number

Color
Ler Parallel
Recursos: Basic
ParticleEmitter.Color:ColorSequence

Drag
Ler Parallel
Recursos: Basic
ParticleEmitter.Drag:number

EmissionDirection
Ler Parallel
Recursos: Basic
ParticleEmitter.EmissionDirection:Enum.NormalId

Enabled
Ler Parallel
Recursos: Basic
ParticleEmitter.Enabled:boolean

FlipbookBlendFrames
Ler Parallel
Recursos: Basic
ParticleEmitter.FlipbookBlendFrames:boolean

FlipbookFramerate
Ler Parallel
Recursos: Basic
ParticleEmitter.FlipbookFramerate:NumberRange

FlipbookIncompatible
Ler Parallel
Recursos: Basic
ParticleEmitter.FlipbookIncompatible:string

FlipbookLayout
Ler Parallel
Recursos: Basic
ParticleEmitter.FlipbookLayout:Enum.ParticleFlipbookLayout

FlipbookMode
Ler Parallel
Recursos: Basic
ParticleEmitter.FlipbookMode:Enum.ParticleFlipbookMode

FlipbookSizeX
Ler Parallel
Recursos: Basic
ParticleEmitter.FlipbookSizeX:number

FlipbookSizeY
Ler Parallel
Recursos: Basic
ParticleEmitter.FlipbookSizeY:number

FlipbookStartRandom
Ler Parallel
Recursos: Basic
ParticleEmitter.FlipbookStartRandom:boolean

Lifetime
Ler Parallel
Recursos: Basic
ParticleEmitter.Lifetime:NumberRange

LightEmission
Ler Parallel
Recursos: Basic
ParticleEmitter.LightEmission:number

LightInfluence
Ler Parallel
Recursos: Basic
ParticleEmitter.LightInfluence:number

LocalTransparencyModifier
Oculto
Não replicado
Ler Parallel
Recursos: Basic
ParticleEmitter.LocalTransparencyModifier:number

LockedToPart
Ler Parallel
Recursos: Basic
ParticleEmitter.LockedToPart:boolean

Orientation
Ler Parallel
Recursos: Basic
ParticleEmitter.Orientation:Enum.ParticleOrientation

Rate
Ler Parallel
Recursos: Basic
ParticleEmitter.Rate:number

Rotation
Ler Parallel
Recursos: Basic
ParticleEmitter.Rotation:NumberRange

RotSpeed
Ler Parallel
Recursos: Basic
ParticleEmitter.RotSpeed:NumberRange

Shape
Ler Parallel
Recursos: Basic
ParticleEmitter.Shape:Enum.ParticleEmitterShape

ShapeInOut
Ler Parallel
Recursos: Basic
ParticleEmitter.ShapeInOut:Enum.ParticleEmitterShapeInOut

ShapePartial
Ler Parallel
Recursos: Basic
ParticleEmitter.ShapePartial:number

ShapeStyle
Ler Parallel
Recursos: Basic
ParticleEmitter.ShapeStyle:Enum.ParticleEmitterShapeStyle

Size
Ler Parallel
Recursos: Basic
ParticleEmitter.Size:NumberSequence

Speed
Ler Parallel
Recursos: Basic
ParticleEmitter.Speed:NumberRange

SpreadAngle
Ler Parallel
Recursos: Basic
ParticleEmitter.SpreadAngle:Vector2

Squash
Ler Parallel
Recursos: Basic
ParticleEmitter.Squash:NumberSequence

Texture
Ler Parallel
Recursos: Basic
ParticleEmitter.Texture:ContentId

TimeScale
Ler Parallel
Recursos: Basic
ParticleEmitter.TimeScale:number

Transparency
Ler Parallel
Recursos: Basic
ParticleEmitter.Transparency:NumberSequence

VelocityInheritance
Ler Parallel
Recursos: Basic
ParticleEmitter.VelocityInheritance:number

VelocitySpread
Obsoleto

WindAffectsDrag
Ler Parallel
Recursos: Basic
ParticleEmitter.WindAffectsDrag:boolean

ZOffset
Ler Parallel
Recursos: Basic
ParticleEmitter.ZOffset:number

Métodos
Clear
Recursos: Basic
ParticleEmitter:Clear():()
Devolução
()
Amostras de código
Emissor de Partículas Burst
local emitter = script.Parent
while true do
emitter:Clear()
emitter:Emit(10)
task.wait(2)
end

Emit
Recursos: Basic
ParticleEmitter:Emit(particleCount:number):()
Parâmetros
particleCount:number
Valor Padrão: 16
Devolução
()
Amostras de código
Emitir Partículas ao Longo da Distância
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
Emissor de Partículas Burst
local emitter = script.Parent
while true do
emitter:Clear()
emitter:Emit(10)
task.wait(2)
end

©2026 Roblox Corporation, Roblox, o logotipo Roblox e Powering Imagination estão entre nossas marcas registradas e não registradas nos EUA e em outros países.