Preview before you generate

The Preview window of Create Destructible and Modify Destructible - the pieces in colour, Spread, Show Collision and the report - which builds the result exactly as Generate would and writes nothing.

Before you commit a mesh to a setup, Preview shows you what you are about to get: every piece in its own colour, pulled apart if you like, with its collision drawn over it, and a report of what the recipe aimed for and what it really produced. Nothing is written to the Content folder and no asset is modified, not even in memory.

Open it

  • In Create Destructible, click Preview, next to Generate, after Analyze -> Authoring Plan. When the plan cannot proceed there is nothing to preview (SDF-PREVIEW-001): resolve what Analyze reports first.
  • In Modify Destructible, click Preview…, next to Apply Changes…. It builds the result of your new choices and shows it beside the setup as it is.

Preview builds the pieces and their collision exactly as Generate or Modify would, then stops before anything is published. The material usage that Generate may need to grant (Used with Geometry Collections) is never granted by a preview.

What the window shows

The window is titled Preview - followed by the object’s name.

  • The pieces, one colour each. They are drawn with the engine’s vertex colour material, so your own materials are never asked to render on a Geometry Collection. The pieces of an anchored base, if any, are grey.
  • Spread moves the pieces apart from the centre so you can see each of them.
  • Show Collision draws each piece’s collision over it: the exact edges of convex shapes and boxes, the bounds of any other shape. Use it to compare Collision Shape choices: Precise Convex, Convex or Preset Recipe.
  • The report, in plain words, under the view.

The report

PartWhat it says
First linePREVIEW - nothing was written to the Content folder. (or NO PREVIEW when nothing could be built)
PIECESThe pieces asked for and the pieces really produced, the smallest and largest, very small ones, and whether every piece has collision. In Modify, the pieces the setup has now beside the pieces after Apply
Anchored baseHow many pieces stay where they stood (shown in grey), or that no piece lies wholly below the height you set, so none stays: raise the height
REPLACEDThe options your choices replace: your own fragment count, your cuts along length, your fracture overrides, your physics mode, your Max Health, Push When Hit, an anchored base, a Behavior or Material other than the preset’s
KEPTThe options kept from the preset or the setup
IssuesAnything validation would report

Structured recipes - wood, barrels, authored parts - follow the mesh’s own parts, so the pieces produced can differ from the pieces asked for. See Fragment counts per preset.

In Modify Destructible

In Modify, Preview is how you check a change on a setup that is already placed in your levels: it shows the pieces after Apply beside the pieces the setup has now, and nothing changes until you click Apply Changes…. A Glass setup cannot switch to another family, nor the reverse (SDF-PREVIEW-002, as SDF-REGEN-014 at Apply): create a new destructible instead. See Modify Destructible.

Limits

  • Glass has nothing to preview: a pane is cut at the moment of the hit, from the point of contact. Its Preview window shows the report only.
  • Partial Break is not shown: Preview shows the pieces, not which ones a given hit would break off. See Partial break.
  • Preview does not simulate the break: the launch, the settling and the debris behaviour are seen in Play In Editor.

Nothing to undo

Closing the Preview window leaves your project exactly as it was. Adjust the settings and preview again as often as you need before Generate or Apply Changes….

Last updated: 2026-10-27

Type to search titles, sections and keywords.