[.Shuggles.] Shuicraft Miner Advanced FULL PERM Version 0.57

The Shuicraft Miner script can be used in a roleplay environment, e.g. to let avatars do
mining operations, clearing a path of blocking rocks and getting minerals or hints from
the object for crafting or further story development. It rezzes the mined item and gives
it to the avatar that mined it before removing the rezzed copy of the item.

The script can be put in a rock to let an avatar sit on it or into a pickaxe that must be
attached to start mining, together with the minerals. 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 pickaxe. After all items are given and optionally removed from the mine,
it unseats the avatar and destroys itself, the pickaxe just detaches.

You can use a custom sit/mining animation and sounds, 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 own the Shuicraft Crafter scripts,
you can use the minerals as ingredients for new products.

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 it
harder to receive rare items and forces the avatar to seek out other mines or try again
later. 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 works well in a fantasy
environment or 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:

- rezzing offset and rotation of mined item, rezzing can be disabled
- sit target and sit rotation, disable if used with another sitter script
- give mined item after completion or only on touch of the rezzed item
- whether only the operator can pick up the mined item or everyone
- attachment point for attach on touch after rezzing
- uses temporary attachments, so that it works for everyone
- access level all, group or owner, also works for deeded objects
- deliver items from object's inventory or separate server
- time after which a rezzed item is auto-deleted if it is not picked up
- 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
- option to ignore numbers of mined items, e.g. treat "Gold 1" as "Gold"
- whether object should pretend to speak as the seated avatar or talk as itself
- say modes: region say/IM, whisper, say, shout or disable
- item type to give: objects, notecards, textures, all etc. (no scripts)
- exclude list for items that shall not be given
- whether (copyable) items should be removed from inventory after being given
- item to give on sit, e.g. a mining tool, optionally require it to be attached
- configurable tool creator for that tool or disable tool check
- 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, forbidden to sit, when someone else wants to pick up
the rezzed item and when auto-deleting mined items that were not taken
- finding chances of items (100% if not specified)
- secret code word or passphrase that must be said before using the mine

The Advanced bundle contains the Shuicraft Server script that's required to deliver items
from a server. You can also buy it separately.

Please take the time to update all your items and miners with the new scripts because old
communication messages are obsolete, so they will stop working after a few more versions.

This package already contains the new Updater for when the Miner will be renamed to
Shuicraft Miner. For now, please still use the Miner Updater, but keep the new one for
the future.

The Shuicraft Miner scripts are full perm. They're licensed under the BSD license with
the addition that they must not be resold or otherwise given away standalone in parts or
as whole. They can be used in your creations as long as these license conditions are met.
Please use the original scripts, keeping script name and creator intact, and remember to
change script permissions to copy or transfer only before you put your products on sale.

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.

See item in Second Life