TabListExtension

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

Mod Function

• TAB List Extension enhances the vanilla TAB overlay with Mixins: a colored dimension label appears before each player name, and ping can be numeric, vanilla bars, or both.
• The server only synchronizes UUIDs and dimension IDs; ping comes from client-side PlayerInfo.latency.

Key Features

• Colored labels: Green Overworld, red Nether, purple End; resource-defined colors for other dimensions and unique bright random colors for unknown IDs.
• Editable names and colors: The standalone mapping is grouped by locale; client resource packs can contribute names or colors.
• Three ping styles: Number, vanilla icon, or both, with two numeric color thresholds.
• Optional GUI: Cloth Config Forge 11.1.136 provides client display settings in the Mods screen.

Technical Architecture

• PlayerTabOverlayMixin preserves the vanilla layout while adding dimension labels and ping options.
• DimensionTranslations reads language assets; DimensionNameStore persists the mapping and reconciles colors across locales.
• DimensionChannel and ServerDimensionSync synchronize dimension IDs, client state uses UUID keys, and Forge ConfigSpec manages TOML files.

Why Choose This Mod

If you need:

• More intuitive understanding of player distribution on the server
• Real-time monitoring of player network connection quality
• Highly customizable TAB list display effects
• Stable and reliable client-server data synchronization
• Smooth experience without cache issues

This mod is exactly what you need. It not only provides visual improvements but also ensures optimal performance and compatibility through technical innovation.

Installation and Usage

1. Client-side: Place the mod jar in client mods/.
2. Server-side (recommended for multiplayer): Install the same version to synchronize other players’ dimensions; client-only installation still displays ping and the local player’s dimension.
3. Configuration: On first launch, config/tablistextension/ contains tablistextension-client.toml for display, tablistextension-common.toml for sync timing, and tablistextension-dimension-names.json for localized names and colors. Existing TOML files are copied only when the new files do not exist; legacy customDisplayName entries are migrated without deleting the old mapping.
4. Usage: Open the TAB list (default Tab key). Restart the client or press F3+T after changing the mapping or resource packs.

The server also creates a locale-grouped mapping at config/tablistextension/tablistextension-dimension-names.json. After an administrator saves edits, the server checks for changes every [sync].intervalTicks (20 ticks by default) and sends the full mapping to connected clients; joining players receive it as well. Server names and colors take precedence only while connected and do not overwrite the client’s file. Invalid server files leave the last valid mapping in effect. Client and server must use compatible mod versions.

Client resource packs can add names or colors per dimension in assets/tablistextension/dimension_lang/<locale>.json. Entries use { "name": "Overworld", "color": "#55FF55" }; legacy string-only names remain supported. The standalone mapping uses the same entry structure under locale keys. Previously unseen dimensions are assigned unused colors when first displayed. On reload, changes from either source are reconciled; simultaneous edits favor the mapping. Bundled jar assets remain read-only. Leave the mapping’s _sources and _appliedColors synchronization records unchanged.

Technical Details

The mod uses modern architectural design:

• The server sends a dimension snapshot on login and checks changes every 20 ticks by default; the client clears its cache on disconnect.
• Restart the client or press F3+T after changing resource-pack or mapping values to refresh dimension labels and colors.

中文描述

模组功能

• 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.