Skip to content

Falling debris controls

Enable Debris on a projectile or demo launcher for family-specific fragments: embers, ice chips, droplets, stone, splinters or motes. These use an additional CPU Niagara mesh emitter and remain in world space after the head passes.

Property Default Range Behavior
EnableDebris On On / off Emit the optional falling debris layer during flight. Existing particles finish when the projectile stops.
DebrisAmount 1 0.0–4.0 Debris amount multiplier. 1 emits 48 particles per second; maximum 192. Independent of preset density.
DebrisSize 1 0.25–3.0 Debris size multiplier, in addition to VisualScale. Does not change the main projectile.
DebrisLifetime 1.5 0.1–3.0 Maximum debris lifetime in seconds. Particles cool/shrink before expiring; actor cleanup waits for them.
DebrisSpread 1 0.0–3.0 Sideways scatter and initial throw multiplier. Gravity remains independently adjustable.
DebrisGravity 1 0.0–3.0 World-down gravity multiplier. Zero lets fragments drift; each family has its own weight.
DebrisCollision On On / off Detect ground contact using CPU scene traces, then bounce, roll and fade on that surface. Disable for cheaper free-falling particles.
DebrisBounce 1 0.0–2.0 Ground rebound multiplier. Zero removes bounce; each fragment material has its own response.
DebrisFriction 1 0.0–3.0 Ground drag multiplier. Higher values stop rolling/sliding sooner; zero retains light base drag.
DebrisTumble 1 0.0–3.0 Fragment rotation multiplier in flight and while bouncing or rolling. Zero disables spin.

Collision uses CPU scene traces and needs query-blocking ground on the WorldDynamic trace channel. After the first upward-facing contact, the emitter remembers the contact plane and produces diminishing rebounds, frictional travel and mesh rotation. The last part of the lifetime cools and shrinks the fragments.

This is bounded Niagara secondary motion. Fragments do not use Chaos rigid bodies and do not query new obstacles, floor edges or moving platforms after first contact. Very short lifetimes, zero gravity or large drop heights can expire before reaching the ground.

DebrisBounce = 0 removes rebounds. DebrisTumble = 0 removes spin. Higher friction shortens ground travel. Collision-off fragments continue without landing. The wobble-target demo floor supports these traces. In your own level, ensure the floor blocks the debris traces.

The normal emission rate is 48 particles per second per flying projectile, capped at 192 by DebrisAmount. It is independent of preset density and ramps up at launch. No additional physics actors or particle lights are created by this layer.

Turn off EnableDebris to skip new debris emission. Existing particles finish, and actor retirement and demo replay allow the selected lifetime. Profile collision and high amounts in your game’s target conditions.