From Grigbertz

Current revision

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 RLV 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.

Menu Icons

These symbols make menus easier to use: ▼ ▲ ► ◄ ● ○ □ ■

▼ ▲ ► ◄ - Navigation ▼ goes to a submenu. ▲ goes up to a previous menu ► ◄ goes to the next section, some menus are so long that they have several sections.

□ ■ - Checkboxes These buttons turn things on and off. Clicking the button toggles the option. An empty checkbox is an option that is currently not active. A full checkbox is an option that is active.

● ○ - Radio Buttons. A series of choices, where only one can be active. For example, your cuffs can be one of a long list of colors. The selected choice is a full ring; the others empty rings. Clicking on the button of an empty ring selects that choice.

RLV Versions

BWP Personal Assistant is made for use with RLV 2.5 or later. Either RLV or RLVa will work. Auto Group, Auto Modesty, and Height Adjustment will not work without RLV; the exact version required varies, but later is generally better. Check what version your client uses; an easy way to do this is to wear a Witchbound HUD, which will tell you what version of RLV you are using.

If this is all gibberish to you, just know that a modern viewer has a better chance to work.

Display Settings

Access this menu by clicking the glowing numbers on the BWP Personal Assistant HUD. It allows you to control what information is displayed. If you have set the assistant to display both speed and time, it will display speed when you are moving and time when you are standing still.

○ "m/s" "km/h" "mph" "speed off"

These will display your current move speed, in meters per second, kilometers per hour, and miles per hour, respectively.

○ "Real Time" "SL Time" "Time off"

Will display real-world time or SL time.

-h +h

Adjusts the real world time setting one hour forward or backward, allowing you to set the time as you want it - to match your own time or that of a friend.

Help ►

This opens the Help menu.

Auto Group

Auto Group requires RLV 2.5 or later to work

This function automatically changes your active group, either to a default group you have set, to the group owing the parcel you are in, or to a group you have programmed Auto Group to associate with the particular sim or parcel you are in. This allows you to avoid embarrassing group title mistakes, and allows you to effortlessly be polite and wear appropriate group titles in various locales. For example, it is often very appreciated to wear the group title of a club or venue you are at.

Auto Group Logic

When selecting which group to activate, Auto Group does so in the following priority.

• The group selected for this Parcel
• The group selected for this Sim
• The group that owns the land you are standing on, as long as that group has been Registered
• The Preferred group
• The currently selected group (that is, no change)

If a certain case applies, that rule is used and all lower priority cases are ignored. The final condition always applies, so if no other condition applies, there will be no change in groups.

Configuring Auto Group

You must configure Auto Group for it to function, setting which sims and parcels are to be associated with which groups. This is done in two ways - by making particular group selections for particular places, and by registering your groups - which means that Auto Group remembers the group and can recognize when you enter a parcel owned by that group. How to actually do the configuration is explained under the Edit button.

Auto Group Buttons

These buttons are used to control the Auto Group feature.

○Off

Turns the entire feature, including all other options, on and off.

○Ask

When you enter an area where Auto Group has been programed to select another group for you, you will be queried if you want to change.

○Auto

Auto Group will automatically change your groups as it has been programmed to do.

○Locked

Auto Group will never change groups, and if you change groups Auto Group will restore the group that was set when this option was chosen.

□Display

Show the selected group as a floating text above the BWP Personal Assistant.

List

List all registered groups, parcels, and sims in local chat.

SetPref

Set the current selected group as the preferred group. Whenever Auto Modesty does not have instructions to select another group, this will be the one chosen. It is the default that applies when no other rule applies.

ClrPref

Clears the preferred group.

SetParcel

Set the current selected group as the chosen group for this parcel. A parcel is a part of a sim that has been parceled of - parcels can be large or small. A property is always one or more parcels - property borders are also always parcel borders.

SetSim

Set the current selected group as the selected group for the current sim.

Edit▼

Opens a menu mainly dedicated to registering groups. Registered groups makes Auto Modesty select them when entering a parcel owned by that group - something that is very handy. But note that you don't need to register all your groups, just those that own land.

• ○Off Registration mode is off. This is the default and should normally be set.
• ○Register Starts group registration. Opens a sub-menu with only 2 buttons "Ok" and "Stop". To register, select it as the active group, then hit OK and wait until the menu reports that the group is successfully registered. You can then select another active group and register that one - repeat as needed. This function is more complex than it seems, lag sensitive and sometimes fails - the simple advice is to try again until it works.
• ○Unregister This unregisters the selected group. There should rarely be a reason to do this
• List Lists all registered groups in local chat.
• CkrAllReg Clears all registrations
• ClrParcel Clears the settings for the parcel you are in when this button is used
• ClrSim Clears the settings for the sim you are in when used
• ClrAllPar Clears all elected parcels
• ClrAllASims Clears all elected sims
• Groups▲ Returns to the Groups menu

Auto Modesty

Auto Modesty requires RLV 1.15 or later to work, except Protected Folders that need RLV 2.3.

This is an advanced wardrobe function. You make up sets 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 manually.

Auto Modesty can be controlled via the Witchbound HUD. If you wear both a BWP Personal Assistant and a Witchbound HUD, it is possible for others to access the Auto Modesty buttons. They still cannot affect your inventory or set up sets for you. This is an exception to the personal nature of the BWP Personal Assistant but only works along with a Witchbound HUD and under all the restrictions you set there.

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 set 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 sets.

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 folder an then adding the items of the now relevant folder. You can also select the maturity level you want to use manually from the HUD with the click of a button.

Sets

An set 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. We call what you have such a folder a "set" - another word could be outfit, but since SL already uses that term for something else, we decided to call ours sets. A set is contained in a folder, with various subfolders inside.

Normal Set Folders

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

General

This is the set as it is to be worn in a general area - that is a version you can show to minors and in guaranteed not to offend.

Moderate

This is a version of the set 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 set has no restrictions - let yourself go as wild as you dare.

Special Set Folders

These are special folders you can have in each set 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 set, 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 set you are wearing.

Protected

Protected Folders requires RLV 2.3 or later to work 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 set. Linked to the Protected button.

GenWear, ModWear, AdWear

Normally, when changing costumes, one costume is removed and another 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. Linked to the SitWear button.

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.

Special Folders

These are folders with special purposes, to be used along with the normal Set folders.

-Basic

This is linked to the Basic button in the menu. Whenever you push that button, everything in this folder will be added to what you are wearing. This is handy for things you almost always wear - bit not quite always. See Default for the things you always want to wear. For example, if you are almost always human, but sometimes turn int a robot, you might want to put your human skin, eyes and so on in here - making it very easy to turn back to human while still allowing you to use Auto Modesty with your troll set.

-Default

This is for items you always wear, that is common to all versions of all sets. If you always wear the same skin, hair, and eyes, put them in here. Unlike Basic, Default is a complete set - it needs the subfolders a normal set has. If you just want one Default setup, put the items in Default/Common. Whatever is in default will be worn along with every set. In effect you are wearing two sets now; first you put on Default and then you put on whatever set you have selected.

Auto Modesty Buttons

These are the buttons of Auto Modesty.

□ Auto

This activates automatic change between the three versions fo your sets - General, Moderare, and Adult. When this is turned off, Auto Modesty is not actually automatic - you need to change sets using the other buttons in the next row. This has no effect on the SitWear and Protected buttons - they can work with or without Auto.

□ SitWear

This activates the Sitting/Standing folder, making you put on and take off thing as you sit down and stand up

□ Protected

Activates the Protected folder,making whatever is in there undetachable as long as you use RLV and this option is active. When this is active, the BWP Personal Asssitant itself is also protected. Auto Modesty itself can deactivate this protection when it changes your sets, but other wardrobe handlers cannot.

General, Moderate, Adult

These buttons tell Auto Modesty to wear a specific class of set, just as if you had just entered a sim of this classification. This is a one-time action - Auto Modesty does not remember your choice.

Strip All

This will remove all worn texture clothing and prims and then wear what is in the appropriate part of the Default folder. It will not touch HUDS or something worn of Skull (which is usually hair).

Requip

This does manually what Auto does when activated - that is load the selected set as appropriate for the sim you are in. Notice that the General, Moderate, and Adult buttons are not settings, and using them has no effect on what Requip does - but Requip is affected by Settings.

Basic

Put on what is in the basic folder. This is the reason that folder exists - to make it easy to restore basic items you want to wear with most (but not all) sets.

Set ▼

This opens a submenu where you can choose which of your sets to use. Once you have created a set and put it in a folder, it will be automatically listed here - there is no registration procedure, Auto Modesty does this on its own.

Settings ▼

This opens a submenu where you can override the default behavior of Auto mode, making Auto Modesty recognize the current sim as something else than what it is. For example, some Adult sims have a "no nudity" policy. If your Adult sets tend to show naughty bits, you may want to instruct Auto Modesty to treat this sim as Moderate. As you open this menu, it tells you what the current setting for this sim is.

• ○ General, ○Moderate, ○Adult Makes Auto Modesty ignore the normal modesty settings of the sim you are in, instead considering it to be what you now program it to be.
• List General, List Moderate, List Adult This lists the sims for which you have instructed Auto Modesty to override the normal behavior. List General lists the sims you have instructed Auto Modesty to treat as if they were General, and so on.
• Clear All Deletes all modesty settings, reverting to default behavior in all sims.
• Modesty ▲ Returns to the previous menu.

Help ►

This opens the Help menu.

Help

This button will hove you a list of what the buttons on the HUD do, and has buttons giving you additional information.

Give LM

Gives a LM to the Bondage Witch Project main store.

Alias Help

Gives you instructions on how to make a gesture to control some function of the BWP Assistant.

Groups ►

Goes to the Auto Groups menu.

Display ►

Goes to the Display Settings menu.

Modesty ►

Goes to the Auto Modesty menu.

Rez Area Finder

This does not trigger a menu. Instead it gives you a nearby location where you can rez objects in, local chat. Click this text to open the map and teleport there.

Movement Assistant

This function helps controls movement speed, allowing speeds both faster and slower than normal and allowing very exact positioning.

○ Off

Turns speed control off.

○ Speed

Opens up a range of walk/run speed options. Run and walk are really the same thing in SL - the animation changes at a certain speed but it has nothing to do with settings or the normal "run" speed. Thus you can appear to run in a downslope even if you are set to be walking. Movement Assistant thus cannot decide what animation is played - that is decided by the actual speed you move at.

• □ Auto With auto walk on, you will continue to walk until you press another movement key - including forward.
• ○ Speed Preset speed selections. Using these buttons, you can make your avatar walk/run at a certain speed. Slopes affect speed - at the lowest settings you might not be able to walk up a steep slope at all.
• Slower, Faster You can change your current walk speed by smaller increments that the presets, allowing precise speed control, by using these buttons. The menu header will show your current selected movement speed.

○ Nudge

In Nudge mode, you move in small jerks. This can be very useful when you want to position yourself precisely, such as when playing animations in coordination with other people. A tip is that you can Shift+A and Shift+D to move sideways without turning. The length of the move is normally 5 cm in SL scale (about 2 inches), but can be increased or lowered using the E and C keys.

Height Assistant

Height Assistant requires RLV 2.5 or later to work

This controls the height of your avatar, and is useful to position you precisely. SL has the bad habit of positioning your avatar too low, especially if wearing high heels. When Enabled you can move your avatar up and down both when standing or the ground and when sitting of furniture, and your settings for each will be remembered.

BWP Chat Commands

BWP Clothing Alias requires RLV 1.15 or later to work

The BWP Personal Assistant also comes with Chat Commands feature and a number of gestures configured to take advantage of this feature.

List of Commands

The commands can be issued by Gestures.

Chat commands to equip #RLV folders (Not case sensitive):

• Take off single folder: /56 take off::<folder name>
• Wear single folder: /56 wear::<folder name>
• Take off folder and subfolders: /56 take off all::<folder name>
• Wear folder and subfolders: /56 wear all::<folder name>
  <folder name> can mean a subfolder deeper in the inventory.
  You separate each level of folders with "/".
  As an example, "foo/fie/fum" means the "fum" folder in the "fie" folder, in the "foo" folder in "#RLV
• Take off attachment points or clothing slots: /56 doff::<slot1>:<slot2>:...:<slotN>
  Example: /56 doff::chest:spine:shirt:undershirt:jacket
• Strip: /56 strip::<position>
  Position can be any one of: total, all, head, top, bottom, shoes, hud, cuffs
  • total: All worn items, clothing and HUDs
  • all: Everything except for hair and HUDs
  • head: Everything on head except for hair (skull positron)
  • top: Everything on arms and torso
  • bottom: Everything on lower body and hips
  • shoes: Everything on legs
  • huds: All HUDs except the Witchbound HUD
  • cuffs: Common Cuff positions, Chest, spine, uper and lower arms, lower legs.
• Change the chat channel from 56 to XX : /56 channel::XX

Gestures

You can easily make gestures to bind these chat commands to function keys. Any chat command can be bound to a function key using a gesture. See the enclosed example gestures for how to do this. Guide to Gestuires on the SL Knowledge Base

You activate gestures by right-clicking on them and selecting "Activate" on the popup menu.

External Links

• Guide to Gestuires on the SL Knowledge Base