LuckyHours

A lightweight and flexible Minecraft plugin that allows you to create scheduled server events such as double experience, special bonuses, and more.

Perfect for servers that want to automate weekend boosts, holiday events, or limited-time bonuses without manual activation.

---

✨ Features

• ⏰ Fully automated scheduled events
• 📅 Support for:
  • Specific dates
  • Days of the week
  • Yearly events
• 🌍 Timezone support
• ⚡ Lightweight and optimized
• 🔧 Easy configuration
• 🎨 Customizable messages
• 📦 Simple API-friendly structure

---

🎁 Current Actions

Experience Multiplier

Automatically enable temporary experience boosts.

Examples:

• x2 EXP Weekend
• Night EXP Boost
• Holiday EXP Events

---

📆 Scheduling Examples

Weekly Event

days:
  - SATURDAY
  - SUNDAY
start: "18:00"
end: "23:00"

Specific Date

dates:
  - "2026-05-15"
start: "12:00"
end: "18:00"

Yearly Event

yearly-date: "12-25"
start: "00:00"
end: "23:59"

---

🌐 Timezone Support

Configure your own timezone:

timezone: "Europe/Kyiv"

---

💬 Custom Messages

Fully customizable language file.

Example:

action.multiplier.enabled: "&aThe x{multiplier} experience bonus has been activated!"
action.multiplier.disabled: "&cThe x{multiplier} experience bonus has ended!"

---

📌 Commands

Command	Description
/luckyhours reload	reload plugin command

---

🔒 Compatibility

• Minecraft 1.16+
• Paper
• Spigot
• Purpur

---

🚀 Why LuckyHours?

Unlike heavy event systems, LuckyHours focuses on simplicity, performance, and automated scheduling.

Set it once — let the plugin handle the rest.

---

📖 Planned Features

• Money multipliers
• Loot boosts
• Custom actions
• PlaceholderAPI support
• GUI editor
• Discord webhook notifications

---