LuckyItems

🍀 LuckyItems v1.0 - The Ultimate Random Reward System

Turn every block break into an exciting surprise! A lightweight plugin that rewards players with random Minecraft items.

✨ Key Features

🔹 True Random Drops - Any item in Minecraft can drop, from sticks to netherite! 🔹 Smart Delivery System - Choose between direct inventory or ground drops 🔹 Universal Compatibility - Works flawlessly with Minecraft 1.13 through 1.21 🔹 Personalized Alerts - Players see colorful notifications for their rewards 🔹 Configurable Odds - Set your perfect drop chance (default: 10%) 🔹 Permission Control - Decide who gets lucky with simple permissions 🔹 Zero Lag - Optimized to run smoothly on any server size

🚀 Quick Start

📥 Installation

1. Download LuckyItems.jar
2. Drop into your server's plugins/ folder
3. Restart the server - works instantly with default settings
4. (Optional) Edit config.yml to tweak drop chances

⚙️ Core Configuration

settings:
  give-directly: true    # Deliver to inventory
  drop-on-ground: false  # Or drop at broken block
  drop-chance: 0.1       # 10% default chance
  message: "&6&lLUCKY! &eYou found: &b{item}"

🔑 Permissions

• luckyitems.get - Receive random drops (default: true)
• luckyitems.reload - Reload config (op only)

💡 Pro Tips

• Great for economy servers - use with Vault for money drops!
• Lower chance (0.05) for rare item servers
• Combine with mining events for extra excitement
• Works with all block types - even custom ones!

📦 Technical Specs

• Minecraft: 1.13 - 1.21
• Java: 17+
• Dependencies: None!
• Storage: No database needed

📥 Transform your server today with thrilling random rewards!

🆚 Why Choose LuckyItems?

✔ Instant Fun - Players love the surprise element ✔ Fully Customizable - Control drops and messages ✔ Server-Friendly - Uses under 1MB RAM ✔ Always Fresh - Randomization ensures endless variety

⚖️ Recommended Drop Rates

Server Type	Ideal Chance	Effect
Survival	0.1 (10%)	Balanced rewards
Hardcore	0.15 (15%)	Extra motivation
Minigames	0.2 (20%)	Fast-paced excitement
RPG	0.05 (5%)	Rare, valuable drops

🔗 Full documentation available on GitHub

Turn mundane mining into an adventure with every block break!