🎂 Birthday70Cents
🎁 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: '🎂'
Links
Details
Licensed GPL-3.0-only
Published 4 months ago
Updated 4 months ago