Partial break
A hit breaks off only the pieces it reaches, and what no longer stands falls with them, until the prop collapses. Radius per power, Collapse At, saves, networked games and the demo barricade.
Strike a barricade and the planks your blow reaches break off, about 30 cm around it; whatever no longer stands on a post or the ground falls with them, and the rest stands. Keep hitting: once about 60 % of it has fallen, the rest comes down. Until then it blocks the way like the whole barricade.
That is Partial Break. Off by default: a hit that breaks the prop breaks all of it, as in SDF 1.0.
Turn it on
| Where | What to set | Applies to |
|---|---|---|
| The setup, Geometry Collection section | Partial Break, Partial Break Radius, Collapse At | Every copy of that setup |
| A setup’s Overrides | Override Partial Break, with Partial Break on | Every copy of that setup |
| A placed copy’s Instance Overrides | Override Partial Break, with Partial Break on | That copy only |
Partial Break works on Chaos props only, those whose Destruction Mode is Geometry Collection. Preview does not show it.
How far a blow reaches
A hit breaks off the pieces within Partial Break Radius (30 cm) of the blow at Medium power, a third of it less per power step below, a third more per step above. With the default radius:
| Destruction Power of the hit | Reach |
|---|---|
| Very Light | 10 cm |
| Light | 20 cm |
| Medium | 30 cm |
| Heavy | 40 cm |
| Massive | 50 cm |
Then every piece that no longer stands on the ground through the pieces left falls with them.
- Which piece rests on which is read from the pieces’ own surfaces, within a centimetre, once per Geometry Collection. The pieces on the ground are those reaching the bottom of the prop, and an anchored base.
- A blow that stops on the prop’s padded hit box, in front of its pieces, is carried straight in, level, to the first standing piece within reach of it. A sword or an arrow that meets the box still breaks off what lies behind it.
- A hit that reaches no standing piece, on fallen pieces lying apart, breaks nothing.
When it comes down
The prop collapses whole, with the pieces it shows:
- once Collapse At (0.6, that is 60 %) of its pieces have fallen; it takes 0.05 to 1;
- when its health runs out;
- under a hit at its Instant Break Power, when its Behavior has Allow Power Override on.
The debris settings, lifetime and removal, apply from the collapse. See Debris: keep, remove, budget and rest.
While it stands
- The prop stands as its pieces, held where they belong. Its hidden intact collision still stops characters, so the way through opens when it collapses, while hits, projectiles and the camera reach the pieces.
- The pieces broken off fall and come to rest. While the prop stands, a fallen piece at rest is held where it lies, so that it cannot creep along the pieces still standing; the collapse frees it.
- Each hit that breaks pieces off plays the break sound and effect where they break off.
- Its result has
bPartialBreakset, the rejection reason Partly Broken, andSpawnedDebrisCountholds how many pieces fell. - A projectile takes a partial break as a break of its target: it follows Reaction When Target Breaks. See Projectile integration.
- The prop takes a slot of the Chaos budget from its first partial break to its collapse or reset. With the budget full, a hit is taken as if Partial Break were off.
On the destructible component, IsPartlyBroken() and GetFallenShare() (0 to 1) read the state in
Blueprint; GetFallenPieces() lists the pieces broken off, by their index in the Geometry Collection,
in C++.
Saved and loaded
A partly broken prop is remembered by its fallen pieces: FSDFPersistedDestruction::FallenPieces lists
them, by their index in the Geometry Collection. It is empty for a prop broken whole and in older
saves.
- Loaded, those pieces have fallen again: where they lay with Remember Debris Layout, gone without it. The others stand, held, with no sound or effect.
- A zone reset brings the prop back whole, unless it is Permanent.
- Its collapse makes the record a whole break.
- Its health is not remembered: loaded, it has its full health again.
In a networked game
The server decides which pieces break off. What travels for the prop is the pieces Partial Break took off and the hit and seed of the last hit that broke pieces off, never the pieces themselves. A partial hit that reaches a machine less than 2 s after the server made it is replayed there with the server’s hit and seed, seen and heard. A machine that arrives later, such as a player who joins or a part of the world that loads again, sets the fallen pieces at once, silent. See Networked games.
The demo barricades
In the showcase’s south-east corner, the Barricade stand holds two demo barricades. On the left, SDF Barricade, as shipped, signed Breaks Whole: it breaks whole at its first breaking hit. On the right, SDF Partial Break - Barricade, signed Partial Break: the same Blueprint, with Partial Break as an exception on that placed copy only. Each sword hit breaks off the planks it reaches, and once about 60 % of it has fallen the rest comes down.
To do the same in your game, on a placed copy of a Geometry Collection prop, tick Instance Overrides > Override Partial Break, with Partial Break on, Partial Break Radius 30 cm and Collapse At 0.6, the values the demo keeps. Tick it on the setup’s Overrides to make every copy break this way. See Playable demo.
A partly broken prop still blocks the way
This is Partial Break as designed. Until the prop collapses, its hidden intact collision stops characters, and only them, so the way opens when it comes down, about 60 % gone. Until then a broken-off piece that has come to rest is held where it lies; the collapse frees it.
Limits
Partial Break applies to Chaos props only. Preview does not show it. A partly broken prop blocks characters until it collapses, and its health is not saved.
Last updated: 2026-10-27