birthday-fabric Mod

What is it?

This mod adds a birthday celebration system to Minecraft servers. Each player can set their birth date and receive congratulations with gifts from other players on their special day!

Main Features

Players can set their birth date in month-day format and change it up to three times (this value is configurable). Administrators have the right to set and edit birthdays for other server members. All birthday information is preserved even after server restarts.

When someone's birthday arrives, the system automatically detects this event (checking occurs daily). The birthday person receives a special congratulation and a festive cake. Other players can type "Happy Birthday" or "生日快乐" in chat to also receive a piece of cake.

Commands

/birthday <MM-DD> - set your birth date (for example: /birthday 05-20)

/birthday info - view your current set birth date

/birthday list - show the list of all players whose birthday is today

/birthday for <player> <MM-DD> - set birthday for another player (requires admin rights)

/birthday reload - reload configuration (requires admin rights)

Configuration

The mod configuration file is located at ./config/birthdaymod/config.json. Here are the default settings with explanations:

{
  // Player settings
  "maxModifications": 3,                 // Maximum number of birthday changes for one player
  "announceCooldownHours": 4,            // Minimum time in hours between birthday announcements

  // Message templates (use %s for value substitution)
  "birthdaySet": "§6Your birthday: §e%s", // Message when setting birthday
  "birthdayAdminSet": "§6Set birthday for §b<%s> §6to: §e%s", // Admin sets birthday for another player
  "birthdayTodayPlayers": "§dToday's birthday celebrants: §a<%s>", // List of today's birthday people
  "birthdayReminder": "§eYou haven't set your birthday yet. Use §b/birthday MM-DD §eto set it.", // Reminder for those who haven't set the date
  "birthdayCakeReceived": "§dYou received a festive cake from §b<%s>", // Cake receipt message
  "birthdayInvalid": "§cInvalid date format! §7Use §eMM-DD§7 (for example: §a05-20§7)", // Invalid date format error
  "birthdayWarning": "§cYou've changed your birthday too often! §7Contact an administrator for further changes.", // Warning about exceeding change limit

  // System messages
  "birthdayAnnouncement": "§a[System] §6Today is §e<%s>§6's birthday (‾◡◝). §aLet's all congratulate them on this holiday! §7(Type §b'Happy Birthday' §7in chat to get a piece of cake!)", // General birthday announcement on the server
  "birthdayMessage": "§a[System] §e(｡･∀･)ﾉﾞ Hello, §b%s§e, happy birthday! §aCheck your inventory - there's a special gift waiting for you from us. §dThank you for your constant support. May happiness find you under every starry sky!", // Personal congratulation

  // Chat keywords
  "rewardKeywords": [                    // Phrases that activate cake receipt when typed in chat
    "Happy Birthday",                    // Standard English phrase
    "生日快乐"                           // Standard Chinese phrase
  ]
}

License

MIT