TAB: настройка таба, префиксы и команды

Установка на Paper, Spigot и в сети Velocity

1. Скачайте jar под своё ядро и версию. Разработчик советует фильтр загрузок на Modrinth: начиная с Minecraft 26.1 один файл под все версии собрать невозможно. Есть также GitHub и SpigotMC.
2. Одиночный сервер: положите jar в папку plugins и перезапустите сервер. Отдельных требований к Java нет: запускается сервер, запустится и TAB.
3. Сеть на Velocity или BungeeCord: TAB рекомендуют ставить на прокси. Там вместо /tab пишется /btab, права те же, но проверяются на прокси, поэтому LuckPerms нужен и там.
4. На бэкенды при установке на прокси ставится TAB-Bridge, иначе не будут работать плейсхолдеры PlaceholderAPI. На Velocity скорборд, ники над головой и сортировка работают через VelocityScoreboardAPI.
5. Ставить TAB одновременно на прокси и на бэкенд нельзя. Откат на старую версию не поддерживается.

Для Bukkit: TAB 5.5.0 поддерживает все версии 1.x начиная с 1.7, для 1.5.2–1.6.4 берут TAB 5.2.5. С 6.0.0 старые 1.x постепенно убирают из сборок.

Как настроить header и footer

Шапка и подвал таба задаются в config.yml, раздел header-footer. Дизайны проверяются сверху вниз: применяется первый, у которого выполнено display-condition, а дизайн без условия служит запасным. Пример из официальной вики, сокращённый:

header-footer:
  enabled: true
  designs:
    world-test:
      display-condition: "%world%=test"
      header:
        - "Test header in world 'test'"
      footer:
        - "Test footer in world 'test'"
    default:
      header:
        - "&3&lServer name"
        - "&r&7Online players: &f%online%"
        - "&6Online staff: &e%staffonline%"
      footer:
        - "&2Ping: %ping%"
        - "&7&l Used memory: %memory-used% MB / %memory-max% MB"

Каждый элемент списка это одна строка. Пустая строка "" даёт отступ. Бегущий текст делается анимацией: в animations.yml задаётся change-interval в миллисекундах и список texts, в шапку вставляется %animation:Имя%. После правки выполните /tab reload.

Префиксы из LuckPerms в табе и над головой

Префикс хранится в LuckPerms, TAB его только показывает. Задайте префикс группе:

/lp group admin meta setprefix 100 "&c[Admin] "

В groups.yml плагина TAB удалите примеры групп и оставьте только это:

_DEFAULT_:
  tabprefix: "%luckperms-prefix%"
  tabsuffix: "%luckperms-suffix%"
  tagprefix: "%luckperms-prefix%"
  tagsuffix: "%luckperms-suffix%"

• tabprefix и tabsuffix видны в табе, нужна включённая функция tablist-name-formatting.
• tagprefix и tagsuffix видны над головой, нужна включённая scoreboard-teams.
• На клиентах 1.12.2 и ниже префикс над головой обрезается до 16 символов.

Без LuckPerms префикс ставится командой TAB, текст с пробелами берут в кавычки: /tab group owner tabprefix "&2&lOwner&r ". Откуда взялось значение у конкретного игрока, покажет /tab dump <ник>.

Сортировка игроков по группам

Группу игрока TAB берёт из LuckPerms или Vault, если в config.yml стоит assign-groups-by-permissions: false. При true группа определяется правом tab.group.<группа>. Порядок в табе задаётся списком:

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

Сначала игроки сортируются по группе, внутри группы по алфавиту. Сортировать по весу групп LuckPerms можно строкой PLACEHOLDER_HIGH_TO_LOW:%luckperms_highest_group_weight%: это плейсхолдер PlaceholderAPI, вес ставится командой /lp group <группа> setweight <число>.

Почему не работает префикс или плейсхолдер

• Плейсхолдер выводится текстом: проверьте, что он закрыт вторым знаком %, что для него установлено расширение PlaceholderAPI и что в сети на бэкенде стоит TAB-Bridge.
• Префикс LuckPerms в сети не обновляется сразу: в конфиге LuckPerms включите messaging-service: pluginmsg.
• Цвета в формате MiniMessage работают только на Paper и Velocity.
• Префикс не тот: /tab dump <ник> покажет группу игрока и источник каждого значения.
• После включения MySQL выполните /tab mysql upload, чтобы перенести groups.yml и users.yml в базу.