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:
| Section | Question | Answered by | Shared |
|---|---|---|---|
| 1. How Does It Break? | How this mesh is cut | The authoring preset and its fracture settings | No: 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 modules | A Behavior asset (USDFDestructionBehavior) | Yes |
| 3. What Is It Made Of? | Break and hit sounds, break and hit effects, impact decals, the response to projectiles | A 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:
| Behavior | How it reacts | Minimum Destruction Power | Picked for |
|---|---|---|---|
| Fragile | Breaks on the lightest valid hit, or when it falls from 60 cm or more (its Fall module) | Very Light | Ceramic, Glass, Glass Vessel |
| Normal | Breaks on the first valid hit of Light power or more | Light | Every other preset |
| Sturdy | Takes several hits: Use Health on, 100 health points, Destroy On Single Valid Hit off. Five blows of the demo sword (20 damage each) | Light | None by default: pick it yourself |
| Indestructible | Never breaks, but still reacts to every hit: it plays its hit sound and effect and, with its HitReaction module, is pushed | Light | None 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 Mode | How the prop counts | Set with |
|---|---|---|
| Health Points (the default, as in SDF 2.0.0) | Each hit’s damage lowers its Max Health: a strong weapon breaks it sooner | Max Health |
| Number of Hits | It 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 game | Hits 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:
| Material | On a hit that does not break it | Picked for |
|---|---|---|
| Wood | Wood hit sound, small splinters, chips and a little dust (NS_SDF_Hit_Wood) | Wood, Wooden Crate, Wooden Furniture, Wooden Coffin, Wooden Barrel (Semantic), Generic |
| Ceramic | Ceramic hit sound and the ceramic impact effect, smaller | Ceramic |
| Stone | Stone hit sound and the stone impact effect, smaller | Stone |
| Glass | Glass hit sound, a few small glass shards and sparkles (NS_SDF_Hit_Glass) | Glass, Glass Vessel |
| Metal | Metal 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 barrel | Metal (Assembled Parts) |
| Chain | As Metal: the metal hit sound, and an arrow that does not break the chain glances off it | Chain |
| Rope | No sound and no effect | Rope |
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.
| Module | What it adds | Read more |
|---|---|---|
| Contact | A 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 Collision | Bodies against props |
| Fall | The 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 |
| Propagation | Breaking 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 |
| HitReaction | A 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 Noise | The 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 |
| Explosion | The prop explodes one frame after it breaks: Explosion Radius (400 cm), Explosion Damage (50), Explosion Prop Damage (200) and the rest | Explosions, break point and cover |
| Fire | The prop can burn: Burn Time (10 s), Burn Break At (0.5), Spreads Fire (on) and the rest | Fire 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:
- its setup: what belongs to its model (pieces, debris, loot, its break point);
- the setup’s Behavior and that Behavior’s modules;
- the setup’s Material;
- the setup’s own exceptions (the profile’s Overrides);
- 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.
| Call | Returns |
|---|---|
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
USDFDestructionBehaviororUSDFDestructionMaterial. - 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