[SA] RLV Folder Chat Commands Plugin

Shady Accessories
RLV Folder Chat Commands Plugin
For Mesmermize Dungeon [MD] products
Version 1.0
Users Manual

WHAT IS THIS?
-------------
This is a plugin for MD products.  You will need to own an MD product in order to utilize this script.

This script will add OpenCollar-style chat commands for RLV outfit control to your MD product.  See below for example usage.

WHO IS THIS FOR?
----------------
This product is intended for MD customers and OpenCollar users who wish to have functionality of OpenCollar in an MD product.

HOW TO INSTALL
--------------
PICK ONLY ONE MD product to install this script into!

I cannot stress this enough:
ONLY ONE copy of this script should be running on your avatar.
UNPREDICTABLE RESULTS will occur if you use MORE THEN ONE copy of this script.

I recommend you install it in your MD Collar where it was made to go, but it will work in ANY MD product that supports plugins.

Before installation:
   1.  Make a Backup Copy of your item.
  
   Your MD Product of choice will be called the 'collar' from here forward.
  
   I will refer to the item as 'collar' from here on out, but remember it can be installed into any MD product.

To install:
   1.  UNLOCK and REMOVE your collar.
   2.  REZ your collar in-world and EDIT it
   3.  ADD the 'plg.c.rlvfolders.v1.0' script to the collar by dragging the script from your inventory onto the collar.
   4.  TAKE back and WEAR your collar.
   5.  You are done!

HOW TO USE
----------
Those familiar with OpenCollar chat commands should find this quite familiar.  I've also added extensions into the interface for more outfit flexibility from chat commands.

By default, the plugin will listen on channel 8, and the public channel 0.  These can both be changed in the plugin's menu.

By default the prefix will be your first and last initials.  For example, if your Username is 'chetar.ruby', your prefix will be 'cr'.  Please be aware Display Names are never used for determining the default prefix.  If you are a newer resident with no last name, your last name is 'Resident', so for example if your username is 'chetar', your prefix would again be 'cr', because your last name is automatically 'Resident.'  Prefix can be changed in the plugin menu.

Below is the commands, I will list them using my prefix of 'cr', be sure to change 'cr' to your own prefix!

Commands
--------
cr-folder    This will remove the named folder from your avatar.
cr+folder    This will add the named folder to your avatar.
cr--folder    This will remove the named folder, and all its subfolders.
cr++folder    This will REPLACE your current outfit with the named folder and its subfolders.

The collar wearer is always permitted to issue chat commands.  Use RLV restrictions to prohibit changing of attachments and/or clothes to stop wearer from changing outfits with chat commands.

The plugin will also accept chat commands from the current key holder.

RLV FOLDERS
-----------
This plugin (like OpenCollar) relies on you having your RLV folders properly configured.  If you don't understand RLV Folders, or have it configured for yourself, I recommend finding someone who can assist you!

Questions?  Comments?  Suggestions?  Feel free to IM me.

(C) 2012 Chetar Ruby of Second Life