MiningEvents
MiningEvents makes mining dynamic and exciting by triggering random events while you mine — some rewarding, some dangerous. Built for Paper servers, fully configurable, and designed with a lightweight listener so it won't impact server performance.
✨ Features
- 9 unique mining events, each individually toggleable and configurable
- 5-tier rarity system: Common → Uncommon → Rare → Epic → Legendary
- Mining Combo system: mine consecutively without stopping to boost fortune, XP, and event chance
- Persistent player stats: blocks mined, events found, rare events, best combo, total mining time
- Fully configurable probabilities and rewards — no reload/restart needed after changes
- Extremely lightweight block-break listener (no heavy scans on every block)
⛏️ Events
| Event | Type | Default Rarity | Effect |
|---|---|---|---|
| Ancient Vein | Positive | Rare | Grants a small cluster of bonus ore |
| Treasure | Positive | Uncommon | Grants a configurable set of items |
| Rare Ore | Positive | Uncommon | Grants an extra rare ore drop |
| Mining Rush | Positive | Rare | Temporary Haste (and optional Speed) buff |
| Lucky Block | Positive | Common | Random reward: XP or money |
| Gem Vein | Positive | Legendary | Grants a valuable gem from a configurable list |
| Cave Collapse | Negative | Uncommon | Damage + temporary Slowness |
| Monster Ambush | Negative | Rare | Spawns hostile mobs that target the player |
| Meteorite | Negative | Epic | Controlled explosion + damage |
🔥 Mining Combo
Mining blocks back-to-back builds a combo. The combo decays after a configurable idle period and boosts:
- Fortune
- XP
- Event trigger chance
📊 Statistics
Tracked per player and saved persistently:
- Blocks mined
- Events triggered
- Rare events triggered (Rare/Epic/Legendary)
- Best combo reached
- Total mining time
🖥️ Commands
| Command | Description |
|---|---|
/miningstats [player] |
View mining statistics |
/miningevents |
List all configured events and their settings |
/miningevents reload |
Reload the configuration without restarting |
⚙️ Configuration
Every event can be enabled/disabled, and its rarity, probability, and reward parameters fully customized in config.yml — no need to touch the code. Changes apply instantly with /miningevents reload.
📋 Requirements
- Paper 1.20.x
- Java 17+
No gallery available for this project.