Better Tablist

模组

· 作者 SenNerd

一个可定制的服务器端标签列表,支持动画表头和表尾、等级前缀、玩家状态以及实时服务器统计信息。

0 本站下载 0 关注 更新于 3 天前

最新 1.7 · 26.3 · NeoForge

一键开服(送7天)

一个可自定义的服务端标签页列表,支持动态标题与页脚、角色前缀、玩家状态以及实时服务器统计信息。

仅安装在服务器上。 玩家使用原版客户端即可加入。LuckPerms、FTB Ranks 和 spark 为可选依赖。

亮点

🎨 颜色与渐变 支持 & 代码、&#RRGGBB 十六进制颜色以及两种渐变语法,同时保持粗体、斜体等其他格式不变。
🎞️ 动态标题与页脚 任意数量的帧自动循环播放,速度由你决定。
🏷️ 丰富的玩家名称 每个名称旁边显示维度符号、含吸收值的生命值、延迟、游戏模式和 AFK 状态。
👑 角色等级 可选的 LuckPerms 前缀、后缀和分组,或 FTB Ranks,并支持按角色权重排序。
📈 实时服务器统计 带颜色编码的 TPS、MSPT 和 CPU、内存及运行时间;若安装了 spark,则提供滚动平均值和百分位数。
💤 AFK 检测 玩家在配置的空闲时间后名称变灰并显示 #AFK。
⚡ 轻量级 仅在内容变化时发送数据包,且所有玩家的指标在每次更新时仅采样一次。
🔁 热重载 编辑 config/tablist.toml 并运行 /tablist reload,无需重启服务器。

支持版本

Minecraft Fabric NeoForge Java
26.1 – 26.3 (26.1, 26.1.1, 26.1.2, 26.2, 26.3) ✅ ✅ 25
1.21 – 1.21.11 (所有版本) ✅ ✅ 21

每个 Minecraft 发布版本都有对应加载器的独立 JAR 文件。请选择与你的服务器确切 Minecraft 版本匹配的文件。

安装

  1. 下载 适用于你的服务器 Minecraft 版本和加载器 的 JAR 文件。
  2. 将其放入服务器的 mods/ 文件夹中。Fabric 服务器还需要 Fabric API。
  3. 启动服务器一次以生成 config/tablist.toml。
  4. 设置 server_name,然后自定义标题、页脚和玩家名称,或者从 示例 开始。
  5. 作为操作员(权限等级 2)运行 /tablist reload,或者重启服务器。

示例

每个示例都是完整且即插即用的配置。将其复制到 config/tablist.toml 并运行 /tablist reload。所有截图均来自真实的 Minecraft 26.3 服务器。

渐变展示

粗体渐变标题、个性化欢迎语和紧凑的状态页脚。

Gradient showcase example
显示配置 · gradient-showcase.toml
[appearance]
server_name = "Aurora SMP"
header = [
    "#N<gradient:#FF5F6D:#FFC371>&l✦ #SERVERNAME ✦</gradient>&r#N&7Welcome back, &f#PLAYERNAME&7!#N"
]
footer = [
    "#N&7Online &f#PLAYERCOUNT&8/&f#MAXPLAYERS  &8┃  &7Ping &f#PING ms  &8┃  &7TPS #CTPS#N<gradient:#4FACFE:#00F2FE>play.example.net</gradient>#N"
]
name_formatting_provider = "NONE"
display_name_format = "{dimension} &f{name} {health} &7#AFK"

[sorting]
sort_mode = "ALPHABETICAL"

性能仪表盘

面向管理员和整合包服务器的实时、彩色编码服务器健康状况。安装 spark 并设置 metrics_provider = "SPARK" 以获取滚动的 TPS 和 MSPT 百分位数。

Performance dashboard example
显示配置 · performance-dashboard.toml
[appearance]
server_name = "Aurora SMP"
header = [
    "#N&#4FACFE&lSERVER MONITOR#N&8#DATE  #TIME#N"
]
footer = [
    "#N&7TPS #CTPS  &8│  &7MSPT #CMSPT  &8│  &7CPU #CCPU#N&7Memory &f#MEMORY  &8│  &7Uptime &f#UPTIME#N"
]
name_formatting_provider = "NONE"
display_name_format = "&f{name} &8[&7{ping}ms&8]"
update_interval = 1000

[performance]
metrics_provider = "VANILLA"

生存模式状态

每个名称一目了然地显示玩家的维度、生命值、延迟和游戏模式。

Survival status example
显示配置 · survival-status.toml
[appearance]
server_name = "Aurora SMP"
header = [
    "#N&a&l#SERVERNAME &r&7— Survival#N"
]
footer = [
    "#N&7You are in &f#WORLD &7with #HEALTH#N"
]
name_formatting_provider = "NONE"
display_name_format = "{dimension} &e{name} &8│ {health} &8│ &7{ping}ms &8│ &7{gamemode} &7#AFK"

[afk]
afk_enabled = true
afk_timeout = 300

动态与极简

三个每约 2 秒切换一次的标题帧,除此之外别无其他。

Animated and minimal example
显示配置 · animated-minimal.toml
[appearance]
server_name = "Aurora SMP"
header = [
    "#N&f&l#SERVERNAME#N",
    "#N&#FFC371&l#SERVERNAME#N",
    "#N&#FF5F6D&l#SERVERNAME#N"
]
footer = [
    "#N&7#PLAYERCOUNT online  &8·  &7discord.gg/example#N"
]
name_formatting_provider = "NONE"
display_name_format = "&f{name}"
update_interval = 500
animation_interval = 4

配置

所有设置均位于 config/tablist.toml 中。文本值请保留引号,开关项使用未加引号的 true / false,并编辑现有部分,而不是添加第二个 [appearance]。

区块 控制内容
[appearance] 服务器名称、页眉/页脚帧、玩家名称格式、排名提供者、刷新间隔
[sorting] 玩家排序方式:NONE(无)、ALPHABETICAL(按字母)或 RANK(按排名)
[afk] AFK 检测及其超时时间,单位为秒(300 = 5 分钟)
[performance] 性能指标来源:VANILLA(原版)或 SPARK

现有配置保持兼容。你的名称和格式设置会被保留,当缺少 name_formatting_provider 时,旧的 ftbranks.enable_ftbranks_formatting 设置将用于选择提供者。

页眉与页脚

每个引号内的项代表一个动画帧。在帧内使用 #N 换行。

  • 一项: 静态文本。两项或以上: 动画效果。[]: 隐藏页眉或页脚。
  • update_interval = 500 每 500 毫秒刷新一次。
  • animation_interval = 4 每 4 次刷新切换一次帧,在默认刷新率下约为 2 秒。

玩家名称

在 [appearance] 中设置 name_formatting_provider 和 display_name_format:

设置 name_formatting_provider display_name_format
纯文本名称 "NONE" "{name} &7#AFK"
维度与健康值 "NONE" "{dimension} {name} {health} &7#AFK"
LuckPerms "LP" "{prefix}{name}{suffix}&r &7#AFK"
FTB Ranks "FTB" "[{rank}] {name} &7#AFK"

在使用 FTB Ranks 时,玩家的 ftbranks.name_format 权限设置优先级高于你的自定义格式。选择 NONE 可始终使用配置文件中的格式。为了兼容性,默认提供者为 FTB,即使未安装任何排名模组,该模组也能正常运行。

排序与 Spark

[sorting]
sort_mode = "RANK" # NONE, ALPHABETICAL 或 RANK

[performance]
metrics_provider = "SPARK" # VANILLA 或 SPARK

RANK 排序依据是继承的 LuckPerms 组权重最高值或 FTB 排名强度,若相同则按字母顺序排列。已加入其他记分板队伍的玩家将保留在原队伍中。滚动 TPS 和 MSPT 百分位数需要安装 spark。若未安装,TPS/MSPT/CPU 使用将依赖内置测量值,且滚动统计数据显示为 N/A。

占位符

涉及玩家的特定值指的是查看标签页列表的玩家。这些占位符可在页眉、页脚和 display_name_format 中使用。

服务器与玩家占位符
占位符 描述
#N 换行
#SERVERNAME 配置文件中的服务器名称
#PLAYERCOUNT / #MAXPLAYERS 在线玩家数 / 最大玩家槽位数
#PLAYERNAME 当前查看者的玩家名称
#PING 玩家延迟(毫秒)
#RANK 来自选定提供者的 FTB 排名或 LuckPerms 主组
#AFK 玩家处于 AFK 状态时显示 AFK,否则为空
#WORLD 玩家当前所在维度
#DIMENSION 带颜色的维度符号(Ⓦ / Ⓝ / Ⓔ),或自定义维度名称
#HEALTH 生命值 + 吸收值,例如 [20❤](20 点生命值 = 10 颗心)
#DATE / #TIME 实际日期 (yyyy-MM-dd) / 时间 (HH:mm)
性能占位符
占位符 描述
#TPS / #CTPS 预估 TPS(原版)或 1 分钟平均 TPS(Spark),普通颜色 / 彩色
#MSPT / #CMSPT 每刻毫秒数,普通颜色 / 彩色
#CPU / #CCPU 服务器进程 CPU 占用率,普通颜色 / 彩色
#TPS_1M / #CTPS_1M 1 分钟平均 TPS,普通颜色 / 彩色(需 Spark)
#TPS_5M / #CTPS_5M 5 分钟平均 TPS,普通颜色 / 彩色(需 Spark)
#MSPT_P95 / #CMSPT_P95 1 分钟 MSPT 的第 95 百分位数,普通颜色 / 彩色(需 Spark)
#MEMORY 内存使用情况(已用 / 最大)
#UPTIME 服务器运行时长

颜色根据阈值变化:TPS ≥18 / ≥15 / <15,MSPT ≤40 / ≤50 / >50,CPU ≤60% / ≤85% / >85%。原版 TPS 基于平均 tick 时间估算。不支持的测量值显示为 N/A。

玩家名称占位符
占位符 描述
{name} 玩家名称
{rank} FTB 排名或 LuckPerms 主组
{prefix}, {suffix} 玩家当前上下文中的 LuckPerms 前缀 / 后缀
{primary_group} LuckPerms 主组
{dimension} 带颜色的维度符号,或自定义维度名称
{health} 带颜色的生命值 + 吸收指示器
{world}, {ping}, {gamemode} 维度名称、延迟(毫秒)和游戏模式

{prefix}、{suffix} 和 {primary_group} 需要启用 LP 提供者。无法获取的集成值为空。AFK 检测通过观察移动、转向和聊天行为来实现。

颜色代码

语法 示例
标准代码 &a 绿色,&c 红色,&l 加粗,&o 斜体,&r 重置
十六进制颜色 &#FF5555
渐变(MiniMessage 风格,2+ 种颜色) <gradient:#FF0000:#FFAA00:#0000FF>text</gradient>
渐变(TAB 风格) <#FF0000>text</#0000FF>

初始配置文件

完整的初始配置文件

仅适用于全新设置。对于现有设置,请编辑相应的设置项,而不是替换整个配置文件。

[appearance]
server_name = "My Server"
header = [
    "#N&a&l#SERVERNAME&r#N&7Welcome, #PLAYERNAME!#N"
]
footer = [
    "#N&fOnline: &e#PLAYERCOUNT&7/&e#MAXPLAYERS#N&7TPS: #CTPS &7| MSPT: #CMSPT#N"
]
name_formatting_provider = "NONE"
display_name_format = "{name} &7#AFK"
update_interval = 500
animation_interval = 4

[sorting]
sort_mode = "NONE"

[afk]
afk_enabled = true
afk_timeout = 300

[performance]
metrics_provider = "VANILLA"

常见问题

我的 LuckPerms 前缀缺失。

请选择 LP,在你的格式中包含 {prefix},并检查玩家在其当前的 LuckPerms 上下文中是否确实设置了前缀。

在使用 FTB Ranks 时,我的配置文件名称格式未生效。

请检查 ftbranks.name_format 权限。如果存在该权限,它将具有更高优先级。若要始终使用配置文件中的格式,请选择 NONE。

额外的头部项目不会显示为额外的行。

每个项目都是一个动画帧。使用 #N 在一个帧内添加换行。

我在 Spark 统计信息中看到了 N/A。

选择 SPARK 并检查 Spark 是否已安装并准备就绪。不支持的统计信息将显示 N/A。

如何应用更改?

以操作员身份运行 /tablist reload,或者重启服务器。在重新加载之前,必须修复无效的 TOML 配置,例如缺少引号或重复的部分。

玩家是否需要安装任何东西?

不需要。Better TabList 仅在服务器上运行,并与原版客户端兼容。

需要帮助?提交 Issue,并提供你的 Minecraft 版本、加载器以及相关的配置设置。

贡献者

  • sennecools 和 NeofastFTL — Better TabList
  • MihailDenisov — 原始的 LuckPerms 集成、维度/生命值显示、排名权重缓存及性能指标相关的想法/代码来自 LPintegration 分支,已适配所有支持的目标平台(issue #13)。

灵感来源于 Tab List。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源