Skip to content

Clothing & Attachment Commands

Commands controlling clothing layers and attachments.

Basic Detach/Attach

@detach

@detach=<y/n>

Locks/unlocks the object containing the calling script. With no parameters, the specific attachment containing the script is locked.

@detach (by point)

@detach:<attach_point_name>=<y/n>

Locks the specified attachment point. If occupied, the object becomes undetachable. If empty, no items can be attached there.

@addattach

@addattach[:<attach_point_name>]=<y/n>

Locks the attachment point empty. Existing objects can be detached, but nothing can be attached. If no point specified, all points are affected.

@remattach

@remattach[:<attach_point_name>]=<y/n>

Locks the attachment point full. Existing objects become undetachable. If no point specified, all points are affected.

@defaultwear (RLV only — Kokua)

@defaultwear=<y/n>

When denied (@defaultwear=n), prevents the viewer's default "Wear" action from context menus on items without a specific attachment point. Scripted @attach commands are unaffected.

Note

Not available in RLVa viewers (Firestorm, Alchemy). Kokua (RLV) only.

Force Commands

@detach (force)

@detach[:<attach_point>]=force

Removes attachments by point name. If no point specified, removes everything.

@detach (by UUID)

@detach:<UUID>=force

Removes a specific attachment by UUID.

@remattach (force)

@remattach[:<attach_point>]=force

Synonym for @detach[:<attach_point>]=force.

@detachme

@detachme=force

Forces the object to detach itself. Use with @clear to avoid race conditions.

Clothing Layers

@addoutfit

@addoutfit[:<part>]=<y/n>

Prevents wearing additional clothing. Parts: gloves, jacket, pants, shirt, shoes, skirt, socks, underpants, undershirt, skin, eyes, hair, shape, alpha, tattoo, physics.

@remoutfit

@remoutfit[:<part>]=<y/n>

Prevents removing clothing. If no part specified, prevents removing anything.

@remoutfit (force)

@remoutfit[:<part>]=force

Removes clothing by layer. If no part specified, removes everything. Note: skin, shape, eyes, hair cannot be removed.

Queries

@getoutfit

@getoutfit[:part]=<channel_number>

Returns current clothing layers as a string of 0s and 1s. Order: gloves,jacket,pants,shirt,shoes,skirt,socks,underpants,undershirt,skin,eyes,hair,shape,alpha,tattoo,physics.

@getattach

@getattach[:attachpt]=<channel_number>

Returns attachment point occupancy as 0s and 1s. First character ("none") is always 0, matching ATTACH_* macros.

Permission Commands

@acceptpermission

@acceptpermission=<rem/add>

Forces auto-acceptance of attach and take control permission requests.

@denypermission

@denypermission=<rem/add>

DEPRECATED

This command is deprecated since v1.16.2. Do not use.

Shared Folder Commands

@unsharedwear

@unsharedwear=<y/n>

Prevents wearing anything not in the #RLV folder.

@unsharedunwear

@unsharedunwear=<y/n>

Prevents removing anything not in the #RLV folder.

@sharedwear

@sharedwear=<y/n>

Prevents wearing items from the #RLV folder.

@sharedunwear

@sharedunwear=<y/n>

Prevents removing items from the #RLV folder.

@getinv

@getinv[:folder1/.../folderN]=<channel_number>

Returns list of folders in #RLV (or specified subfolder). Folder names starting with . are ignored.

@getinvworn

@getinvworn[:folder1/.../folderN]=<channel_number>

Returns folders with worn status. Two digits per folder: first = items worn in folder, second = items worn in subfolders. Values: 0=none, 1=present but not worn, 2=some worn, 3=all worn.

@findfolder

@findfolder:part1[&&...&&partN]=<channel_number>

Returns path to first shared folder containing all specified parts.

@findfolders

@findfolders:part1[&&...&&partN][;output_separator]=<channel_number>

Returns paths to all matching shared folders.

@getpath / @getpathnew

@getpath[:<attachpt>|<clothing_layer>|<uuid>]=<channel_number>
@getpathnew[:<attachpt>|<clothing_layer>|<uuid>]=<channel_number>

Returns path to shared folder containing the specified item.

Force Folder Commands

@attach

@attach:<folder1/.../folderN>=force

Forces wearing all items in the specified folder. Item names must contain target attachment point name.

@attachover

@attachover:<folder1/.../folderN>=force

Like @attach but won't kick already-worn items.

@attachall

@attachall:<folder1/.../folderN>=force

Like @attach but includes child folders.

@attachallover

@attachallover:<folder1/.../folderN>=force

Like @attachall but won't kick already-worn items.

@detach (folder)

@detach:<folder_name>=force

Forces removing all items in the specified folder.

@detachall

@detachall:<folder1/.../folderN>=force

Like @detach but includes child folders.

Shortcut Commands

@attachthis

@attachthis[:<attachpt>|<clothing_layer>]=force

Shortcut for @getpath + @attach.

@attachthisover

@attachthisover[:<attachpt>|<clothing_layer>]=force

Like @attachthis but won't kick already-worn items.

@attachallthis

@attachallthis[:<attachpt>|<clothing_layer>]=force

Shortcut for @getpath + @attachall.

@attachallthisover

@attachallthisover[:<attachpt>|<clothing_layer>]=force

Like @attachallthis but won't kick already-worn items.

@addoutfit (force)

@addoutfit:<folder1/.../folderN>=force

Synonym for @attach.

@addoutfitall (force)

@addoutfitall:<folder1/.../folderN>=force

Synonym for @attachall.

@addoutfitover (force)

@addoutfitover:<folder1/.../folderN>=force

Synonym for @attachover.

@addoutfitallover (force)

@addoutfitallover:<folder1/.../folderN>=force

Synonym for @attachallover.

@addoutfitthis (force)

@addoutfitthis[:<attachpt>|<clothing_layer>]=force

Synonym for @attachthis.

@addoutfitallthis (force)

@addoutfitallthis[:<attachpt>|<clothing_layer>]=force

Synonym for @attachallthis.

@addoutfitthisover (force)

@addoutfitthisover[:<attachpt>|<clothing_layer>]=force

Synonym for @attachthisover.

@addoutfitallthisover (force)

@addoutfitallthisover[:<attachpt>|<clothing_layer>]=force

Synonym for @attachallthisover.

@attachoverorreplace

@attachoverorreplace:<folder1/.../folderN>=force

Version: v2.5

Synonym for @attach. Named for future behavior where it will allow folder-name-driven wear/replace decisions. Currently identical to @attach.

@attachalloverorreplace

@attachalloverorreplace:<folder1/.../folderN>=force

Version: v2.5

Synonym for @attachall. Named for future behavior. Currently identical to @attachall.

@attachthisoverorreplace

@attachthisoverorreplace[:<attachpt>|<clothing_layer>]=force

Version: v2.5

Synonym for @attachthis. Named for future behavior. Currently identical to @attachthis.

@attachallthisoverorreplace

@attachallthisoverorreplace[:<attachpt>|<clothing_layer>]=force

Version: v2.5

Synonym for @attachallthis. Named for future behavior. Currently identical to @attachallthis.

@detachthis

@detachthis[:<attachpt>|<clothing_layer>]=force

Shortcut for @getpath + @detach.

@detachallthis

@detachallthis[:<attachpt>|<clothing_layer>]=force

Shortcut for @getpath + @detachall.

Lock Folder Commands

@detachthis (lock)

@detachthis[:<layer>|<attachpt>|<path_to_folder>]=<y/n>

Prevents removing the folder containing the calling object, or folders matching the criteria. Folder cannot be renamed, moved, or deleted.

@detachallthis (lock)

@detachallthis[:<layer>|<attachpt>|<path_to_folder>]=<y/n>

Like @detachthis but applies to child folders recursively.

@attachthis (lock)

@attachthis:<layer>|<attachpt>|<path_to_folder>=<y/n>

Prevents attaching items from the specified folder.

@attachallthis (lock)

@attachallthis[:<layer>|<attachpt>|<path_to_folder>]=<y/n>

Like @attachthis but applies to child folders recursively.

Exception Commands

@detachthis_except

@detachthis_except:<folder>=<rem/add>

Adds exception to remove items from the specified folder.

@detachallthis_except

@detachallthis_except:<folder>=<rem/add>

Adds exception to remove items from the folder or its children.

@attachthis_except

@attachthis_except:<folder>=<rem/add>

Adds exception to wear items from the specified folder.

@attachallthis_except

@attachallthis_except:<folder>=<rem/add>

Adds exception to wear items from the folder or its children.

Note

Exceptions only apply to restrictions from the same object. The viewer checks the closest parent in the folder hierarchy.

Attachment Points

Head group: head, nose, mouth, tongue, chin, jaw, left ear, right ear, left ear (extended), right ear (extended), left eye, right eye, left eye (extended), right eye (extended), neck

Torso group: left shoulder, right shoulder, chest/sternum, left pectoral, right pectoral, belly/stomach/tummy, back, tail base, tail tip, avatar center/root, pelvis, groin

Arms group: left upper arm, right upper arm, left lower arm, right lower arm, left hand, right hand, left ring finger, right ring finger, left wing, right wing

Legs group: left hip, right hip, left upper leg, right upper leg, right lower leg, left lower leg, left foot, right foot, left hind foot, right hind foot

HUD group: HUD, HUD Center 2, HUD Top Right, HUD Top, HUD Top Left, HUD Center, HUD Bottom Left, HUD Bottom, HUD Bottom Right

Clothing Layers

alpha, tattoo, shoe base, physics, socks, gloves, undershirt, underpants, shirt, pants, jacket, skirt

See also: Shared Folders | Sitting