Bodies against props
Let a character's body break a prop — touching it, standing on it, landing on it — with the Contact module, the SDF 1.0 Break By Pawn Collision, the contact sound of a prop that holds, and touches reported to the AI.
Walk into a row of jars and they topple and shatter. Step onto a rotten crate and it gives way under your feet. Drop onto a pile of bones from a ledge and it bursts. Brush past a pot that holds and you hear it tinkle. None of this needs a weapon: the character’s body is enough. Every option on this page is off by default.
The Contact module
Add the Contact module to a Behavior, and every prop that uses that Behavior answers bodies. To change one setup or one placed copy only, tick the Contact exception (Override Contact) on the setup’s Overrides or the copy’s Instance Overrides: it carries the same options, except Contact Break Power. See Behaviors and Materials and Exceptions.
| Setting | Default | What it does |
|---|---|---|
| Break By Player Contact | Off | The touch of a player’s character breaks the prop |
| Break By Enemy Contact | Off | The touch of an enemy’s body breaks the prop |
| Contact Minimum Speed | 0 cm/s | Speed a character must carry for its touch to break the prop. 0: a mere touch |
| Break When Stood On | Off | A character standing on the prop breaks it |
| Stood On Delay Seconds | 0 s | How long a character must stand on it before it gives way. 0: at once |
| Break When Landed On | Off | A character landing on the prop from at least Landing Minimum Height breaks it |
| Landing Minimum Height | 200 cm | The drop a landing needs |
| Contact Break Power | Light | Power these breaks carry, weighed against Minimum Destruction Power like any hit |
| Report Pawn Touches | Off | Announce each touch to the game, for the AI. See Touches, for the AI |
A player is a pawn or controller a player controls; an enemy is any other pawn.
How a body breaks the prop
- Touching. With Break By Player Contact or Break By Enemy Contact, a body that meets the standing prop at Contact Minimum Speed or faster breaks it. Raise the speed on a prop that only a roll or a sprint should break: walking sits near 200 cm/s, sprinting near 600, a roll higher still.
- Standing on it. With Break When Stood On, SDF reads each walking character’s floor, 10 times a second while such props exist, so walking or stepping onto the prop counts as much as jumping on it. With a Stood On Delay Seconds above 0, the prop gives way only if the character is still on it when the delay ends: stepping off in time saves it.
- Landing on it. With Break When Landed On, a character landing on the prop from at least Landing Minimum Height breaks it, even when standing on it does not.
These breaks ignore the prop’s health: a contact breaks it outright. Contact Break Power must still reach the prop’s Minimum Destruction Power, and Allowed Breakers still applies, so a prop set to Player Only is not broken by an enemy walking into it. The prop’s Minimum Impact Speed, a gate for weapons, does not apply to these contacts.
Each break says where it came from, under SDF.Source.Collision:
| Tag | Break |
|---|---|
SDF.Source.Collision.Contact | A touch (Break By Player Contact, Break By Enemy Contact) |
SDF.Source.Collision.Ride | Standing on it (Break When Stood On) |
SDF.Source.Collision.Land | Landing on it (Break When Landed On) |
Filter on them in OnDestructionDamageReceived. See
Destruction hit.
Which shape characters meet
On SDF’s classic Actor (ASDFDestructibleActor), characters meet the Intact Collision box while
the prop stands still, and its mesh once it simulates: SDF listens to both. With Use Mesh Collision
When Intact on the Actor (new in 2.0.1), the standing prop collides with its Static Mesh’s own simple
collision instead of the box; see
Intact collision. Diagnose
this object lists the body contacts on its Body contact line. See
Diagnostics.
A prop that characters walk through — Intact Blocks Characters off — cannot be broken by body contact: contact breaks need the body to meet it. See Camera and characters.
Rolls and charges
A body contact cannot tell a walk from a committed roll by itself. When the game knows a roll, a dash or a charge is happening, send it as an explicit hit with the SDF Collision Hit Sender (Begin SDF Collision Window, Send SDF Collision Hit), which carries its own power and speed. See Roll and collision integration.
Break By Pawn Collision (SDF 1.0)
The SDF 1.0 body contact is still there, in the Contact module, and keeps exactly its 1.0 behaviour:
| Setting | Default | What it does |
|---|---|---|
| Break By Pawn Collision | Off | The prop breaks when a pawn walks, runs or rolls into it |
| Pawn Collision Minimum Speed | 200 cm/s | Contact speed floor, measured on the pawn |
| Pawn Collision Power | Light | Power of the contact, weighed against Minimum Destruction Power |
Its hits are tagged SDF.Source.Collision.Pawn. A converted SDF 1.0 setup that used it plays exactly
as before. For new props, the options above give finer control: player and enemy apart, standing,
landing.
The Contact module also keeps an older, optional shortcut through the hit-assist volume, Break On Pawn Contact (off by default), with Pawn Contact Minimum Speed (300 cm/s), Pawn Contact Power (Light), Pawn Contact Damage (9999) and Pawn Contact Impulse (450). A raw pawn overlap cannot tell walking, sprinting and a committed roll apart reliably: prefer the options above, or explicit hits from the collision sender.
Contact sound
Contact Sound, on the Material, plays when a character’s body brushes the prop and the prop holds: a pot that tinkles as you walk past. Empty, the prop stays silent.
| Setting | Default | What it does |
|---|---|---|
| Contact Sound | None | The sound of a body brushing the prop |
| Contact Sound Cooldown | 1 s | The contact sound plays at most once in this long |
| Contact Sound Minimum Speed | 50 cm/s | A body slower than this stays silent: a character at rest against the prop makes no sound |
- A touch that breaks the prop plays its break sound, not the contact sound.
- The request goes through the usual audio path as the
Contactevent, so a middleware listener onOnDestructionAudioRequestedreceives it too. See Audio. - One setup or one placed copy can set its own Contact Sound and Contact Sound Cooldown with the Contact Sound exception.
Touches, for the AI
With Report Pawn Touches on (Contact module, or the Contact exception), a character touching the standing prop is announced:
- on the prop,
OnPawnTouched(Pawn); - for the whole world,
USDFDestructionSubsystem::OnDestructibleTouched(Destructible, Pawn).
Each fires at most once a second per character and prop, for players and enemies alike. An AI can then decide to strike what is in its way: a guard that bumps into a barricade can swing at it. Reporting the touch breaks nothing by itself; your game decides what to do with it.
Limits
- Body contacts only reach a standing prop that characters meet. Debris never blocks characters.
- In a networked game, the server decides every break, body contacts included; each machine shows it. See Networked games.
- For what characters do to debris once a prop is broken, see Debris Pushed By Characters.
Last updated: 2026-10-29