Type Function
Object Joint
Library physics.*
Return value none
Revision 2017.3044
Keywords joint, removeSelf
See also display.remove()
Physics Joints (guide)


Destroys an existing joint and detaches the two joined bodies. This should not be called during a collision event — instead, set a flag or add a time delay so the destruction can occur in the next application cycle or later, for example via timer.performWithDelay().

Alternatively, you can destroy a joint via display.remove(), passing the joint reference as the sole argument.