LSL Wiki Mirror 10-5-2006: llBreakLink

llBreakLink(integer linknum)

Delinks the object with the given link number linknum (requires the permission PERMISSION_CHANGE_LINKS be set).

Remaining link children in the link set will be renumbered, so if llBreakLink(5) will cause the previous child prim 6 to become 5, child 7 will become 6, and so on.

If you want the prim that was delinked to do something after delinking, use a changed event, as in this example:

changed(integer change) {
    if (change & CHANGED_LINK) // linked/unlinked/sat on
        if (llGetLinkNumber() == 0) // now i'm a single prim linked to nothing
            llDie(); // so i die
}

Q: Can I delink a prim from an attachment?
A: No. If you want to make a prim in an attachment invisible, you can use llSetAlpha to hide it, but it will remain linked to the rest of the attachment.

Q: Do I need to call llBreakLink from the root prim in order for this to work?
A: No, as long as it has PERMISSION_CHANGE_LINKS set, any script in any prim may break the link. You cannot grant permissions to one script and have another act upon those permissions, however. Scripts must request their own permissions.

Q: Can I delink a prim from a no mod object
A: Yes.

To break all links in a linked object, use llBreakAllLinks.

Functions | Constants | Link