Hanging props
Hang a destructible prop from a point or an actor with the SDF Breakable Attachment - swinging, the chain or rope that holds it, what makes it give way, and the demo's gibbet cage.
A cage, a chandelier or a lantern hangs from a chain. Strike it and it sways about its anchor, the swing dying down. Shoot the chain and it breaks into its links: the prop falls clear of them, lands on its own, and its fall decides whether it breaks.
The SDF Breakable Attachment (USDFBreakableAttachmentComponent) does this for the destructible
prop it is added to.
Set it up
- The prop. A destructible prop that simulates physics: Physics Mode Simulated. A prop that does not simulate cannot hang: the log says so, and it stands where it was placed.
- The attachment. Add an SDF Breakable Attachment to the prop’s actor, placed where the chain meets the prop: its ring.
- The anchor. Choose what it hangs from: a point above it, or an actor such as a beam or a gallows.
- The chain, optional. A placed destructible prop made with the Chain or Rope preset, Physics Mode Static, whose pivot is where it hangs from. Set it as the attachment’s Chain.
Settings
| Setting | Default | What it does |
|---|---|---|
| Anchor | World Point | World Point hangs the prop from a point Chain Length above the component, straight up. Actor hangs it from Anchor Actor |
| Chain Length | 100 cm | World Point: how far above the component the prop hangs from |
| Anchor Actor | none | Actor: the actor it hangs from |
| Anchor Socket | None | Actor: the socket of its root it hangs from; None hangs it from the root’s origin |
| Break Force | 0 N | The pull, in newtons, past which the attachment gives way. 0 never gives way to a pull |
| Swing Damping | 1 | How quickly a swing dies down: it shrinks by e every 2 / Swing Damping seconds, whatever the prop’s size or mass. 0 swings on |
| Chain | none | The chain or rope, a placed destructible prop. Its break breaks the attachment |
| Chain Hit Reach | 0 cm | A projectile that strikes the prop this near the component strikes the chain instead. 0 leaves such hits to the prop |
Swinging
The prop swings about its anchor, and a hit that pushes it (Push When Hit) sets it swaying. The chain swings with the prop, rigid. Its collision answers hits only: it never pushes the prop it holds.
When it gives way
The attachment gives way:
- when it is pulled harder than Break Force;
- when its chain breaks: hits reach the chain as any prop, and an arrow breaks a Chain-preset chain;
- when the prop itself breaks;
- on Break Attachment, which lets the prop go now. Nothing happens once it is already free.
The prop then falls, and its Fall module decides whether the landing breaks it (see Intact physics and fall damage). A pull or Break Attachment breaks the chain too; a chain left whole when the prop breaks hangs straight again.
As its chain breaks, the prop falls clear of the links, the last one passing through its ring, and lands on the world alone.
OnAttachmentBroken(Cause) fires once each time it gives way, with the cause:
| Cause | When |
|---|---|
| Force | Pulled harder than Break Force |
| Chain Broken | Its chain or rope broke |
| Script | Break Attachment was called |
| Prop Broken | The prop itself broke |
| Loaded | The chain was remembered broken when the level loaded |
Is Attached says whether the prop hangs from its anchor; Get Anchor Location says where it hangs from, in the world.
Chain Hit Reach
A player who aims at the ring, where the chain holds the prop, expects to break the chain. With Chain Hit Reach above 0, a projectile that strikes the prop within that reach of the attachment component strikes the chain instead. 0, the default, leaves such hits to the prop. The demo cage uses 15 cm.
Aiming at the chain
A hanging prop’s Hit Assist stops at the top of its mesh rather than 55 cm above it: an arrow aimed at its chain or rope, just above the prop, reaches the chain or rope instead of glancing off the prop. Changed in 2.0.1, with nothing to set. See Hit assist.
An arrow breaks a chain or a rope only when its Projectile Profile has Light power or more: the chain and the rope keep the Normal behavior. See The Projectile Profile.
Chains and ropes
- The Chain preset breaks a chain modelled link by link into its links. The Rope preset snaps a rope into lengths of about 30 cm. Metal (Assembled Parts) cuts nothing: each part modelled apart becomes a piece and drops whole. See Authoring presets.
- The Chain and Metal presets turn on Pieces Pass Through Each Other: a chain’s links hang through one another and a cage’s bars are riveted through its hoops, so their broken pieces collide with the world and never with each other.
- The Chain material plays the metal hit sound, an arrow that does not break the chain glances off it, and it snaps and its links land with recordings of their own. The Rope material makes no sound or effect on a hit that does not break it, and snaps with its own recording.
- A chain keeps the Normal behavior: an arrow breaks it only with a Projectile Profile of Light power or more.
- A rope can burn: made Flammable, it burns through and the attachment gives way when the fire breaks it. See Fire and burning props.
Resets and saves
- A level loaded with the chain remembered broken leaves the prop lying on the ground below where it hung, still, and fires Loaded. A prop loaded broken hangs nothing.
- When the prop or its chain is reset whole, by
ResetDestruction()or a reset of the level’s props, the prop hangs again where it hung, the chain above it, on the next frame. - Every destructible component fires
OnDestructionResetwhen a reset makes it whole again.
The demo gibbet cage
Right of the showcase’s projectile range, a gibbet cage hangs from an iron chain, its bottom 1.5 m above the floor: SDF Gibbet Cage on an SDF Breakable Attachment, and SDF Gibbet Chain.
- Strike the cage with the sword: it sways, and does not break. Only a fall breaks it.
- Shoot the chain from the firing post: the chain breaks into its 26 links, the cage falls and breaks on the floor into its 29 parts, each bar tipping over on its foot.
- An arrow in the cage’s ring breaks the chain too. An arrow that strikes the cage itself glances off.
To build the same in your game:
| Part | Setup |
|---|---|
| The cage | A mesh made of separate parts, generated with Metal (Assembled Parts), Physics Simulated. Its own Behavior, Demo/Props/GibbetCage/DA_SDF_Beh_Gibbet: Minimum Destruction Power Massive, so the sword’s Medium only sways it; the Fall module with Fall Destruction Power Massive, so its fall breaks it; and the HitReaction module, so a blow pushes it. Its Material, DA_SDF_Material_DemoGibbet, has Breakable by Projectile off: an arrow glances off the iron |
| The chain | Modelled link by link, generated with Chain, Physics Static, its pivot at the point it hangs from. It keeps the Normal behavior |
| The attachment | On the cage, an SDF Breakable Attachment placed at the ring: Anchor World Point, Chain set to the chain actor, Chain Hit Reach 15, Swing Damping 0.5 |
The fire arena’s burn-through stand hangs a cage from a gallows by a rope (Burn Time 6, Spreads Fire off): shoot the rope, it burns 6 s and gives way half way through, and the cage breaks on the stand. See Playable demo.
A hanging prop falls at once, or its chain's links fly apart
The prop must simulate physics: set its Physics Mode to Simulated. A chain that simulates is held still, with a warning: set its Physics Mode to Static. A chain or an assembled prop whose broken pieces fly apart needs Pieces Pass Through Each Other, which the Chain and Metal presets turn on.
Last updated: 2026-10-29