Tab Player Highlighter

Tab Player Highlighter (сокращённо TPH) - небольшой клиентский мод для Minecraft Java, который подсвечивает выбранных игроков прямо в списке Tab. Работает по UUID, то есть привязка идёт не к нику, а к уникальному идентификатору аккаунта. Это важно: ник можно сменить, а UUID остаётся тем же.

Зачем это вообще нужно

На маленьком сервере с десятком друзей вы и так всех знаете в лицо. А вот на публичном проекте с онлайн в сотни человек таб превращается в мешанину ников. Где там админ? Кто модератор? Кто просто свой? Пока найдёшь нужного - уже написали в чат и ушли.

Tab Player Highlighter решает ровно эту проблему. Вы один раз прописываете список UUID и роли к ним, а дальше мод сам помечает этих игроков в списке. Никаких плагинов на сервере для этого не надо - всё работает на стороне клиента.

Что умеет мод

• Выделение по UUID - подсвечивает конкретных игроков в табе, а не всех подряд
• Цветные префиксы ролей - можно повесить метку вроде [Admin] или [Moderator] с цветом через коды §
• Несколько игроков сразу - список не ограничен парой человек, хоть сто штук
• Онлайн-режим - префиксы можно тянуть с внешнего API, а не хранить локально

Мод клиентский, ставится только себе. Соседи по серверу ничего не заметят, античит его за серверный чит не считает - это чисто косметика интерфейса.

Требования и совместимость

Для работы Tab Player Highlighter нужна библиотека Cloth Config API. Без неё мод просто не запустится, так что ставьте её первой.

Загрузчик - только Fabric. Версии Forge и NeoForge проект не поддерживает, это стоит учитывать ещё до скачивания. Заявлена работа на Minecraft 1.21-1.21.1, 1.21.6-1.21.8, 1.21.11, а также на снапшот-ветке 26.1.2. Свежие порты подтягивают довольно оперативно, так что мод не отстаёт от актуальных версий игры. Лицензия - MIT, на Modrinth у проекта порядка 17,2 тыс. загрузок.

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

Файл конфигурации лежит по адресу:

.minecraft\config\tab_player_highlighter.json

По умолчанию он выглядит так:

{
  "onlineMod": false,
  "API_URL": "localhost:3000/get_roles",
  "playersPrefixes": {
  }
}

В блоке playersPrefixes вы прописываете нужные UUID и роли к ним. Можно указать сколько угодно игроков. Пример:

{
  "onlineMod": false,
  "API_URL": "localhost:3000/get_roles",
  "playersPrefixes": {
    "uuid1": "§a[Admin]",
    "uuid2": "§a[Moderator]",
    "uuid3": "§a[Helper]",
    ...
    "uuid100": "§a[Cheater]"
  }
}

Если включить onlineMod, то при заходе на сервер префиксы будут браться с API_URL, а локальный список playersPrefixes мод проигнорирует. Это удобно, когда состав администрации на сервере часто меняется и держать его в ручном файле лень.

Ответ от API_URL должен быть в формате JSON и выглядеть примерно так:

{
  "players": {
    "6a640b67-87f0-456a-8f4d-a65aeb55f4f4": "[Moderator]",
    "53e45cf5-c017-427a-9e67-7b6f00d47219": "§a[Admin]"
  }
}

Важные нюансы

Совет: для правки JSON лучше взять Notepad++ или любой другой редактор с подсветкой синтаксиса. Обычный блокнот любит добавлять BOM и лишние символы, из-за чего конфиг потом не читается и мод молча игнорирует настройки. Классическая ошибка новичков.

UUID игрока можно посмотреть на NameMC - вбиваете ник, смотрите страницу профиля. Просто вписать ник в конфиг нельзя, мод привязан именно к идентификатору.

Ещё момент: если ответ от API не парсится или сервер недоступен, префиксы в табе просто не появятся. Ошибок в чат мод не сыплет, так что проверяйте структуру JSON внимательно, особенно запятые и кавычки.

Кому пригодится

В первую очередь это инструмент для админов и модераторов больших серверов, а также для стримеров, которым важно видеть своих модераторов в чате. Обычному игроку, который заходит по вечерам на пару часов, мод мало что даст - разве что вы хотите пометить друга, чтобы не терять его в толпе.

Если вы собираете клиент под Fabric и играете на многолюдных серверах, Tab Player Highlighter - неплохая мелкая вещь в коллекцию. Занимает копейки по производительности, ничего не грузит и делает таб читаемым. Скачать мод Tab Player Highlighter можно на Modrinth, там же указаны актуальные версии под вашу сборку.