TAB и scoreboard: как оформить таб на сервере Minecraft

Список игроков по клавише Tab и табло справа игроки видят постоянно. Пустой таб с голыми никами сразу выдаёт сервер, собранный за вечер. Плагин TAB от NEZNAMY закрывает всё разом: шапку и низ таба, префиксы и порядок игроков, табло, ники над головой. Разберём основные разделы и то, где чаще всего ломается.

Где что лежит

После любой правки: /tab reload. Перезапускать сервер не нужно.

TAB активно развивается, и между крупными версиями разделы конфига переименовывали и переносили. Примеры ниже показывают логику. Если ключ у вас называется иначе, сверяйтесь с файлом, который плагин создал сам при первом запуске.

Шапка и низ таба

header-footer:
  enabled: true
  header:
  - '<#FFD60A>&lMYSERVER</#FF8A00>'
  - '&7Онлайн: &f%online%'
  - ''
  footer:
  - ''
  - '&7Пинг: &f%ping% мс'
  - '&7Сайт: &fmyserver.ru'

%online% и %ping% встроены в TAB, ставить ничего не нужно. Плейсхолдеры PlaceholderAPI тоже работают, если PAPI стоит и нужное расширение скачано.

Цвета: обычные коды &a, &l, HEX вида #FFD60A и градиент <#начало>текст</#конец>. HEX и градиенты видят клиенты 1.16 и новее.

Префиксы групп

Если префиксы уже заданы в LuckPerms, дублировать их в TAB не нужно. Берите их плейсхолдером, и тогда правка в одном месте меняет и чат, и таб. В groups.yml:

_DEFAULT_:
  tabprefix: '%luckperms-prefix%'
  tagprefix: '%luckperms-prefix%'
  tabsuffix: '%luckperms-suffix%'
  tagsuffix: '%luckperms-suffix%'
admin:
  tabprefix: '&c[Админ] &f'

tabprefix отвечает за таб, tagprefix за ник над головой. _DEFAULT_ применяется ко всем группам, у которых нет своей записи. Как завести группы и префиксы, разобрано в статье про LuckPerms.

Порядок игроков в списке задаётся в разделе сортировки: например, по списку групп от владельца до обычного игрока. Без настройки TAB сортирует по-своему, и админ может оказаться внизу.

Табло справа

scoreboard:
  enabled: true
  toggle-command: /sb
  scoreboards:
    main:
      title: '<#FFD60A>&lMYSERVER</#FF8A00>'
      lines:
      - '&7Ник: &f%player%'
      - '&7Баланс: &f%vault_eco_balance_formatted%'
      - ''
      - '&7Онлайн: &f%online%'
      - '&emyserver.ru'

Главная ловушка: в свежей установке табло выключено, enabled: false. Вы правите строки, делаете reload, а табло нет. Включите раздел.

Строк в табло не больше 15, это ограничение самой игры. Красные цифры справа на клиентах 1.20.3 и новее TAB умеет прятать. Разные табло для разных миров делаются через display-condition, например '%world%=world_nether'. Баланс в примере идёт через расширение Vault для PlaceholderAPI.

Анимации

В animations.yml:

logo:
  change-interval: 400
  texts:
  - '&e&lMYSERVER'
  - '&6&lMYSERVER'
  - '&f&lMYSERVER'

Интервал в миллисекундах, кратный 50. В таб или табло анимация вставляется плейсхолдером %animation:logo%. Не увлекайтесь: мигающая шапка из десяти кадров раздражает уже на второй минуте.

Типичные ошибки

• Табло не появляется. Раздел выключен по умолчанию, см. выше.
• Таб или табло мигают. Их пишут два плагина сразу: TAB и отдельный плагин табло, или чат-плагин, который тоже меняет имена в списке. Оставьте один источник.
• Плейсхолдер виден текстом. Нет PlaceholderAPI, не скачано расширение или опечатка в имени.
• Не тот префикс. У игрока несколько групп, и показывается префикс с большим приоритетом в LuckPerms. Проверьте приоритеты.
• Ник над головой не меняется. Командами игроков (teams) уже управляет другой плагин, и они с TAB тянут одно место на себя.
• Градиент кашей. Клиент старше 1.16 HEX не видит. Для старых версий держите обычные коды.
• Строка обрезается. Слишком длинный текст. Шапку и табло держите короткими.
• Файл не грузится. Табуляция или незакрытая кавычка в YAML. TAB пишет строку с ошибкой в консоль.

Как то же сделать быстрее

В Cloud Panel таб и табло правятся с живым превью: шапка, список игроков, табло на спавне. Цвета, градиенты, SmallCaps и подстановки видно сразу, как в игре. Не надо гадать, как ляжет градиент, и делать reload после каждой буквы.

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

Шапку и подвал таба можно собрать в бесплатном генераторе TAB, а боковое табло — в генераторе scoreboard. Оба отдают конфиг, который кладётся в плагин как есть.

Чек-лист

1. Стоит один плагин, который пишет таб и табло.
2. Шапка и низ таба короткие, онлайн и сайт на виду.
3. Префиксы берутся из LuckPerms плейсхолдером, а не переписаны вручную.
4. Порядок групп в списке настроен.
5. Табло включено, строк не больше 15.
6. Плейсхолдеры показывают данные, расширения PAPI скачаны.
7. Проверено на клиенте той версии, с которой играет большинство.
8. После правки сделан /tab reload, консоль чистая.

Хотите собрать таб и табло с живым превью на своём сервере: 3 дня бесплатно, без карты.