LuckyItems

AuthorBebo Naiem
PlatformMinecraft
Versions1.13 - 1.21

🍀 LuckyItems v1.0

LuckyItems is an exciting Minecraft plugin that rewards players with random item drops when breaking blocks. Designed for servers looking to add surprise elements to mining and resource gathering, it works seamlessly across Minecraft versions 1.13+.

✨ Key Features

🎁 Reward System

  • 🎲 True Randomization: Drops any valid Minecraft item
  • ⚖️ Configurable Odds: Adjust drop chance in config (default: 10%)
  • 📦 Delivery Options: Choose inventory or ground drops
  • 🔔 Player Notifications: Colorful messages for reward recipients

⚙️ Configuration

  • 📝 Simple YAML Config: Single config file with clear options
  • 🔄 Live Reloading: /luckyitems reload updates settings
  • 🎨 Custom Messages: Personalize drop notifications

🛡️ Server Integration

  • 🔐 Permission Control: luckyitems.get permission required
  • ⚡ Performance Optimized: Lightweight with minimal overhead
  • 🌐 Multi-World Support: Works across all loaded worlds

📥 Installation

  1. Download LuckyItems.jar
  2. Place in plugins/ folder
  3. Restart server
  4. Edit plugins/LuckyItems/config.yml if needed

⚙️ Sample Config

settings:
  give-directly: true
  drop-on-ground: false 
  drop-chance: 0.1
  message: "&6&lLUCKY! &eYou found: &b{item}"

🔑 Permissions

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

🕹️ Usage

  • Players automatically get random items when breaking blocks.
  • Admins can use /luckyitems reload to update settings.

📌 Technical Specs

  • Minecraft: 1.13+
  • Java: 17+
  • Dependencies: None
  • Storage: No database required

❓ FAQ

Q: Can I blacklist certain items?
A: Currently supports all valid items - future updates may include filtering

Q: How often will players get items?
A: Default 10% chance per block break - adjustable in config

Q: Does this work with Fortune enchant?
A: Yes, but doesn't affect drop chances

🌟 Pro Tips

  • Great for economy servers as surprise rewards
  • Combine with mining events for extra excitement
  • Lower drop chances for rare item servers

(Perfect for adding fun surprises to any survival server!)