LeaderBoard 排行榜

侧边栏轮播计分板 + 玩家头顶排名 + 全服首成成就榜，零依赖，MIT 开源

作者：TinyAII　版本：1.0.0　一路通吃：Spigot/Paper 1.16 ~ 26.x　依赖：无前置

给服务器装上多维度排行榜，侧边栏自动轮播各榜单 Top 10，玩家头顶显示自己的实时名次，全服首个达成关键成就的玩家永久载入"首成榜"。一台 jar 从 1.16 服到 26.x，老服新服都吃得下。

---

功能一览

功能	说明
侧边栏轮播	每 N 秒自动切到下一个榜单（默认 15 秒），Top 10 排行实时显示，底部显示"你排第几"
9 个数据榜	挖石头／挖钻石／挖泥土／死亡数／等级／击杀数／在线时长，每个可单独开关
全服首成榜	第一个击杀末影龙、第一个挖到钻石、第一个穿戴钻石甲、第一个死亡，永久记录（全服广播）
玩家头顶标签	头顶显示 [#名次] 名字 榜单×值，玩家可 /榜 头顶 <名字> 切换看哪张榜
在线时长统计	按累计在线小时计，每 60 秒自动累加一次
数据持久化	每 5 分钟自动落盘 data.yml，重启不丢，支持手动重置
方块分类可配	石头/钻石/泥土分类的源方均可配置，想加可鉴赏沙岩/凝灰岩随便加
热重载	/榜 重载 不重启服直接重新读配置
零依赖	不需要 ProtocolLib、不需要 Vault，丢进 plugins 即用

安装

把 leaderboard-1.0.0.jar 丢进服务器的 plugins/ 目录，启动（或重启）服务器一次即可。首次启动会自动生成 plugins/LeaderBoard/config.yml 和 data.yml。

Java 版本：MC 1.16 ~ 1.21.x 用 Java 17+/21；MC 26.x 需 Java 25+。

命令

命令	权限	说明
/榜 帮助	所有玩家	查看帮助
/榜 查看 [榜单名]	所有玩家	查看完整排行（默认看第一张开着的榜）
/榜 侧边 [开/关]	所有玩家	开关自己的侧边栏显示
/榜 头顶 <榜单名>	所有玩家	切换自己头顶标签显示哪张榜
/榜 间隔 <秒>	OP	设置侧边栏轮播间隔秒数
/榜 重置 <榜单名>	OP	重置某张榜的数据
/榜 重载	OP	热重载配置（不重启服）

别名：/榜 = /leaderboard = /lb = /排行榜 = /排行

配置（config.yml）

sidebar:
  enabled: true              # 侧边栏总开关
  top: 10                    # 每个榜显示前几名
  cycle-seconds: 15          # 轮播间隔秒数
  refresh-ticks: 20          # 刷新频率（20=1秒）
  show-my-rank: true         # 底部显示"你排第几"
  cycles: [stone, diamond, dirt, death, level, kills, playtime, firsts]  # 轮播顺序
  title-color: '&6'

head-tag:
  enabled: true              # 头顶标签开关
  default-board: stone       # 默认头顶显示哪张
  format: '&e[#{rank}] &f{name} &7{board}×{value}'

enabled-boards:              # 开了的榜才统计、轮播、可查看
  stone: true
  diamond: true
  dirt: true
  death: true
  level: true
  kills: true
  playtime: true

block-categories:            # 方块分类（可自定义扩展）
  stone: [STONE, COBBLESTONE, GRANITE, DIORITE, ANDESITE, DEEPSLATE, ...]
  diamond: [DIAMOND_ORE, DEEPSLATE_DIAMOND_ORE]
  dirt: [DIRT, GRASS_BLOCK, SAND, GRAVEL, RED_SAND, PODZOL, ...]

playtime:
  minute-add-seconds: 60     # 每 60 秒按分钟累加在线时长

data:
  autosave-minutes: 5        # 每 5 分钟自动落盘

只轮播一张榜的方法：把 sidebar.cycles 压成 1 个元素，例如 cycles: [stone]，侧边栏就只显示石头榜不轮播。

首成榜的内容

标识	全服广播文本
first-dragon	"第一个击杀末影龙"
first-diamond	"第一个挖到钻石"
first-diamond-armor	"第一个穿戴钻石甲之人"
first-death	"第一个死亡的倒霉蛋"

首成榜只记全服第一个达成的人，永久记录（不会因后来人而改），每次有人达成时整服广播。

兼容性

维度	支持
服务端	Paper / Spigot（推荐 Paper）
MC 版本	1.16 ~ 26.x（用 spigot-api 1.16.5 编译 + api-version 1.16，纯 Bukkit API）
Java	21+（MC 1.21.x）；25+（MC 26.x）
前置依赖	无
数据持久化	YAML（data.yml）

FAQ

Q：能不能只看好朋友排名？　A：一轮只显示 Top 10，但底部会显示你自己当前排名（哪怕你在 100 名也显示"你排第 11"）。整个完整榜单用 /榜 查看。

Q：服务器老（1.16）能用吗？　A：能。本插件用 spigot-api 1.16.5 编译加 api-version: 1.16，一路通吃 1.16~26.x。

Q：可以加自定义榜单吗？　A：配置文件可以加自定义方块分类，但榜单的逻辑（石头榜统计挖石头方块）需要源码扩展——欢迎提 PR，本插件 MIT。

---

LeaderBoard

Sidebar cycling scoreboard + player head ranking tags + server-wide "first to achieve" milestones. Zero dependencies, MIT open source.

Author: TinyAII　Version: 1.0.0　Supports: Spigot/Paper 1.16 ~ 26.x　Dependencies: None

Install multi-dimensional leaderboards on your server. The sidebar automatically cycles through Top 10 boards every N seconds, players get a real-time rank tag above their heads, and the first player to achieve each key milestone is permanently inscribed into the "firsts" board. One jar, 1.16 through 26.x.

---

Features

Feature	Description
Sidebar cycling	Auto-switches boards every N seconds (default 15s), shows Top 10, with "You're #N" footer
9 statistic boards	Stone mined / Diamond mined / Dirt mined / Deaths / Level / Kills / Online hours
Server-wide firsts	First to kill Ender Dragon / first to mine a diamond / first to wear diamond armor / first death — permanent record, server-broadcast
Player head tag	Shows [#rank] name board×value above head; players can /lb head <board> to switch
Online time tracking	Accumulates online hours, added every 60 seconds
Persistence	Auto-saves to data.yml every 5 minutes; survives restart; manual reset supported
Configurable categories	Stone / Diamond / Dirt block lists fully configurable
Hot reload	/lb reload without server restart
Zero dependencies	No ProtocolLib, no Vault, just drop in

Install

Drop leaderboard-1.0.0.jar into plugins/, start (or restart) once. First start auto-generates plugins/LeaderBoard/config.yml and data.yml.

Java: MC 1.16–1.21.x → Java 17+/21; MC 26.x requires Java 25+.

Commands

Command	Permission	Description
/lb help	all	Show help
/lb view [board]	all	View full leaderboard
/lb sidebar [on/off]	all	Toggle own sidebar
/lb head <board>	all	Switch which board your head tag shows
/lb interval <sec>	OP	Set sidebar cycle interval (seconds)
/lb reset <board>	OP	Reset a board's data
/lb reload	OP	Hot-reload config

Aliases: /lb = /leaderboard = /榜 = /排行榜

Config (config.yml)

See Chinese section above — full config.yml is identical. Key sections: sidebar (cycle list, top N, interval), head-tag (default board, format), enabled-boards (which boards count/rotate), block-categories (configurable source blocks), playtime, data.

Firsts Board

Records the first player server-wide to: slay the Ender Dragon / mine a diamond / wear diamond armor / die. Permanent, server-broadcast on each.

Compatibility

Aspect	Support
Server	Paper / Spigot (Paper recommended)
MC	1.16 ~ 26.x (spigot-api 1.16.5 + api-version 1.16, pure Bukkit API)
Java	21+ (1.21.x); 25+ (26.x)
Dependencies	None
Storage	YAML (data.yml)

---

Author

TinyAII · MIT License · Zero dependencies

Made with care. Open source under MIT — feel free to fork, extend, and PR.