🎲 V-LuckyMine

⚡ Zero-lag lucky container spawning system for Paper servers
🎨 Fully configurable loot tables, block chances & container types
🔒 Simple & lightweight — no bloat, just fun!

Transform mining into a thrilling treasure hunt! V-LuckyMine spawns magical containers filled with custom loot whenever players mine specific blocks. Perfect for survival servers, RPG worlds, or minigame lobbies.

---

✨ Features

• 🎲 Chance-based spawning — Configure unique probabilities for every block type
• 📦 16+ Container types — Chests, Shulkers, Barrels, Hoppers, Droppers, Dispensers & more
• 🎯 Visual GUI editor — Manage everything in-game with /lm
• ⏱️ Auto-despawn — Containers vanish after configurable time (default: 10 seconds)
• 🎨 Per-item chances — Each loot item has its own independent spawn probability
• ⚡ Async operations — Zero server lag guaranteed
• 🔧 Live reload — Update configs without restarts

---

📥 Installation

1. Download the latest V-LuckyMine-1.0.0.jar
2. Upload the JAR file to your server's plugins/ folder
3. Restart your Paper server (Java 21+ required)
4. Run /lm as OP to configure via GUI
5. Enjoy the treasure hunting experience!

---

🛠️ Commands

Command	Description	Permission
/lm or /luckymine	Open the GUI menu	luckymine.admin
/lm reload	Reload config.yml and loot.yml	luckymine.admin
/lm createnbt <name>	Create loot table by right-clicking a chest	luckymine.admin
/lm cancel	Cancel active createnbt session	luckymine.admin

Alias: /lm (works for all commands)

> 🔒 All commands are OP-only and hidden from non-ops

---

🔐 Permissions

Permission	Default	Description
luckymine.admin	OP	Full access to GUI and commands
luckymine.lucky	Everyone	Allows triggering lucky containers when mining

---