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
```yaml
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!