
服务器排行榜
带可自定义HUD面板的服务器端玩家统计排行榜
服务器排行榜
带有可自定义客户端 HUD 面板和聊天命令的服务器端玩家统计排行榜。 无需服务器 tick 延迟即可追踪所有在线和离线玩家的游戏时长、死亡次数、生物击杀数和 PvP 击杀数。
这个模组有什么作用?
Server Leaderboard 从活动会话和已保存的 stats/<uuid>.json 文件中汇总原版玩家统计数据,计算全服排名,并通过轻量级的玻璃拟态 HUD 面板或聊天中展示。
1. 两种 HUD 显示样式
叠加层支持两种不同的视觉布局,可随时切换:
- 分类视图(样式 1):一张紧凑卡片,一次聚焦一个活动分类。显示分类名称、页数(
1/4)、排名 1–10 以及格式化数值。

- 完整表格视图(样式 2):一个全面的数据矩阵,以并排的列显示玩家名称和所有启用的分类(
Player、⏱ Playtime、💀 Deaths、🗡 Mob Kills、⚔ PvP Kills)。循环切换排序键会动态重新排列表格并高亮当前活动列。
2. 排名徽章与当前玩家行
- 排名徽章:第一名以金色 ① 徽章标记,第二名以白色 ② 徽章标记,第三名以青铜 ③ 标记,第 4 名及以后使用简洁的浅灰色数字。
- 当前玩家高亮:查看者自己所在的行以青色边框强调,并带有柔和的背景光晕。
- 未进前 10 固定行:如果查看者不在前 10 名内,面板底部会固定显示一个专属行,展示其在服务器中的准确排名和个人得分。
3. 游戏内 HUD 重定位
按下编辑键位进入交互式定位模式:
- 在 9 点屏幕网格上移动面板(左上、顶部居中、右上、左侧居中、居中、右侧居中、左下、底部居中、右下)。
- 脉动的霓虹准星框住面板,以指示活动边界框。
- 使用方向键重新定位,按
Enter或Esc保存。

4. 聊天命令
玩家可以直接在聊天中查看排名,无需打开 HUD:
/leaderboard time— 按总游戏时长排名的顶尖玩家。/leaderboard deaths— 按死亡次数排名的顶尖玩家。/leaderboard mob_kills— 按生物击杀数排名的顶尖玩家。/leaderboard player_kills— 按 PvP 击杀数排名的顶尖玩家。/leaderboard style <1|2>— 直接从聊天切换 HUD 显示模式。
聊天条目会显示玩家排名徽章、用户名、在线状态指示符(●)以及格式化得分。

默认控制与键位绑定
所有键位均可在标准的 Minecraft 控制菜单中重新绑定(Options -> Controls -> Key Binds -> Server Leaderboard):
| 操作 | 默认按键 | 描述 |
|---|---|---|
| 切换排行榜 | '(撇号) |
显示或隐藏 HUD 排行榜面板 |
| 切换分类 / 排序 | Caps Lock |
在样式 1 中循环切换活动分类,或在样式 2 中更改排序列 |
| 切换样式 | [(左方括号) |
在分类视图(1)和表格视图(2)之间切换 |
| 编辑位置 | ](右方括号) |
进入 9 点网格编辑模式(使用方向键移动,Enter/Esc 确认) |
配置
客户端设置(config/server_leaderboard-client.toml)
display_style(1–2,默认1):默认 HUD 样式(1 = 分类卡片,2 = 完整表格)。position(1–9,默认3):默认屏幕网格位置(3 = 右上角)。
服务器设置(config/server_leaderboard-server.toml)
enabled_categories(默认:["play_time", "deaths", "mob_kills", "player_kills"]):活动追踪分类的列表及显示顺序。hud_player_limit(1–20,默认10):HUD 叠加层上显示的前列玩家最大数量。command_player_limit(1–50,默认10):/leaderboard聊天命令输出的最大玩家数量。
服务器性能与缓存
在数百个玩家文件中计算全服排名可能带来磁盘 I/O 瓶颈。Server Leaderboard 实现了专用的线程安全缓存架构:
- 30 秒缓存 TTL:在线玩家统计数据被读入内存并缓存 30 秒(
ConcurrentHashMap),可消除高达 90% 的磁盘读取开销。 - 非阻塞后台更新:离线玩家文件加载不会阻塞主服务器 tick。
- 智能失效:玩家缓存条目会在玩家连接和断开时自动失效,以保持排名最新。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。