TablistMod

模组

· 作者 official.andy

使用完整的精灵占位符和动画支持来格式化你的标签页/玩家列表

0 本站下载 0 关注 更新于 1 个月前

需要前置:Fabric API

最新 1.0.0 · 26.3 · Fabric

一键开服(送7天)
TabListMod Logo

TabListMod — 基于权限驱动的动画式标签页列表,支持精灵、渐变、行内动画及多维度布局

作为 Chat Mod 的配套模组构建。 直接共享 ChatMod 的精灵图集和 sprites.yml ——你在 ChatMod 中定义的每个精灵别名都可以在你的标签页头部、尾部、前缀和后缀中使用,无需任何重复。ChatMod 的所有颜色、渐变和精灵语法在所有格式字符串中均完全支持。


功能介绍

TabListMod 赋予服务器管理员对标签页列表(tablist)头部、尾部以及玩家名称行外观的完全控制权——这是基于每位玩家的权限来实现的。管理员看到的布局与 VIP 不同,而 VIP 看到的又与普通成员不同。每种格式都可以进行动画处理、针对特定维度(维度),并包含实时占位符——所有这些都可以通过简单的 YAML 定义,且无需重启服务器。

此外,每位玩家都会获得一个格式化后的名称行,其中包含其前缀、带颜色的显示名称和后缀,这些均由可配置的格式字符串生成。前缀和后缀各自拥有独立的优先级系统、权限节点和可选条件。


特性

? 按权限划分的标签页列表格式

在 tablist_formats.yml 中定义任意数量的标签页列表格式。系统会应用玩家拥有的第一个权限节点对应的格式。没有权限节点的格式将作为适用于所有人的兜底回退方案。

formats:
  admin:
    priority: 100
    permission_node: 'TabListMod.admin'
    animated: true
    seconds: 2.0
    frames:
      1:
        header:
          - ''
          - '<#FF5555>⚡ Admin ⚡<#FF0000>'
          - '&7Players: &f%online_players%&7/&f%max_players%   &7Balance: &a%balance%'
          - ''
        footer:
          - ''
          - '&7%datetime%'
          - ''

  default:
    priority: 0
    animated: true
    seconds: 2.0
    frames:
      1:
        header:
          - ''
          - '%animation:running_man%'
          - '<#55FF55>✦ Welcome to the Server ✦'
          - '&7Players: &f%online_players%   &7Ping: &f%ping%ms'
          - '&7Balance: &a%balance%'
          - ''
        footer:
          - ''
          - '&7%date%   &f%time%'
          - ''

每种格式字符串都支持颜色代码、平面十六进制颜色 (&#RRGGBB)、渐变 (<#RRGGBB>text<#RRGGBB>)、精灵令牌 ([#alias], [item], [player]),以及所有内部占位符和 PlaceholderAPI 占位符。


? 基于帧的动画与回退机制

动画格式使用编号帧映射而非扁平列表。帧 1 是标准帧——它必须同时定义头部和尾部。任何后续帧只需声明实际发生更改的部分。在第 2、3 或更多帧中省略的行会自动回退到第 1 帧的值,因此你永远不会在不同帧之间重复静态行。

frames:
  1:
    header:
      - ''
      - '<#55FF55>✦ Welcome ✦'
      - '&7Players: &f%online_players%'
      - ''
    footer:              # ← 仅定义一次,被所有其他帧继承
      - ''
      - '&7%date%   &f%time%'
      - ''
  2:
    header:              # 仅头部发生变化——尾部省略 → 使用第 1 帧的值
      - ''
      - '<#FFAA00>✦ Welcome ✦'
      - '&7Players: &f%online_players%'
      - ''

✨ 行内动画 %animation:name%

在 tablist_animations.yml 中定义可复用的文本动画。每种动画都有自己独立的帧率,并循环播放一组文本值。将 %animation:name% 放入任何头部、尾部、前缀、后缀或玩家名称格式字符串中,它就会以自身速度进行动画播放——完全独立于周围格式的动画速度。

animations:
  running_man:
    seconds: 0.20
    frames:
      - '&f[#run]&7·····················'
      - '&f·[#walk]&7····················'
      # ...

即使在完全静态的格式中,动画也能正常工作——如果任何行包含 %animation:x%,该格式将在每个游戏刻(tick)自动发送,从而确保不会跳过任何帧。


? 多维度布局

每种格式都可以定义维度特定的覆盖项,当玩家进入该世界时激活。覆盖项可以是静态的,也可以拥有自己的帧率进行独立动画处理。

dimensions:
  'minecraft:the_nether':
    animated: false
    header:
      - ''
      - '&4&l[ Nether ] &b&lModerator'
      - '&cWorld: [#netherrack] &4The Nether'
      - ''
    footer:
      - ''
      - '&c%datetime%'
      - ''

?️ 前缀、后缀与玩家名称格式

在 tablist_prefixes.yml 中定义前缀和后缀层级。每个条目都有各自的优先级、权限节点和可选条件。标签页列表中玩家的名称行可通过 tablistmod.yml 中的 tablist_name_format 完全配置:

tablist_name_format: '%custom_rank%%displayname%'
令牌 值
%custom_rank% 活动前缀格式字符串(包含颜色代码)
%displayname% 玩家的游戏内显示名称
%player% 原始 Minecraft 用户名
%balance% EcoBal 余额(需要 EcoBal 模组)
%ping% 当前延迟(毫秒)

精灵、十六进制颜色和渐变同样可以在名称格式中使用。


?️ 通过 ChatMod 支持的精灵

TabListMod 直接与 ChatMod 的 AtlasSpriteHelper 和 SpritesManager 桥接。你在 ChatMod 的 sprites.yml 中定义的每个精灵别名都在 TabListMod 中可用,并使用相同的令牌语法——无需单独的精灵配置文件。

[#grass_block]    → sprites.yml 中的精灵别名
[#netherrack]     → 精灵别名
[item]            → 玩家手持的物品
[item:1]          → 快捷栏第 1 格的物品
[player]          → 玩家皮肤头像(16×16)
[player:Name]     → 特定玩家的头像

如果未安装 ChatMod,sprite 标记将解析为空值——标签页其余部分仍正常工作。


? EcoBal 经济集成

如果存在 EcoBal,%balance% 将解析为带有可配置货币符号和小数位数的格式化玩家余额。如果不存在 EcoBal,%balance% 显示 N/A。无需任何配置——检测完全自动完成。

ecobal:
  enabled: true
  decimal_places: 2
  currency_symbol: "$"

? 占位符

占位符 值
%player% 原始 Minecraft 用户名
%displayname% 游戏内显示名称
%custom_rank% 当前前缀(含颜色代码)
%ping% 延迟(毫秒)
%online_players% 当前在线玩家数量
%max_players% 服务器玩家槽位上限
%balance% EcoBal 余额
%date% 当前日期 (yyyy-MM-dd)
%time% 当前时间 (HH:mm:ss)
%datetime% 完整的日期、时间和时区
%dimension% 维度显示名称
%dimension_id% 原始维度键,例如 minecraft:the_nether
%dimension_sprite% 当前维度的 sprite 标记
%playtime% 总游戏时长,例如 3d 2h 15m
%animation:name% 命名内联动画的当前帧

所有 Fabric PlaceholderAPI 占位符也会自动解析。


? 逐行动画模式

为了实现更精细的控制,各个标题行的动画速度可以独立设置。速度为 0 的行保持完全静态,而其周围的各行则独立进行动画循环。

per_line_seconds:
  - 0      # 第 1 行 — 永远静态
  - 1.25   # 第 2 行 — 每 1.25 秒循环一次
  - 1.0    # 第 3 行 — 每 1.0 秒循环一次
  - 0      # 第 4 行 — 永远静态
header_lines:
  - frames: ['']
  - frames: ['<#FF5555>⚡ Admin ⚡', '<#FF0000>⚡ Admin ⚡']
  - frames: ['&7Players: &f%online_players%']
  - frames: ['']

? 观察者模式处理

配置观察者在标签页中的显示方式。

模式 行为
KEEP_POSITION 观察者保持在正常的排序位置
SINK_TO_BOTTOM 观察者沉降至所有生存玩家下方
HIDE_EFFECT 取消观察者游戏模式数据包;表现为普通玩家

? 管理员命令

命令 描述 权限
/tablist reload 热重载所有 TabListMod 配置 tablistmod.reload
/tablist debug [player] 显示当前活动的格式、前缀和后缀 tablistmod.debug
/tablist list formats 列出所有已加载的格式 tablistmod.list
/tablist list prefixes 列出所有已加载的前缀 tablistmod.list
/tablist player <name> refresh 强制刷新某玩家的标签页 tablistmod.player.refresh

任何配置更改都不需要重启服务器——/tablist reload 会立即生效。


配置文件

所有文件均位于 config/tablistmod/ 目录下。编辑后请使用 /tablist reload。

文件 包含内容
tablistmod.yml 全局设置、名称格式、时区、观察者模式、EcoBal、维度映射
tablist_formats.yml 按权限划分的标题/页脚格式定义
tablist_prefixes.yml 前缀和后缀定义
tablist_animations.yml 可复用的内联动画定义

依赖项

模组 是否必需?
Fabric API ✅ 必需
LuckPerms ✅ 用于按权限区分格式
ChatMod ⭐ 强烈推荐 — 启用 sprites 和共享图集
EcoBal ? 可选 — 启用 %balance% 占位符
Placeholder API ? 可选 — 启用 PAPI 占位符

TabListMod 没有对 ChatMod 的硬性编译期依赖——它可以独立运行,并在未安装 ChatMod 时优雅降级(sprites 解析为空)。这两个模组设计为配套使用,配合效果最佳。


整合包政策

  • ✅ 你可以将 TabListMod 包含在任何整合包中。
  • ❌ 该整合包不得出售。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源