Destruction

Break props into baked fracture pieces with partial damage and anchoring, and carve voxel solids whose loose pieces fall as physics debris.

Last updated Oct 26, 2026Edit this pageVersion 1.0.0

Mowo has two kinds of destructible. A Destructible prop breaks into pre-cut pieces, like Unreal's Chaos geometry collections. A VoxelDestructible solid is carved away a sphere at a time. Both are reflected components in the Physics category and need a collider and a rigid body on the entity.

Fractured props

The Destructible component breaks its entity into pieces when hit hard enough. DestructibleComponent

FieldEffect
pieceCount, seedHow many pieces and which cut
breakOnImpact, impactThresholdBreak on a collision harder than the threshold
scatterImpulseHow hard the pieces fly apart
pieceLifetimeSeconds before pieces are removed
cascadeLevelsPieces are themselves destructible, with half the pieces each level and a higher threshold
requestBreakSet it to break the prop from code
partialDamage, damageRadiusA hit releases only the pieces near it; the rest stands as a remnant
anchor, anchorMarginWhich side holds the prop up; remnant pieces cut off from it fall
replicateBreaksThe server owns breaks and sends one small event; every client replays the same pieces from its own bake

Bake the fracture

Without a bake, the pieces are cut at break time on the game thread, which costs a frame hitch on a prop with many pieces. Click Bake Fracture in the component's Details section to store the cut as a .fracture asset, referenced by the Fracture Bake field. A bake also guarantees every networked peer gets the same pieces. Engine/Source/Runtime/Destruction/Public/Destruction/FractureBake.h

Fracture methods are Uniform, Clustered, Radial, Planar, Slice and Brick; brick walls can be laid in stretcher, stack, English, header or Flemish bond. Engine/Source/Runtime/Destruction/Public/Destruction/FractureMethods.h

Mowo Editor Details panel for a crate with the Destructible component expanded: Piece Count 24, Partial Damage on, Anchor Bottom, and the Bake Fracture button; the viewport shows the crate's Voronoi pieces outlined
Bake the fracture so breaks cost nothing at runtime.

Break from code

DestructionSystem applies damage directly: ApplyPointDamage(entity, point, radius, impulse) for one prop, ApplyDamageField(center, radius, impulse) for an explosion. DestructionSystem

Voxel destruction

The VoxelDestructible component turns its entity's box, sphere or mesh collider into voxels of voxelSize when play begins. Damage carves a sphere of voxels out; the carved voxels fall as rubble chunks, and any part no longer connected to the floor (with anchorFloor) drops as a dynamic rigid body. VoxelDestructibleComponent

FieldEffect
voxelSizeResolution
anchorFloorPieces touching the bottom layer stay put
rubbleChunkVoxels per rubble chunk
densityMass per voxel volume
maxDebris, debrisLifetimeDebris budget

Apply damage with MVoxelDestructionStatics::ApplyVoxelDamage(position, radius) from Visual Scripting or C++. It takes effect on the next simulation tick. MVoxelDestructionStatics

Engine sources

This page describes behavior implemented in these files of the engine repository, checked against commit 5922e6e5e.

  • Engine/Source/Runtime/Destruction/Public/Destruction/DestructibleComponent.h
  • Engine/Source/Runtime/Destruction/Public/Destruction/DestructionSystem.h
  • Engine/Source/Runtime/Destruction/Public/Destruction/FractureBake.h
  • Engine/Source/Runtime/Destruction/Public/Destruction/FractureMethods.h
  • Engine/Source/Runtime/Destruction/Public/Destruction/FractureConnectivity.h
  • Engine/Source/Runtime/Destruction/Public/Destruction/DebrisPool.h
  • Engine/Source/Runtime/Destruction/Public/Destruction/VoxelDestructibleComponent.h
  • Engine/Source/Runtime/Destruction/Public/Destruction/VoxelDestruction.h
  • Engine/Source/Runtime/Destruction/Public/Destruction/VoxelGrid.h
  • Engine/Source/Runtime/Destruction/Public/Destruction/MVoxelDestructionStatics.h

Page feedback

Was this page helpful?