MinerPlugin — Automatic Miners with Upgrades, Storage & Holograms [1.20+]Three types of upgradable miners (Normal, Epic, Legendary) with custom mining speeds, fortune/durbility upgrades via Vault economy, built-in storage GUI, and floating holograms above each miner!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
DESCRIPTIONMinerPlugin adds powerful automatic miner blocks to your server. Place a miner, power it with redstone, and watch it dig! Each miner type has different mining area and speed. Upgrade fortune and durability using in-game money through an intuitive GUI. Every miner displays a floating hologram showing its type and upgrade levels.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FEATURES
THREE MINER TIERS┌──────────────┬────────────┬──────────┬──────────────┬──────────────┐
│ Type │ Mining Area│ Speed │ Storage │ Durability │
├──────────────┼────────────┼──────────┼──────────────┼──────────────┤
│
NORMAL │ 4×4×4 │ ~7 blk/s │ 27 slots │ 1,000 ││
EPIC │ 8×8×8 │ ~13 blk/s│ 54 slots │ 2,500 ││
LEGENDARY │ 14×14×14 │ ~26 blk/s│ 54 slots │ 5,000 │└──────────────┴────────────┴──────────┴──────────────┴──────────────┘
UPGRADE SYSTEM (GUI)• Upgrade Fortune — increases drop multiplier (cost multiplies ×4 per level)
• Upgrade Durability — adds max durability and restores HP (cost multiplies ×4 per level)
• Open Storage — one-click access to mined resources
• All upgrades purchased with in-game money via Vault
HOLOGRAMS• Floating name tag above every miner showing:
"⛏ Normal Miner [F:3 D:2]"
• Auto-updates when you upgrade fortune or durability
• Automatically removed when miner is broken
CORE FEATURES• Redstone-powered — miner works only with redstone signal
• Keeps items when broken — all storage contents saved in NBT
• Fortune multiplier — configurable base + per-level bonus
• Chunk limit — prevents server lag
• Full config — everything adjustable in config.yml
• Lightweight — optimized for high TPS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
INTEGRATIONS
Vault — economy support (buy upgrades with money)Compatible with: EssentialsX, CMI, TheNewEconomy, EcoEnchants, and any Vault-compatible economy plugin
Protection Plugins (via Bukkit events)Compatible with: WorldGuard, GriefPrevention, Towny, Lands, PlotSquared
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
HOW TO USECommands:
/minergive normal — Get Normal Miner (4×4×4)
/minergive epic — Get Epic Miner (8×8×8)
/minergive legendary — Get Legendary Miner (14×14×14)
/minergive <type> <player> — Give miner to another player
/minergive reload — Reload configuration
How it works:
1. Get a miner with /minergive
2. Place it like a dispenser — hologram appears above it
3. Power it with redstone (lever, torch, block) — miner starts digging
4. Right-click to open upgrade GUI:
• Diamond Pickaxe — Upgrade Fortune
• Netherite Chestplate — Upgrade Durability
• Chest — Open Storage
5. Break the miner with a pickaxe — drops with all items saved
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CONFIGURATION (config.yml)miners:
legendary:
name: "&6Legendary Miner"
mining-area: [14, 14, 14] # Mining area size
blocks-per-tick: 4 # Blocks per tick (~26/sec)
fortune-multiplier: 2.5 # Base fortune multiplier
fortune-base-cost: 500.0 # Base upgrade cost
durability-base-cost: 600.0 # Durability upgrade cost
durability-per-level: 1000 # Extra durability per level
Upgrade cost formula: base × 4^level
Level 0→1: $500
Level 1→2: $2,000
Level 2→3: $8,000
Level 3→4: $32,000
Level 4→5: $128,000
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
REQUIREMENTS
Java 17+
Paper 1.20.4+ (or Purpur, Pufferfish) Vault (required for economy upgrades)
Any Vault-compatible economy plugin (EssentialsX recommended)━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
INSTALLATION1. Install Vault and EssentialsX (or any economy plugin)
2. Drop MinerPlugin-3.2.0.jar into /plugins/
3. Restart server
4. Edit plugins/MinerPlugin/config.yml if needed
5. Run /minergive normal to test
6. Done!
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
FAQQ: Miner is not working, why?
A: Make sure it's powered by redstone (lever, redstone block, torch). Check chunk is loaded.
Q: How are items saved when breaking the miner?
A: All storage contents are saved in NBT tags. Place it again — all items return.
Q: Can I change mining speed?
A: Yes! Adjust blocks-per-tick in config.yml for each miner type.
Q: Does it work with WorldGuard?
A: Yes, miner respects all protection plugins through Bukkit events.
Q: What economy plugins are supported?
A: Everything that works with Vault: EssentialsX, CMI, TNE, and more.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
CHANGELOGv3.2.0:
• Different mining speeds per tier (7/13/26 blocks/sec)
• Floating holograms above miners
• Dynamic upgrade costs (base × 4^level)
• One-click GUI (Fortune/Durability/Storage)
• Vault economy integration
• NBT data persistence
• Chunk limit system
• Full config customization
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
SUPPORTDiscord: deluxdll
Email: [email protected]
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Automate mining on your server with MinerPlugin!━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
