TAB 页眉与页脚

在 TAB 插件的页眉或页脚填写 <<布局ID>>，即可显示 Xerr 布局。玩家名单、分组、排序和其它文字仍由原有 TAB 插件管理。

使用旅人手札主题复制章节链接

默认提供两块布局：

• tab_traveler_header：标题、副标题、在线人数与欢迎语。
• tab_traveler_footer：玩家头像、名称、等级、服务器时间与寄语。

将下面片段填入现有 TAB 插件对应的页眉、页脚设置，外层节点沿用该插件的格式。保留空行，为图片留出高度，避免与玩家名单重叠：

header:
  - "<<tab_traveler_header>>"
  - " "
  - " "
  - " "
  - " "
  - " "
  - " "
  - " "
  - " "
  - " "
  - " "
footer:
  - "<<tab_traveler_footer>>"
  - " "
  - " "
  - " "
  - " "
  - " "
  - " "

确认 Xerr 的 feature.tab.enable 为 true，执行 /xerr pack 并让客户端加载资源包，再重载 TAB 插件。

只修改已有文字时，编辑布局中的 value 后执行 /xerr reload；修改位置、图片、字体或模板后，需要重新打包并加载资源包。

制作自己的布局复制章节链接

TAB 复用普通布局，可组合文字、图片、头像、人物、进度条和罗盘，无需单独登记为 HUD。

defaults:
  font: ui

tab_info:
  name:
    x: 0
    y: 0
    align: center
    value: "&f{{ player name }}"
  level:
    x: 0
    y: -14
    align: center
    value: "&7Lv. &f{{ player level }}"

执行 /xerr pack 并加载新包后，在 TAB 页眉引用：

header:
  - "<<tab_info>>"
  - " "
  - " "

引用的是顶层布局 ID tab_info，不是文件名。TAB 使用局部 X/Y，不需要 anchor；较高的布局通过增加空行留出空间。

传入变量复制章节链接

把上例的 name.value 改为：

value: "&f{{ get title }}"

然后在页眉或页脚中填写：

<<tab_info::title=冒险服务器>>

同一个布局可以在不同位置引用，并传入不同变量。

配置与刷新复制章节链接

feature:
  tab:
    enable: true
    start: "<<"
    end: ">>"
    refresh: 10
    hide-background: false

修改开关、标记或刷新间隔后执行 /xerr reload。refresh 控制 TAB 中的普通动态内容，与 HUD 中的布局刷新设置独立；头像、人物、罗盘和进度条按所需频率刷新。没有布局标记时，不会启用布局刷新。

隐藏原版背景复制章节链接

将 feature.tab.hide-background 改为 true，执行 /xerr pack 并让客户端加载新包，即可隐藏原版页眉、页脚和玩家名单的默认底色，保留 Xerr 布局中的背景图片。改回 false 并重新打包可恢复。

玩家启用客户端全局文字背景时，自定义的玩家行底色仍会保留。与其它修改 GUI 核心着色器的资源包共用时，需要检查资源冲突。

排查显示问题复制章节链接