BlockQuest - 方块寻宝任务插件

为你的大厅添加隐藏方块，等待玩家发现并获取奖励！

💡为什么选择 BlockQuest？

• 完全免费且开源：你可以自由使用，甚至可以根据需要添加自己的功能。
• 易于设置：只需创建一个系列，添加方块，修改命令，然后启用即可。
• 粒子效果支持：根据方块状态（已找到或未找到），为每位玩家在方块附近显示粒子效果。
• 发现特效：提供类似热门服务器上的酷炫发现效果。
• 数据统计：记录谁找到了所有方块，或者每位玩家找到了多少方块。
• PlaceholderAPI 支持：可使用丰富的占位符。
• 独特功能：可隐藏你已经找到的方块，只显示尚未发现的方块。（即将回归）
• 高度可配置：当然，如果你愿意，也可以禁用任何功能。

> 提示：本插件与 RawMSG 和 TitleManager 搭配使用效果更佳！

🎮快速开始指南

如果你对配置感到困惑，请按以下步骤操作

第一步：创建系列

使用命令创建你的第一个寻宝系列

/blockquest series <系列ID> create

第二步：配置命令

配置是核心，主要需要编辑以下几个命令列表

• find-block-commands：玩家找到一个方块时执行的命令。
• all-blocks-found-commands：玩家找到一个系列中所有方块时执行的命令。
• already-found-commands：玩家点击已找到的方块时执行的命令。
• already-found-all-blocks：玩家已找全所有方块时，再次点击方块执行的命令。

第三步：使用可用变量

你可以在上述命令中使用以下变量

• %pLocX%, %pLocY%, %pLocZ%：玩家的坐标。
• %locX%, %locY%, %locZ%：被点击方块的坐标。
• %player%：玩家名称。
• %blocksLeft%：该系列中剩余的方块数量。
• rawmsg：来自 RawMSG 插件的命令。

✨PlaceholderAPI 占位符

确保在 config.yml 中启用了 placeholderapi。

• %blockquest_blocksfound_<系列>%：玩家在指定系列中已找到的方块数。
• %blockquest_blocksleft_<系列>%：玩家在指定系列中尚未找到的方块数。
• %blockquest_allblocks_<系列>%：指定系列中总的方块数量。

> 注意：请将 <系列> 替换为你的实际系列名称。

🔧命令与权限

• 主命令：/blockquest
• 指南命令：/blockquest guide - 获取插件设置指南。
• 所需权限：blockquest.command - 使用 /blockquest 命令的权限。

⭐要求与依赖

• 运行环境：Java 8 或更高版本。
• 可选依赖：PlaceholderAPI（用于占位符功能）。

❓获取帮助与支持

• 开发者 API：可通过 BlockQuestAPI.getInstance(); 访问，用于创建自定义系列或按需存储数据。
• 社区支持：如需插件帮助，请在 Discord 的 #general-plugin 频道中 @ 我（我拥有 Trusted 角色），这是获取支持最快的方式。
• 配置示例：你可以在 此处 查看示例配置文件。
• 教学视频：

-   [英文教程](https://example.com)（注：视频基于 2.0 版本之前录制，内容可能过时但仍具参考价值）

-   [西班牙文教程](https://example.com)

> 免责声明：插件截图展示的并非默认配置。