TAB List Extension 模组描述
模组功能
- TAB List Extension 通过 Mixins 增强原版 TAB 界面:每个玩家名称前显示彩色的维度标签,延迟(ping)可以以数字、原版图标或两者同时显示。
- 服务器仅同步 UUID 和维度 ID;延迟数据来自客户端的
PlayerInfo.latency。
主要特性
- 彩色标签:绿色主世界、红色下界、紫色末地;其他维度使用资源定义的颜色,未知 ID 则使用独特的明亮随机颜色。
- 可编辑的名称与颜色:独立映射按语言环境分组;客户端资源包可以提供名称或颜色。
- 三种延迟样式:数字、原版图标或两者兼有,并支持两个数字颜色阈值。
- 可选 GUI:Cloth Config Forge 11.1.136 在“模组”屏幕中提供客户端显示设置。
技术架构
PlayerTabOverlayMixin 在保留原版布局的同时添加维度标签和延迟选项。
DimensionTranslations 读取语言资产;DimensionNameStore 持久化映射并在不同语言环境中协调颜色。
DimensionChannel 和 ServerDimensionSync 同步维度 ID,客户端状态使用 UUID 作为键,Forge ConfigSpec 管理 TOML 文件。
为什么选择此模组
如果您需要:
- 更直观地了解服务器上玩家的分布情况
- 实时监控玩家的网络连接质量
- 高度自定义的 TAB 列表显示效果
- 稳定可靠的客户端-服务器数据同步
- 无缓存问题的流畅体验
那么这个模组正是您所需要的。它不仅提供了视觉上的改进,还通过技术创新确保了最佳的性能和兼容性。
安装与使用
- 客户端:将模组 jar 文件放入客户端的
mods/ 目录中。
- 服务端(多人游戏推荐):安装相同版本以同步其他玩家的维度信息;仅安装在客户端仍可显示延迟和本地玩家的维度。
- 配置:首次启动时,
config/tablistextension/ 包含用于显示的 tablistextension-client.toml、用于同步时间的 tablistextension-common.toml 以及用于本地化名称和颜色的 tablistextension-dimension-names.json。仅在不存在新文件时才会复制现有的 TOML 文件;旧的 customDisplayName 条目会被迁移,而不会删除旧映射。
- 使用:打开 TAB 列表(默认 Tab 键)。更改映射或资源包后,重启客户端或按
F3+T。
客户端资源包可以在 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列表显示效果
- 稳定可靠的客户端-服务端数据同步
- 无缓存问题的流畅体验
这个模组正是您所需要的。它不仅提供了视觉上的改进,还通过技术创新确保了最佳的性能和兼容性。
安装和使用
- 客户端:将模组 jar 放入客户端
mods/。
- 服务端(联机推荐):安装同版本模组以同步其他玩家维度;仅客户端安装仍能显示延迟和本地玩家维度。
- 配置:首次启动后,在
config/tablistextension/ 中编辑 tablistextension-client.toml 调整显示项、编辑 tablistextension-dimension-names.json 调整各语言的维度名称与颜色;tablistextension-common.toml 管理同步间隔。旧目录中同名 TOML 会在新文件不存在时复制;旧映射文件中的 customDisplayName 会迁移,原文件不会删除。
- 使用:打开 TAB 列表(默认 Tab 键)查看增强效果。修改映射文件或资源包后,重启客户端或按
F3+T 重新加载。
客户端资源包可在 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.
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
- Client-side: Place the mod jar in client
mods/.
- 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.
- 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.
- 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列表显示效果
- 稳定可靠的客户端-服务端数据同步
- 无缓存问题的流畅体验
这个模组正是您所需要的。它不仅提供了视觉上的改进,还通过技术创新确保了最佳的性能和兼容性。
安装和使用
- 客户端:将模组 jar 放入客户端
mods/。
- 服务端(联机推荐):安装同版本模组以同步其他玩家维度;仅客户端安装仍能显示延迟和本地玩家维度。
- 配置:首次启动后,在
config/tablistextension/ 中编辑 tablistextension-client.toml 调整显示项、编辑 tablistextension-dimension-names.json 调整各语言的维度名称与颜色;tablistextension-common.toml 管理同步间隔。旧目录中同名 TOML 会在新文件不存在时复制;旧映射文件中的 customDisplayName 会迁移,原文件不会删除。
- 使用:打开 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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧