Tutorial: #RLV Folders

This plugin gives access to the contents of the #RLV folder:
- You can easily force wear or take off complete sets of clothing or toys.
- You can make your pet wear their full set of cuffs or a gag or whatever restraint by a click of a button.

All settings and status will be displayed in the dialog box and the buttons.
As with all MoDesign plugins, you get comfort and easy use for the most detailed control, not to mention the low lag design.

Learn how to set up #RLV Folders by following this link.
Learn how to use the MoDesign #RLV Folders by following this link.
Learn how to use the Total Submission set as Kidnappee and set up #RLV

MoDesign #RLV Folders, MoDesign Attachment Lock, MoDesign Cloth Lock and Body Lock are all compatible:
- Change complete outfits while all outfit is permanently locked up
- No way to wear any other attachment or cloth
- No way to undress any locked attachment or cloth

---

⤷  #RLV Folders  ⤶

This app can be used to access a special section of the Inventory of the submissive.
You can:
- force-wear
- force-strip
- deny wear
- deny strip
of all items located in any individual folder.
Access is only folder-wise, not item-wise.

It is convenient to organize your inventory in different sets of folders, that make sense.


⤷  Setup of #RLV Folders  ⤶

Create a folder #RLV in the root of your inventory.
Create #RLV-root-folders
- Body (to organize everything that is related to your body; shape, hair, AO, ..)
- Clothing (to organize clothing)
- Cl.Shoes (to organize shoes; I chose the prefix Cl., to sort it next to clothing)
- Cl.Jewelry (to organize your jewelry)
- Cl.Lingerie (to organize underwear)
- Restraints (to organize wearable bondage gear)

A general HowTo about #RLV-Folders-Setup can be found here.



When you organize your clothing, it is highly recommended to do that compatible to Smart Strip.



⤷  MoDesign Smart Strip  ⤶

Smart Strip is a way to link modern mesh clothing with traditional clothing layers and to find a way to address mesh clothing with RLV means.

A big problem with mesh is, that rigged mesh clothing can be attached to any attachment point and that mesh usually requires that you wear an matching alpha layer to hide the body. This makes stripping by script quite difficult, as you never know what attachment to strip and you have no chance to unwear the corresponding alpha layer. To fix this, Smart Strip was invented.

The idea of Smart Strip is, to organize your mesh clothing in folders. You sort all items for a particular mesh in one folder and then you add one (or more) matching clothing layers.

Lets say you have a pair of mesh pants, blue jeans. They attach at right hand and need you to wear an alpha layer, to hide the skin of your legs under the pants. You organize that like this:

But like this, RLV hardly has a chance to tell if that items needs to be stripped, when you want to strip pants. It might be able to guess by the folder name of the previous folder, but imagine, if you add the pants to a suit, that option is gone. We need something, RLV and you can rely on. Now here comes the magic trick. You add an invisible pants clothing layer:

Now, if you wear everything inside that folder, you wear "pants", and RLV can be sure "pants are worn", as RLV can see that you wear a pants layer. Even more, if you want to strip pants, now Smart Strip has a chance to kick in. What Smart Strip actually does, is not only to strip a layer, but also to strip the complete folder where the layer is located.

This means, if you use Smart Strip to strip "pants", it will also strip the mesh attachment and the alpha layer. You will be stripped correctly and not float around with an invisible lower body. Now, isn't that cool!

Make sure to always use a copy of that clothing layers, every time you use them. Don't remove it somewhere else by accident, if you just drag it.

To get a smart strip compatible RLV relay, have a look at the related products. Tip: set the relay to exclusive smart strip, to protect your attachments that aren't actually clothes.

You can find a free copy of MoDesign Smart Strip clothes at the Marketplace:
https://marketplace.secondlife.com/p/MoDesign-Smart-Strip-Clothing/6929552



⤷  Advanced #RLV Folders options  ⤶

- Global Lock: Lock all #RLV folders
-- this setting can be activated on proximity conditions
- #RLV Only: submissive can only wear items that are located in #RLV folders
- Sort Modes: to sort the folder buttons on your preference
- Hide ~: to hide folders that beginn with ~ (e.g. auto added folders)
- Overrule: Dominants will operate locked items as if they where not locked
- Access: to limit public access to a specific public folder, or deny it completely

Smart Dress:
Smart Dress options are shortcut options to quick wear or unwear folders, usually the last folders in a folder tree. It has 4 modes of operation:
    0: off
    1: undress worn folders, when you enter them
    2: add folders with unworn items, when you enter them
    3: undress worn folders, add folders with unworn items,  when you enter them
If you get confused by this behavior, that usually saves you one click, just turn it off.



⤷  Smart Body (or Auto Attach) ⤶

This is a special feature that makes it possible to setup folders that get worn or undressed automatic. The main purpose is, to wear items that are usually hidden under clothing and get attached when the clothing gets undressed. To use it, you need to set up special folders.

Examples:

• /#RLV/Body/_Auto/Upper
  attach prim nipples, when neither jacket nor shirt nor undershirt are worn, remove them otherwise
• /#RLV/Body/_Auto/Lower
  attach organs, when neither pants nor underpants are worn, remove them otherwise
• /#RLV/Body/_Auto/Feet
  attach prim feet, when neither shoes not socks are worn, remove them otherwise

There is also an expert mode, that let you use every possible combination of not worn clothing layers that trigger attach or detach. Instead of Upper, Lower or feet, you us a folder name that is a code consisting of nine positions of 0s and 1s, beginning with an _ The list of the code corresponds to clothing layers: gloves,jacket,pants,shirt,shoes,skirt,socks,underpants,undershirt.
Please notice:

So, if you have an item that needs to be attached every time no gloves are worn (e.g. fingernails), you can create a folder /#RLV/Body/_Auto/_100000000 and put your fingernails and their skin applier tattoo to that folder, and maybe a fingernail-fix-hud, and every time you don't wear gloves, you will wear fingernails and soon as you wear a gloves layer, they get removed. The equivalent for the folder /#RLV/Body/_Auto/Feet would be /#RLV/Body/_Auto/_000010100 (shirt and socks not worn).

It is recommended to add a notecard to such a number code folder, that describes, what the folder is about (use _ not ~ ! this change was needed, as RLV does not handle ~ sub-folders, while RLVa does!):

While Smart Body is active, the Auto folders will be locked. If you want to change the Smart body set up, you need to turn off the Smart Body option, first.


The #RLV Folders Menu
This part of the tutorial is about the older #RLV Folders app version 3.xx, some features work different with version 4.xx.

When you access the #RLV Folder plugin menu
It will display:
- Item it is installed in
- Script name, version and free memory
- Mode (Wear or Undress)
- Present branch of folders
- List of Subfolders in this branch

Every #RLV folder is represented by one button.
Some more buttons allow propper operation and setup of the plugin.

Folders might begin with additional prefixes:
/ : Folder will have more sub folders
+ : Folder or subfolders contains worn items
* : All items in this folder and sub folders are worn
~ : Items given by force to your #RLV folder by RLv Toys

Navigation
To enter a subfolder, press a folder button that has subfolders inside.
These folders are indicated by a leading /
To get back, press the /.. -button.
Learn how to use the MoDesign #RLV Folders by this example.

Wearing / Undressing
If a folder button is not marked with an / and you press that folder, the script tries to wear or undress the outfit located in that folder, depending on the Mode (wear / undress).
If an outfit folder is beginning with an * and *-Mode is set to be active, pressing this button will undress the outfit located in that folder. This is the default behavior.

Mode: Wear / Mode: Add / Mode:Undress
Use this to toggle between Wear modes and Undress mode
- In Wear-Mode, your sub will wear a outfit if you click an Outfit-button.
- In Add-Mode, your sub will add a outfit, attached items will not get detached.
- In Undress-Mode, your sub will take off the outfit if you click the Outfit-button and the sub is wearing that outfit (or parts of it).

Wear This / Add This / Undress This
The script will try to wear/undress the items in the present branch of folders, but not the items in the sub-folders.

(All)
The script will try to wear/undress the items in the present branch of folders, as well as the items in the sub-folders.

(Refresh)
Press this to reread the present folder contents.

(Settings...)

This will open a Setup sub-menu with lots of options:

• Sort Mode:
  You can set several rules to sort the displayed folders:
  alphabetic: all folders will show in alphabetic order no matter if they content more sub folders or worn items.
  alphabetic - folders first: like alphabetic, but it will first present the folders that contain more subfolders.
  alphabetic - worn first: like "alphabetic - folders first", but folders with worn items inside will be listed first.
  Please take in mind that capital letters are sorted separate from lower letters.
• * Mode:
  You can set up the plugin to auto undress all folders that have 100% worn items inside, independent from the Wear/Undress mode.
  3 Options are available:
  - Off: *Buttons and */ Folders will behave normal
  - *Buttons will undress, */ Folders behave normal (default)
  - *Buttons and */Folders will undress
• Attachment: (only available if Attachment Lock is installed)
  Toggles if MoDesign Attachment Lock locked attachments will be changed or not when you try to wear or undress outfits.
  Default is Yes to change.
  If set to Yes, all locked attachments will be unlocked - then the outfilt can be changed and the previously locked clothing will be locked again - whether clothing is worn or not.
  This will only work for items locked with Attachment Lock installed inside the same attachment as this script.
• Body: (only available if Body Lock is installed)
  Toggles if MoDesign Body Lock locked body parts will be changed or not when you try to wear or undress outfits.
  Default is Yes to change.
  If set to Yes, all locked body parts will be unlocked - then the outfilt can be changed and the previously locked body parts will be locked again - whether clothing is worn or not.
  This will only work for items locked with Body Lock installed inside the same attachment as this script.
• Clothing: (only available if Cloth Lock is installed)
  Toggles if MoDesign Cloth Lock locked clothing will be changed or not when you try to wear or undress outfits.
  Default is Yes to change.
  If set to Yes, all locked clothing will be unlocked - then the outfilt can be changed and the previously locked clothing will be locked again - whether clothing is worn or not.
  This will only work for items locked with Cloth Lock installed inside the same attachment as this script.

Limitations:
Attachments, Body Parts or Clothing that is locked by other scripts can not be changed.
The use of the RestrainedLife viewer is required for the wearer of the attachment with this plugin.

Tutorial: #RLV Folders Setup

This tutorial describes how to set up folders of outfits in your inventory, so you can use the 'Wear' command again.

I will describe that by setting up some folders in the #RLV folder directory.

If you don't know how to handle your inventory, please have a look first at this Video Tutorial "How to manage your inventory", made by Torley Linden.

How #RLV Folders work
The #RLV folder is a special folder. It is possible to gain access to this inventory by special RLv commands to force wear or force undress the outfit and toys prepared there. This is done using the MoDesign #RLV Folders Plugin (e.g. part of the MoDesign Total Submission toys).

#RLV folders work like any other usual Inventory folders that contain clothing or attachments. Two things are important about them:

1. you have created a #RLV folder in the root of My Inventory
2. you have made the attachments Rlv-Ready, so they can easily be worn.
   

Create the #RLV root folder

1. open your inventory
2. open the context menu of the inventory root folder "My Inventory"
   
3. choose: New Folder
4. rename the New Folder to #RLV
   Case sensitive!

You should end with this result:

You see the new #RLV folder as new folder in your My Inventory folder

How to add outfits
At first I want to add my black latex catsuit to the RLv Folders. The catsuit is already unpacked and located in my Outfit folder. To add it to #RLv Folders, I do:

1. create a New Folder in the #RLV folder
2. rename the New Folder to Latex
   
3. copy the folder with the latex catsuit to the Latex folder
   Now located at: #RLV/Latex
   
4. rename the folder of the catsuit, so it fits less then 20 letters
   

Now, that was easy.
As you can see, no special action was needed:

The clothing can be worn with the Wear context menu and is available with #RLV folder toys to be dressed or undressed.

How to add attachments
Next, I want to add a MoDesign Chastity Belt:

1. create a New Folder in the #RLV folder
2. rename that New Folder to Chastity Belt
3. move the chastity belt from my inventory into the new created Chastity Belt folder
   

Seems to be very easy as well.
What is the difference between clothing and attachments?

With attachments, you need to add the name of the attachment point where the attachment is needed to be attached to the name of the attachment. It is common to add the attachment point name in brackets at the end of the attachment name.

This is already done by default with the chastity belt I just added. The wear context menu is available, as you can see:

The chastity belt will be attached at stomach.

How to add not RLv-ready outfits

Ok. Now that we have learned the basics, we take the final step to the high mysteries of making any outfit RLV-Folders-enabeled.

I want to add a pair of boots. When I unpack the boots, its clear to see, there are no RLv compatible attachment point identifiers given. Even worse, some of the items are no modify - no way to add the attachment point name by hand here!

So, what to do?

1. move the folder of the boots into the #RLV folder
2. rename the folder to Boots Black
   the folder name needs to have less then 20 letters

Ok. But there is still no Wear option after doing that. But there is a simple standard procedure how to make outfit sets like this RLV-ready:

Standard procedure to get any outfit RLV ready

1. check the attachments of the outfit
   - make sure you know where to attach every single attachment
   -> make a list
   (hint: if in doubt, use a non RLv viewer and wear the attachment, then launch RLv again)
   
2. wear one attachment after an other at the correct attachment point:
   - open the context menu of the attachment
   - choose Attach To ...
   - choose the correct attachment point
   -> the attachment should be worn
   -> if the attachment is modify, the viewer should have added the correct attachment point identifier to its name and you can skip the next steps with this attachment
   
3. Only proceed, if the attachment point was not added to the attachments name:
1. create a New Folder in the folder of the present outfit
2. drag the attachment you are processing into that New Folder
3. wear the attachment at the correct attachment point
   - as described above
   -> the New Folder should be renamed automatic to the attachment points name and a leading dot
4. You don't need to care about Clothing that is no attachment
5. After processing all attachments:
1. create a New Folder in the folder of the present outfit
2. rename that folder to ".bak"
   the leading dot is most important!
3. move all not needed stuff of the outfit into that folder
   - this is to tidy up the outfit folder
   - folders with a leading .dot will be ignored by the #RLV Folders toys

After I follow these steps with the shoes from above, I end with:

As you can see, its possible to wear the boots when sorted in a .(attachmentpoint) folder.

Well done!

Combined Outfits in #RLV Folders
Very well, now that we are able to have some nice outfit available in #RLv Folders, its time to combine it to get a complete kinky outfit:

1. rename the folder Latex to Latex Outfit
2. drag the folder Chastity Belt to the new folder Latex Outfit
3. drag the folder Boots Black to the folder Latex Outfit

Now I have a complete outfit in my #RLV folder:

To see how to handle this with MoDesign #RLV Folders scripts, we start the next lesson: Tutorial: #RLV Folders Usage Example

Tutorial: #RLV Folders Usage Example

In the previous lesson, we learned how to set up an outfit in #RLV folders.
Now I want to show how to use the MoDesign #RLV Folders plugin to wear or undress this outfit or parts of it.

First, lets have a look again at the folder structure I created in my #RLV folder:

When I open the #RLV Folders plugin, I get this:
(The menu shoots for this tutorial have been created with MoDesign #RLV Folders v2.14 - if you use a newer version, the menu might look slightly different. The general usage stays the same.)

Please have a look at the menu text. It indicates, that:
- we are in wear mode (not undress)
- we are currently at the #RLV root folder: /
- we can access a folder named Latex Outfit


Notice the slash / in front of the Latex Outfit. It indicates, that there are more outfits inside.

Lets enter the Latex Outfit folder: I click that button:

Now we see the 3 folders of the Latex Outfit, the catsuit, the boots and the belt.

You can see no leading slash / at any of the named items. This indicates, that these are basic outfits, no more sub folders inside.

As I am in Wear Mode, a click on the button of one of these outfits will wear that.
Klicking on "Wear This" would only wear all outfit in the Latex Outfit folder, but not the outfits in the subfolders (Catsuit, Boots and Belt). As there is no 'basic' stuff in the Latex Outfit folder, this would have no effect for this folder at present.

Clicking on (All) would wear everything in the Latex Outfit folder and all sub-folders.

Lets do this and click (All):

Looks pretty the same now, safe that all outfits now start with an asterix. This means, all these outfits are worn. When a asterix is shown in front of a folder, it means all outfits inside that folder are worn.

One very handy feater is the * Mode of the plugin. It is active on default, but can be changed individually in the Settings menu of course.
The * Mode allows you to undress worn outfit without the need to change the Wear-Mode. This gives me two options to get rid of that chastity belt:

• Press Mode:Undress and then the Chastity Belt button
  or
• press the Chastity Belt button right away, as the * Mode is active

Ok, lets do it fast and press the Chastity Belt button to get rid of the belt.
After that, I press /.. (up) to get back to the Latex Outfit folder:

As you can see, the Latex Outfit folder is now marked with a plus. This indicates that there are some items worn inside the folder.

When I click it, I will enter the folder again. When dressing the chastity belt again and going back up, the plus will be replaced by an asterix.
When I now click the */Latex Outfit button .. I do not enter the folder .. gosh, * Mode is active and all worn outfit inside will be undressed .... sorry, seems I need to run. ;o)