Fire and burning props

Make a prop Flammable. What sets it alight, how long it burns and when its fire breaks it, how fire spreads, hurts characters and goes out, and the flames, char and sounds SDF ships for it.

A Flammable prop catches fire from a fire arrow, a script or an explosion. Flames cover it and follow it, so a barrel rolling away burns as it rolls, and it chars as it burns. Part way through its fire it breaks with no push: its pieces fall apart where it stood, and the fire burns on in its debris until the prop is Consumed. On the way it can set the props near it alight, hurt the characters standing in it, and go out in water.

Fire is off by default: no prop burns until you make it Flammable.

Make a prop Flammable

WhereWhat to setApplies to
A BehaviorAdd the Fire moduleEvery prop that uses the Behavior
A setup’s OverridesTick Override Fire, with Flammable onEvery copy of that setup
A placed copy’s Instance OverridesTick Override Fire, with Flammable onThat copy only

The Override Fire exception holds Flammable, Burn Time, Burn Break At, Burns Without Breaking, Spreads Fire and Burn Damage Per Second. A prop made Flammable by it burns with SDF’s own flames, char and fire sounds.

The finer settings live on the Fire module only: Fire Spread Radius, Fire Spread Delay, Burn Damage Reach, Water Puts Out Fire, Burn Damage Type, the effects, the overlay material and the sounds. To give one prop its own, duplicate the Behavior into your project, change its Fire module and pick the duplicate for that setup. See Exceptions for one setup or one prop.

What sets it alight

  • A fire hit. Any hit carrying the gameplay tag SDF.Source.Fire sets the prop burning, even a hit too weak to break it. A fire arrow is an arrow carrying an SDF Fire Arrow, or a Projectile Profile with SDF.Source.Fire added to its Gameplay Tags: a Flammable prop catches from it even when its projectile policy refuses projectile damage. See Fire arrows.
  • A script. Ignite (Ignite(Instigator)) on the destructible component. The Instigator is charged with the fire’s burn damage and passes on to the props it sets alight. It returns false, changing nothing, for a prop that is not Flammable, locked, broken, already burning, consumed or in water, or that has not begun play.
  • An explosion. An explosive prop with Explosion Ignites sets alight the Flammable props whose centre lies within its radius, before it breaks them, so those it breaks burn on in their debris. See Explosions, break point and cover.
  • Another fire, when it spreads: see Spreading.

A prop already burning, consumed, broken or locked does not catch, nor does one in water.

Burning, breaking, consumed

SettingDefaultWhat it does
Burn Time10 sHow long it burns, from catching fire to consumed
Burn Break At0.5When its fire breaks it, as a share of Burn Time: 0.5 half way, 1 as it burns out
Burns Without BreakingoffIt stands to the end, charred, and is consumed standing

At Burn Break At, the fire breaks the prop as a script break would, tagged SDF.Source.Fire, with no push: its pieces fall apart where it stood. Geometry Collection pieces too are neither launched nor spun, and two that start well inside each other, such as a barrel’s hoops modelled round its staves, pass through each other until they have come apart instead of throwing each other away.

The fire burns on in the debris to the end of Burn Time. The prop is then Consumed: broken until it is reset, and remembered broken like any break (Broken props remembered).

With Burns Without Breaking, the prop stands to the end, charred, and stays consumed until it is reset. A locked or indestructible prop burns whole.

Spreading

With Spreads Fire (on), Fire Spread Delay (3 s) after it caught, the burning prop sets alight, once, the Flammable props whose bounds come within Fire Spread Radius (150 cm) of the fire’s, edge to edge. A prop that is not Flammable never catches, however close it stands.

In the demo’s fire arena, three crates 40 cm apart catch one after the other, each 3 s after the one before it caught; a fourth, 2.3 m and more beyond the 150 cm radius, never catches.

Burn damage

None by default. With Burn Damage Per Second above 0, the fire hurts the characters within Burn Damage Reach (50 cm) of its bounds through Unreal’s ApplyDamage, four times a second, with Burn Damage Type (Unreal’s default damage type when empty). Only the machine with authority deals it; its instigator is whoever set the prop alight.

In the demo, a crate with Burn Damage Per Second 10 takes 10 health a second from the training dummy beside it, and nothing from a second dummy 1.5 m away.

Putting it out

  • Extinguish (Extinguish()) puts a burning prop out. It returns false when the prop was not burning.
  • With Water Puts Out Fire (on), a physics volume marked Water Volume puts the fire out, over the standing prop or over its debris.
  • Put out before its fire broke it, the prop stands whole and can burn again. Put out after, it stays broken. Its char stays until it is reset.
  • A reset (ResetDestruction(), a zone reset) puts the fire out at once and takes the char away.

What shows and what is heard

Fire Effect (Niagara) burns on the prop and follows it, then burns on its debris. SDF sets its user parameters as the fire goes:

ParameterValue
FireSizeThe fire’s box: its width, depth and height, in cm
FireFlameSizeHow large its flames burn to cover it: the box’s widest side, 25 cm to 3.5 m
FireStrength0 to 1, growing as it catches and dying down as it burns out

Ignite Sound plays as it catches, Burn Loop Sound loops until it goes out and then fades, and Extinguish Sound plays as it is put out.

The char: overlay, or its own

The prop’s own material decides how it chars.

The charred overlay. Charred Overlay Material is laid over the prop’s mesh and its debris’ in Unreal’s overlay material slot. Its scalar parameter Char darkens from 0 to 1 as it burns. A reset gives the mesh back its own overlay. The demo crates and buckets char this way.

Its own char. A mesh whose material has a scalar parameter CharProgress chars itself instead and takes no overlay. On a dynamic instance of each such material, SDF sets:

ParameterValue
CharProgress0 to 1: full where the fire has reached, once the prop is a quarter burnt
BurnOriginWhere the fire struck, on the prop. A hit on a hit assist larger than the prop is brought onto it; set alight with no hit, its middle
BurnRadiusIn cm: from 10 cm (from its surface when it was set alight with no hit) until the whole mesh is black by the time its fire breaks it, or at the end if it never breaks
EmberStrengthThe fire’s strength while it burns, 0 once it is out

Its debris char the same way, and a reset puts the char back to 0.

MF_SDF_ThermalCharring (FX/Materials) turns these parameters into charcoal spreading from the hit, a roughness of 0.95 and embers glowing in the wood’s cracks. Put it between your material’s base colour and roughness and their outputs, and add its emissive to yours. The demo barrels and barricade char this way.

What SDF ships

The Fire module comes with SDF’s own assets already set:

AssetUsed as
FX/Niagara/NS_SDF_FireFire Effect: flames the size of the prop covering it, smoke, embers and a flickering light
FX/Niagara/NS_SDF_Fire_SmokeFire Smoke Effect: the light smoke shown past Max Burning Effects
FX/Materials/M_SDF_CharredCharred Overlay Material
Demo/Audio/Fire/SC_SDF_Fire_IgniteIgnite Sound: catching
Demo/Audio/Fire/SC_SDF_Fire_BurnLoopBurn Loop Sound: a crackling loop
Demo/Audio/Fire/SC_SDF_Fire_ExtinguishExtinguish Sound: putting out

A placed copy made Flammable by its exception burns with them too. Since 2.0.1 a fire draws half as many lights, each twice as bright: as much light, and half the lights to render. See Audio and Niagara and VFX.

Many fires at once

Max Burning Effects (16) is in Project Settings > Plugins > Souls Destruction Framework > Performance Budget > Budget Limits. Beyond it, the burning props farthest from the local players’ cameras show Fire Smoke Effect instead of their flames, ranked again four times a second. With no camera, on a server, the first to catch keep theirs. They burn, break, spread and go out all the same. 0 shows every fire.

In the demo, twenty buckets catch at once and burn out standing: the sixteen nearest the camera show their flames, the others burn with a light smoke.

State and events

  • OnFireChanged(PreviousState, NewState) fires as the prop catches, is put out, burns out or is reset.
  • GetFireState() returns Not Burning (never lit, or put out before it broke: it can be set alight), Burning (intact or on its debris) or Consumed (burnt out, or put out once broken: it cannot burn again until it is reset).
  • GetBurnProgress() returns how far through Burn Time it is, 0 to 1: 0 when not burning, 1 once consumed.
  • IsFlammable() says whether the prop can burn, after this copy’s exceptions.
  • The fire’s break carries SDF.Source.Fire: filter on it in OnDestructionDamageReceived.

Fire arrows

Any arrow carrying an SDF Fire Arrow (USDFFireArrowComponent, new in 2.0.1) is a fire arrow: while it burns, every hit it sends carries SDF.Source.Fire, whatever its profile, and it plays its flame, FX/Niagara/NS_SDF_FlamingArrow, in flight and where it plants. Water puts it out, and a put-out arrow lights nothing. A Projectile Profile with SDF.Source.Fire added to its Gameplay Tags lights props the same way, without a flame. On a target that is not Flammable a fire arrow behaves as any arrow. See Projectile integration and Your own character.

The demo firing post’s Fire Arrows option (off by default) gives its arrows the tag and a flame on the tip. In the demo’s fire arena, a fire arrow zone lights every arrow loosed inside it, from the firing post or from your own character’s bow.

To make arrows stick in a prop and let only the fire break it, as the demo’s fire arena does, also tick Override Projectile Policy on that prop with Breakable by Projectile off.

In a networked game

The server lights and puts out every fire, and every machine shows it: the flames, the char and the sounds. On a client, Ignite and Extinguish change nothing. Burn damage is dealt on the server only. A player who joins while a prop burns sees it burning, as far through its Burn Time as on the server. See Networked games.

Limits

A prop consumed standing (Burns Without Breaking) is not saved: it comes back unburnt on load. Fire Spread Radius, Fire Spread Delay, Burn Damage Reach and Water Puts Out Fire have no exception: set them on a Behavior.

Try it in the demo

Below the showcase floor, the fire arena puts a second firing post among eleven stands, one for each side of burning props: burning, flammable or not, spread, break point, a rope that burns through, a powder fuse, a barricade that opens the way, the effect budget, water, burn damage and a burning chock. See Playable demo.

Last updated: 2026-10-29

Type to search titles, sections and keywords.