服务器排行榜

服务器排行榜

带可自定义HUD面板的服务器端玩家统计排行榜

服务器排行榜

带有可自定义客户端 HUD 面板和聊天命令的服务器端玩家统计排行榜。 无需服务器 tick 延迟即可追踪所有在线和离线玩家的游戏时长、死亡次数、生物击杀数和 PvP 击杀数。


这个模组有什么作用?

Server Leaderboard 从活动会话和已保存的 stats/<uuid>.json 文件中汇总原版玩家统计数据,计算全服排名,并通过轻量级的玻璃拟态 HUD 面板或聊天中展示。

1. 两种 HUD 显示样式

叠加层支持两种不同的视觉布局,可随时切换:

  • 分类视图(样式 1):一张紧凑卡片,一次聚焦一个活动分类。显示分类名称、页数(1/4)、排名 1–10 以及格式化数值。HUD overlay in Category View showing playtime ranking mob kills  rank
  • 完整表格视图(样式 2):一个全面的数据矩阵,以并排的列显示玩家名称和所有启用的分类(Player、⏱ Playtime、💀 Deaths、🗡 Mob Kills、⚔ PvP Kills)。循环切换排序键会动态重新排列表格并高亮当前活动列。all ranks

2. 排名徽章与当前玩家行

  • 排名徽章:第一名以金色 ① 徽章标记,第二名以白色 ② 徽章标记,第三名以青铜 ③ 标记,第 4 名及以后使用简洁的浅灰色数字。
  • 当前玩家高亮:查看者自己所在的行以青色边框强调,并带有柔和的背景光晕。
  • 未进前 10 固定行:如果查看者不在前 10 名内,面板底部会固定显示一个专属行,展示其在服务器中的准确排名和个人得分。

3. 游戏内 HUD 重定位

按下编辑键位进入交互式定位模式:

  • 在 9 点屏幕网格上移动面板(左上、顶部居中、右上、左侧居中、居中、右侧居中、左下、底部居中、右下)。
  • 脉动的霓虹准星框住面板,以指示活动边界框。
  • 使用方向键重新定位,按 Enter 或 Esc 保存。
Interactive positioning mode showing corner reticle markers and keyboard navigation hints

4. 聊天命令

玩家可以直接在聊天中查看排名,无需打开 HUD:

  • /leaderboard time — 按总游戏时长排名的顶尖玩家。
  • /leaderboard deaths — 按死亡次数排名的顶尖玩家。
  • /leaderboard mob_kills — 按生物击杀数排名的顶尖玩家。
  • /leaderboard player_kills — 按 PvP 击杀数排名的顶尖玩家。
  • /leaderboard style <1|2> — 直接从聊天切换 HUD 显示模式。

聊天条目会显示玩家排名徽章、用户名、在线状态指示符(●)以及格式化得分。

Chat command output showing /leaderboard time rankings with online status dots

默认控制与键位绑定

所有键位均可在标准的 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。
  • 智能失效:玩家缓存条目会在玩家连接和断开时自动失效,以保持排名最新。