[SA] Locksync Plugin for Mesmerize Dungeon Products

==================================================
                   ❍❍❍❍ ●●●  [SA] Shades of Passion ●●● ❍❍❍❍
==================================================
❍❍❍❍ ●●● Locksync Plugin for Mesmerize Dungeon Products ●●● ❍❍❍❍
==================================================
                            ❍❍❍❍ ●●● [Version 1.0] ●●● ❍❍❍❍
==================================================

Introduction
---------------
This plugin is called Locksync.  It will attempt to synchronize locking and unlocking of multiple MD products worn at the same time.  For example, if you are wearing a full MD cuffs set, it's three separate locks.  The handcuffs, legcuffs and collar.  With this locksync plugin installed into all three, locking any one of the devices will lock them all.  Unlocking any of the devices will unlock them all.  It is compatible with all MD products, both v3 and v4.  It is compatible with any mixture of versions (ie it will attempt to locksync both v3 and v4 if both are being worn and this plugin is installed in them all.)

Installation
--------------
Installation is fairly easy.  You will need to be capable of rezzing objects in world, editing them, and adding inventory to prim contents.  If you're unfamiliar with these concepts, please ask a friend for assistance.  Shady Accessories can also be of assistance, depending on how busy we are.

For leg and hand cuffs, you will want to rez and edit the 'engine' component of the product.  For other products, like boots and mitts, typically the right hand/right leg object is the one with the MD scripts in it, which you will need to rez and edit.  For a MD collar, the collar itself is what you will need to rez and edit.

If you're unsure, look through the various attachments included with your MD product.  The one with several scripts and animations is the one you'll want to be rezzing and editing.  If you're unsure which one to edit, don't hesitate to ask Shady Accessories or Mesmerize Dungeon groups for assistance.

Once you've located and rezzed the correct object, installation is easy.  Just place a copy of the plg.a.locksync.v1.0 into you product.  Reset the scripts in your product, then take it back into your inventory.

Usage
-------
The locksync menu is accessable from the plugin's menu of your MD product.  From this menu you can toggle 'send' and 'receive' locksync information to/from other products.

When 'send' is enabled, when the item is locked or unlocked, it will 'send' that to any other MD products that are set to receive.  If sending is not enabled, the item will not send.

When 'receive' is enabled, whenever any sending object is locked/unlocked, the item will try to stay synchronized with the sender.  If receive is disabled, it will not.

Think of it like a two-way radio.  Sending allows a product to tell other product to lock or unlock.  Receiving tells a product to listen for other senders to tell it to lock and unlock.

An example:  With a full set of MD cuffs: handcuffs, legcuffs and collar.  If handcuffs and legcuffs are both set to send+receive and the collar is set to only send, the following actions would result in different behavior.  Keep in mind the settings in this example with these scenarios.

Someone touches the collar and locks it.  The handcuffs and legcuffs will also become locked.

With all items locked, the handcuffs are unlocked.  Since the collar is set not to receive, it remains locked, but the legcuffs unlock.

Compatibility and Security
------------------------------
This plugin is compatible with ALL MD products, both version 3 and version 4.  The lock synchronization information is compatible across versions as well.  For example, if you are wearing a set of v4 MD handcuffs and legcuffs, and v3 Pony Boots, and all these products have this plugin, locksync will be able to synchronize locking and unlocking on all the products.

You cannot use this product to 'cheat', when lock synchronization commands are exchanged between objects, the key holder from the sending object is checked against the key holder of every locked item.  Any mismatched keyholders are not unlocked.  So you cannot use this to unlock items which you are not the keyholder of.

Please be aware, Locksync plugin uses the RLV detection phase of all MD products to identify which version the product is.  If you log in without an RLV enabled viewer, Locksync may fail to detect the version of your product correctly and not work.  This is unsupported usage of this plugin, please be sure to have the RLV features of your viewer enabled at all times while using this plugin.

==================================================
==================================================
Copyright © 2012 Shady Accessories.
All rights to Artwork and Designs from Shady Accessories are Copyright © and belongs to Shaden Sura.
All Script work Belongs and is Copyright © to Chetar Ruby
==================================================
Need help or have a Suggestion contact: Shaden Sura or Chetar Ruby
==================================================