birthday-fabric

Description

A birthday celebration mod designed for Minecraft servers, allowing each player to set their birthday and receive gifts and warm wishes from others on their special day!

Features

• Players can set their birthday (MM-DD format)
• Players can modify their birthday up to 3 times (configurable)
• Admins can set/modify birthdays for other players
• Birthday info persists across server restarts
• Players can say "Happy Birthday" or "生日快乐" in chat to receive a cake
• Special birthday message and cake for the birthday player
• Automatic birthday detection (checks daily)

Commands

• /birthday <MM-DD> - Set your birthday date (e.g. /birthday 05-20)
• /birthday info - Check your current birthday setting
• /birthday list - List all players with birthdays today
• /birthday for <player> <MM-DD> - Set birthday for another player (OP required)
• /birthday reload - Reload configuration (OP required)

Configuration

Mod configuration file is located at ./config/birthdaymod/config.json. Here's the default configuration with explanations:

Default Config

{
  // Player settings
  "maxModifications": 3,                 // Maximum number of times a player can change their birthday
  "announceCooldownHours": 4,            // Minimum hours between birthday announcements
  
  // Message templates (use %s for dynamic values)
  "birthdaySet": "§6Your birthday: §e%s", // Message when player sets their birthday
  "birthdayAdminSet": "§6Set birthday for §b<%s> §6to: §e%s", // Admin sets birthday for another player
  "birthdayTodayPlayers": "§dToday's birthday players: §a<%s>", // List of today's birthdays
  "birthdayReminder": "§eYou haven't set your birthday yet. Use §b/birthday MM-DD §eto set it.", // Reminder for unset birthdays
  "birthdayCakeReceived": "§dYou received a birthday cake from §b<%s>", // Cake reward message
  "birthdayInvalid": "§cInvalid date format! §7Please use §eMM-DD§7 (e.g. §a05-20§7)", // Invalid date format error
  "birthdayWarning": "§cYou've modified your birthday too many times! §7Please contact an admin if you need further changes.", // Modification limit warning
  
  // System messages
  "birthdayAnnouncement": "§a[System] §6Today is §e<%s>§6's birthday (‾◡◝). §aLet's all wish them a happy birthday! §7(Type §b'Happy Birthday' §7in chat to receive a birthday cake!)", // Server-wide birthday announcement
  "birthdayMessage": "§a[System] §e(｡･∀･)ﾉﾞ Hi §b%s§e, happy birthday! §aPlease check your inventory for a special gift from us. §dThank you for your continued support. May you find happiness under every starry sky!", // Personal birthday message
  
  // Chat triggers
  "rewardKeywords": [                    // Phrases that trigger cake rewards when said in chat
    "Happy Birthday",                    // Default English trigger
    "生日快乐"                           // Default Chinese trigger
  ]
}

License

MIT