MiningEvents
Makes mining dynamic with 9 random events (positive and negative), rarity tiers, a Mining Combo system, and persistent stats.
⬇ Download on ModrinthMiningEvents
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+
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.20, 1.20.1, 1.20.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
- Ships as MiningEvents-1.0.0.jar — drop this file into the mods folder
- Download size: 49 KB
- Download link checked 14 Sept 2026 — working
These come from our own check of the pack file, not from the source page.