Animated break

Destruction Mode Animated - a hand-made setup on an SDF Animated Destructible Actor that plays one of its Break Animations when the prop breaks, with Weapon Hit Assist, Crush Damage, persistence, networking and the demo bridge.

Some collapses are better told than solved: a rope bridge giving way under the player, a scaffold folding over. Strike the bridge and it falls the way its animation tells, with the player on it, then stays in its last pose. Destruction Mode: Animated plays a skeletal animation when the prop breaks, instead of breaking a mesh into pieces.

How it works

  • The prop is an SDF Animated Destructible Actor (ASDFAnimatedDestructibleActor). Its skeletal mesh is the prop, one bone per moving piece, and it is the actor’s root and collider.
  • The mesh has a physics asset whose bodies are kinematic: the bodies follow the bones, so a character standing on a piece falls with it, and hits and projectiles reach every piece.
  • When the prop breaks, the break’s seed picks one of the setup’s Break Animations. The mesh plays it and keeps its last pose.
  • The animation’s own notifies are its sounds, and anything else a notify can do. The setup’s break sound and effect play at the break as for any prop.

What never moves - rocks, posts - is better placed beside it as ordinary static meshes.

Set it up

Create Destructible takes Static Meshes only: an animated break is set up by hand.

  1. Import the prop as a Skeletal Mesh, one bone per moving piece, with a physics asset whose bodies are kinematic, and its break animation.
  2. Place an SDF Animated Destructible Actor in the level and set its skeletal mesh.
  3. Create a Data Asset of class USDFDestructionProfile. Set Destruction Mode to Animated, add the animation to Break Animations (several animations give several variants), and pick a Material for its sounds and effects. A Behavior is optional: without one, the profile’s own reaction values apply.
  4. Assign the profile to the actor’s SDF Destructible component, Destruction Profile.

The actor exposes GetAnimatedMeshComponent(), GetDestructibleComponent() and GetHitAssistComponent() in Blueprint. Hits and projectiles reach every piece and go through its SDF Destructible component as on any destructible: the breaking rules - power, health, Allowed Breakers - are those of its profile. See Who may break a prop, and how hard.

Weapon Hit Assist

Weapon Hit Assist (bWeaponHitAssist), on the actor, on by default, new in 2.0.1: a weapon finds the prop anywhere within its skeletal mesh’s bounds, so a swing at hip height over a bridge’s deck strikes it.

  • Only weapon sweeps that query by object type see this box - the SDF Weapon Trace, the demo sword. Characters walk through it, projectiles and the camera ignore it, and arrows still strike the pieces themselves.
  • A weapon you trace yourself must sweep by object type, not by trace channel, to find it. See Melee integration.
  • Off, a weapon must touch a piece’s body.

Settings

On the profile, under Animated Break:

SettingDefaultMeaning
Break AnimationsEmptyThe animations of that mesh; the break’s seed picks one
Crush DamageOffA falling piece hurts the characters it strikes
Crush Damage Amount50The damage a struck character takes

Crush Damage, off by default: a piece falling faster than 3 m/s hurts each character it strikes from above, once per break, by Crush Damage Amount, with Unreal’s damage. A collapse is otherwise something to escape, not a trap. Crush damage is dealt on the server only.

Remembered, reset and networked

  • Remembered. The animation played is remembered with the break: BreakVariant in a saved record (FSDFPersistedDestruction), GetAnimatedBreakVariant() on the component (-1 when none). A prop that comes back broken is set at that animation’s end at once, in silence.
  • Reset. A reset - a rest, a death, a zone reset, ResetDestruction() - makes it whole again in its mesh’s own pose.
  • Networked games. Each machine plays the same animation from where the server’s has reached. A player who joins later sees its last pose. A dedicated server still plays it: its pieces carry and crush the characters. See Networked games and Broken props remembered.

Cost and validation

An animated break spawns nothing and takes no slot of the destruction budget. Asset validation reports a setup in Animated mode with a missing Break Animation (SDF-DATA-080): a break that picks it fails.

Scope limitation

Create Destructible and Batch Generate take Static Meshes only, so they do not make Animated setups, and an Animated setup has no authoring manifest for Modify or Regenerate to rebuild. The skeletal mesh, its physics asset and its animations are yours to author.

The demo bridge

On the showcase’s plaza, a wooden bridge spans two rocks under an ANIMATED BREAK sign. Climb onto a rock, walk onto the bridge and strike it: it falls as its animation tells and keeps the animation’s last pose. The RESET gong by the west stair, struck with any weapon that sends its hits to SDF, makes it whole again.

AssetPath, under the plugin’s Demo folder
ProfileDemo/Actors/Profiles/DA_SDF_DemoBridge: Animated, Break Animations A_SDF_Bridge_Collapse_A, Material Wood
Skeletal meshDemo/Props/WoodenBridge/Generated/SK_SDF_DemoBridge_01
Physics assetPHYS_SDF_DemoBridge_01

In your game, ResetDestruction() or a zone reset makes it whole, as the gong does. See Playable demo.

Last updated: 2026-10-29

Type to search titles, sections and keywords.