AddHeads - головы игроков в чате и табе

AddHeads - лёгкий плагин для серверов на Paper и Purpur, который добавляет головы игроков прямо в чат и в таб-лист (список игроков по Tab). Звучит как мелочь, но на деле это одна из тех фишек, которая сразу делает сервер визуально живее: вместо безликих ников в чате вы видите скин собеседника, а в табе можно с первого взгляда понять, кто есть кто. Скачать плагин AddHeads стоит хотя бы ради того, что он вообще не требует от игроков ничего лишнего - ни ресурспака, ни модов, ни каких-то настроек на клиенте. Всё работает на ванильном клиенте Майнкрафт.

Зачем вообще нужны головы в чате и табе

В ванильном Minecraft чат и список игроков - это просто текст. На большом сервере с сотней ников разобраться в том, кто пишет, бывает сложно, особенно если у игроков похожие префиксы или цвета. Плагины вроде AddHeads решают эту проблему элегантно: рядом с ником рисуется миниатюрная голова со скином игрока. Это работает за счёт особых символов и кастомного шрифта на уровне сервера, поэтому клиенту ничего скачивать не нужно - он просто видит картинку.

По факту это must-have для серверов с кастомным чатом, ролевым уклоном или просто для тех админов, кто хочет придать своему проекту более polished-вид без установки ресурспака на каждый клиент. И да, это работает даже в оффлайн-режиме (offline mode), что редкость для подобных решений - скины подтягиваются через SkinsRestorer и другие источники.

Просто скачай и работает

Главная фишка AddHeads - отсутствие возни с настройкой. Не нужно лезть в конфиги чат-плагинов и вручную вставлять плейсхолдеры в каждый формат сообщения. Плагин работает поверх уже существующих решений: он берёт финальный компонент чата после того, как его отформатировали другие плагины, и аккуратно добавляет голову перед текстом. То же самое с таб-листом - голова вставляется автоматически через имя игрока в списке, без ручной настройки плейсхолдеров.

Короче, закинул jar в папку plugins, перезапустил сервер - и готово. Дальше по желанию можно покрутить настройки через GUI командой /hd settings.

Что конкретно делает плагин

• Автоматически добавляет голову игрока перед его ником в таб-листе
• Работает с ванильным списком игроков и с таб-плагинами без ручной вставки плейсхолдеров, даже в оффлайн-режиме
• Ставит голову перед сообщением в чате
• Сохраняет форматирование чата от других плагинов - цвета, префиксы, суффиксы не ломаются
• Умеет подтягивать скины через SkinsRestorer, если тот установлен
• Держит единый кэш скинов для чата и плейсхолдеров - никакого дублирования запросов
• Включает локализованное GUI настроек для админов по команде /hd settings

Возможности

• Рендер голов в ванильном чате
• Автоматическая вставка голов в таб-лист без дополнительной настройки
• Публичный Bukkit service API для интеграции со сторонними плагинами
• Поддержка PlaceholderAPI с несколькими форматами экспорта
• Поиск скинов с учётом SkinsRestorer
• Автоматическое обновление скинов и кэша
• Персональные переключатели видимости голов в чате и табе для каждого игрока
• Локализованное GUI настроек
• Горячая перезагрузка конфига и языковых файлов
• Автоматическое дополнение новых ключей конфига и языка при перезагрузке
• Настраиваемый отступ между головой и текстом в чате и в табе
• Раздельные настройки теней для голов в чате и в таб-листе
• Проверка обновлений с GitHub и Modrinth

Совместимость с чат-плагинами

AddHeads поддерживает любые чат-плагины. Это важный момент: плагин не навязывает свой форматировщик, а декорирует уже готовое сообщение после того, как его обработали другие плагины. То есть если у вас стоит какой-нибудь кастомный чат с каналами, цветами и префиксами - всё это сохранится, просто перед сообщением появится голова.

Поддерживаемые плагины таб-листа

С некоторыми плагинами интеграция сделана напрямую:

• TAB

  Нативная поддержка реализована через API плагина TAB, поэтому головы добавляются корректно даже когда TAB форматирует префиксы, суффиксы, цвета и имена в табе.

• CMI / PowerBoard / любые другие

  Поддерживаются через стандартный путь совместимости.

AddHeads также работает с другими плагинами таб-листа, если те не блокируют внешние изменения списка игроков. Если плагин позволяет извне изменить финальное имя в табе - AddHeads, как правило, сможет добавить голову через свой обычный механизм совместимости. Для TAB вместо этого используется нативная интеграция через API, так что головы отображаются правильно даже со всеми функциями форматирования TAB.

Требования

• Paper или Purpur версии 1.21.9+
• Java 21

Да, плагин заточен под свежие версии Майнкрафт. Если ваш сервер на 1.20 или ниже - придётся либо обновляться, либо искать альтернативу. Зато на актуальных версиях вы получаете все современные механики Paper API, включая работу с профилями игроков.

Опциональные зависимости

• PlaceholderAPI - для плейсхолдеров в кастомных интерфейсах, скорбордах и префиксах
• SkinsRestorer - для корректного отображения скинов на серверах в оффлайн-режиме

Команды

Команда	Описание	Право
/hd togglechat	Включает/выключает головы в чате для себя	addhead.togglechat
/hd toggletab	Включает/выключает головы в табе для себя	addhead.toggletab
/hd settings	Открывает локализованное GUI настроек	addhead.settings
/hd info	Показывает название, версию и автора плагина	Не требуется
/hd reload	Перезагружает конфиг, языковые файлы и кэш скинов	addhead.reload

Права доступа

• addhead.togglechat - разрешает переключать свои головы в чате
• addhead.toggletab - разрешает переключать свои головы в табе
• addhead.settings - разрешает открывать GUI настроек
• addhead.reload - разрешает перезагрузку плагина и действия по восстановлению
• addhead.premium - используется только при premium.mode=permission

Установка

1. Скачайте файл AddHeads-{version}.jar.
2. Поместите его в папку plugins/ вашего сервера.
3. Запустите или перезапустите сервер.
4. При необходимости отредактируйте config.yml и файлы в languages/*.yml или используйте /hd settings.
5. После изменений выполните /hd reload.

Кстати, если хотите поиграть с друзьями на своём сервере с такими плюшками - плагин отлично встанет на BungeeHost (https://bungee.host), причём установка там делается буквально в один клик. Для небольшого сервера с друзьями это вообще идеальный вариант: поднял Paper, закинул AddHeads, и у всех в чате красивые головы.

Плейсхолдеры для PlaceholderAPI

Если стандартной автоматики мало и хочется встроить головы в кастомные интерфейсы - скорборды, префиксы, табы от других плагинов - в вашем распоряжении набор плейсхолдеров:

• %addhead_head% - JSON-компонент головы для чата и плагинов, работающих с компонентами
• %addhead_tab% - опциональный плейсхолдер головы для кастомных раскладок таба на базе PlaceholderAPI
• %addhead_texture_value% - сырое значение текстуры
• %addhead_texture_signature% - сырая подпись текстуры
• %addhead_texture_hash% - хэш с textures.minecraft.net
• %addhead_skin_ready% - true или false, есть ли уже подтверждённый скин в общем кэше
• %addhead_tab_visible% - true или false, включён ли вывод головы в табе для конкретного игрока

Откуда берутся скины

AddHeads ищет скины в строгом порядке приоритета:

1. SkinsRestorer
2. Актуальный профиль игрока Paper
3. Поиск через обновление профиля Paper
4. Запрос к профилю/сессии Mojang по нику игрока
5. Уже закэшированное значение, полученное AddHeads ранее

Такая цепочка гарантирует, что голова найдётся почти всегда - даже если игрок с пиратки и скин установлен через SkinsRestorer. А единый кэш означает, что сервер не будет долбить Mojang запросами при каждом сообщении в чате.

Языки

Из коробки плагин переведён на несколько языков:

en-us | es-es | de-de | fr-fr | pt-br | zh-cn | ru-ru

Русский язык есть, так что GUI настроек и сообщения плагина будут понятны без дополнительных манипуляций. При перезагрузке новые языковые ключи и ключи конфига автоматически дополняются из встроенных значений по умолчанию - конфиг не сломается после обновления плагина.

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

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

Единственный реальный минус - требование Paper/Purpur 1.21.9+ и Java 21. На старых версиях сервера плагин просто не заведётся. Но если вы держите сервер на актуальной версии Minecraft, AddHeads - один из самых простых способов сделать чат и таб визуально приятнее без единого ресурспака. Скачать AddHeads и попробовать его в деле - дело пяти минут, а эффект на восприятие сервера игроками заметен сразу.