🎂 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>