# 随机 BACAP 挑战
将 **BlazeandCave 的进阶系统包** 变成一个轮换挑战系统，供您或您的服务器使用。
玩家（或所有人全局）获得一个随机的 BACAP 进阶来完成。
> **要求：** [BlazeandCave 的进阶系统包](https://modrinth.com/datapack/blazeandcaves-advancements-pack) 安装在您世界的 `datapacks/` 文件夹中。
> **推荐：** 一个隐藏 Bossbar 的材质包，例如 [Invisible Boss Bars](https://modrinth.com/resourcepack/invisible-bars)
> **已在以下版本测试：** Paper (1.21.8)。
---
## 功能
- **单人** – 为您自己挑选一个随机的 BACAP 进阶。
- **全球挑战** – 为整个服务器挑选一个随机的 BACAP 进阶
（启用 **BACAP 合同模式** 以在玩家之间同步进阶）。
- **Bossbar UI** – 基于 BACAP 类别进行着色标题和描述。
- **组件侧边栏 & GUI** – 查看进阶的各个标准：
- 配有 ✓/✗ 标记的侧边栏记分牌。
- 分页的箱子 GUI。
- **计时器命令** – 动作栏中的简单游戏内计时器：开始 / 停止 / 状态 / 重置。
- **跳过投票 (全球)** – 玩家可以投票跳过当前的全球挑战。
- **过滤** – 通过配置包含/排除类别和 ID。
- **本地化** – 包含英语和德语；易于扩展。
---
## 命令
```
/challenge start # 开始或恢复您的个人挑战
/challenge next # 挑选一个新的个人挑战
/challenge stop # 隐藏您的个人挑战
/challenge status
/challenge global start # 为所有在线玩家开始一个全球挑战
/challenge global next
/challenge global stop
/challenge global skip # 投票跳过当前的全球挑战
/challenge global status
/challenge components true|false # 切换侧边栏
/challenge components gui # 为当前挑战打开箱子 GUI
/timer start | stop | status | reset
```
_所有命令默认情况下都可以由玩家使用。_
---
## 配置 (摘录)
您真正关心的 `config.yml` 键：
```yaml
language: en # en 或 de
filter:
only_categories: [] # 例如 [redstone, technical]
exclude_categories: []
exclude_ids: [] # 要排除的精确进阶 ID
exclude_prefixes: [] # 要排除的 ID 前缀
exclude_regex: [] # 使用正则表达式进行高级过滤
```
> 提示：如果您过滤过于严格，您可能会最终只有很少的可用挑战。
---
## 安装
1. 将 **BlazeandCave 的进阶系统包** 安装到您的世界中 (`world/datapacks/`) 。
2. 将此插件 JAR 放入 `plugins/` 并重启。
3. (可选) 调整 `config.yml` 并重启/重新加载。
4. 使用 `/challenge start` (单人) 或 `/challenge global start` (用于所有人)。
---
## 兼容性
- 基于 Bukkit/Adventure API 构建，并在 Paper 上测试。
- 可与大多数游戏插件一起使用；它仅读取 BACAP 进阶并显示 UI。
---
## 本地化
附带英语和德语消息。
---
## 常见问题解答
**Q: 玩家需要下载任何东西吗？**
A: 不。只有服务器需要插件和 BACAP 数据包。
**Q: 我可以限制对特定组的命令吗？**
A: 默认情况下，每个人都可以使用它们。使用您的权限插件来设置或别名命令。
**Q: 支持哪些 Minecraft 版本？**
A: 在 1.21.x 上测试。如果您的 BACAP 包非常旧，插件将发出有关可能不兼容性的警告。
---
这是我的第一个插件，请在 [GitHub](https://github.com/ADHEni/RandomBCAPChallengePlugin) 上报告错误或提出功能请求。
享受挑战磨练吧！