LinuxTAB 帮助中心

1安装与启用

LinuxTAB 不需要前置插件，一个 jar 就能跑。队伍、头衔、假人都是可选的联动项：装了谁就接谁，没装也只是少一块信息，不会报错、不会影响其它功能。

1. 把 LinuxTAB-26.11.8.jar 放进服务器的 plugins/ 目录。服务端用 Paper 或 Spigot 1.12.2，Java 8 及以上。
2. 重启服务器。第一次启动会生成 plugins/LinuxTAB/config.yml，默认就是「2 列 × 20 行、补空位、延迟列开」。
3. 看一眼控制台的启动摘要，确认列数、补位、延迟列、PlaceholderAPI 都是你要的状态。
4. 之后改配置只需要 /linuxtab reload，不用重启服务器；玩家列表会在下一次刷新（默认 20 tick）内变过来。

正常启动时控制台是这样两行：

如果第二行里某一段写的是「未检测到」，说明对应的插件没装或没启用，那一项功能会自动关掉，其余照常工作。想让队伍、头衔、假人都显示出来，把 LinuxTeam、LinuxTitle、FakePlayerPlugin 一起装上即可，LinuxTAB 启动时会自己认。

配置放在哪

插件的所有配置都在一个文件里，没有子目录、没有数据库：

改完存盘，执行 /linuxtab reload。如果配置写错（缩进错了、键名拼错），插件不会崩，会在控制台打一行黄色警告并保留旧配置继续跑，修好再 reload 一次就行。

2布局：怎么让人少也是多列

1.12.2 的客户端把玩家列表画成一张固定网格：每列固定 20 行，最多 4 列。行数是客户端写死的，服务端改不了；服务端唯一能决定的是「谁被塞进第几列第几行」。

所以在线只有 12 个人的时候，如果只发 12 个条目，客户端就只画一列 12 行，右边三列是空的——看起来根本没有多列。LinuxTAB 的做法是按列补位：把空条目补齐到整列（20 的倍数），多列布局在人少时也成立，题目里的「人少也是多列」就是这么来的。

配置项

两种填充方式怎么选

column 是默认值：假人排第一列开头，真人接着往下排，第一列满了才换第二列，视觉上最像「一列名单接着一列名单」。balance 会把总数平均摊到每一列，比如 30 个人分 2 列就是 15 + 15，看起来更对称，代价是玩家进出的瞬间偶尔会看到整列重排。

一个完整的布局配置

3顺序规则（重要）

LinuxTAB 发出去的最终顺序是：真人（各自队伍）→ 补位空行。真人按队伍聚在一起，空行全部沉底。假人默认不进列表，需要的话在配置里打开 layout.include-fakes，打开后假人排在真人上面。

客户端会自己重排，你要顺着它来

1.12.2 客户端拿到玩家列表后并不会照抄服务端给的顺序，它会按三个键重新排序：是否旁观 → 计分板队伍名 → 玩家名。也就是说，服务端发过去的顺序会被打乱一遍，插件必须让「排序结果」也符合预期，否则你看到的永远是乱序。

补位空条目就是这里最容易翻车的：它们没有队伍、名字又只有一个颜色码，客户端一排就会把它们排到中间去，于是「真人被空行挤到中间」或者「真人掉到最后一行」。LinuxTAB 的处理是——把补位空条目全部塞进一个队名以 U+FFFF 开头的计分板队伍里，这个字符比任何正常字符都大，客户端按队伍名排序时必然把它们排到最后，空行就永远沉底了。

假人默认不显示

假人是 FakePlayerPlugin 创建的服务器端玩家，它为了让假人有皮肤、也让别的插件（经济、在线统计）认得出它，会自己把假人加进玩家列表——客户端随即会把假人画进 TAB。LinuxTAB 默认的处理是把假人条目摘掉：每轮刷新都发一次移除，进服瞬间也会补一刀，所以列表里只有真人。

想看到假人，把 layout.include-fakes 改成 true 再 /linuxtab reload。打开后假人排在真人上面（用的是假人自己的 UUID，不会和真人重条目），顺序是假人（无队伍）→ 真人（各自队伍）→ 补位空行。

4头尾面板

玩家列表上方（header）和下方（footer）的两块文字面板。LinuxTAB 允许你写多套设计，按世界、按条件切换，每套面板里还能用动画和 PlaceholderAPI 变量。

配置项

display-condition 怎么写

条件是一串「变量 符号 值」的判断，多条用分号 ; 隔开，必须全部满足才生效。符号支持 = 和 !=。

可用变量

5动画与打字机

头尾面板里的文字可以动起来：按帧轮播，或者用打字机一个字一个字打出来。动画定义在 animations 下面，用 %animation:<名字>% 引用。

配置项

打字机的完整过程

以 text: "欢迎回来" 为例，一整个循环是这样的：

欢 → 欢迎 → 欢迎回 → 欢迎回来（停 hold 帧）→ 欢迎回 → 欢迎 → 欢 → 空（停一下）→ 从头再来。

也就是打完不会硬切回空，而是原路收回去，看起来像有人在敲键盘又删掉。想让收字更快，把 hold 调小即可；不想收字就直接用 frames 轮播。

6玩家名格式

列表里每个名字显示成什么样，由 player-list.name-format 决定。它是一段模板，支持颜色码和几个占位符，插件会把它们换成队伍、头衔和玩家名。

默认格式渲染出来是这样，队伍和头衔各带一层方括号：

7延迟列

延迟列用玩家列表右侧的计分板区域显示每个人的 ping，数值直接取自服务端记录的连接延迟，不额外发包，也不影响性能。

单元格的显示格式是 &7%ping% ms 这种风格：前面一个颜色码，中间是数字，后面跟单位。分档着色也会自动做——延迟低的偏绿、偏高偏黄、再高偏红，方便一眼看出谁在卡。

8命令

命令不多，日常只用得到 reload。所有子命令都需要 linuxtab.admin 权限，默认只有 OP 有。

debug 打开后能看到什么

顺序不对的时候，先看第一行的「合计」是不是 20 的整数倍。不是整数倍说明补位没生效，检查 layout.pad-empty 和 layout.rows；是整数倍但人还是掉到最后，把第二行发出来看空行到底排在第几位。

9常见问题

10配置全表

下面这张表是 config.yml 里 LinuxTAB 用到的全部键，默认值和说明都在里面。左边一列可以直接对照你的配置文件。