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
| Where | What to set | Applies to |
|---|---|---|
| A Behavior | Add the Fire module | Every prop that uses the Behavior |
| A setup’s Overrides | Tick Override Fire, with Flammable on | Every copy of that setup |
| A placed copy’s Instance Overrides | Tick Override Fire, with Flammable on | That 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.Firesets 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 withSDF.Source.Fireadded 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
| Setting | Default | What it does |
|---|---|---|
| Burn Time | 10 s | How long it burns, from catching fire to consumed |
| Burn Break At | 0.5 | When its fire breaks it, as a share of Burn Time: 0.5 half way, 1 as it burns out |
| Burns Without Breaking | off | It 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:
| Parameter | Value |
|---|---|
FireSize | The fire’s box: its width, depth and height, in cm |
FireFlameSize | How large its flames burn to cover it: the box’s widest side, 25 cm to 3.5 m |
FireStrength | 0 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:
| Parameter | Value |
|---|---|
CharProgress | 0 to 1: full where the fire has reached, once the prop is a quarter burnt |
BurnOrigin | Where 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 |
BurnRadius | In 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 |
EmberStrength | The 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:
| Asset | Used as |
|---|---|
FX/Niagara/NS_SDF_Fire | Fire Effect: flames the size of the prop covering it, smoke, embers and a flickering light |
FX/Niagara/NS_SDF_Fire_Smoke | Fire Smoke Effect: the light smoke shown past Max Burning Effects |
FX/Materials/M_SDF_Charred | Charred Overlay Material |
Demo/Audio/Fire/SC_SDF_Fire_Ignite | Ignite Sound: catching |
Demo/Audio/Fire/SC_SDF_Fire_BurnLoop | Burn Loop Sound: a crackling loop |
Demo/Audio/Fire/SC_SDF_Fire_Extinguish | Extinguish 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 inOnDestructionDamageReceived.
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