TAB 列表扩展

TAB 列表扩展

扩展TAB列表显示功能 Extended TAB list display

工具

TAB List Extension 模组描述 / TAB List Extension Mod Description

模组功能

  • TAB List Extension 通过 Mixin 增强原版 TAB 列表:在每个玩家名称前显示带颜色的维度标签,延迟可显示为数字、原版信号图标或两者。
  • 服务端仅同步 UUID 和维度 ID;ping 读取客户端 PlayerInfo.latency。

主要特点

  • 彩色标签:主世界绿色、下界红色、末地紫色;其他维度使用资源定义的颜色,未知 ID 获得独特的明亮随机颜色。
  • 名称和颜色可编辑:独立映射按语言分组;客户端资源包可提供名称或颜色。
  • 三种延迟样式:数字、原版图标或两者,并带有两个数字颜色阈值。
  • 可选 GUI:Cloth Config Forge 11.1.136 在模组界面中提供客户端显示设置。

技术架构

  • PlayerTabOverlayMixin 保留原版布局,同时添加维度标签和延迟选项。
  • DimensionTranslations 读取语言资源;DimensionNameStore 持久化映射并协调各语言之间的颜色。
  • DimensionChannel 和 ServerDimensionSync 同步维度 ID,客户端状态使用 UUID 键,Forge ConfigSpec 管理 TOML 文件。

为什么选择这个模组

如果您需要:

  • 更直观地了解玩家在服务器中的分布
  • 实时监控玩家网络连接质量
  • 高度可自定义的 TAB 列表显示效果
  • 稳定可靠的客户端-服务端数据同步
  • 无缓存问题的流畅体验

这个模组正是您所需要的。它不仅提供视觉改进,还通过技术创新确保最佳的性能和兼容性。

安装和使用

  1. 客户端:将模组 jar 放入客户端 mods/。
  2. 服务端(多人游戏推荐):安装相同版本以同步其他玩家的维度;仅客户端安装仍会显示延迟和本地玩家的维度。
  3. 配置:首次启动时,config/tablistextension/ 中包含用于显示的 tablistextension-client.toml、用于同步计时的 tablistextension-common.toml,以及用于本地化名称和颜色的 tablistextension-dimension-names.json。仅在不存在新文件时复制现有 TOML 文件;旧版 customDisplayName 条目会被迁移,且不会删除旧映射。
  4. 使用:打开 TAB 列表(默认 Tab 键)。更改映射或资源包后,请重启客户端或按 F3+T。

服务端还会在 config/tablistextension/tablistextension-dimension-names.json 创建按语言分组的映射。管理员保存修改后,服务端每 [sync].intervalTicks(默认 20 tick)检查一次更改,并向已连接客户端发送完整映射;新加入的玩家也会收到。服务端名称和颜色仅在连接期间优先,且不会覆盖客户端文件。无效的服务端文件会使最后有效的映射继续生效。客户端和服务端必须使用兼容的模组版本。

客户端资源包可在 assets/tablistextension/dimension_lang/<locale>.json 中按维度添加名称或颜色。条目使用 { "name": "Overworld", "color": "#55FF55" };仍支持旧版仅字符串名称。独立映射在语言键下使用相同的条目结构。首次显示以前未见的维度时,会为其分配未使用的颜色。重新加载时,任一来源的更改都会被协调;同时编辑时优先采用映射。内置 jar 资源保持只读。请保持映射中的 _sources 和 _appliedColors 同步记录不变。

技术细节

模组采用现代架构设计:

  • 服务端在登录时发送维度快照,默认每 20 tick 检查更改;客户端在断开连接时清除缓存。
  • 更改资源包或映射值后,重启客户端或按 F3+T 以刷新维度标签和颜色。

中文描述

模组功能

  • TAB List Extension 以 Mixin 局部增强原版 TAB 列表:在玩家名前显示带独立颜色的维度标签,并在延迟区域显示数字、原版图标或两者。
  • 服务端仅同步 UUID 和维度 ID;ping 读取客户端的 PlayerInfo.latency。

主要特点

  • 彩色维度标签:主世界绿色、下界红色、末地紫色;其他维度使用语言资源指定的颜色,未知维度获得未占用的随机亮色。
  • 名称与配色可编辑:独立映射文件按语言保存名称和颜色;客户端资源包也可补充维度名称或颜色。
  • 三种延迟样式:数字、原版信号图标、数字加图标;数字按两档阈值选择三种颜色。
  • 可选图形配置:安装 Cloth Config Forge 11.1.136 后可在模组列表编辑客户端显示选项。

技术架构

  • PlayerTabOverlayMixin 保留原版布局并增强维度标签与延迟显示。
  • DimensionTranslations 读取语言资源,DimensionNameStore 负责独立映射和跨语言颜色同步。
  • DimensionChannel 与 ServerDimensionSync 同步维度 ID,客户端按 UUID 保存;Forge ConfigSpec 管理 TOML。

为什么选择这个模组

如果您需要:

  • 更直观地了解服务器中玩家的分布情况
  • 实时监控玩家的网络连接质量
  • 高度可定制的TAB列表显示效果
  • 稳定可靠的客户端-服务端数据同步
  • 无缓存问题的流畅体验

这个模组正是您所需要的。它不仅提供了视觉上的改进,还通过技术创新确保了最佳的性能和兼容性。

安装和使用

  1. 客户端:将模组 jar 放入客户端 mods/。
  2. 服务端(联机推荐):安装同版本模组以同步其他玩家维度;仅客户端安装仍能显示延迟和本地玩家维度。
  3. 配置:首次启动后,在 config/tablistextension/ 中编辑 tablistextension-client.toml 调整显示项、编辑 tablistextension-dimension-names.json 调整各语言的维度名称与颜色;tablistextension-common.toml 管理同步间隔。旧目录中同名 TOML 会在新文件不存在时复制;旧映射文件中的 customDisplayName 会迁移,原文件不会删除。
  4. 使用:打开 TAB 列表(默认 Tab 键)查看增强效果。修改映射文件或资源包后,重启客户端或按 F3+T 重新加载。

服务端也会在 config/tablistextension/tablistextension-dimension-names.json 创建同样的按语言分组的映射文件。管理员修改并保存后,服务端按 [sync].intervalTicks(默认 20 tick)检测文件变化,并把完整映射推送给在线客户端;新玩家登录时也会收到映射。服务端条目的名称和颜色优先于客户端本地映射,但只覆盖当前连接的显示,断线后清除,不改写客户端文件。服务端文件无效时保留最近一次有效映射;客户端和服务端需使用兼容的模组版本。

客户端资源包可在 assets/tablistextension/dimension_lang/<locale>.json 中补充名称或颜色,按维度 ID 逐项覆盖。内置资源采用以下结构;旧版纯字符串名称仍可读取:

{
  "minecraft:overworld": { "name": "主世界", "color": "#55FF55" },
  "minecraft:the_nether": { "name": "下界", "color": "#FF5555" },
  "minecraft:the_end": { "name": "末地", "color": "#AA55FF" }
}

独立映射文件按语言分组,每个维度也使用 { "name": "...", "color": "#RRGGBB" }。未知维度首次显示时会写入映射文件,并分配未占用的颜色。修改映射文件中任一语言或资源包中的颜色后,重新加载会同步最终显示颜色;两者同时修改时以映射文件的人工修改为准。jar 内资源只读,不会被物理改写;映射文件的 _sources 和 _appliedColors 是同步记录,请勿手动编辑。

技术细节

模组使用现代化的架构设计:

  • 服务端登录时发送维度快照,默认每 20 tick 检查变化;客户端断开时清理维度缓存。
  • 资源或映射文件改动后重启客户端或按 F3+T 重新读取,TAB 标签直接使用合并后的名称和颜色。

贡献 / Contributing

欢迎提交Issue和Pull Request来改进这个模组。
Welcome to submit Issues and Pull Requests to improve this mod.