LlAttachToAvatar

Attaches the object to the avatar who has granted permission to the script. The object is taken into the users inventory and attached to attach_point.

Requires the PERMISSION_ATTACH permission, granted by the owner, to run. If attach_point is zero, then the object attaches to the attach point it was most recently attached to.

• Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event.
• If the script lacks the permission PERMISSION_ATTACH, the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run).
• If PERMISSION_ATTACH is granted by anyone other than the owner, then when the function is called an error will be shouted on DEBUG_CHANNEL.
• Once the PERMISSION_ATTACH permission is granted there is no way to revoke it except from inside the script (for example, with a new llRequestPermissions call). Otherwise, the script will only lose the permission if it is reset or the object is derezzed (deleted, detached, or taken).
• If attach_point is occupied, the existing object will be detached and the new attachment will take it's place. Two objects cannot be attached to the same attachment point at the same time.
• Objects attached to the head (and any attachment position within the head) will not be visible in First Person view (aka Mouselook) if "show attachments in mouselook" is disable.
• If attach_point is zero but the object was never previously attached, it defaults to the right hand (ATTACH_RHAND).
• If the object is already attached the function fails silently, regardless if the attach_point is a different attach point.

Important Issues

SVC-890

[c]

llAttachToAvatar can cause a stack/heap collision in certain circumstances

//-- rez object on ground, drop in this script, it will request permissions to attach,
//-- and then attach to the left hand if permission is granted. if permission is denied,
//-- then the script complains.
default
{
    state_entry()
    {
        llRequestPermissions( llGetOwner(), PERMISSION_ATTACH );
    }
 
    run_time_permissions( integer vBitPermissions )
    {
        if( vBitPermissions & PERMISSION_ATTACH )
        {
            llAttachToAvatar( ATTACH_LHAND );
        }
        else
        {
            llOwnerSay( "Permission to attach denied" );
        }
    }
 
    on_rez(integer rez)
    {
        if(!llGetAttached())
        { //reset the script if it's not attached.
            llResetScript();
        }
    }
 
    attach(key AvatarKey)
    {
        if(AvatarKey)
        {//event is called on both attach and detach, but Key is only valid on attach
            integer test = llGetAttached();
            if (test) {
                llOwnerSay( "The object is attached" );
            } else {
                llOwnerSay( "The object is not attached");
            }
        }
    }
}

Events

Functions

Articles

Issues

		VWR-12525	[c]		llAttachToAvatar() can cause parentless attachments that can subsequently crash the client when selected
		SVC-890	[c]		llAttachToAvatar can cause a stack/heap collision in certain circumstances