[❢] 支持的版本: 1.20-1.20.6, 1.21-1.21.8
[❢] 要求: Java 21, Vault
*旧版本不支持，并且将来也不会支持*
## ✨ 关于插件
**MrCommunityQuest**是一个社区驱动的寻宝任务插件，为你的 Minecraft 服务器带来服务器范围内的挑战和协作目标。玩家共同完成各种任务，根据他们的贡献获得奖励。
## ✨ 特性
- **社区寻宝任务** - 服务器范围内的协作挑战
- **多种寻宝任务类型** - 打破、放置、捐赠等多种任务类型
- **自动排程** - 带有可配置时间器的自动寻宝任务轮换
- **进度追踪** - 所有玩家的实时进度更新
- **奖励系统** - 基于排名的奖励，具有多个等级的奖品
- **可定制的 GUI** - 完全可配置的图形用户界面
- **Vault 集成** - 捐赠任务的经济支持
- **持久的进度** - 寻宝任务进度在重启之间保存
- **渐变颜色支持** - 带有十六进制代码的美丽彩色 GUI 标题
- **PlaceholderAPI 集成** - 消息中的动态占位符
- **多语言支持** - 通过 messages.yml 本地化消息
- **管理员命令** - 通过 /mqc 命令套件获得完全控制权
## ✨ 命令
### 玩家命令
- `/cq` – 打开社区寻宝任务菜单
- `/cquest` – 另一种打开寻宝任务菜单的命令
### 管理员命令
- `/mqc reload` – 重新加载配置文件和消息文件
- `/mqc start` – 启动一个新的社区寻宝任务
- `/mqc end` – 结束当前的社区寻宝任务
- `/mqc list` – 列出所有可用的寻宝任务
## ✨ 寻宝任务类型
### 打破寻宝任务
- 玩家打破特定方块以贡献社区目标
### 放置寻宝任务
- 玩家放置特定方块以贡献社区目标
### 捐赠寻宝任务
- 玩家通过 Vault 捐款以贡献社区目标
### 击杀寻宝任务
- 玩家击杀特定生物以贡献社区目标
## ✨ 奖励系统
### 基于排名的奖励
- **第一名** - 贡献最高的玩家获得最佳奖励
- **第二名** - 贡献最高的第二名玩家
- **第三名** - 贡献最高的第三名玩家
- **参与者奖励** - 所有贡献玩家都获得奖励
### 奖励配置
- 在 quests.yml 中完全可定制的奖励
- 每个位置多个物品奖励
- 可配置的奖励金额和几率
## ✨ PlaceholderAPI 占位符
### 活跃寻宝任务占位符
- `%mrcommunityquests_active_quest_1%` - 返回第一个活跃寻宝任务的名称
- `%mrcommunityquests_active_quest_completed_1%` - 返回已完成的量（例如，500）
- `%mrcommunityquests_active_quest_required_1%` - 返回所需的量
- `%mrcommunityquests_active_quest_percentage_1%` - 返回完成百分比
- `%mrcommunityquests_active_quest_myposition_1%` - 返回玩家在寻宝任务中的位置
- `%mrcommunityquests_active_quest_myvalue_1%` - 返回玩家的贡献计数
- `%mrcommunityquests_active_quest_position_1_1%` - 返回寻宝任务中位置 1 的玩家
- `%mrcommunityquests_active_quest_timetoend_1%` - 返回寻宝任务结束前的分钟数
- `%mrcommunityquests_active_quest_progressbar_1%` - 返回可定制的进度条
### 通用占位符
- `%mrcommunityquests_active_quests%` - 返回活跃寻宝任务的数量
- `%mrcommunityquests_quests%` - 返回寻宝任务的总数（活跃的和非活跃的）
### 进度条配置
进度条可以在 messages.yml 中进行定制：
```yaml
MrCommunityQuest:
Placeholders:
ProgressBar:
Filled: "█"
Empty: "░"
Length: 20
```
### 定制选项
- 完全可配置的寻宝任务目标和奖励
- 带有渐变颜色的自定义 GUI 标题
- 可调整的寻宝任务计时器和自动排程
- 可配置的奖励系统
- 多个语言的本地化支持
## ✨ 插件预览
你可以在 Gallery 中找到预览图片。
