TAB-плагин: настройка табсписка, scoreboard и BossBar в Minecraft (2026)

Когда на сервере вырастает больше двух десятков игроков, голый ванильный табсписок начинает раздражать. Имена идут в случайном порядке, префиксы из LuckPerms видны только в чате, scoreboard на сайдбаре отсутствует, BossBar никто не использует. TAB by NEZNAMY закрывает все эти точки одним плагином, и разбираться с ним стоит один раз.

Разберём установку, прокси-режим, основные конфиги, sorting, anti-override и типовые поломки. Все примеры рабочие, проверены на Paper 1.21.4 и Velocity 3.4.

Что такое TAB и почему он стандарт

TAB by NEZNAMY (репозиторий github.com/NEZNAMY/TAB, релизы на hangar.papermc.io/NEZNAMY/TAB) это один плагин, который заменяет сразу несколько старых: TAB-list editor, custom scoreboard, BossBar plugin, name-tags. Раньше для этого ставили три-четыре плагина от разных авторов, и они конфликтовали из-за пакетов.

Ключевые модули в одном jar:

• табсписок: header, footer, отдельные строки для каждого слота, кастомные иконки, сортировка
• scoreboard на сайдбаре: набор строк, переключение по миру или по permission
• BossBar: одна или несколько полос сверху, прогресс по placeholder
• name-tags: префикс/суффикс над головой, цвет ника, скрытие при невидимости
• below-name: маленький текст под именем, обычно HP или клан
• yellow-number: цифра справа от ника в табе (HP, ping, score)

Всё это управляется через config.yml, groups.yml, animations.yml и пару дополнительных файлов. Никаких отдельных плагинов на каждый компонент.

Текущая стабильная ветка на 2026 год это TAB 5.x. Минимальные требования: Java 17 и Paper 1.16.5 или новее. На 1.8.x официальная поддержка прекращена давно, не пытайся её натянуть.

Установка

Скачай свежий jar с Hangar: hangar.papermc.io/NEZNAMY/TAB. Релизный файл называется TAB-5.x.x.jar, отдельных сборок под Spigot/Paper нет, jar универсальный.

Для одиночного сервера:

1. Положи jar в plugins/
2. Перезапусти сервер (не /reload)
3. Проверь /plugins, TAB должен быть зелёным
4. Запусти /tab cpu чтобы убедиться, что плагин работает

При первом старте появится папка plugins/TAB/ с конфигами. Дальше все настройки только там, в jar лазить не нужно.

Для прокси (Velocity или BungeeCord) используется тот же jar, кладёшь его в plugins/ прокси. Velocity 3.4+ обязательна, на старых версиях возможны проблемы с tablist API.

Первый запуск и список конфигов

После первого старта в plugins/TAB/ лежат:

• config.yml: главный файл. Включаешь и выключаешь модули, прописываешь header, footer, scoreboard, bossbar
• animations.yml: определения анимаций (бегущие радуги, пульсации, переключение фраз)
• groups.yml: настройки префиксов и tabprefix по группам LuckPerms или по имени игрока
• advanced-config.yml: placeholder refresh intervals, debug-флаги, мелкие настройки
• messages.yml: тексты команд для админов (можно перевести)
• premiumvanish.yml: интеграция с PremiumVanish (если плагин стоит)

Дефолтный config.yml уже работоспособный, но скорее всего не то, что нужно. Например, scoreboard по умолчанию выключен, header показывает базовые плейсхолдеры. Дальше настраиваем под себя.

Важно: если установлен PlaceholderAPI (а он почти наверняка установлен), TAB подцепит его автоматически. Если PAPI нет, доступны только встроенные плейсхолдеры TAB вида %online%, %maxplayers%, %player%, %world%.

Прокси-режим: ставить TAB на Velocity или на бэкенды

Если у тебя сеть из нескольких серверов под Velocity или BungeeCord, есть выбор: ставить TAB на каждый бэкенд отдельно или на прокси.

Короткий ответ: ставь на прокси. Причины:

• единый табсписок при переключении между серверами, не моргает
• сортировка работает по всем игрокам сети, а не по одному серверу
• header/footer задаются один раз на прокси
• меньше дублирования конфигов

Для прокси-режима нужно:

1. TAB установлен на прокси (Velocity-plugins/ или BungeeCord/plugins/)
2. На каждом бэкенде тоже стоит TAB (он работает в режиме backend client)
3. Включена опция enable-redis-bungee если используется RedisBungee, иначе обычный bungee-messaging
4. PlaceholderAPI стоит на бэкендах, чтобы плейсхолдеры считались на нужном сервере

В config.yml на прокси включаешь модули как обычно. На бэкендах выключаешь те модули, которые рулятся с прокси (обычно tablist и scoreboard), оставляешь nametags и bossbar если они зависят от мира.

Header и footer с PlaceholderAPI

Самое заметное место TAB это header (вверху табсписка) и footer (внизу). Минимальный пример из config.yml:

header-footer:
  enabled: true
  disable-condition: "%world%=disabled_world"
  header:
    - "&a&l>> %server_name% <<"
    - "&7Online: &f%online%&7/&f%maxplayers%"
    - "&7TPS: &a%tps%"
  footer:
    - "&7play.example.net"
    - "&8discord.gg/example"

Цветовые коды через & работают, поддерживаются hex &#RRGGBB и градиенты через тег <gradient:#hex1:#hex2>текст</gradient> (TAB парсит MiniMessage начиная с 5.x).

Чтобы header был разный на разных серверах сети, используй per-server:

header-footer:
  enabled: true
  per-server:
    survival:
      header:
        - "&a&lSurvival"
        - "&7%online% online"
      footer:
        - "&8survival.example.net"
    creative:
      header:
        - "&b&lCreative"
        - "&7%online% online"
      footer:
        - "&8creative.example.net"

Имена ключей (survival, creative) должны совпадать с именами серверов в Velocity-конфиге.

Для чисто бэкендного TAB без прокси работает аналогичный per-world с именами миров.

Sorting: по LuckPerms, permission или placeholder

Когда в табсписке больше десяти человек, важен порядок. По умолчанию игроки идут в порядке логина. TAB умеет сортировать по нескольким признакам, и комбинации это самое частое место, где люди залипают.

Пример из config.yml:

scoreboard-teams:
  enabled: true
  sorting-types:
    - "GROUPS:owner,admin,mod,vip,default"
    - "PLACEHOLDER_A_TO_Z:%player%"

Что это значит. Сначала TAB смотрит на группу LuckPerms игрока. Owner идёт выше admin, admin выше mod и так далее. Внутри одной группы (например, два игрока с группой default) применяется второй критерий: алфавит по имени.

Доступные типы сортировки:

• GROUPS:список_групп: порядок по списку, недостающие группы идут в конец
• PERMISSIONS:список_permissions: игроки с первым permission выше тех, у кого второй
• PLACEHOLDER_A_TO_Z:%placeholder%: алфавитная сортировка по плейсхолдеру
• PLACEHOLDER_Z_TO_A:%placeholder%: обратная алфавитная
• PLACEHOLDER_LOW_TO_HIGH:%placeholder%: по числу, по возрастанию
• PLACEHOLDER_HIGH_TO_LOW:%placeholder%: по числу, по убыванию

Для сетей с экономикой удобно сортировать по балансу:

sorting-types:
  - "GROUPS:owner,admin,vip,default"
  - "PLACEHOLDER_HIGH_TO_LOW:%vault_eco_balance%"

Важно: сортировка работает через scoreboard teams, и Minecraft ограничивает имена команд 16 символами. TAB сам управляет генерацией, но если у тебя стоит другой плагин на teams (например, custom-чат с кланами), они подерутся. Анти-override это решает, см. ниже.

Префиксы и tabprefix через LuckPerms

Если LuckPerms уже стоит и группы настроены через /lp group <name> meta setprefix "...", TAB подхватит префикс автоматически. Но часто хочется, чтобы в табсписке префикс был один (короткий), а в чате другой (длинный). Для этого есть groups.yml:

groups:
  owner:
    tabprefix: "&4&l[OWNER] &c"
    tagprefix: "&4[OWNER] &c"
    tabsuffix: ""
  admin:
    tabprefix: "&c[ADMIN] &c"
    tagprefix: "&c[A] &c"
  mod:
    tabprefix: "&e[MOD] &e"
    tagprefix: "&e[M] &e"
  vip:
    tabprefix: "&6[VIP] &6"
    tagprefix: "&6"
  default:
    tabprefix: "&7"
    tagprefix: "&7"

Ключ tabprefix это то, что видно в табе, tagprefix это то, что висит над головой, tabsuffix/tagsuffix справа от имени. TAB сначала смотрит в groups.yml, если группы там нет, использует данные из LuckPerms.

Чтобы группы определялись правильно, в config.yml должна быть включена интеграция:

use-luckperms-prefix-suffix: false
use-permissions-as-groups: false

Первая опция: если true, TAB берёт префикс из LuckPerms напрямую и groups.yml игнорируется. Удобно для простых случаев. Если хочешь свой формат в табе и свой в чате, ставь false и настраивай через groups.yml.

Anti-override

Классическая беда: ставишь EssentialsXChat или другой плагин с tablist-фичами, и они начинают переписывать имена в табе после TAB. У игроков пропадают префиксы или мерцает порядок.

В config.yml есть секция anti-override:

anti-override:
  tablist-names: true
  scoreboard-teams: true
  bossbar: true

С true TAB перехватывает попытки других плагинов модифицировать соответствующие пакеты и оставляет свои значения. По умолчанию всё уже включено, и трогать обычно не нужно, но если видишь, что префиксы периодически пропадают, проверь, что эти три флага в true.

Если проблема не уходит, помогает выключить tablist в EssentialsX (change-display-name: false в config.yml Essentials) и ChatControl, Carbon и подобных плагинах. Один источник правды лучше двух конфликтующих.

Per-world и per-server конфиги

Для каждого модуля можно задать поведение по миру (на бэкенде) или по серверу (на прокси). Реальный пример для scoreboard:

scoreboard:
  enabled: true
  default-scoreboard: main
  scoreboards:
    main:
      title: "&a&lSMP STATS"
      lines:
        - "&7Ping: &f%ping%ms"
        - "&7Online: &f%online%"
        - "&7Money: &6$%vault_eco_balance%"
        - "&7Rank: %luckperms_primary_group_name%"
        - "&7Kills: &c%statistic_player_kills%"
        - "&7World: &a%world%"
        - ""
        - "&8play.example.net"
    creative:
      title: "&b&lCREATIVE"
      lines:
        - "&7Online: &f%online%"
        - "&7World: &b%world%"
        - ""
        - "&8play.example.net"
      display-condition: "%world%=creative"

Ключ display-condition поддерживает плейсхолдеры и операторы =, !=, <, >, <=, >=. У одного игрока может быть несколько scoreboard, TAB покажет первый, чьё условие выполнено.

BossBar

BossBar полезен для глобальных уведомлений: онлайн, текущий ивент, статус сервера. Минимальный пример:

bossbar:
  enabled: true
  toggle-command: "/bossbar"
  default-bars:
    - online
    - event
  bars:
    online:
      style: "PROGRESS"
      color: "GREEN"
      progress: "%math_0_(%online%/%maxplayers%)%"
      text: "&a%online%&7/&a%maxplayers% players online"
    event:
      style: "NOTCHED_10"
      color: "PURPLE"
      progress: "100"
      text: "&dDouble XP weekend!"
      announcement-bar: true

Для прогресса можно использовать вычислимый плейсхолдер через PAPI Math expansion. Стили: PROGRESS, NOTCHED_6, NOTCHED_10, NOTCHED_12, NOTCHED_20. Цвета: PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE.

Если announcement-bar: true, бар показывается всем сразу при включении и автоматически снимается через announcement-bar-time секунд. Удобно для рестарт-уведомлений.

Анимации

Файл animations.yml содержит набор переиспользуемых анимаций. Пример:

animations:
  rainbow_text:
    change-interval: 200
    texts:
      - "&cE&6X&eA&aM&bP&dL&5E"
      - "&6E&eX&aA&bM&dP&5L&cE"
      - "&eE&aX&bA&dM&5P&cL&6E"
  pulse_online:
    change-interval: 500
    texts:
      - "&aOnline: &f%online%"
      - "&2Online: &7%online%"

Использовать в любом другом конфиге через %animation:имя%:

header:
  - "%animation:rainbow_text%"
  - "%animation:pulse_online%"

change-interval в миллисекундах. Меньше 50 ставить смысла нет, клиент всё равно не успеет отрисовать.

Интеграции: PremiumVanish, PlaceholderAPI, Vault

Фича	PremiumVanish	PlaceholderAPI	Vault
Скрытие vanished игроков из таба	Да	Нет	Нет
Префиксы из LuckPerms	Нет	Через %luckperms_prefix%	Да, напрямую
Баланс игрока в scoreboard	Нет	Через %vault_eco_balance%	Через PAPI
Кастомные плейсхолдеры	Нет	Да, основной источник	Нет
Группа игрока для sorting	Нет	Через %vault_group%	Да
Подсчёт онлайна без vanish	Да	Нет	Нет
Совместимость с TAB	Нативная	Нативная	Через PAPI Vault expansion

Короткое правило. PlaceholderAPI ставится почти всегда, без него scoreboard и header будут пустыми. Vault нужен, если есть экономика. PremiumVanish нужен только если ты используешь именно его как vanish-плагин (не путать со встроенным /v Essentials).

Troubleshooting

Префиксы не показываются, хотя в LuckPerms прописаны. Проверь permission node tab.prefixes (или его отсутствие у группы). По умолчанию TAB показывает префиксы всем, но если в config.yml стоит permission-required-for-prefixes: true, нужно явно дать permission. Также убедись, что в LuckPerms префикс задан через meta setprefix, а не через permission prefix.10.vip. TAB по умолчанию читает meta prefixes.

Плейсхолдер выводится буквально (%player_world% вместо имени мира). Запусти /papi parse me %player_world%. Если возвращает текст как есть, expansion не установлен. Поставь через /papi ecloud download Player. После установки сделай /tab reload.

Sorting не работает, игроки идут в случайном порядке. Проверь две вещи. Первая: в config.yml секция scoreboard-teams.enabled: true (модуль выключен по умолчанию в некоторых сборках). Вторая: убедись, что нет другого плагина, который тоже трогает scoreboard teams. Конфликты с EssentialsXChat и MyPet встречаются чаще всего.

Scoreboard моргает или дублируется. Скорее всего, у тебя стоит ещё один плагин на scoreboard (FeatherBoard, Fabled-Scoreboard). TAB и второй плагин дерутся за пакеты. Удали второй, оставь только TAB.

При переключении серверов на прокси на секунду пропадает табсписок. Это значит, что TAB стоит только на бэкендах, а не на прокси. Поставь jar в plugins/ Velocity, перезапусти прокси.

/tab reload ничего не меняет после правки конфига. Проверь синтаксис YAML, любая лишняя пробелина ломает парсинг. Сделай дамп через /tab debug и смотри в latest.log ошибки. Часто помогает копирование примера из документации github.com/NEZNAMY/TAB/wiki.

FAQ

Можно ли использовать TAB вместе с FeatherBoard?

Нет смысла. TAB полностью покрывает функционал FeatherBoard, и держать оба плагина одновременно это лишний расход ресурсов и постоянные конфликты за scoreboard packets. Выбери один.

TAB сильно нагружает сервер?

При стандартных настройках почти нет. На сетях по 200 игроков занимает 0.5-1% CPU тика. Тяжёлые плейсхолдеры (например, кастомные через PAPI с обращением к БД на каждый тик) могут просесть, но это вина не TAB, а expansion. Используй refresh-intervals в advanced-config.yml, чтобы редкие данные пересчитывались раз в несколько секунд, а не каждый тик.

Поддерживает ли TAB Folia?

Folia поддерживается с TAB 5.0. Если у тебя более старая версия, обнови. На Folia плагин корректно работает через regional schedulers.

Можно ли отключить TAB для конкретного игрока?

Да, через permission tab.staff можно выдать админу скрытый режим, либо использовать disable-condition в каждом модуле. Например, disable-condition: "%world%=spectator_world" отключит модуль на конкретном мире.

Что лучше для name-tags: TAB или EssentialsXChat?

TAB. EssentialsXChat умеет только префикс перед именем в чате. Над головой игрока префиксы рисует именно TAB через scoreboard teams. Без TAB или аналога над головой будет только белое имя.

Совместим ли TAB с Geyser/Floodgate?

Да, но есть нюансы. Bedrock-клиенты не поддерживают форматирование hex-цветов и градиентов в табсписке так, как Java-клиенты. Используй стандартные & коды для совместимости, либо прячь сложное форматирование под условие %player_client%=java.

На этом базовая настройка TAB закончена. Дальше уже идут детали под конкретные сценарии: BossBar для PvP-арен, scoreboard для квестов, кастомные иконки в табе через tablist-formatting. Всё это есть в вики на GitHub, и читать её стоит после того, как базовый конфиг работает.