[插件]ajLeaderboards 为几乎所有数据创建排行榜

ajLeaderboards
为几乎所有数据创建排行榜！

插件作者：ajgeiss0702
开源协议：GPL-3.0-only
项目地址：https://modrinth.com/plugin/ajleaderboards
源码仓库：https://github.com/ajgeiss0702/ajLeaderboards
Wiki 文档：https://wiki.ajg0702.us/ajleaderboards/
Discord 社区：https://discord.gg/GXv2F5sXCx

概述

ajLeaderboards 是一款基于 PlaceholderAPI 的排行榜插件，能够将服务器中任何返回数值的 PAPI 占位符转化为实时排行榜。无论是击杀数、挖矿量、游戏币余额，还是自定义统计指标，只要数据源能提供数字，就能生成对应的排行榜。

插件支持 1.8.x 至 1.21.x 及 26.1.x 的服务器版本，几乎可以确定在新版 Minecraft 发布后无需更新即可正常运行。

画廊预览
全息图排行榜

通过 DecentHolograms 等插件在游戏中悬浮展示，支持翻页交互。

Hologram Leaderboard
NPC 排行榜

借助 Citizens 插件，让 NPC 头顶或身旁直接显示排行榜内容。

NPC Leaderboard
告示牌 + 头颅排行榜

使用内置告示牌功能，自动渲染玩家头颅与排名数据，也支持盔甲架展示。

Sign/Head Leaderboard
交互式全息排行榜

结合 DecentHolograms 的分页功能，点击即可在不同时间维度（小时榜、日榜、月榜）之间切换。

Interactive Leaderboard

核心功能
通用数据接入
只要目标插件提供了返回数值的 PAPI 占位符，就能为其创建排行榜。无需插件专门适配，覆盖面极广。
多维度展示
全息图：搭配 DecentHolograms / 显示实体，悬浮于任意位置
告示牌：内置原生支持，完全可自定义格式
NPC：通过 Citizens 将排行榜挂载到 NPC 上
盔甲架：在盔甲架顶部渲染玩家头颅
任意 PAPI 支持位置：计分板、Boss 血条、聊天前缀等均可调用
玩家信息整合
自动读取 Vault 的前缀/后缀，在排行榜中展示玩家头衔
在告示牌与盔甲架上方渲染玩家头颅，增强辨识度
定时排行榜
支持按小时、天、周、月等周期自动重置的排行榜，与全时段总榜互不干扰。例如可同时拥有"今日击杀榜"和"历史总击杀榜"。
跨服数据同步
通过 MySQL 存储确保多台服务器间的排行榜数据一致（前提是目标占位符的数据本身也开启了同步）。
扩展占位符
"Extra" 占位符功能允许在排行榜旁额外展示任意 PAPI 文本，例如同时显示玩家的击杀数与死亡数。
Folia 兼容
原生支持 Folia 服务端，充分利用区域化多线程调度。

支持的平台与版本
服务端平台
Bukkit / Spigot / Paper / Folia / Purpur
Minecraft 版本
1.8.8 - 1.8.9、1.9.x - 1.21.x、26.1.x、26.2

几乎涵盖所有仍在使用的 Java 版服务端版本。

安装与快速上手
前置依赖
PlaceholderAPI（必须）：提供数值数据源，是插件运行的基础
Vault（可选）：用于读取玩家前缀/后缀
DecentHolograms（可选）：用于全息图展示
Citizens（可选）：用于 NPC 展示
安装步骤
下载 ajLeaderboards 的 jar 文件，放入 plugins/ 目录
确保 PlaceholderAPI 已安装并启用
启动或重启服务器，等待插件生成配置文件
使用 /ajLeaderboards add <名称> <PAPI占位符> 命令注册第一个排行榜
玩家加入服务器后会被自动收录进排行榜
显示排行榜
PAPI 占位符方式：通过 \%ajleaderboards_xxx% 系列占位符，将排行榜嵌入任意支持 PAPI 的位置
内置告示牌方式：在游戏中直接放置告示牌并写入对应指令，即可自动渲染

详细配置说明请参阅 Wiki 的安装指南。

常用命令

| 命令 | 说明 |
| :--- | :--- |
| /ajLeaderboards add <名称> <占位符> | 注册一个新的排行榜 |
| /ajLeaderboards remove <名称> | 删除已有排行榜 |
| /ajLeaderboards list | 列出所有已注册的排行榜 |
| /ajLeaderboards reload | 重载配置文件 |
完整占位符列表与告示牌语法请查阅 Wiki。

数据库配置

插件默认使用本地文件存储，单服开箱即用。如需跨服同步，请在配置文件中切换为 MySQL：

storage:
type: mysql
host: "127.0.0.1"
port: 3306
database: "ajleaderboards"
username: "root"
password: "your_password"
table_prefix: "ajlb_"

跨服部署时，所有节点必须连接同一个 MySQL 实例并使用相同的表前缀。

版本说明
正式版
从 Modrinth 主下载按钮或 SpigotMC 获取，经过完整测试，适合生产环境。
预发布版（Pre-Release / Dev Build）
基于 dev 分支构建，可能包含未测试或不稳定的改动。
下载渠道：Modrinth 的 Versions 标签页、Voxel.shop（原 Polymart）
版本号末尾带有构建号，例如 2.10.1-b320
SpigotMC 不提供独立的预发布下载通道

获取支持

在寻求技术支持前，请先查阅 FAQ。

如仍有问题，可通过以下方式联系作者（推荐优先使用 Discord）：
Discord：https://discord.gg/GXv2F5sXCx
Spigot 私信：向 ajgeiss0702 发送站内信
Spigot 讨论帖：在插件发布帖中回复
邮件：plugin-support@ajg0702.us

Discord 服务器内还提供 AI 辅助支持，可直接访问 Wiki 最新内容，响应迅速且准确。

数据统计

插件通过 bStats 收集匿名的运行数据（如服务器版本、玩家数量等），用于了解使用规模与版本分布。可在 bStats 配置文件中关闭此功能。

帖子制作 by LT-YHC