# 🎂 Birthday70Cents

> 🎁 A Minecraft 1.21.4 plugin for birthday gifts by [70CentsApple](https://github.com/70CentsApple). **Birthday70Cents** is a simple and fun plugin that allows players to set their birthday, receive birthday presents, and for administrators to manage those presents efficiently. - 🌐 Supports [Folia](https://papermc.io/software/folia) and [Paper](https://papermc.io/) 1.21.4 - 🎁 Fully configurable birthday present system - 👥 Permissions-based player control - 📦 Able to define action chains for present unwrapping, such as executing commands or giving items --- ## 🛡️ Commands & Permissions | Command | Description (* = admin by default) | Permission | |--------------------------------------|----------------------------------------------|---------------------------| | `/birthday70cents` | Base command (aliases: `/birthday`, `/bday`) | `birthday.basic` | | `/birthday help` | Show command help | `birthday.basic.help` | | `/birthday set ` | Set your birthday (format: MM-dd) | `birthday.basic.set` | | `/birthday withdraw` | Claim your birthday present | `birthday.basic.withdraw` | | `/birthday edit` | * Edit birthday gift items and action chains | `birthday.admin.edit` | | `/birthday get` | * Get sample birthday present | `birthday.admin.get` | | `/birthday query ` | * Query player’s birthday info | `birthday.admin.query` | | `/birthday modify ` | * Modify player birthday info | `birthday.admin.modify` | | `/birthday reload` | * Reload plugin configuration | `birthday.admin.reload` | > 📌 You can fine-tune child permissions using LuckPerms (for example) as needed. --- ## 🪜 PAPI Placeholders You can use PlaceholderAPI to access player birthday information. Here are the available placeholders: | Placeholder | Description | Example | |--------------------------------------|--------------------------------------------------------------------------------------------------------------------------------|--------------------| | `%birthday70cents_is_birthday_today%` | 1 or 0, indicating if today is the player's birthday | 1 | | `%birthday70cents_has_withdrawn_this_year%` | 1 or 0, indicating if the player has claimed a gift this year | 0 | | `%birthday70cents_has_set_birthday%` | 1 or 0, indicating if the player has set their birthday | 1 | | `%birthday70cents_withdrawn_years%` | Years the player has withdrawn presents, separated by commas | `2022, 2024, 2025` | | `%birthday70cents_today_prefix%` | If today is the player's birthday, this will be the value of `papi-birthday-prefix` in the config; otherwise, it will be empty | | --- ## 🧩 Configuration The plugin's configuration file is located at `config.yml`. The players' birthdays are stored in `birthday.yml`, which is automatically created in the plugin's folder. You can edit this file to manage player birthdays, but it is recommended to use the provided commands for safety. Example configuration: ```yaml # Language, takes value: [en_us, zh_cn] language: en_us # If a player's birthday is 02-29: # 0 - They could only withdraw their present at exactly 02-29. # 1 - If this year is not a leap year, consider the user's birthday as 03-01. # -1 - If this year is not a leap year, consider the user's birthday as 02-28. adjust-leap-year: 0 # The value of %birthday_today_prefix% will be this if today is the player's birthday, # empty string otherwise. (Requires PAPI) papi-birthday-prefix: '🎂' ```