Property | Default | Meaning |
|---|---|---|
| true | Any first valid hostile hit destroys the prop, regardless of damage amount |
| true | Forces the destructable damage calculator on the owner's Damage Handler at BeginPlay |
| true | Forces the |
| 400 / 1000 / 1 / 2.4M | The Chaos strain applied at the impact point to break the cluster bonds |
| (0,0,600) | Scatter direction used when the damage event carries no hit direction |
| — | Particle + sound spawned at the impact point by the destruction cue |
|
| The cue executed when the prop breaks |
The break impulse is driven by the hit, not by the prop:
piece velocity = hit direction × ( DamageImpulse of the Damage Type ÷ mass of the Geometry Collection )Per weapon: set Damage Impulse on the weapon/projectile's UACFDamageType. The engine default (800) barely moves a heavy barrel — use values like 50 000–200 000 for a visible punch.
Per prop: set the mass/density on the Geometry Collection asset. Heavier props resist more.
There is deliberately no per-prop "impulse" setting: the same barrel reacts differently to a dagger and to a shotgun blast.
Weapons & projectiles — any damage that reaches the ACF damage pipeline (melee traces, swipe-trace shots, projectiles). The damage calculator triggers the break server-side after the team check.
Dodge contact — UACFDirectionalDodgeAction destroys destructibles you crash into while dodging (toggle with Destroy Destructables On Contact on the dodge ability).
Stats-driven death — if your prop does have a working statistics setup, the component also listens to the owner's death and plays the same Chaos break.
Scripted — call ForceDestruction (BlueprintCallable, server-side) with a damage event you build yourself.
React to destruction from Blueprint with the component's OnDestroyed event (on AACFDestructable the actor's OnActorDestroyed event also fires).
Everything is server-authoritative:
The break decision runs on the server; the Chaos destruction is played on every machine through a NetMulticast (owner and component must replicate — they do by default on AACFDestructable).
Props have no Ability System: the destruction cue is executed through the damage dealer's AbilitySystemComponent, and GAS replicates it to all clients. If the dealer has no ASC, the FX is skipped (logged) but the destruction still happens.
AACFDestructableConvenience actor: Geometry Collection root + the component, pre-wired |
| Damage calculator for props: damage passes through unmodified (no attribute lookups) and every valid hit triggers the destruction. Set automatically on the owner's Damage Handler |
| GameplayCue notify that spawns the prop's particle & sound at the impact point |
Create a Geometry Collection from your mesh and fracture it in Fracture Mode:
Place the mesh in the level, select it, switch to Fracture Mode.
Generate → New to create the Geometry Collection asset.
Select the root bone — you must see the colored Voronoi preview on the mesh. If you don't, the selection is not valid and the Fracture button will silently do nothing.
Pick the Uniform tool (15–25 sites is a good start) and press Fracture.
Check the result with the Explode slider, then save.
⚠️ A Geometry Collection without fracture pieces can never break. If your prop reacts to hits (falls, gets pushed) but never shatters, the asset almost certainly has a single transform — fracture it.
Option A — use the convenience actor. Create a Blueprint from AACFDestructable, assign your fractured Geometry Collection to its GeometryCollection component, set its Team.
Option B — make any actor destructible. Add to your actor:
a GeometryCollectionComponent with the fractured asset;
an ACF Destructable Component.
For destruction by weapons and projectiles the owner also needs a UACFDamageHandlerComponent with TakeDamage routed to it — every AACFActor / AACFCharacter subclass already does this. Destruction by dodge contact works on any actor, no damage handler required.
Set Enable Damage From Collision = false. Otherwise the physics contact when the prop settles on the ground at spawn can shatter it instantly.
Give the prop a Team hostile to the attacker (e.g. Teams.Enemies for player-breakable props): hits are validated with the standard ACF team rules (CanActorDamageActor).
FX are played through a GameplayCue so they replicate automatically in multiplayer:
Create a Blueprint child of UACFDestructableGameplayCue.
Set its GameplayCueTag to GameplayCue.ACF.Destruction.
Save it in a folder scanned by the GameplayCueManager (the sample uses Blueprints/GAS/Cues/).
Then assign your particle (Cascade or Niagara) and sound in the component's Destruction FX — the cue reads them from the destroyed prop and spawns them at the impact point.