Shared Folders (#RLV)

Shared folders allow scripts to force wear, unwear, and list items from a special inventory folder.

Overview

The #RLV folder is a special inventory folder that allows scripts to:

List available items
Force wearing items
Force removing items
Check what's currently worn

"Shared" does not mean items can be taken by others — it means scripts can force you to wear/unwear them.

Setup

Creating the Shared Root

Right-click My Inventory in the inventory window
Select New Folder
Name it exactly #RLV

Organizing Items

Place your items in sub-folders under #RLV:

My Inventory
├── #RLV
│   ├── cuffs
│   │   ├── left cuff (l forearm)
│   │   └── right cuff (r forearm)
│   └── gag
│       └── gag (mouth)
├── Animations
├── Body Parts
└── ...

Renaming Items

Item names must contain the target attachment point name:

left cuff (l forearm)
right ankle cuff (r lower leg)
gag (mouth)

If you wear an item without renaming it first, the viewer will rename it automatically — but only if:

It's in a shared folder
It doesn't already contain an attachment point name
It's modifiable

No-Modify Items

No-modify items cannot be renamed. Use sub-folders:

#RLV
└── shoes
    ├── left shoe (left foot)
    │   └── left shoe [no modify]
    ├── right shoe (right foot)
    │   └── right shoe [no modify]
    └── shoe base [no modify]

Put one no-modify item per sub-folder. The folder itself gets renamed.

Commands

Listing Items

// List folders in #RLV
llOwnerSay("@getinv=2048");

// List folders with worn status
llOwnerSay("@getinvworn=2048");

// Search for folders containing "cuff"
llOwnerSay("@findfolder:cuff=2048");

Wearing Items

// Wear all items in a folder
llOwnerSay("@attach:cuffs=force");

// Wear without kicking existing items
llOwnerSay("@attachover:cuffs=force");

// Wear including child folders
llOwnerSay("@attachall:cuffs=force");

Removing Items

// Remove all items in a folder
llOwnerSay("@detach:cuffs=force");

// Remove including child folders
llOwnerSay("@detachall:cuffs=force");

Checking Worn Status

// Check if a specific item is worn
llOwnerSay("@getoutfit:socks=2048");

// Check if an attachment point is occupied
llOwnerSay("@getattach:chest=2048");

Giving Items to #RLV

You can give items to a victim's #RLV folder using llGiveInventoryList():

llGiveInventoryList(victim_id, "#RLV/~subfolder_name", list_of_items);

The victim sees a standard Keep/Discard/Mute dialog. If accepted, items are stored in #RLV/~subfolder_name.

Note

The tilde (~) prefix is required for sub-folder names
The feature can be disabled via RestrainedLoveForbidGiveToRLV debug setting
Always check that the folder exists with @getinv before attempting @attach

Gotchas

No commas in folder names under #RLV — it breaks the list
Rename items or wear them at least once for auto-renaming
Keep folder names short — chat messages are limited to 1023 characters
One no-modify item per sub-folder so the viewer can determine attachment points