AlonsoLeaderboards • Signs! Heads! Armorstands! NPC! Placeholders! DeveloperAPI! - AlonsoLeaderboards - 排行榜插件

AlonsoLeaderboards 是一款高度可自定义的排行榜插件，支持通过 PlaceholderAPI 创建基于数值的排行榜，并提供 NPC、盔甲架、头颅显示等多种展示方式。开发者可轻松集成其 API 为自有插件添加排行榜功能。

💡重要须知

• 请尊重作者劳动成果，严禁在任何情况下重新分发本插件。
• 严禁在 MCBBS 或类似论坛发布、搬运或复制本插件内容。
• 如果您在其他论坛发现此插件，请向作者举报。
• 异步模式（Async mode for placeholders）目前处于 BETA 阶段，许多插件可能不支持，不建议使用。

🎮核心特性

多种展示方式（BETA）

• 头颅支持：可在告示牌后方或上方的方块上显示玩家头颅。
• 盔甲架支持：可在盔甲架上显示玩家头颅，模拟知名网络服务器的效果。
• NPC 支持（需 Citizens2）：可使用 NPC 显示排行榜，并支持自定义皮肤与名称。
• 库存（GUI）支持：可在美观的图形界面中查看玩家头颅，支持自定义大小与槽位。
• 全息显示支持（需 HolographicDisplays、HolographicExtension 和 ProtocolLib）：可通过简单命令创建基础全息排行榜。

强大的排行榜功能

• 基于 PlaceholderAPI：可使用任何返回数字/双精度浮点数的占位符创建排行榜。
• 关联占位符（Linked placeholder）：可基于一个占位符（数值）排序，但显示另一个占位符的内容（如格式化后的余额 20k、150M）。适用于等级、排名、ELO 等系统。
• 支持字符串：不仅限于数字。
• 更新效果：开发者可选择在更新排行榜时在告示牌位置生成粒子等效果。
• 空位显示：当无数据或槽位为空时，会显示染色玻璃板作为占位。
• 即时更新：首次创建排行榜时会立即更新。

保护与自定义

• 告示牌保护（BETA）：防止玩家直接破坏告示牌（不防爆炸或破坏附着方块，建议搭配 WorldGuard 等保护插件）。
• 盔甲架保护（BETA）：防止玩家破坏盔甲架。
• 头颅保护（BETA）：防止玩家破坏头颅。
• 高度可定制：几乎所有内容均可通过配置文件调整。
• 命令别名：可为主命令设置别名（主命令 /pluginname 始终有效）。

开发者友好

• 易于使用的 API：开发者可轻松集成并为自己的插件添加排行榜。
• 原生占位符支持：便于获取数据。
• “固定”占位符：当未找到排名时返回占位符本身（供开发者使用）。
• 配置自动更新：插件更新时配置文件会自动更新（注释会被移除）。
• 更新检查器：有新版本时获得通知。

🔧安装与配置

安装步骤

• 从 SpigotMC.org 下载插件。
• 将 JAR 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 按需编辑配置文件（如 config.yml）。
• 再次重启服务器。

配置与权限

• 权限可在配置文件中进行配置。
• 详细命令、权限及原生支持插件列表，请查看我们的 Github。

❓常见问题

• 为什么许多功能标记为 BETA？ 这并不代表有 Bug，仅是作者偏好使用的标签。
• 我可以使用它吗？

- **非开发者**：如果您使用的插件原生支持 AlonsoLeaderboards，直接安装即可。否则，也可利用 PlaceholderAPI 创建基于数值的排行榜。

- **开发者**：可以，我们提供了易于使用的 API。请查看 [Github 上的开发指南](https://github.com/AlonsoAliaga/AlonsoLeaderboards)。

• 支持哪些插件？ 技术上支持任何通过 PlaceholderAPI 返回数字/双精度浮点数的插件。原生支持列表见 Github。
• 如何报告 Bug 或请求功能？ 请加入 Discord 或使用 Issue 跟踪器。请不要在评论区域报告错误。
• 如何支持作者？ 可以加入 Discord 分享插件、请求 YouTuber 评测，或进行捐赠。

⭐使用教程

• 放置排行榜：请遵循相关教程。
• 创建排行榜：请遵循相关教程。
• 创建关联排行榜：请遵循相关教程。
• 为您的插件添加排行榜：请查看 开发指南。

✨测试版本

插件已在以下 Minecraft 版本测试通过

• 1.8.8, 1.9.2, 1.10.2, 1.11.2, 1.12.2
• 1.13.2, 1.14.4, 1.15.2, 1.16.2

🔧条款与条件

下载即表示您同意以下条款

• 禁止以任何形式重新分发本插件（包括作为任何软件包的一部分）。
• 禁止以任何形式反编译或修改本插件。
• 禁止声称本资源是您自己的创作。