Attachments

An attachment is any object that is nonphysical and has been attached (via the user's command, either through their inventory or a pie menu, or by a script using llAttachToAvatar) to any attachment point on the avatar's body. An attachment may contain scripts and can be edited like a standard object--the one exception is that its position and rotation are local to the avatar it is attached to, so values can't be manually entered for its position or rotation in the editor. LSL is now able to edit position and rotation of an attachment. - Ice

There are 38 points to attach objects: 30 on the avatar's body, and 8 HUD attachments. For a full list, see llGetAttached.

Notes:

• Scripts contained within a child prim's inventory within a linked attachment may return different data than one within the parent. See llSensor for an example.
• Attachments do not add any mass to an avatar's overall mass, though attachments do maintain their own, seperate mass which affects scripts.
• Avatars cannot sit on attachments.
• When an object is attached, functions that affect objects linked to the attachment (llCreateLink, llBreakLink, and llBreakAllLinks) fail silently when called.
• Scripts in two different attachments can't use link messages to communicate "through" the avatar. However, scripts in attached objects can pass link messages to other scripts within the object just as they would normally.
• For much the same reason we cannot write to or create notecards from scripts, there is no plan to allow attachments to save themselves into central persistent storage. Anything that has a large dependence on lots of dynamically changing global state will either need to centralize that functionality in an SL script running in a safe place or externally on a remote server. Currently, the easiest way to do this is through llEmail. The new HTTP API we are currently testing will ease this. (Phoenix Linden, 4/11/06)

Functions	Purpose
llAttachToAvatar	attaches an object to avatar
llDetachFromAvatar	detaches an attachment, sending it to the wearer's inventory
llGetAttached	returns the attachment's current attachment point
llGetPermissions	returns which permissions have been granted (for attaching/detaching use PERMISSION_ATTACH)
llGetPermissionsKey	returns the key of the agent to which permissions have been granted
llRequestPermissions	requests permissions (for attaching/detaching use PERMISSION_ATTACH)

Event	Triggered when
attach	object is attached object is detached user logs in with object already attached
changed	object changes sims object is teleported
on_rez	object is rezzed object is attached from inventory user logs in with object already attached
run_time_permissions	permissions are granted.

---

Functions | Agent/Avatar