Particles and VFX

Particle emitters and their modules, CPU and GPU simulation, sub-emitters, collision, VFX graphs, trails and beams, and effects scalability.

Last updated Oct 26, 2026Edit this pageVersion 1.0.0

A particle effect is an emitter whose behavior is built from a stack of modules. Emitters simulate and render the same way in the editor viewport, in play-in-editor and in the packaged game, so you see an effect where you place it.

Place an effect

Place an AParticleEmitterActor, or add an MParticleEmitterComponent to an actor and set particlePath to a .particle or .vfx asset. playOnAwake and loop control playback. MParticleEmitterComponent

On the ECS side, the ParticleEmitter component has Play(), Stop(), Restart() and Clear(). A non-zero seed makes the effect replay identically every time, on every machine. ParticleEmitterComponent

Author an emitter

Two asset types describe the same emitter model:

AssetEditorNotes
.particleParticle editor: a module stack with curves and a live previewOne emitter
.vfxVFX Graph editor: nodes in Emitter, Spawn, Update and Render stagesA system: the graph plus any number of named extra emitters

Both compile to the same runtime emitter, so a graph-authored emitter and a property-authored one behave identically. FVfxGraphCompiler

Mowo Editor Particle editor with PS_Embers.particle open: the module stack on the left (Shape, Velocity, Color, Size, Noise, Collision), a Color over Life curve in the curve panel, and embers rising in the preview viewport
Stack modules, tune their curves and preview the effect live.

Emitter settings

GroupSettings
EmissionRate per second, max particles, a one-shot burstCount that fires once at start
Lifetime and startLifetime range, start velocity, speed, size and color
SimulationCPU (default) or GPU
RenderingBillboard or Mesh; Unlit or Lit shading; texture and flipbook (subUVColumns, subUVRows); soft particles (softFadeDistance); alpha, additive or multiply blending
Billboard alignmentCamera, Horizontal, Vertical or Stretched along velocity
CullingcullDistance; 0 never culls

Modules

ModuleDoes
ShapeSpawn volume: sphere, hemisphere, cone, box, circle, edge or point
VelocityOrbital and radial velocity, speed over life
Color, SizeGradients over life
Force, NoiseConstant forces and turbulence
RotationSpin
CollisionBounces off the scene
LightTurns the brightest particles into point lights
ExpressionA small script run on spawn or update, with up to four custom per-particle attributes (attr.name)
SubEmitterSpawns particles in a child emitter on a parent's birth, death or collision
Engine/Source/Runtime/Particles/Public/Particles/ParticleModule.h

Sub-emitters

A SubEmitter module listens for Birth, Death or Collision events and spawns spawnCount particles into a child emitter at the event position: sparks that burst where a firework dies, puffs where debris lands. The child is another emitter of the same .vfx system (childEmitter) or a separate asset (childPath). It can inherit a share of the parent's velocity and color.

Collision

The Collision module treats each particle as a sphere of radius and bounces it with bounce and friction. It collides against the scene's distance field when one is available (Medium quality and up), which sees off-screen geometry, and falls back to the depth buffer. killOnCollide, lifetimeLoss and restThreshold shape the response. GPU emitters resolve collision the same way in their compute pass. Engine/Source/Runtime/Particles/Public/Particles/ParticleCollision.h

CPU or GPU simulation

CPUGPU
Good forMesh particles, small and sorted effectsLarge additive bursts: sparks, embers, magic
Mesh render modeYesNo, billboards only
Frustum culling and the fill budgetYesDistance from the emitter only

GPU emitters are spawned on the CPU and aged, moved, collided, sorted and drawn on the GPU. Expression scripts run on both paths. CPU emitter trees simulate in parallel (fx.Particles.Parallel). ParticleSystem

Effects scalability

Particle cost in a real scene is mostly fill. The scalability tiers scale every emitter, so you author an effect once at the top tier:

Console variableEffect
r.Effects.SpawnRateScaleMultiplies emission rates
r.Effects.MaxParticleScaleMultiplies particle caps
r.Effects.CullDistanceScaleMultiplies cull distances
r.Effects.MaxActiveEmittersCaps emitters drawn per view; 0 is unlimited
r.Effects.OverdrawBudgetCaps the estimated fill, in screens of overdraw; 0 is unlimited
r.Effects.LogStatsLogs submitted, culled and dropped emitters every N views

An emitter that alone exceeds the overdraw budget still draws, so an effect never flickers out in front of the player. See Rendering for the quality tiers.

Trails, lines and beams

ComponentDraws
TrailRendererA ribbon that follows a moving entity, such as a sword swing or a tracer TrailRendererComponent
LineRendererA ribbon through authored points LineRendererComponent
LaserBeamA glowing beam along the entity's direction, up to maxLength LaserBeamComponent

Engine sources

This page describes behavior implemented in these files of the engine repository, checked against commit 5922e6e5e.

  • Engine/Source/Runtime/Particles/Public/Particles/Components/ParticleEmitterComponent.h
  • Engine/Source/Runtime/Particles/Public/Particles/ParticleSystem.h
  • Engine/Source/Runtime/Particles/Public/Particles/ParticleModule.h
  • Engine/Source/Runtime/Particles/Public/Particles/ParticleExpression.h
  • Engine/Source/Runtime/Particles/Public/Particles/ParticleCollision.h
  • Engine/Source/Runtime/Particles/Public/Particles/GPUParticle.h
  • Engine/Source/Runtime/Particles/Public/Particles/VfxGraph.h
  • Engine/Source/Runtime/Particles/Public/Particles/VfxGraphCompiler.h
  • Engine/Source/Runtime/Particles/Public/Particles/VfxEmitterConfig.h
  • Engine/Source/Runtime/Game/Public/Game/MParticleEmitterComponent.h
  • Engine/Source/Runtime/Game/Public/Game/AParticleEmitterActor.h
  • Engine/Source/Runtime/Game/Public/Game/Components/TrailRendererComponent.h
  • Engine/Source/Runtime/Game/Public/Game/Components/LineRendererComponent.h
  • Engine/Source/Runtime/Game/Public/Game/Components/LaserBeamComponent.h

Page feedback

Was this page helpful?