Mcast-WorldBehavior MINE HERE

Small Paper plugin by mcast for mining worlds, player profiles, and controlled
bonus resources.

What It Does
------------
MINE HERE gives mining a light progression layer without multiplying every
block. Each group has its own Haste level and three independent reward chances.

Bonuses
-------
- The bonus drop copies a natural drop listed in `bonus-drop-materials`.
- The building bonus adds one item matching a natural drop listed in
  `building-drop-materials`.
- The extra-material reward adds one random item from the group's
  `extra-materials` pool.

All mechanisms respect the tool's real drops. Silk Touch replaces only the
regular bonus-drop chance; the building reward uses the resulting Silk Touch
drop. Cancelled events, Creative, Spectator, containers, and blocked materials
do not trigger rewards.

Default Profiles
----------------
Profile          Haste  Bonus  Silk  Building  Extra
default         I       8%     0%       12%       1%
miner           II     16%     4%       20%       2%
master-miner    II     24%     8%       24%       4%
hephaistos      III    32%    24%       28%       8%

Numeric settings are not inherited. `miner` and `master-miner` have separate
extra-material pools. `hephaistos` inherits the `master-miner` pool and adds
`NETHERITE_SCRAP` and `ECHO_SHARD`.

Main Features
-------------
- Three independent bonus mechanisms.
- Global allowlists for valuable and building drops.
- Per-group Haste, chances, and extra materials.
- Fortune and Silk Touch through Minecraft's natural drops.
- Sound, particles, and action-bar feedback for actual rewards.
- UUID and last known player name stored in `miners.yml`.

Commands
--------
/minehere group set <uuid|online-player> <miner|master-miner|hephaistos>
/minehere group remove <uuid|online-player>
/minehere group list [miner|master-miner|hephaistos]

Commands can be used by the console, OPs, and players in `hephaistos`.

Upgrading To 1.2.0
------------------
Legacy UUID group keys in `miners.yml` are migrated to `miner` and
`master-miner` on first start. The file is also rewritten to store UUID and
player name. Legacy names are not command aliases.

When upgrading, replace or merge the existing `config.yml` with the new version
to add `building-drop-materials`, building chances, and the renamed groups.

Technical Info
--------------
- Version 1.2.0
- Paper 1.21.11
- Minecraft 1.21.x
- Server-side plugin

Author
------
mcast
Website: https://www.mc-amethyst.com
