🎂 Birthday Celebrations

Birthday Celebrations brings a fun, community-focused birthday system to your Minecraft server. Players register their birthday once, and the plugin handles the rest - daily announcements, in-game broadcasts, a claimable shulker box reward, and Discord webhook notifications to keep your community in the loop.

---

✨ Features

🎉 Player Birthdays

• Players register their own birthday with /birthday add <month> <day> (supports full month names, short names, or numbers)
• Birthdays are locked after being set - only admins can make changes
• /birthday on its own shows a player their registered birthday and lets them claim their reward during their birthday month

🎁 Shulker Box Reward System

• Admins set the birthday reward by holding a filled shulker box and running /birthday setreward
• The shulker (including all its contents) is serialised and saved - exactly what you put in is what players receive
• Optional extra reward commands (e.g. giving in-game currency) can be configured alongside the shulker
• Rewards are claimable any time during the player's birthday month, not just on the day itself
• Claim tracking is per-year, so players get their reward fresh each year

📣 Automated Daily Announcements

• A configurable daily task fires at a set time (default 08:30, 24-hour format) and announces all birthdays for that day
• Broadcasts both in-game (server-wide message) and to a Discord webhook channel
• Fires only once per day - safe against server restarts and lag

💬 Smart Join Notifications

• Players who haven't set their birthday yet get a friendly reminder on join
• On join, players are notified of any birthdays happening today
• If it's the joining player's own birthday, they receive a personalised welcome message
• Players in their birthday month (but not yet claimed) are reminded to collect their present
• All join messages use configurable delays so they don't collide with other plugins' join messages

🔔 Discord Integration

• Announcement webhook - fires the daily birthday announcement to a public channel
• Log webhook - records admin actions (birthday set, cleared, updated) and player birthday registrations with colour-coded embeds
• Both webhooks are independent and optional - leave either blank to disable

🛠️ Admin Tools

• /birthday set <player> <month> <day> - set or override a birthday for any player
• /birthday clear <player> - remove a player's registered birthday
• /birthday clearclaim <player> <year> - reset a specific year's claim (useful if a player missed out or needs a re-issue)
• /birthday upcoming - view all birthdays occurring in the next 30 days, sorted by soonest, with "TODAY" highlighted
• /birthday reload - reload config and data without restarting

⚙️ Fully Configurable

• All messages customisable via config.yml with colour code support
• Announcement time configurable in 24-hour HH:MM format
• Join message delays configurable (in seconds) to fit your server's join flow
• Reward commands list supports any console command with %player% placeholder

---

📋 Commands

Command	Description	Permission
/birthday	Check status or claim reward	birthday.use
/birthday add <month> <day>	Set your birthday	birthday.use
/birthday set <player> <month> <day>	Admin: set a player's birthday	birthday.admin
/birthday clear <player>	Admin: remove a player's birthday	birthday.admin
/birthday clearclaim <player> <year>	Admin: reset a year's claim	birthday.admin
/birthday setreward	Admin: save held shulker as reward	birthday.admin
/birthday upcoming	Admin: view next 30 days of birthdays	birthday.admin
/birthday reload	Admin: reload plugin	birthday.admin

Alias: /bd

---

🔒 Permissions

Permission	Default	Description
birthday.use	All players	Access to /birthday and /birthday add
birthday.admin	OP	Access to all admin commands

---

📦 Installation

1. Drop BirthdayCelebrations.jar into your plugins/ folder
2. Start or reload your server
3. Configure plugins/BirthdayCelebrations/config.yml - set your Discord webhooks and announcement time
4. Hold a filled shulker box and run /birthday setreward to configure the birthday reward
5. Players can now register their birthdays with /birthday add <month> <day>