Birthday70Cents

<div align="center">

<img alt="LOGO" src="https://cdn.modrinth.com/data/1CBdpQCN/3a2f5de45d104f89503945b07afd890d03467f1d_96.webp" width="200" height="200" />

🎂 Birthday70Cents

</div>

> 🎁 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: ```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: '🎂' ```