[.Shuggles.] Miner Version 0.57

The Miner script can be used in an roleplay environment, e.g. to let avatars do some
mining operations, by that clearing a path of blocking rocks and getting minerals or
hints for further story development from the object.

The script is intended to be put in e.g. a rock to let an avatar sit on it or into e.g.
an axe that must be attached to start mining. The minerals must be placed in the same
object the script is in. The script scans the inventory of the prim and after a random
time it gives one of its items randomly or depending on finding chance to the seated
avatar or the one who has attached the axe. After all items are given and then removed
from the prim's inventory (which is optional), the mine unseats the avatar and destroys
itself, the axe just detaches.

You can use a custom sit/mining animation, have sounds played during mining, on giving
an item and on finishing mining, configure texts, the sit target and time interval after
which an item is given and the chance any item can be found. It can also be used together
with a sitter script. If you also possess the Product Maker scripts, you could use the
minerals as ingredients for new products you make.

A maximum number of tries can be configured after which the mining avatar is kicked off
and the mine can be temporarily disabled for a configurable time interval. This makes the
chance of receiving rare items more difficult and forces the avatar to seek out other
mines or try again later. After the time passes, the mine becomes available for use to
whoever gets to it first.

Optionally, a secret code word or passphrase can be setup that must be provided on a
specified or random channel before the mine can be used. This would work well in a
fantasy environment or e.g. for bank safes.

Many parameters can be configured in a config notecard; a description and an example are
included. All parameters can be set in the script as well. Detailed configuration options:

- sit target and sit rotation, can be disabled if used with another sitter script
- access level all, group or owner, also works for deeded objects
- minimum and maximum time of giving interval
- maximum number of tries before disabling the mine
- minimum and maximum time of interval the mine is disabled
- whether disabled mines should be hidden (invisible, phantom, no sit target)
- whether object should pretend to speak as the seated avatar or talk as itself
- say mode to select between region say/IM, whisper, say and shout or to disable messages
- item type that should be given: objects, notecards, textures, all etc. (no scripts)
- exclude list for items that shall not be given
- whether (copiable) items should be removed from inventory after they are given
- optionally ignore trailing numbers in item names when checking chances
- item to give automatically on sit, e.g. a mining tool, optionally require it to be attached
- text to display on right-click menu instead of "Sit"
- mining animation to use, otherwise uses first found anim, or standard anim if none
- configurable sounds that are played during mining, on giving an item and on finishing
- spoken texts on sit, unsit, getting an item, getting empty/destroyed/disabled, entering
the passphrase, needing a tool and forbidden to sit
- finding chances of the items (100% if not specified)
- secret code word or passphrase that must be said before using the mine

The Miner script is full perm. It's licensed under the BSD license with the addition that
it must not be resold or otherwise given away standalone in parts or as whole. It can be
used in your creations as long as these license conditions are met. Please remember to
remove modify and either copy or transfer permissions on the script before you put your
products on sale.

Feel free to report bugs, request features, give feedback or write a nice MP review ^^
To update or redeliver a product, wear the included Updater and follow the instructions.
Store policies and info about custom scripting at my MP store and the inworld terminals.

Changelog:

- v0.54 ... Section names case-insensitive, fixed checking for them,
don't use EXCLUDE_ITEMS and FIND_CHANCES with notecard,
read whole notecard before starting, stop more reliably,
optionally limit number of tries, optionally require passphrase
- v0.55 ... Use vector for sit rotation, optionally check attached tool first,
only check substring, extra message for tool to attach