MH+ presents: RLVC v0.22 ============================================= MH+ RestrainedLife Viewer Controller ============================================= Requirements: RLV client 1.12.x or above for general use. 1.13.x or above for subfolder support. The MH+ RLVC (restrained life viewer controller) is a single prim wearable controller designed for subs and thier owners to easily restrain them in Second Life. Designed speficially as single point full range controller, the MH+ RLVC provides virtually all* RLV functions, with a single button push. Features include easy to navigate menus and clearly presented commands for the novice user to expert. Functions are grouped together so finding the right command is simple and intuitive. Features include: - Keep Sit feature to resit your sub when they log in/out for enforced punishment.* - Keep ENV feature, after login keeps currently environment again. - Status displays on each menu, so you know what is set at a glance. - Owner registration. - Protected mode or Everyone access mode. - Selectable communication channel for security. - Single prim owner HUD button provided on demand. - SIM wide range. - Inventory Subfolder support for rlv1.13 and above. - Sub Call button for owners. =========================== Contents: 1. Quick Start 2. Menu Function List 3. Supported function list. 4. Disclaimer/warnings. =========================== ++++++++++ Quick Start ++++++++++ - Unpack the box to your inventory - Attach the controller to your right eye (default placement). - You can attach the controller to any body part, if so, please rename the location. ***** If you want to attach the RLVC to a different location, rename it from inventory, do not drop it on the ground**** - The controller will tell you it is equipped and active on channel /3125 (default). * It is recommended that you set a new channel ( see below). - As wearer with no owners registered, you can access all of the menu fucntions. - Type "/3125 menu" in open chat without the quotes to access the menu. - The sub can also wear the included single button HUD for one-touch menu access. (see below) ** To set a new channel, type /3125 menu, then select OPTION, then Channel. - you will be prompted with the current channel and to say the new channel number. - To set a new channel, say "/3125 12345", with any channel you or your owner prefer. - Only the wearer can set the channel number, you must notify your owner(s) when a channel is changed. - Edit the Channel_List in any hud buttons with the new channel number. (see below) - Add a owner once you have changed the channel from the default. - OPTIONS - Add Owner - Select thier name from those people within 8m. - The owner will receive a IM telling them they have access, and on what channel. - Get a sub HUD button - Type /3125 menu (the channel number you've set) - Click on OPTIONS - give HUD - You will receive a sub HUD (single button) - Equip the HUD, the default is center, you can attach it anywhere on your hud you like. * if the button looks odd when placed in a different location, edit it and check the X rotation value. This should be 90 degrees. - Right click and edit the button. Go to the content tab and edit the Channel_List notecard and add the sub's name and channel, ex: sub,23456. - The name of the sub can be anything such as a petname, but is limited to 12 displayed characters due to button size. - INVENTORY SUBFOLDER Support - To enable subfolder support for inventory items (This expands the capacity of shared foldes) you must set a subfolder prefix. - The subfolder prefix is the character that will preceede a folder name indicating that it is a catagory, not a item folder. - The subfolder prefix can be any character except a period "." or a forward slash "/". - Bring up the RLVC menu and click OPTION - PreFix. You will be promted to type in the character for the prefix - Type in open chat the following: /3125 prefix > , which is /channenumber, prefix , then whatever character you choose, and hit enter. - You can easily check the prefix by bringing up the menu and clicking OPTIONS, the inventory sub folder prefix will be listed. - You can now make >cuffs, >binders, >latex, >shoes, >hair or any other sub folder and place the appropriate items within. - Take care that Inventory folders that have the same special prefix character are not copied directly into the #RLV folder. ------------------- - NEW OWNERS - Type /channel# menu to access the sub's controller - click on OPTIONS - give HUD - A registered owner will recieve a Owner's HUD. - Equip the HUD, the default is center, you can attach it anywhere on your hud you like. * if the button looks odd when placed in a different location, edit it and check the X rotation value. This should be 90 degrees. - Right click and edit the button. Go to the content tab and edit the Channel_List notecard and add the sub's name and channel, ex: sub,23456. - The name of the sub can be anything such as a petname, but is limited to 12 displayed characters due to button size. - Save the changes and you can click the red button and choose the sub to control without using chat commands each time. - CALL SUB - Click on the blue button then choose the sub to call to your location (you must be in the same sim). ------------------- - SETTING FORCE TP LOCATIONS - You must edit the notecard "LocationCard" in the sub's RLVC attachment. - You can have the sub give you a copy of the notecard so that you can prepair locations easier, and make copies with different locations for multiple subs. - Open the notecard and add up to twelve locations with the following format: BUTTON_NAME/REGION_NAME/X/Y/Z - Button name is the name as it will appear on the menu, such as "Prision", "House", "Bath", button names are limited to 12 displayed characters. - Region Name is the name of the region or sim of the location, and must be exact. You can easily type in the name as it appears in the top of the viewer. - X/Y/Z are the coordinates as they appear after the region name at the top of the viewer, use a / to seperate them, not a comma. - Save the changes to the notecard and the sub can be sent anywhere in the grid via the controller. You must be in the same region to access thier controller. ------------------- +++++++++++++++ MENU FUNCTIONS +++++++++++++++ INVENTORY ------------- - This menu accesses the shared folders and provides a list of total folders, and total characters used for descriptions. - Subfolders are enabled or not enabled is shown on the inventory status menu. To enable subfolder support , see the quick start instructions. - When adding or removing items from shared folders you can browse forward or back from page 1 for fast access to the last pages. - Attach/Detach allows you to browse the folders and subfolders. If you go into a subfolder, the Back button will move you back up the folder heirarchy. - If items are several folders deep inside the inventory folders, it can be easier to use the DETATCH or OUTFIT buttons to remove clothing or worn attachments. STATUS ------------- - Lists current restrictions OPTION ------------- ==== wearer specifc functions ==== - PreFix - this function sets the folder name prefix and enables subfolder viewing when a prefix is set. This is blank by default and subfolder support is 'off' until a prefix is set. - Add Owner - Click the button to add a registered owner within 8m. - Rem Owner - click the button and choose the name of the registered owner to remove. +++++ Owner and general functions++++++ - give HUD - Gives a single prim hud button to the sub. A registered owner will recieve a two button HUD. The 2 button Owner HUD has a blue "Call" button so they can easily call a sub to thier location within the same SIM. - Protect/Everyone - toggles between owner access and public access for the controller. - lock MENU - bars wearer access to menu functions except the channel selection, owner selection and CLEAR. - RLV CLEAR - Clears all restrictions and sends a IM to the owner. - Readme - gives a copy of this document. MISC ------ - Allow/Deny miscellanious restrictions not directly grouped in specific menus, such as fly, rez, show inventory, map access. - CLEAR - clears MISC restrictions. OUTFIT ------- - Allow/Deny wearing or removing clothing - Lists worn clothes. If a piece of clothing is not worn, it will show as a blank button. Click the appropriate button to remove a item of clothing. DETACH -------- - Lists the currently attached body prim items and HUD attachements. - Click the appropriate button to detach the item desired. - The limitation of detach can be given individually in each part.(reqiure RLV1.20 or higher) - Menu can go forward or back from page 1 for faster access. CHAT/IM --------- - Allow or Deny chat and im functions. - CLEAR - clears CHAT/IM restrictions. - redirchat : Redirect public chat to private channels - sendchannel : Allow/Deny using any chat channels TP/LM -------- - Allow or Deny TP options. tplm is teleport via a landmark, tploc is teleport via map specification, tplure is teleport offers from friends. * Registered owners will be able to tp the sub even though teleport offers are restricted. - CLEAR - clears TP/LM restrictions. - Add_accTP / Rem_accTP * add(remove) to me for auto-accept teleport offers from a particular avatar. - Teleport - This is the force teleport function and will list locations you have added to the 'LocationCard' notecard in the RLVC eye attachment. * TPLOC must be enabled for Forced Teleport to function. * To Prevent the sub from cheating using a map teleport, simply deny use of the Show World Map under MISC menu. * You must be in the same region as the sub to force teleport them, but can send them grid wide. - GoTo - This is the force teleport function, from chatlines locations with the following format: REGION_NAME/X/Y/Z SIT/MOVE ------- - Target - scans objects within 10m and presents them as a forced sit target. Select the appropriate object from the list. - Keep SIT - forces the sub to resit on a device when they log back in. * KeepSIT is cancelled when the sub is forced, or allowed to stand. * KeepSIT requires that the device the sub was sitting on when they log out is not used by another avatar, or the sub will not be forced back onto the device. * For best results in high lag conditions, restrict unsit prior to keep sit. - CLEAR - clears sit restrictions. - Allow or Deny sittp or unsit. - Stand - forces the sub to stand from what they are sitting on. * If the sub is 'keep sit' and stand is used, unsit=n will be enabled. * A sub must be careful where they sit after being 'keep sit' and forced to stand. * If a sub will be allowed to sit and stand at will, please use the CLEAR button on the sit menu, or allow unsit via the allow button. - Move/Rot - force move to avator position, or direction * Push to X / Y Button, moves in that direction by 1m. * Push to DEG+ / DEG- Button, rotates in that direction (about 15degrees). ENV ------- - Allow or Deny setenv functions. - dafault - force set environment to daytime "region dafault" - sunrise - force set environment to daytime "sunrise" - noon - force set environment to daytime "noon" - sunset - force set environment to daytime "sunset" - midnight- force set environment to daytime "midnight" - Keep ENV - after login keeps currently environment again. ** currently support to daytime set only SECURE --------- - Allow or Deny secure functions. - CLEAR - clears secure restrictions. !!!Please refer to WIKI of RLV API for the effect of each function.!!! The command name dares not to have been changed in MH+RLVC. Therefore, it can know details by the same command name. http://wiki.secondlife.com/wiki/LSL_Protocol/RestrainedLifeAPI +++++++++++++++++++++++++++ List of Supported Functions +++++++++++++++++++++++++++ *** The following RLV functions are supported. * Note that for Forced Sit, the detection range is 10m. * Sub Folders are not currently supported. If your sub has many folders, subfolders use memory for organization. * Force teleport must have locations set in the notecard per the above instructions. [X]:support [_]:non support [X]* Allow/prevent receiving chat messages [X]* Allow/prevent sending chat messages [X]* Allow/prevent receiving instant messages [X]* Allow/prevent sending instant messages [X]* Allow/prevent using any chat channel but certain channels (*5) [_]* Remove/add exceptions to the chat message receiving prevention (*5) [_]* Remove/add exceptions to the instant message sending prevention (*5) [X]* Allow/prevent teleporting to a landmark [X]* Allow/prevent teleporting to a location [X]* Allow/prevent teleporting by a friend [X]* Force-Teleport the user (*4) [_]* Remove/add exceptions to the friend teleport prevention (*5) [X]* Allow/prevent standing up [X]* Force sit on an object (*1) [X]* Unlimit/limit sit-tp [X]* Force unsit [X]* Force removing clothes [X]* Allow/prevent wearing clothes (*2) [X]* Allow/prevent removing clothes (*2) [X]* Get the list of worn clothes [X]* Automated version checking [X]* Clear a subset of the rules tied to an object [X]* Clear all the rules tied to an object [X]* Allow/prevent editing objects [X]* Allow/prevent knowing the current location [X]* Allow/prevent reading notecards [X]* Render an object detachable/nondetachable [X]* Get the list of restrictions the avatar is currently submitted to [X]* Allow/prevent rezzing inventory [X]* Allow/prevent touching objects located further than 1.5 meters away from the avatar [X]* Allow/prevent using inventory [X]* Allow/prevent viewing the mini map [X]* Allow/prevent viewing the world map [X]* Allow/prevent seeing the names of the people around [_]* Remove/add an exception to the emote truncation above [X]* Force removing attachments [X]* Force attach items contained inside a shared folder [X]* Force detach items contained inside a shared folder [X]* Get the list of worn attachments [X]* Get the list of shared folders in the avatar's inventory [_]* Get the path to a shared folder by giving a search criterion [X]* Get the list of all the restrictions the avatar is currently submitted to [X]* Remove/add auto-accept teleport offers from a particular avatar [_]* Get the list of shared folders in the avatar's inventory, with information about worn items [_]* Force attach items contained inside a shared folder, and its children recursively [_]* Force detach items contained inside a shared folder, and its children recursively [X]* Allow/prevent shouting [X]* Allow/prevent chatting at normal volume [X]* Allow/prevent whispering [X]* Allow/prevent changing the environment settings [X]* Get the value of an environment setting (*6) [X]* Force change an environment setting (*6) [X]* Redirect public chat to private channels [X]* Force the viewer to automatically accept attach and take control permission requests [_]* Allow/prevent accepting attach and take control permissions [_]* Get the path to the shared folder containing a particular object/clothing [_]* Force attach items contained into a shared folder that contains a particular object/clothing [_]* Force attach items contained into a shared folder that contains a particular object/clothing, and its children folders [_]* Force detach items contained into a shared folder that contains a particular object/clothing [_]* Force detach items contained into a shared folder that contains a particular object/clothing, and its children folders [_]* Force detach an item (object self detach) [_]* Allow/prevent changing some debug settings [_]* Force change a debug setting [_]* Get the value of a debug setting [X]* Force rotate the avatar to a set direction [X]* Allow/prevent seeing all the hovertexts (*7) [_]* Allow/prevent seeing one hovertext in particular (*7) [X]* Allow/prevent seeing the hovertexts on the HUD of the user [X]* Allow/prevent seeing the hovertexts in-world [_]* Redirect public emotes to private channels [_]* Allow/prevent seeing emotes [_]* Remove/add exceptions to the emote seeing prevention [X]* Allow/prevent attaching/detaching per attachment point [_]* Start/stop notifications on a private channel [X]* Allow/prevent teleporting by a friend, secure way [X]* Allow/prevent seeing emotes, secure way [X]* Allow/prevent receiving chat messages, secure way [X]* Allow/prevent receiving instant messages, secure way [X]* Allow/prevent sending instant messages, secure way [X]* Allow/deny permissive exceptions [X]* Allow/deny the 'Wear' contextual menu [X]* Automated version number checking [X]* Allow/prevent opening textures [X]* Allow/prevent opening scripts [X]* Unlock/Lock an attachment point full [X]* Unlock/Lock an attachment point empty --------------------------------------------------------------------------- (*1):range of detection to object is 10m. (*2):always all part only.(case of MH+RLVC lower than v0.22) (*4):location is described in notecard. (*5):always, Owners automated add to exceptions (*6):currently support "daytime" windlight set only (*7):currently hovertext is not used in MH+RLVC. ++++++++++++++++++ DISCLAIMER/WARNING ++++++++++++++++++ - The MH+ RLVC has been throroughly tested and designed as a low lag, high performance tool. However problems with the Secondlife Grid (lag) or issues with the RLV code are beyond the control of what is possible to overcome. When there is high lag, some functions may not work correctly. - Asset server performance can affect listing of inventory folders. - KeepSit can be affected by an extremely slow login process. - As stated in the RLV release notes, UNSIT is not 100% reliable, it may take a few attempts to unseat an avatar. - With serveral levels of subfolder such as >shoes>pumps>black>platforms lag can cause the menu to stick. Cancel the menu and rebrowse the inventory. For inquiries in Japanese, please send a notecard to Mayumi Hirano. For questions in English, please send a notecard to Misao Nakamura. 日本語でのお問い合わせについては、真由美平野にnotecard送信してください。英語での質問には、中村操にnotecard送信してください。 (c)2008,2009 MH+