Prepare your mesh
What a Static Mesh needs before Create Destructible - real size, clean geometry, simple collision, a pivot you can live with - and what each preset expects of its construction.
Most surprises after Generate come from the mesh, not from SDF: a barrel that will not split into staves because its hoops are welded to its body, a bench that breaks into pieces twice too long because it was modelled ten times too small, a window whose shards all take one material. Five minutes with this page before the first run saves the round trips.
SDF reads the mesh’s LOD0. It never modifies your mesh.
What every preset needs
- Real size, in centimetres. The recipes measure in cm: Wooden Furniture pieces of about 60 cm, rope lengths of about 30 cm, thick blocks over 15 cm, a Partial Break radius of 30 cm. A prop modelled at the wrong scale breaks at the wrong scale.
- Clean geometry. No edge shared by three or more triangles (
SDF-AUTH-SRC-010), no zero-area triangles (SDF-AUTH-SRC-012), no material slot without triangles (SDF-AUTH-SRC-013). - Simple collision for a Simulated prop. Without it, SDF makes a collision copy,
SM_SDF_<Name>_Sim, and never touches your mesh. See Intact physics and fall damage. Simple collision is also what an intact prop collides with when you tick Use Mesh Collision When Intact on its Actor (new in 2.0.1); see Intact collision. - A pivot you can live with. A Simulated prop keeps the mesh’s own pivot; a Static prop’s actor puts its pivot at the base. A chain or rope that holds a hanging prop has its pivot where it hangs from.
What each preset expects
| Preset | The mesh must be |
|---|---|
| Generic | A closed volume (SDF-AUTH-SRC-011 otherwise). Assign an interior material |
| Wood, Wooden Crate, Wooden Furniture, Wooden Coffin | Built from boards modelled as separate, disconnected parts. Connected geometry is not read as joints. Cuts Along Length 0 needs separate parts (SDF-AUTH-GC-WOOD-005) |
| Wooden Barrel (Semantic) | One body shell plus at least two disconnected hoops, or six or more full-height staves closing the wall. End caps optional. Height at least 60% of the widest diameter (SDF-AUTH-SEM-BARREL-001 otherwise) |
| Ceramic | A shell with real thickness, closed |
| Stone | A solid, closed volume |
| Glass | A flat pane, with Allow CPU Access on (SDF-AUTH-SRC-014). In a batch, a mesh that is not a flat pane is refused (SDF-BATCH-GEN-002). For a window with its surround, see below |
| Glass Vessel | A closed curved vessel. A stopper that should drop whole is a disconnected island on a cork slot, see below |
| Metal (Assembled Parts) | Made of separate parts; Generate refuses a single piece |
| Chain | Modelled link by link, each link a separate part |
| Rope | A rope modelled along its length |
“Separate parts” means disconnected islands of geometry in LOD0: a board that shares no vertex with its neighbour, a hoop that is not welded to the staves. The wood recipes recover those parts and break them; they do not guess where an artist meant a joint to be.
Material slots that change the result
Some presets read your material slot names. The match is a case-insensitive substring of the slot name or of the material’s name.
| Preset | Slots it looks for | Effect |
|---|---|---|
| Glass | Stone, Metal, Lead, Iron, Frame, Wood | Islands on those slots become one unbreakable frame; every other island becomes a pane that breaks on its own. Model each pane as a disconnected island |
| Glass Vessel | Cork | A disconnected island on that slot drops whole: a corked bottle breaks around its stopper |
Mono-material and multi-material meshes are both supported. SDF finds the interior material by object reference and appends or reuses its slot; it never assumes a fixed slot index. A wooden crate with metal fasteners keeps the right material on each piece.
Preflight warnings and what to do
These codes come from Analyze -> Authoring Plan or, for the recipe checks (barrel, wood cuts), from Generate while it stages the pieces. Nothing is published when generation stops.
| Code | Meaning | What to do |
|---|---|---|
SDF-AUTH-SRC-010 | Edges shared by three or more triangles | Separate the overlapping surfaces, or make them distinct disconnected islands |
SDF-AUTH-SRC-011 | The surface is open: cuts produce fragments with no enclosed volume | Close the shell, or give it thickness with a Solidify or Shell modifier |
SDF-AUTH-SRC-012 | Triangles with no measurable area | Run a degenerate-cleanup pass before reimporting |
SDF-AUTH-SRC-013 | Material slots owning no triangle | Remove the unused slots: empty ones shift the debris material mapping |
SDF-AUTH-SRC-014 | A Glass panel does not allow CPU access | Enable Allow CPU Access on the Static Mesh, otherwise shards are cut to the bounding rectangle and all use slot 0 |
SDF-AUTH-SEM-BARREL-001 | The source is not a stave-built container | Supply one body shell, or six or more full-height staves that close the wall, and at least two disconnected hoops |
SDF-AUTH-GC-WOOD-005 | Cuts Along Length 0 on a single-piece mesh: it would not break at all | Model the boards as separate parts, or choose a cut count |
SDF-AUTH-PERF-001 | LOD0 above the triangle warning threshold (250 000 by default) | Fracture a lighter mesh |
The full preflight table is on the Authoring overview.
See it first
Run Preview after Analyze to see the pieces your mesh really gives, with their collision, before anything is written. See Preview before you generate.
Size of the result
The number of pieces depends on the mesh as much as on the density you ask for. Structured recipes - wood, barrels, authored parts - cut the mesh’s own parts: a table of 30 boards gives at least 30 pieces, whatever the density. Every output is capped by the project’s Maximum Fragment Count (Project Settings > Souls Destruction Authoring, 400 by default). See Authoring presets.
Last updated: 2026-10-29