TD排行榜

TD排行榜

TD排行榜将标准的多人游戏玩家列表转换为服务器权威的统计排行榜。它提供了按住TAB键时显示的紧凑排名，以及一个用于浏览和比较玩家统计数据的详细全屏界面。

功能特性

• 用紧凑的实时排行榜替换标准TAB玩家列表。
• 通过/tdleaderboard打开详细的全屏排行榜。
• 按死亡次数、步行距离或总旅行距离对玩家进行排名。
• 支持升序和降序排序。
• 允许玩家选择可见的统计列。
• 提供分页，每页最多显示50个条目。
• 可将已知的离线玩家包含在排名中。
• 显示稳定的排名，并使用确定性平局决胜规则。
• 自动刷新实时统计数据。
• 本地存储每位玩家的显示偏好。
• 包含英语和德语翻译。
• 提供响应式布局、状态消息、提示工具和屏幕叙述。

可用统计指标

死亡次数

使用Minecraft标准的minecraft:deaths统计数据。

步行距离

合并了行走、冲刺和潜行时的移动距离。

总距离

合并了步行、游泳、攀爬、坠落、飞行、鞘翅飞行、水中移动以及支持的载具或坐骑移动。

Minecraft以厘米为单位存储距离。TD排行榜将其显示为可读的米或公里值，而不会修改原始统计数据。

在线与离线玩家

已连接玩家根据其当前的服务器端统计数据进行排名。

当服务器启动时，TD排行榜会在后台读取现有的原版统计文件。只有当服务器同时拥有可读取的统计文件和该UUID的本地缓存的玩家名称时，离线玩家才会出现。

可以从全屏排行榜中启用或禁用离线玩家。排名会重新计算以匹配所选玩家范围。

TD排行榜不会联系外部配置文件服务。无法读取的统计文件或无法解析的玩家档案将被跳过，而不会阻止其余排行榜数据的加载。

服务器权威设计

所有统计、排名和玩家身份均由服务器计算和验证。客户端仅选择诸如排序、可见列以及是否包含已知离线玩家等展示选项。

该模组不会修改原版统计数据或世界数据，不会为了排名加载区块，也不需要数据库或外部统计服务。

需求条件

• Minecraft 1.21.1
• NeoForge 21.1.249 或更高版本（在21.1系列内）
• Java 21
• 客户端和服务器均需安装TD排行榜

双方必须安装相同版本的TD排行榜。版本1不支持仅服务器安装。

支持的NeoForge版本为21.1.249或更高，但低于21.2。

安装步骤

1. 为Minecraft 1.21.1安装NeoForge。
2. 将TD排行榜JAR文件放入每个客户端的mods文件夹。
3. 将相同的JAR文件放入服务器的mods文件夹。
4. 完全重启客户端和服务器。

无需额外的模组或外部服务。

使用方法

• 按住TAB键显示紧凑排行榜。
• 运行/tdleaderboard打开全屏视图。
• 选择一项指标以更改排序列。
• 在升序和降序之间更改排序方向。
• 切换显示已知离线玩家。
• 选择应显示的指标列。

至少必须保持一个指标列可见。

客户端配置

显示偏好保存在：

config/tdleaderboard-client.toml

默认情况下，死亡次数、步行距离和总距离可见。排行榜按死亡次数降序排序，且隐藏离线玩家。

当前限制

• 没有经济、账户余额或TDEconemy集成。
• 没有外部数据库或基于网页的统计。
• 没有针对个人显示偏好的服务器全局配置。
• 客户端和服务器必须使用匹配的模组版本。

支持

报告问题时，请包括：

• TD排行榜版本
• Minecraft版本
• NeoForge版本
• 问题发生在客户端、服务器还是双方
• 相关的日志消息
• 复现问题的步骤