LlGetAttachedListFiltered

Looking for the current API? Open the llGetAttachedListFiltered reference →

Function notes

If avatar is a child agent, ["NOT ON REGION"] is returned.

If avatar is not a main agent and not a child agent or not an agent at all, ["NOT FOUND"] is returned.

Return value notes

Returns a list of object keys corresponding to public attachments worn by an avatar in the order they were attached.

Specification

Returns a list of attachments on the avatar.

By default this function will return all attachments on all attachment points. A script may specify multiple FILTER_INCLUDE options which will limit the returned attachments to only those listed.

If the script specifies the FILTER_FLAGS option with FILTER_FLAG_HUDS this function will include any attached HUDs if the following conditions are met:

• The script must be compiled with an experience
• The experience must be active in the region
• The avatar must have accepted the experience
• The HUD must include at least one script that was also compiled with the same experience.

FILTER_INCLUDE integer 1 b=[  e= ] s=rowspan="1" s1=id="FILTER_INCLUDE"

FILTER_FLAGS integer 2 b=[  e= ] s=rowspan="1" s1=id="FILTER_FLAGS"

FILTER_FLAG_HUDS integer 0x0001 b=[  e= ] s=rowspan="1" s1=id="FILTER_FLAG_HUDS"

Parameter		Format		Description
[ FILTER_INCLUDE, integer attachment_point ]		Include attachments on the specified attachment point in the returned results. This parameter may occur multiple times. If it is omitted the function returns attachments on all attachment points.
[ FILTER_FLAGS, integer flags ]		Flags to control filter behavior. Parameter Description Include HUDs in the returned result.

Constants in italic require a viewer compatible with the Project Bento skeleton.

Body Constant # Name Comment ATTACH_HEAD 2 Skull head ATTACH_NOSE 17 Nose nose ATTACH_MOUTH 11 Mouth mouth ''ATTACH_FACE_TONGUE'' 52 Tongue tongue ATTACH_CHIN 12 Chin chin ''ATTACH_FACE_JAW'' 47 Jaw jaw ATTACH_LEAR 13 Left Ear left ear ATTACH_REAR 14 Right Ear right ear ''ATTACH_FACE_LEAR'' 48 Alt Left Ear left ear (extended) ''ATTACH_FACE_REAR'' 49 Alt Right Ear right ear (extended) ATTACH_LEYE 15 Left Eye left eye ATTACH_REYE 16 Right Eye right eye ''ATTACH_FACE_LEYE'' 50 Alt Left Eye left eye (extended) ''ATTACH_FACE_REYE'' 51 Alt Right Eye right eye (extended) ATTACH_NECK 39 Neck neck ATTACH_LSHOULDER 3 Left Shoulder left shoulder ATTACH_RSHOULDER 4 Right Shoulder right shoulder ATTACH_LUARM 20 L Upper Arm left upper arm ATTACH_RUARM 18 R Upper Arm right upper arm ATTACH_LLARM 21 L Lower Arm left lower arm ATTACH_RLARM 19 R Lower Arm right lower arm ATTACH_LHAND 5 Left Hand left hand ATTACH_RHAND 6 Right Hand right hand ''ATTACH_LHAND_RING1'' 41 Left Ring Finger left ring finger ''ATTACH_RHAND_RING1'' 42 Right Ring Finger right ring finger ''ATTACH_LWING'' 45 Left Wing left wing ''ATTACH_RWING'' 46 Right Wing right wing ATTACH_CHEST 1 Chest chest/sternum ATTACH_LEFT_PEC 29 Left Pec left pectoral ATTACH_RIGHT_PEC 30 Right Pec right pectoral ATTACH_BELLY 28 Stomach belly/stomach/tummy ATTACH_BACK 9 Spine back ''ATTACH_TAIL_BASE'' 43 Tail Base tail base ''ATTACH_TAIL_TIP'' 44 Tail Tip tail tip ATTACH_AVATAR_CENTER 40 Avatar Center avatar center/root ATTACH_PELVIS 10 Pelvis pelvis ''ATTACH_GROIN'' 53 Groin groin ATTACH_LHIP 25 Left Hip left hip ATTACH_RHIP 22 Right Hip right hip ATTACH_LULEG 26 L Upper Leg left upper leg ATTACH_RULEG 23 R Upper Leg right upper leg ATTACH_RLLEG 24 R Lower Leg right lower leg ATTACH_LLLEG 27 L Lower Leg left lower leg ATTACH_LFOOT 7 Left Foot left foot ATTACH_RFOOT 8 Right Foot right foot ''ATTACH_HIND_LFOOT'' 54 Left Hind Foot left hind foot ''ATTACH_HIND_RFOOT'' 55 Right Hind Foot right hind foot

HUD Constant Comment ATTACH_HUD_CENTER_2 31 HUD Center 2 ATTACH_HUD_TOP_RIGHT 32 HUD Top Right ATTACH_HUD_TOP_CENTER 33 HUD Top ATTACH_HUD_TOP_LEFT 34 HUD Top Left ATTACH_HUD_CENTER_1 35 HUD Center ATTACH_HUD_BOTTOM_LEFT 36 HUD Bottom Left ATTACH_HUD_BOTTOM 37 HUD Bottom ATTACH_HUD_BOTTOM_RIGHT 38 HUD Bottom Right Special Constant Comment ATTACH_ANY_HUD -1 A special constant representing all HUD attachment points when filtering.

Caveats

When an avatar first arrives in a region, there is a brief period when their attachments are not yet fully rezzed or added. During this time, those attachments will not appear in the results.

Examples

default
{
    state_entry()
    {
        list attachments = llGetAttachedListFiltered(llGetOwner(), [FILTER_INCLUDE, ATTACH_RHAND]);

        // Object UUIDs:
        llOwnerSay(llList2CSV(attachments));

        // Object names:
        integer i;
        integer max = llGetListLength(attachments);
        for (i = 0; i < max; ++i)
        {
            string name = llList2String(attachments, i);
            llOwnerSay(llKey2Name(name));
        }
    }
}

See also: functions

llGetAttachedList

llGetAttached

llGetAttachedList

llAttachToAvatar

llDetachFromAvatar

llAttachToAvatar

llGetObjectDetails — OBJECT_ATTACHED_POINT

See also: events

attach

Shared wiki helpers

The original page also injects shared parameter notes, caveats or issue information through these helpers. Their conditional MediaWiki logic is not reproduced here; inspect the preserved helper source for additional material.

Template:LSL Function/avatar

Original shared helper source (conditional wiki logic is not evaluated)

{{LSL Injection Test}}<noinclude>{{Multi-lang|category=LSL}}</noinclude>{{#if:

{{#vardefine:p_{{{1|none}}}_desc|avatar {{#if:{{{group|}}}|or group}} {{HoverLink|UUID|Universally Unique Identifier}} {{#if:{{{sim|}}}{{{region|}}}|that is in the same [[region]] {{#ifeq:{{{sim|}}}{{{region|}}}|known|or is otherwise known to the region{{Footnote|handle=known}}}}}}}}

{{#vardefine:p_{{{1|none}}}_hover|avatar {{#if:{{{group|}}}|or group}} UUID {{#if:{{{sim|}}}{{{region|}}}|that is in the same region {{#ifeq:{{{sim|}}}{{{region|}}}|known|or is otherwise known to the region}}}}}}

<includeonly>
{{#if:{{{nc|}}}||{{#vardefine:hidden-text|{{#var:hidden-text}}
{{#if:{{#pos:{{#var:moded}}|r}}{{#pos:{{#var:moded}}|u}}||{{LSLC|Avatar/As A Parameter||{{#var:lang}}}}}}
}}}}
</includeonly>

}}<noinclude>
{| {{Prettytable}}
|-{{Hl2}}
! #var
! value
|-
{{VarPair|p_{{{1|none}}}_desc}}
|-
{{VarPair|p_{{{1|none}}}_hover}}
|}
</noinclude>

Original wiki source

Some wiki templates and tables need their original context. View this article on the Second Life Wiki. Technical wording and examples are retained from the source; historical guidance may differ from current behavior.

From the Second Life Wiki

Community documentation adapted from LlGetAttachedListFiltered, by Linden Research, Inc. and contributing residents.View contributors and history.

Built from these wiki pages, as imported:

• LlGetAttachedListFiltered (revision 1217859, 2025-01-09)
• Template:LSL Constants Attachment (revision 1217598, 2024-11-06)
• Template:LSL Constants Attachment Filter (revision 1217603, 2024-11-06)
• Template:LSL Function/avatar (revision 1179236, 2013-06-15)

Licensed under CC BY-SA 3.0. Last wiki edit: 2025-01-09.Formatting and links have been adapted for this site; API metadata follows the LSL definitions.