HubParkour - 中心跑酷插件

HubParkour 是一款功能丰富、支持多路线的跑酷插件，包含检查点、奖励、排行榜等趣味功能，并高度可定制，适合各类服务器使用。

💡核心特性

• 轻量且高度可定制：插件轻便，几乎所有消息和功能均可配置。
• 精准的计时系统：跑酷时间精确到 3 位小数，误差范围仅 0.001 秒。
• 检查点系统：玩家失败后可传送至最近检查点。
• 排行榜系统：支持单条跑酷的玩家用时排行榜和全局总排行榜。
• 奖励系统：可在检查点或跑酷终点给予玩家奖励。
• 多跑酷支持：可在服务器上创建并管理多条独立的跑酷路线。
• 编辑模式：可随时修改已创建的跑酷路线。
• 防作弊机制：内置高级防利用措施，防止玩家作弊。
• 玩家隐藏：可在跑酷过程中隐藏其他玩家，避免干扰。
• 统计信息：提供详细的玩家跑酷统计数据。
• 跑酷列表 GUI：通过图形界面浏览和选择跑酷路线。

高级功能

• 全息图支持：支持使用 DecentHolograms 或 FancyHolograms 显示排行榜和跑酷点数。
• PlaceholderAPI 支持：提供大量占位符，用于在其他插件中显示跑酷信息。
• MySQL/多服务器支持：支持 MySQL 数据库，可实现多服务器数据同步。
• 开发者 API：提供 API 供开发者进行深度定制和功能扩展。
• 跑酷物品栏：玩家进行跑酷时，物品栏会显示专用工具。
• 动作栏状态：在玩家屏幕的动作栏实时显示当前跑酷时间等信息。
• 分段计时：为追求竞技性的玩家提供分段计时功能。
• 掉落传送：玩家从跑酷路线掉落时，可自动传送回起点或检查点。

🎮安装与设置

• 下载插件的最新版本。
• 将 .jar 文件放入服务器的 plugins 文件夹。
• （可选）如需全息图功能，请安装 DecentHolograms 或 FancyHolograms。
• 启动服务器，等待插件文件生成。
• 根据需求修改配置文件 (config.yml)。
• 重启服务器使配置生效。
• 使用 /parkour setup 命令启动设置向导，创建你的第一条跑酷路线。
• 完成！

可选依赖

• DecentHolograms (用于全息图)
• FancyHolograms (用于全息图)
• PlaceholderAPI (用于占位符)

🔧玩家命令

所有玩家命令均以 /parkour 或它的别名 /pk 开头。

• /parkour checkpoint - 传送至最后到达的检查点。

- 权限：`hubparkour.command.checkpoint`

• /parkour reset - 传送回当前跑酷的起点。

- 权限：`hubparkour.command.reset`

• /parkour leaderboard [parkour] - 查看指定跑酷的排行榜。

- 权限：`hubparkour.command.leaderboard`

• /parkour leave - 退出当前正在进行的跑酷。

- 权限：`hubparkour.command.leave`

• /parkour teleport [parkour] - 传送至指定跑酷的起点。

- 权限：`hubparkour.command.teleport`

• /parkour stats [parkour] - 查看自己全局或指定跑酷的统计数据。

- 权限：`hubparkour.command.stats`

• /parkour gui - 打开跑酷路线列表的图形界面 (GUI)。

- 权限：`hubparkour.command.gui`

🔧管理员命令

• /parkour setup - 进入设置模式，启动跑酷创建向导。

- 权限：`hubparkour.admin.setup`

• /parkour done - 在设置检查点时，继续向导的下一步。

- 权限：`hubparkour.admin.setup`

• /parkour cancel - 取消当前正在进行的设置或编辑操作。

- 权限：`hubparkour.admin.setup`

• /parkour input [text] - 在设置或编辑模式中需要文本输入时提供输入。

- 权限：`hubparkour.admin.setup`

• /parkour delete [parkour id or name] - 删除指定 ID 或名称的跑酷。

- 权限：`hubparkour.admin.delete`

• /parkour list - 列出所有活跃的跑酷路线及正在游玩的玩家。

- 权限：`hubparkour.admin.list`

• /parkour hologram list - 列出所有活跃的排行榜全息图。

- 权限：`hubparkour.admin.hologram`

• /parkour hologram create [parkour id or name] - 为指定跑酷创建一个排行榜全息图。

- 权限：`hubparkour.admin.hologram`

• /parkour hologram delete [parkour id or name] - 删除指定跑酷的全息图。

- 权限：`hubparkour.admin.hologram`

• /parkour removetime [parkour id or name] [player name] - 删除指定玩家在指定跑酷中的排行榜记录。

- 权限：`hubparkour.admin.removetime`

• /parkour cleartimes [parkour id or name] - 清除指定跑酷的所有排行榜记录。

- 权限：`hubparkour.admin.cleartimes`

• /parkour resettimes [player name] - 清除指定玩家的所有跑酷记录。

- 权限：`hubparkour.admin.resettimes`

• /parkour resetalltimes - 清除所有玩家的所有跑酷记录。

- 权限：`hubparkour.admin.resetalltimes`

• /parkour edit [parkour id or name] - 编辑指定 ID 或名称的跑酷。

- 权限：`hubparkour.admin.edit`

• /parkour reload - 重载插件配置（全息图设置需重启服务器生效）。

- 权限：`hubparkour.admin.reload`

• /parkour import - 将数据从 SQLite 存储导入到 MySQL 存储。

- 权限：`hubparkour.admin.import`

注意：插件支持通配符权限。此外，放置告示牌需要权限 hubparkour.admin.signs。

✨附加功能与支持

配置翻译

插件所有消息均可翻译。已有社区贡献的翻译配置，例如荷兰语版本：https://pastebin.com/Juc4qn7k (由 Discord 用户 Arjan#0001 提供)。请注意，开发者不提供除英语外其他语言的支持，也无法保证翻译的准确性。

PlaceholderAPI 占位符

部分占位符中的 PARKOURID 指的是跑酷的数字 ID（可通过 /parkour list 查看），而非跑酷名称。

**常用占位符示例**

• %hubparkour_checkpointcount_PARKOURID% - 返回指定跑酷的检查点数量。
• %hubparkour_recordtime_PARKOURID% - 返回指定跑酷的最佳记录时间。
• %hubparkour_currentparkour% - 返回玩家当前所在跑酷的名称。
• %hubparkour_currenttime% - 返回玩家当前跑酷的已用时间。
• %hubparkour_besttime_PARKOURID% - 返回玩家在指定跑酷中的个人最佳时间。

告示牌支持

从 v2.6 版本开始支持告示牌。第一行必须写 [HubParkour]，第三行写跑酷名称或 ID。第二行用于指定类型，目前有三种：

• teleport - 传送至跑酷起点
• start - 开始跑酷
• stats - 查看跑酷统计

❓已知问题与兼容性

• 命令冲突：任何添加了 /parkour 命令的插件都可能产生冲突。
• 聊天插件干扰：部分聊天插件可能会干扰跑酷设置过程。遇到时可尝试使用 /parkour input 命令替代直接聊天输入。
• 飞行插件：某些飞行插件（如 gfly）可能导致本插件的“移除飞行”功能失效。
• 隐身插件：在跑酷中隐藏玩家时，可能会与某些隐身插件发生冲突。

⭐开发者相关

更新追踪

开发进度和未来更新计划可在 Trello 看板查看：[更新追踪器](HERE)。

开发者 API (Maven)

若使用 Maven，请在 pom.xml 中添加以下依赖：

<repositories>
    <repository>
        <id>hp-repo</id>
        <url>http://nexus.block2block.me/repository/HubParkour/</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>me.block2block.hubparkour</groupId>
        <artifactId>hubparkour-api</artifactId>
        <version>2.8</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

JavaDocs 地址：hubparkour.block2block.me。更多帮助请在 Discord 中获取。

开源与反馈

• GitHub 项目：本插件是开源的，代码仓库位于：https://github.com/Block2Block/HubParkour
• 问题与建议：欢迎在 GitHub 上提交错误报告或功能建议。
• Discord 社区：加入 Discord 是获取支持、提出建议和报告漏洞的最佳方式。
• 插件评价：如果你喜欢这个插件，请留下评价！但请注意，请不要在评价区提交错误报告，请使用 GitHub 问题跟踪器。