🎁 A Minecraft 1.21.4 plugin for birthday gifts by 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 and Paper 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 <MM-dd>	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 <player>	* Query player’s birthday info	birthday.admin.query
/birthday modify <player> <reset?>	* 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:

# 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: '🎂'