From Grigbertz

Revision as of 19:20, 9 November 2011

Introduction

The Bondage Witch Project Personal Assistant is a HUD made to make Second Life easier and more intuitive. It is strictly personal - it cannot affect anyone else and nobody but the wearer can use it. Many of the features need RV to function, a feature you will either need to install or activate depending on which viewer you use. But it is not an adult device and it does not in any way restrain the wearer - it uses RLV features to do things SL normally cannot.

Auto modesty

This is an advanced wardrobe function. You make up outfits in three modestly levels - General, Mature, and Adult. Auto modesty can automatically change your clothes as you move into regions of various maturity rating, or you can do so automatically.

This function is relatively complex and takes a bit of time to set up.

Setting Up

To use Auto Modesty, you need to create a folder named '-BWP-Assistant' inside your #RLV folder. In this folder you set up subfolders for each outfit you want Auto Modesty to handle. You can also create a Basic folder there to hold items you commonly use.

Note that you must manually create all the folders you need, name them correctly (including capitalization) and make sure they are correctly placed and filled for Auto Modesty to work properly - this can be a bit of a chore but the utility of Auto Modesty makes this worth it - at least for your favorite outfits.

Common Folders

These are folders used by all outfits, holding general items you always want to have - like

• -Basic
• -Default

Outfits

An outfit for Auto Modesty is a folders with a set of subfolders inside, set up so that the BWP Personal Assistant can use Auto Modesty to put them and and take them off. Each such folder is set up to accommodate the various types of sims - General, Moderate, and Adult - as well as special folders.

Common Outfit Folders

All you really need to put in each outfit folder are are these three folders. If you use this way, each folder should contain one complete outfit, which means there might be many duplicates between them - which is easy to do using links.

• General This is the outfit as it is to be worn in a general area - that is an outfit you can show to minors and in guaranteed not to offend.
• Moderate This is a version of the outfit suited to Moderate sims - it can be somewhat risque, but should not show genitals, female nipples, or otherwise be considered adult.
• Adult This version of the outfit has no restrictions - let yourself go as wild as you dare.

As you move around using Auto Modesty set on Auto, the BWP Assistant will automatically change between these three costumes as you move from area to area - taking off all the items in one fold an then adding the items of the now relevant folder.

Special Outfit Folders

These are special folders you can have in each outfit if you want. They are not necessary for Auto Modesty to function, but allows greater control and special features.

• Common If you have items that are in all three variants of your outfit, you can put them in a "Common" folder to save space and links. Items in this folder will be worn with whatever version of the outfit you are wearing.
• Protected Items in the protected folder will be RLV bound to you - they cannot be bumped or taken off. This is handy for such things as tails, ears, tattoos, and other items you never wish to loose. The protected folder otherwise works like the Common folder - these items will be worn with all versions of the outfit.
  • GenWear, ModWear, AdWear Normally, when changing costumes, one costume is removed and anoter is put on using the "Add" command. This means that other worn items are never bumped of. By instead putting the items in these folders, they will be put on using the "Wear" command - meaning they will bump off whatever was there before.
• Sitting, Standing If you use the SitWear function, whatever is in the Sitting folder will be worn when you sit on an object, and whatever is in the Standing folder will be worn when standing up. Not that uyou need to sit on an object - various animations that play a sitting animation will not work.
• SitWear, StandWear This is the same as Sitting and Standing, but puts on the items inside using the "Wear" command instead of the "Add" command, as explained under GenWear, ModWear, AdWear above.

The second button row has buttons that control the auto modesty function. It’s made to help nudists not offend in General sims, but I'm sure you can come up with other uses. this function will take on and off the clothes in these folders as you enter PG, Mature and Adult sims. You can also override it to always be either modest or immodest, and you can define certain sims as PG just for this – many Mature sims have a PG dress code. Finally, it has a Strip button that takes off all clothes.

 To use this, you have to create a folder inside your #RLV folder that is named "-AutoModesty". Inside the auto modesty folder you can have subfolders holding different outfits; each of the outfit folders should contain 3 subfolders named "Common", "Risque", and "Modest".
 Here is an example tree for these folders and items, using two outfits named My Outfit 1 and My Outfit 2.

1. RLV

 -AutoModesty
     Default
       Common
       Adult
       AdWear
       Moderate
       ModerWear
       General
       GeneWear
       Protected
       ProtecWear
       Sitting
       SittWear
       Unsitting
       UnsittWear
   Outfit
       Common
       Adult
       AdWear
       Moderate
       ModerWear
       General
       GeneWear
       Protected
       ProtecWear
   My Outfit 1
       Common
          <here you put the items common to both Risque and Modest>
       Adult
         <here you put the adult variant items>
       Moderate
         <here you put the moderate variant items>
       General
         <here you put the general variant items>
       AdWear
       ModerWear
       GeneWear
       Protected
       ProtecWear
       
   My Outfit 2
       etc

When you click the "Modesty" button, you get a menu where you can access the same options I just explained. It has two additional buttons:

 Set>> This selects one of the outfits from the -AutoModesty folder.
 Settings>> Here you can add the sim you are to your personal PG or ADULT sims list.

This was just a basic introduction to get you going; there is much more to be discovered in the advanced guide.

Button-By-Button Documentation

A detailed description of what each button does.

Button #4: Auto Modesty [ON, OFF, Always Modest, Always Immodest] Can take on and off clothes based on the rating of the sim you are in – PG or Adult. It has several settings and requires that you create two folders in your #RLV folder, one named -PG and the other -Mature.

• Auto: Puts on and takes off the contents of the #RLV/.AutoModesty folder as explained in the basic guide.
• Auto Off: Turns off the Auto function, keeping clothes as they are.
• Modest: Turns off the Auto function. Puts on the Modest content of your selected outfit and takes off the Risque content.
• Risque: Turns off the Auto function . Puts on the Risque content of your selected outfit and takes off the Modest content.

• Set Modest: The region you are currently on will be treated as a PG sim by the auto-modesty function from now on.
• Remove Modest.: If the sim you are in has been added to the list of sims to be treated as PG sims, this button removes it. If it’s not on the list, nothing happens.
• List Modest: Lists the regions currently being treated as PG sims.
• Set Risque: The region you are currently on will be treated as a ADULT sim by the auto-modesty function from now on.
• Remove Risque.: If the sim you are in has been added to the list of sims to be treated as ADULT sims, this button removes it. If it’s not on the list, nothing happens.
• List Risque: Lists the regions currently being treated as ADULT sims.

The Modesty menu features more buttons that will be explained in the advanced guide.

BWP Clothing Alias

This package also contains a selection of BWP Clothing Aliases, invisible prim attachments used to control clothing. Based on what it says in the properties field of the alias, these either take off or put on folders of clothing.

 The alias requires Restrained Life Viewer to work.
 An alias is an invisible prim that attaches temporarily.  When attached, it can make you wear or unwear any items in the #RLV folder. The alias itself can use any attachment point and you can give the alias whatever name you want.
 The command specifying what to wear or take off goes into the alias description, under properties. Max 127 characters

The command has this form:

<command>::<actionitems>::<attachment point>

The attachment point is where the alias will go for a few seconds before detaching themselves. Use any little-used attachment slot (e.g. left pec, right hip ) . HUD positions can be used as well. Avoid using several aliases attaching to the same position in the same folder if possible.

The commands are : (These are case insensitive) Wear, Take Off, Wear All, Take Off All, Doff, Strip

-Wear- Specify an RLV folder to wear. The subfolders are not worn. Example:

   Wear::Mature2 

This will put on contents of the "#RLV/Mature2 folder", but not any subfolders.

-Take Off- All worn items in a specified an RLV folder are taken off. The subfolders are ignored. Example:

   Take Off::Mature2

This will take of the contents of the "#RLV/Mature2" folder, but not any subfolders.

-Wear All- Specify an RLV folder to wear. The subfolders are also worn. Example:

   Wear All::Mature2

This will put on the contents of the "#RLV/Mature2" folder, including any subfolders.

-Take Off All- All worn items in a specified an RLV folder and all its subfolders are taken off. Example:

   Take Off All::Mature2

This will take of the contents of the "#RLV/Mature2" folder, including any subfolders.

-Doff (or Off)- Take Off all listed attachment points and clothing slots. Mixing is OK. Use ':' to separate items. Example:

   Doff::chest:spine:shirt:undershirt:jacket:left shoulder:right shoulder

This will take off whatever is worn on the chest, spine, right shoulder, and left shoulder attachment points, as well as any clothing worn on the shirt, jacket and undershirt positions, stripping the entire upper torso.

-Strip- Strip items according to any one of the listed grouped positions: Top, Bottom, Shoes, All, Cuffs, HUD, Total ('All' leaves hair and HUDs while 'Total' strips everything) Example:

   Strip::All

This takes off all clothes and attachments worn on the body except for the head location (where hair is usually worn).