Behaviors and Materials

How Create Destructible separates how a prop breaks, how it reacts and what it is made of, the shared Behavior and Material assets SDF ships, the seven Behavior modules and the effective profile a prop plays.

Two clay pots in the same corridor should take the same blow, make the same sound and answer an arrow the same way. In SDF 2.0 they do, because they share two assets: a Behavior, which decides how they react to hits, and a Material, which decides what they sound and look like. Change one of those assets and every pot that uses it follows, including the copies already placed in your levels.

Three questions

Create Destructible asks three separate questions, each in its own section of the window:

SectionQuestionAnswered byShared
1. How Does It Break?How this mesh is cutThe authoring preset and its fracture settingsNo: it belongs to this prop alone
2. How Does It React?Health, the hit power needed, whether one valid hit breaks it, intact physics, debris timing, optional modulesA Behavior asset (USDFDestructionBehavior)Yes
3. What Is It Made Of?Break and hit sounds, break and hit effects, impact decals, the response to projectilesA Material asset (USDFDestructionMaterial)Yes

The generated setup, its destruction profile, references the Behavior and the Material instead of carrying its own copy of their values. When a profile references them, its Details panel hides the fields they provide: you edit those on the shared asset, or as an exception for one setup or one placed prop.

The Behavior and Material fields of the window follow the preset you pick. You can pick any other asset of the right class, including one of your own. Batch Generate and Modify Destructible offer the same two fields.

The built-in behaviors

SDF ships four behaviors in the plugin’s Authoring/Behaviors folder:

BehaviorHow it reactsMinimum Destruction PowerPicked for
FragileBreaks on the lightest valid hit, or when it falls from 60 cm or more (its Fall module)Very LightCeramic, Glass, Glass Vessel
NormalBreaks on the first valid hit of Light power or moreLightEvery other preset
SturdyTakes several hits: Use Health on, 100 health points, Destroy On Single Valid Hit off. Five blows of the demo sword (20 damage each)LightNone by default: pick it yourself
IndestructibleNever breaks, but still reacts to every hit: it plays its hit sound and effect and, with its HitReaction module, is pushedLightNone by default: pick it yourself

All four set Minimum Impact Speed to 300 cm/s: a hit that reports a closing speed below it returns Too Slow. A hit with an Impact Speed of 0 (unknown) skips this gate. The melee sender sends 0 unless its swing is given a speed; the projectile and collision senders send the real speed. See Who may break a prop, and how hard for every rule a hit goes through.

Health points or number of hits

A prop with health (Use Health on, Destroy On Single Valid Hit off) counts it one of two ways, chosen with Health Mode on the Behavior, on the setup, or in the health exception of one placed copy. New in 2.0.1:

Health ModeHow the prop countsSet with
Health Points (the default, as in SDF 2.0.0)Each hit’s damage lowers its Max Health: a strong weapon breaks it soonerMax Health
Number of HitsIt breaks on its Hits To Break-th valid hit, whatever each weapon’s damage: a door that takes three blows from any sword, in any gameHits To Break (3 by default, at least 1)
  • A hit under Minimum Damage Threshold does not count as one of the hits.
  • A body contact (Contact module) still breaks the prop outright, in either mode.
  • Diagnose this object shows the hits left. See Diagnostics.
  • In Create Destructible, Batch Generate and Modify Destructible, Hits To Break (0 = Health Points) sets it for one setup: see the Authoring overview.

Health Points is what a game whose weapons have their own damage numbers expects: a door with 50 health points takes three blows of the demo sword’s 20, and one blow of a weapon dealing 50 or more. Number of Hits keeps the same count whatever weapons your game gives the player.

The built-in materials

SDF ships seven materials in the plugin’s Authoring/Materials folder. What each one plays on a hit that does not break the prop:

MaterialOn a hit that does not break itPicked for
WoodWood hit sound, small splinters, chips and a little dust (NS_SDF_Hit_Wood)Wood, Wooden Crate, Wooden Furniture, Wooden Coffin, Wooden Barrel (Semantic), Generic
CeramicCeramic hit sound and the ceramic impact effect, smallerCeramic
StoneStone hit sound and the stone impact effect, smallerStone
GlassGlass hit sound, a few small glass shards and sparkles (NS_SDF_Hit_Glass)Glass, Glass Vessel
MetalMetal hit sound, no hit effect; an arrow that does not break the iron glances off it. Its pieces land with the iron hoop drops of the demo barrelMetal (Assembled Parts)
ChainAs Metal: the metal hit sound, and an arrow that does not break the chain glances off itChain
RopeNo sound and no effectRope

Each material’s break sounds and effects are those of its family’s Runtime template, except two that break with recordings of their own: Chain snaps and its links land as a chain, Rope snaps.

A hit that does not break the prop plays the Material’s Light Impact Sounds or Heavy Impact Sounds and Light Impact Effects or Heavy Impact Effects at the struck point, at most once per Impact Presentation Cooldown, so a flurry of hits stays readable. See Audio and Niagara and VFX.

Modules

A Behavior lists its optional functions as Modules. Only the modules added to a Behavior are active: a function whose module is absent is off. A Behavior without modules reacts as a plain SDF 1.0 profile does.

ModuleWhat it addsRead more
ContactA character’s body breaks the prop by touching it, standing on it or landing on it; touches can be reported to the AI. Also carries the SDF 1.0 Break By Pawn CollisionBodies against props
FallThe prop takes damage when it lands after a fall: MinimumFallHeightCm (80 cm in a new module), Fall Damage Per Meter (50), Fall Destruction Power (Very Light)Intact physics and fall damage
PropagationBreaking the prop damages the destructibles around it: Propagation Radius (250), Propagation Damage (100), Propagation Power (Light), Propagation Impulse (600), Max Propagation Depth (2)Chain reactions
HitReactionA hit that does not break the prop pushes it: Minimum Hit Reaction Power (Very Light), Apply Built In Physics Reaction (on), Hit Reaction Impulse Multiplier (0.2), Maximum Hit Reaction Impulse (250)Decals and hit reactions
Break NoiseThe break makes a noise the AI hears: Break Noise Loudness (1), Break Noise Range (1500 cm), Break Noise Tag (SDF.Break)The world reacting to a break
ExplosionThe prop explodes one frame after it breaks: Explosion Radius (400 cm), Explosion Damage (50), Explosion Prop Damage (200) and the restExplosions, break point and cover
FireThe prop can burn: Burn Time (10 s), Burn Break At (0.5), Spreads Fire (on) and the restFire and burning props

To add one, open the Behavior, add an element to Modules and choose its class. Asset validation reports an empty module slot (SDF-DATA-050) and two modules of the same kind (SDF-DATA-051).

Of the built-in behaviors, Fragile carries a Fall module (MinimumFallHeightCm 60) and Indestructible a HitReaction module. Normal and Sturdy carry none.

Push When Hit, in section 2. How Does It React? of Create Destructible, in the batch and in Modify, is off by default: a hit that does not break the prop then leaves it where it is, as in SDF 1.0. Ticked, such a hit pushes it when the prop simulates physics. When the picked Behavior already pushes, nothing is added; otherwise the setup records it as the Override Push When Hit exception.

The effective profile

A destructible plays its effective profile, composed in this order:

  1. its setup: what belongs to its model (pieces, debris, loot, its break point);
  2. the setup’s Behavior and that Behavior’s modules;
  3. the setup’s Material;
  4. the setup’s own exceptions (the profile’s Overrides);
  5. the placed copy’s exceptions (the component’s Instance Overrides).

Behavior, module and Material fields reach the profile through the profile field of the same name and type. A setup without Behavior, Material or exception is used exactly as it is, which is how an SDF 1.0 profile keeps working.

CallReturns
GetEffectiveProfile()The values the prop plays. Read gameplay values from it
GetDestructionProfile()The setup asset, as authored
RefreshEffectiveProfile()Composes the effective profile again. Call it after changing a Behavior, a Material or an exception at runtime

Diagnose() and the Diagnose this object panel report the effective values, exceptions included. See Diagnostics. In C++, the composition is FSDFProfileResolver::Resolve; see Destruction profiles for which profile fields belong to the setup, the Behavior and the Material.

Edit a shared asset, or duplicate it

  • Edit the shared asset to change a whole family of props: every prop that uses it follows, including the props already placed. The shipped Behaviors and Materials are created when they are missing and never overwritten afterwards, so your edits stay.
  • Duplicate it into your project content to keep a variant apart, then pick the duplicate in Create Destructible, in the batch, in Modify Destructible, or in the profile’s Behavior and Material fields. The original and the props that use it stay as they were.
  • Create your own as a Data Asset of class USDFDestructionBehavior or USDFDestructionMaterial.
  • Set an exception when only one setup, or one placed copy, must differ. See Exceptions for one setup or one prop.

Presets are not shared assets

Authoring presets and their Runtime templates under the plugin’s Authoring folder are plugin-maintained defaults that the Editor can refresh. To change fracture defaults, duplicate the preset and its template instead. See Creating your own preset.

SDF 1.0 setups

An SDF 1.0 setup carries its own copy of every reaction and material value. When the Editor starts, SDF converts the 1.0 setups of your project content (/Game): their values move into shared assets under /Game/SDF_Shared/Behaviors and /Game/SDF_Shared/Materials, setups with identical values share one asset, and nothing is saved unless every value each setup uses matches what it used before. See Upgrading from SDF 1.0.

Behaviors and Materials validate through Unreal’s Data Validation like the other SDF assets: what a shared asset does on its own is reported once, on that asset, not on every setup that uses it.

Last updated: 2026-10-29

Type to search titles, sections and keywords.