User:Allen Kerensky/Myriad Lite/Lite Module BAM

= Myriad Lite Module BAM =

Module BAM Concepts
The Myriad Lite Module BAM script goes into the Myriad Lite HUD.

Thanks to a mighty contribution from Baroun Tardis, Myriad Lite also includes Baroun Tardis' Adventure Machine (BAM) v1.

Sim owners can create objects using BAM allowing you to find and participate in scavenger hunt-style "quests", "adventures", or "crusades" in their regions.

To go on a quest, you find an Non-Player Character (NPC) in the sim who will give you the quest, and the first task to complete, along with a hint. Complete each task in the quest, possibly earning prizes or necessary support equipment along the way. Once you have completed the quest tasks, return to the NPC to complete the quest itself, and possibly earn a prize.

You should get the first 'task' for the adventure, which will show what your goal and a hint on how to obtain it.

If you should lose track of what you're doing, touch the HUD on your screen, and it will give you a quick update on the status of your adventure.

If you remove your HUD, it will reset and clear the current adventure.

This will cause you to lose all goals you have achieved, and reset you to "no adventure in progress"

Adventures are like a scavenger hunt: You go after certain goals, and when you get all of them, you win the main prize at the end.

Say /5 quest or click the HUD attachment will show you your current quest status.

Quest Goals
There are four basic types of goals in the BAM system: 1) Adventure Giver : if you're reading this, you've already found one.... These start adventures, and can also be the end point of one. Usually, some small prize is given out when you complete the adventure. These have a text floating over their head, indicating their name, such as "Baker" or "Clerk"

2) Collision Goal: These occupy an area, and when you run into it or step on it while looking for that area, it lets you know you've reached it, and gives you a clue for the next step in the adventure. These have no floating text, since that would be too much of a give away that this is the spot (grin)

3) Location Goal: These scan an area, and when you enter it while looking for that area, let you know you've reached it, and give you a clue for the next step in the adventure. These have no floating text, since that would be too much of a give away that this is the spot (grin)

4) Touch Goal : These sit still, waiting, until you touch them. If they're not the current goal for you in the adventure, then nothing happens. If they _are_ your current goal, then the victory music plays and you get clue/hint for the next step. These have a text floating over them, indicating their name.

If you have problems with an adventure, please contact the region owner of the region where you found the quest.

Module BAM Setup
See the Myriad Lite HUD instructions for setup.

Quickstart for Players

 * 1) (required) Copy scripts and instructions from this notecard into inventory
 * 2) (required) Drop the scripts into appropriate objects as described in the script's instructions.
 * 3) (required) Wear the HUD.
 * 4) (optional) Wear the hovertext meter
 * 5) (optional) Wear armor, which you should see reported in your chat window.
 * 6) (optional) Wear a holster
 * 7) (optional) Wear a melee or ranged combat weapon

When Module Lite BAM starts, you will see "Looking for Adventure..." in hovertext over your HUD object, to indicate you are not yet in a Quest.

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

You can send commands to Myriad Lite on chat channel 5.
 * /5 quest - see your current status in your current quest

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 Module BAM, 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 Module BAM 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 Module BAM // Copyright (c) 2012 by Baroun Tardis (OSG/SL) and 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/ //============================================================================