# 🎂 Birthday70Cents
> 🎁 适用于 Minecraft 1.21.4 的生日礼物插件，由 [70CentsApple](https://github.com/70CentsApple) 开发。
**Birthday70Cents** 是一个简单有趣的插件，允许玩家设置他们的生日，接收生日礼物，并让管理员高效地管理这些礼物。
- 🌐 支持 [Folia](https://papermc.io/software/folia) 和 [Paper](https://papermc.io/) 1.21.4
- 🎁 全可配置的生日礼物系统
- 👥 基于权限的玩家控制
- 📦 能够定义礼物拆包的操作链，例如执行命令或给予物品
---
## 🛡️ 命令 & 权限
| 命令 | 描述 (* 代表默认管理员权限) | 权限 |
|--------------------------------------|----------------------------------------------|---------------------------|
| `/birthday70cents` | 基础命令 (别名：`/birthday`, `/bday`) | `birthday.basic` |
| `/birthday help` | 显示命令帮助 | `birthday.basic.help` |
| `/birthday set
` | 设置你的生日 (格式: MM-dd) | `birthday.basic.set` |
| `/birthday withdraw` | 领取你的生日礼物 | `birthday.basic.withdraw` |
| `/birthday edit` | * 编辑生日礼物物品和操作链 | `birthday.admin.edit` |
| `/birthday get` | * 获取示例生日礼物 | `birthday.admin.get` |
| `/birthday query ` | * 查询玩家的生日信息 | `birthday.admin.query` |
| `/birthday modify ` | * 修改玩家生日信息 | `birthday.admin.modify` |
| `/birthday reload` | * 重新加载插件配置 | `birthday.admin.reload` |
> 📌 您可以使用 LuckPerms（例如）微调子权限，以满足需求。
---
## 🪜 PAPI 占位符
您可以使用 PlaceholderAPI 来访问玩家生日信息。 以下是可用的占位符：
| 占位符 | 描述 | 示例 |
|--------------------------------------|--------------------------------------------------------------------------------------------------------------------------------|--------------------|
| `%birthday70cents_is_birthday_today%` | 1 或 0，指示今天是否是玩家的生日 | 1 |
| `%birthday70cents_has_withdrawn_this_year%` | 1 或 0，指示玩家是否在本年领取过礼物 | 0 |
| `%birthday70cents_has_set_birthday%` | 1 或 0，指示玩家是否设置了他们的生日 | 1 |
| `%birthday70cents_withdrawn_years%` | 玩家领取礼物的年份，用逗号分隔 | `2022, 2024, 2025` |
| `%birthday70cents_today_prefix%` | 如果今天是玩家的生日，则为 `papi-birthday-prefix` 在 config 中的值；否则为空 | |
---
## 🧩 配置
插件的配置文件位于 `config.yml`。
玩家的生日存储在 `birthday.yml` 中，该文件会自动在插件文件夹中创建。
您可以通过编辑此文件来管理玩家生日，但建议使用提供的命令以确保安全。
示例配置:
```yaml
# 语言，取值：[en_us, zh_cn]
language: en_us
# 如果玩家的生日是 02-29:
# 0 - 他们只能在 02-29 准时领取礼物。
# 1 - 如果今年不是闰年，将用户的生日视为 03-01。
# -1 - 如果今年不是闰年，将用户的生日视为 02-28。
adjust-leap-year: 0
# %birthday_today_prefix% 的值，如果今天是玩家的生日，则会是这个值，
# 否则为空。 (需要 PAPI)
papi-birthday-prefix: '🎂'
```
