User:Allen Kerensky/Myriad Lite/Holster

= Myriad Lite Holster =

Holster Concepts
A holstered or sheathed weapon is a visual indicator that your character is armed and ready for combat.

The holster works by turning invisible on a "draw" command, and turning visible again when the weapon is holstered or sheathed.

Players can draw weapons from a holster or sheathe to begin combat, or sheathe/holster weapons to withdraw from combat.

Setting Up Myriad Lite Holster

 * 1) Create an object to act as a wearable holster for a firearm or a sheathe for a melee weapon.
 * 2) Drag and Drop the Myriad Lite Holster script from inventory into the holster object
 * 3) Attach the object to the desired attachment point.
 * 4) Adjust the position and rotation.
 * 5) Detach the object back to inventory to "save" the new default attach point.
 * 6) Attach or wear the holster when desired.

Quickstart for Players

 * (required) Wear the Myriad Lite HUD.
 * (optional) Wear the hovertext meter
 * (optional) Wear armor, which you should see reported in your chat window.
 * (optional) Wear a holster
 * (optional) Wear a melee or ranged combat weapon

Commands
Myriad Lite accepts a variety of chat commands on channel 5.

/5 will activate that command.

Scripters can also send the same commands as a link message.

Custom HUDs can be constructed with buttons named each command, and the button will activate the command of the same name

Close Combat: Melee Weapons
For melee weapon (knife, sword, club, etc)

Wear the melee weapon, which disables fist fighter mode if active

NOTE: The melee weapon is invisible when first attached, as if it is "sheathed".

Say /5 drawright or /5 drawleft in main chat to draw the weapon.

In mouselook or third person view, press left mouse button to trigger the weapon's attack.

Ranged Combat: Firearms
Wear a firearm with a Myriad bullet in it.

NOTE: The melee weapon is invisible when first attached, as if it is "sheathed".

Say /5 drawright or /5 drawleft in main chat to draw the weapon.

Go into mouselook for first person view

Aim.

Press left mouse button to fire.

Ranged combat does not work in third-person view.

/5 checkammo will show ammo count remaining.

/5 reload will reload ammo

Holstering a weapon
 * /5 holsterright
 * /5 holsterleft
 * /5 holsterboth

The Myriad RPG Group
Join the Myriad RPG group for announcements and discussion around the Myriad RPG and Myriad Lite scripts.

SecondLife: secondlife:///app/group/dbedc3be-729e-a123-d669-92f401e07a1e/about

OSgrid: secondlife:///app/group/da0227e5-8a0d-4d99-b970-9411932c852d/about

Feature Requests
If you have a feature you would like to see added to Myriad Lite Holster, write a new feature request on the talk page for this article.

The best feature requests will have: Your SL name The name, version, and date of the script you are requesting new features in A description of the feature A sample implementation of the feature in LSL compatible with OSG and SL.

Bug Reports
If you find a bug or something that just doesn't seem right in how the Myriad Lite Holster script works, file a bug report on the talk page for this article.

The best bug reports will have: Your OSG or SL name The name, version, and date of the script you are having problems with A description of the problem itself Steps to follow to reproduce the problem

Contributing to Myriad Lite
If you would like to contribute to the Myriad Lite project, please do!

The best contributions will have: Your SL Name A description of the contribution The patch, script, file, or object being contributed A release stating: * that you intend to contribute this to Myriad Lite * that you are the original creator of the contribution or are legally empowered to contribute it * that you acknowledge this contribution can be released under the Creative Commons BY 3.0 Unported and Modified BSD (3-clause) licenses

//============================================================================ // Myriad Lite Holster // Copyright (c) 2012 by Allen Kerensky (OSG/SL) All Rights Reserved. // This work is dual-licensed under // Creative Commons Attribution (CC BY) 3.0 Unported // http://creativecommons.org/licenses/by/3.0/ // - or - // Modified BSD License (3-clause) // Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions are met: // * Redistributions of source code must retain the above copyright notice, //  this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above copyright notice, //  this list of conditions and the following disclaimer in the documentation //  and/or other materials provided with the distribution. // * Neither the name of Myriad Lite nor the names of its contributors may be //  used to endorse or promote products derived from this software without //  specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY EXPRESS OR // IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES // OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN // NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, // INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT // NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF // THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // // The Myriad RPG System was designed, written, and illustrated by Ashok Desai // Myriad RPG System licensed under: // Creative Commons Attribution (CC BY) 2.0 UK: England and Wales // http://creativecommons.org/licenses/by/2.0/uk/ //============================================================================