LlBreakLink

Delinks the task with the given link number

Requires the PERMISSION_CHANGE_LINKS permission, granted by the owner, to run.

• Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event.
• If the script lacks the permission PERMISSION_CHANGE_LINKS, the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run).
• If PERMISSION_CHANGE_LINKS is granted by anyone other then the owner then when the function is called an error will be shouted on DEBUG_CHANNEL.
• Once the PERMISSION_CHANGE_LINKS permission is granted there is no way to revoke it. The script will only loose the permission if it is reset or the object derezzed (deleted, detached, or taken).
• This function removes sitting avatars from the object, even if not sitting on the unlinked prim.
• This function silently fails if called from a script inside an attachment.

 
//-- requests permission to change links, then breaks the link
//-- between the prim its in and the rest of the object, on touch.
default{
  state_entry(){
    llRequestPermissions( llGetOwner(), PERMISSION_CHANGE_LINKS );
  }
 
  run_time_permissions( integer vBitPermissions ){
    if (PERMISSION_CHANGE_LINKS & vBitPermissions){
      state sMain;
    }else{
      llResetScript();
    }
  }
}
 
state sMain{
  touch_start( integer vIntTouched ){
    llBreakLink( LINK_THIS );
  }
}
 

Events

Functions

Articles