llDie
Revision as of 12:18, 28 October 2007 by Ppaatt Lynagh (talk | contribs) (link with llRemoveInventory that deletes just the script, rather than all of the object that the script contains)
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
Summary
Function: llDie( );| 41 | Function ID |
| 0.0 | Forced Delay |
| 0.0 | Energy |
Deletes the object. The object does not go to the owners Inventory:Trash.
If called in any prim in the link set the result will be the deletion of the entire object.
To remove a single prim from an object use llBreakLink first.
Caveats
- After this function is called there is no way to undo the deletion of the object.
- Has no effect if called from within an attachment; there is no way to delete an attachment.
- To detach an object from the avatar call llDetachFromAvatar
Examples
//Counts down from 5 to 1, then dies
default
{
state_entry()
{
integer olf;
for(olf = 5; olf > 0; --olf)
llSay(0, (string)olf);
llDie();
}
}
Useful Snippets
llRemoveInventory of llGetScriptName deletes just the calling script, rather than all of the object that the calling script contains. For instance, you can write a script that chats a little when dragged on to an object from inventory and then politely disappears itself, such as:
default
{
state_entry()
{
llOwnerSay("llGetRegionTimeDilation()");
llOwnerSay((string) llGetRegionTimeDilation());
llRemoveInventory(llGetScriptName());
}
}