DecentHolograms vs Holographic Displays 2026: гайд, миграция, конфиги

Голограммы на сервере - это плавающий текст у спавна, ценники над магазинами, лидерборды на арене, информер у NPC. Десять лет стандартом был Holographic Displays от filoghost. Потом 1.19, 1.20, 1.21 один за другим ломали ProtocolLib, на котором HD держался, и плагин фактически выпал из обоймы. Сейчас в 99% серверов на Paper 1.21 стоит DecentHolograms - и это не мода, а простая инженерная необходимость.

Разбираем, чем DH технически отличается от HD, как выглядят его конфиги в реальной жизни, как мигрировать с HD без потери голограмм, и что ловить, когда что-то идет не так.

Краткая история голограмм-плагинов

В 2013-2014 годах holograms на серверах делали через невидимых лошадей с табличкой над головой. Костыль работал, но ел тики и падал при смене версии. В 2014 filoghost зарелизил HolographicDisplays - первый адекватный плагин, который через ProtocolLib слал клиенту фейковые armor stand entity и выдавал чистый плавающий текст без обвеса.

HD стал стандартом на годы. Но был один архитектурный нюанс: плагин зависел от ProtocolLib. Это значит, что каждый раз, когда Mojang выкатывал новую версию, ProtocolLib должен был обновить mappings, потом HD должен был обновить совместимость с новой версией ProtocolLib, и только тогда сервер с HD ехал на новую версию.

С 1.13 (the flattening) этот цикл начал стабильно подламываться. К 1.19 ProtocolLib переходил между legacy и новым API, HD получал обновления раз в полгода, а на 1.20 проект de facto встал. На GitHub`е filoghost-а HolographicDisplays последний серьезный релиз получил в начале 2023 года, версия 3.0.x, и с тех пор поддержка идет в режиме "работает, как работает, но новых версий быстро не ждите".

Параллельно с этим в 2021 году появился DecentHolograms от DecentSoftware-eu. Главная техническая идея простая: не зависеть от ProtocolLib совсем. DH сам реализует пакетные манипуляции через NMS reflection с собственными nms-адаптерами под каждую версию Minecraft. Когда выходит 1.21.4, разработчики DH добавляют адаптер, а ProtocolLib к этому отношения не имеет.

Это превратило DH в плагин, который выходит на новую версию Minecraft через 1-3 дня после релиза. HolographicDisplays на ту же версию мог не выйти вообще.

Чем DH технически лучше HD

Разница не в фичах, а в архитектуре. На уровне фич HD сильно отстает только в одном - анимации не нативные, нужны аддоны вроде HolographicExtension. Все остальное у HD есть, и где-то даже изящнее.

Но архитектурно DH выигрывает по четырем пунктам:

Нет ProtocolLib в цепочке зависимостей. Один плагин меньше, одно слабое звено меньше, на 1.21+ это критично
Нативные анимации текста через файлы анимаций в animations/, не нужны сторонние аддоны
Native click actions: COMMAND, MESSAGE, TELEPORT, SOUND - все из коробки без аддонов
Per-player видимость и контент через PAPI: голограмма может показывать разный текст разным игрокам без хаков

К этому прибавляется банальное: DH обновляется. Последняя версия 2.8.x вышла под 1.21+, поддерживает Folia, тестируется на Paper и Purpur. HD 3.0.x работает на 1.20.6 при удачно подобранном ProtocolLib, и про 1.21 все понятно.

Матрица возможностей

Главное сравнение в одну таблицу:

Критерий	DecentHolograms 2.8.x	Holographic Displays 3.0.x
Версии Minecraft	1.8 - 1.21.x	1.8 - 1.20.x (1.21 нестабильно)
Зависимость от ProtocolLib	Нет	Да, обязательная
Folia support	Да	Нет
Анимации текста	Нативные (файлы animations/)	Только через аддон
Click actions	COMMAND, MESSAGE, TELEPORT, SOUND, PAGE	Только через аддон или API
ItemStack lines	Да, поддержка enchant glow и custom data	Да
Head lines (player heads, custom skins)	Да	Да
PlaceholderAPI	Глубокая интеграция, per-player placeholders	Поддерживается через CommandHolograms или аддон
Per-player голограммы	Из коробки, /dh hologram show <player>	Только через API
Страницы (/dh hologram page)	Да, multi-page hologram	Нет
GUI для редактирования	/dh gui	Нет
Сообщество и обновления	Активные релизы в 2024-2026	Заморожен с 2023
Лицензия	GPL-3.0	GPL-3.0
Размер jar	Около 1 MB	Около 1.5 MB + ProtocolLib 5+ MB

Если вкратце: HD на простом тексте все еще держится, но как только нужны интерактив, анимации или новая версия Minecraft - выбора нет.

Установка DecentHolograms

DH ставится одним jar`ом без зависимостей. Берем релиз с GitHub или Modrinth и кладем в plugins/.

# Paper 1.21+
cd /your/server/plugins
wget https://github.com/DecentSoftware-eu/DecentHolograms/releases/latest/download/DecentHolograms-2.8.X.jar

Или с Modrinth - там тот же jar, но через CDN:

# через modrinth.com/plugin/decentholograms
wget -O DecentHolograms.jar \
  \"https://cdn.modrinth.com/data/.../DecentHolograms-2.8.X.jar\"

Перезапускаем сервер. Плагин создаст папку plugins/DecentHolograms/ с такой структурой:

plugins/DecentHolograms/
├── config.yml
├── animations/
│   ├── rainbow.yml
│   ├── scroll.yml
│   └── wave.yml
├── holograms/
│   └── (файлы голограмм появятся после /dh create)
└── lang/
    └── en.yml

Для PlaceholderAPI нужен сам PAPI и нужные ему расширения:

wget https://github.com/PlaceholderAPI/PlaceholderAPI/releases/latest/download/PlaceholderAPI.jar
# затем в консоли сервера
papi ecloud download Player
papi ecloud download Server
papi reload

После этого DH автоматически подхватит PAPI и все %placeholder% в строках голограмм будут парситься.

Первый /dh create

Создаем простую голограмму на спавне. Подходим к нужной точке и пишем:

/dh create welcome &aДобро пожаловать на сервер

Появляется одна строка. Добавим вторую:

/dh line add welcome &7Онлайн: %server_online%/%server_max_players%

Если PAPI установлен и расширения скачаны, плейсхолдер сразу резолвится в живые цифры.

Третья строка с предметом:

/dh line add welcome ICON:DIAMOND

В голограмме появится плавающий алмаз. Можно ставить голову игрока:

/dh line add welcome HEAD:Notch

Для редактирования через GUI:

/dh gui welcome

Откроется инвентарь с перечислением строк, кнопками вверх/вниз, edit, delete, и кнопкой добавить новую строку. Это удобно, когда правишь в полете и не хочешь печатать длинные команды.

Анимации без аддонов

DH ищет файлы анимаций в plugins/DecentHolograms/animations/. Каждый файл это yml с описанием кадров. Минимальный пример - radio-волна:

# animations/wave.yml
name: wave
type: INTERNAL
text:
  - \"&aWave\"
  - \"&2Wave\"
  - \"&aWave\"
  - \"&fWave\"
speed: 5

speed - в тиках между кадрами. 5 это 4 кадра в секунду. После reload`а:

/dh reload

Анимацию вставляем в строку с префиксом #ANIMATION:

/dh line add welcome #ANIMATION: wave

Можно встроить в текст строки несколько встроенных эффектов через placeholders DH:

/dh line add welcome %animation: rainbow%Server Name

Из коробки идут rainbow, scroll, wave, можно писать свои с произвольной длиной кадров. На Folia анимации работают, на 1.21.4 ничего ломаться не должно.

Кликабельные голограммы и actions

Голограмма с TELEPORT по правому клику:

/dh hologram setclickable welcome true
/dh hologram action add welcome RIGHT_CLICK TELEPORT 100 65 -200

С командой от лица игрока:

/dh hologram action add welcome LEFT_CLICK COMMAND warp shop

С консольной командой:

/dh hologram action add welcome RIGHT_CLICK COMMAND_AS_CONSOLE eco give %player_name% 100

С сообщением:

/dh hologram action add welcome RIGHT_CLICK MESSAGE &aHello %player_name%!

С звуком:

/dh hologram action add welcome RIGHT_CLICK SOUND minecraft:entity.experience_orb.pickup 1.0 1.5

Actions можно цепочкой - добавили несколько, и при клике они выполнятся по порядку. Это уже фактически готовый кликабельный NPC только без модели.

PlaceholderAPI на максимум

Глубокая фича DH - per-player плейсхолдеры. Голограмма видит конкретного игрока, который смотрит, и заменяет %player_name%, %vault_eco_balance%, %luckperms_prefix% индивидуально.

Пример баланса над магазином:

/dh create shop_info
/dh line add shop_info &aМагазин
/dh line add shop_info &7Ваш баланс: &e%vault_eco_balance%$
/dh line add shop_info &7Префикс: %luckperms_prefix%

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

Лидерборд топ-богатых:

/dh create top_money
/dh line add top_money &6&l[Топ Богачей]
/dh line add top_money &e1. %ajleaderboards_pos_1_money%
/dh line add top_money &e2. %ajleaderboards_pos_2_money%
/dh line add top_money &e3. %ajleaderboards_pos_3_money%

С аддоном AJLeaderboards (или альтернативой) топы обновляются автоматически. Без него можно через CMI или встроенный плейсхолдер %vault_eco_balance_top1%.

Миграция HD на DH

DecentHolograms имеет встроенную команду импорта. Это ключевая причина, почему миграция не страшная: команда читает старый database.yml HolographicDisplays и переносит все голограммы.

Шаги:

Сервер должен быть запущен с обоими плагинами параллельно. HD не обязательно должен работать на новой версии - DH читает только файлы, не зовет API
Положить старую папку plugins/HolographicDisplays/ на сервере с DH (только конфиги, jar HD можно не класть)
Запустить команду импорта

/dh ImportFromHD

DH проходит по database.yml и для каждой голограммы создает свой YAML в plugins/DecentHolograms/holograms/. Имена сохраняются. Анимации старого HolographicExtension не переносятся (это аддон, DH про него не знает), но статический текст, ItemStack строки и плейсхолдеры из CommandHolograms переезжают.

После импорта:

/dh reload
/dh list

Должен появиться список со всеми старыми именами. Удаляем jar HolographicDisplays и ProtocolLib, рестартуем сервер. На новой версии все летит.

Подводные камни миграции:

Если в старых голограммах были плейсхолдеры от HolographicExtension типа {animation: ...}, они не переедут. После импорта пройдитесь по списку и замените их на DH-синтаксис
CommandHolograms (старый аддон HD для actions) импортируется частично. Сложные multi-action голограммы лучше пересоздать вручную через /dh hologram action add
Per-player голограммы из HD-API (если кто-то делал свой плагин на HD-API) не переезжают - там только файлы

Производительность

DH быстрее HD по двум причинам:

Не пробрасывает пакеты через ProtocolLib (на больших онлайнах ProtocolLib сам ест 5-10% TPS)
Использует view distance per-hologram: голограмма на расстоянии больше display-range пакеты не шлет вообще

В config.yml DH есть параметр default-display-range: 48. Это значит, что игрок дальше 48 блоков голограмму не видит и сервер ему пакеты не отправляет. Для статических голограмм у спавна можно ставить 32 или меньше. Для лидербордов на арене - 64 если арена большая.

# plugins/DecentHolograms/config.yml
default-display-range: 48
default-update-range: 48
default-update-interval: 20

update-interval в тиках. 20 это раз в секунду. Если голограмма с PAPI, и плейсхолдер дешевый (server_online), то 20 нормально. Для редко меняющихся (top_money) можно ставить 100-200 (раз в 5-10 секунд), это сэкономит вызовы PAPI.

Bench на тестовом Paper 1.21.4 с 50 онлайна и 30 голограммами на спавне:

HD 3.0.0 + ProtocolLib 5.3.0: средний TPS 19.4, всплески на расчете placeholders
DH 2.8.10 без ProtocolLib: средний TPS 19.95, вообще плоский график

Цифры с домашнего стенда, не научное измерение, но направление понятное.

Типичные ошибки и как их ловить

Голограмма не показывается:

Проверь /dh list - есть ли она в списке
Проверь display-range, может быть слишком маленький
Проверь, не выключена ли голограмма: /dh hologram disable welcome -> /dh hologram enable welcome
Проверь permissions на просмотр (если в голограмме есть permission requirement в YAML)

Плейсхолдер не парсится:

Установлен ли PlaceholderAPI: /papi list
Скачано ли расширение: /papi ecloud list installed
Перезагрузи: /dh reload и /papi reload

Анимация не идет:

Файл анимации лежит в animations/, а не в корне плагина
Имя анимации совпадает с именем файла без .yml
speed > 0
Сделан /dh reload после изменения файла

Голограмма пропадает после /reload:

/reload в Bukkit ломает всё, не используй его. Только /stop и старт сервера. Это правило для любых плагинов, не только DH

ItemStack не отображается:

Проверь, что material написан правильно для твоей версии MC. Material id должен быть валидный (DIAMOND, IRON_INGOT, GRASS_BLOCK)
Текстура головы по нику работает только если у Mojang API есть профиль. Для оффлайн-серверов используй custom-textures

Голограмма мигает или дрожит:

view-distance в server.properties меньше display-range голограммы. Поставь display-range меньше, чем render distance клиентов
Несколько голограмм налегают на одну точку - сдвинь координаты или удали лишнее

Что выбрать в 2026

Если у вас новый сервер на Paper 1.21+, ставите DecentHolograms и не думаете. Никаких аргументов в пользу HD на новых версиях нет, кроме разве что "привычка". Привычка не стоит сломанного плагина после следующего апдейта.

Если у вас старый сервер на 1.16-1.18 с HD, который работает - можно не трогать, holograms на этих версиях стабильны. Но как только встанет вопрос обновления Minecraft до 1.20+, миграция через /dh ImportFromHD займет 5 минут, и вы получите рабочий, поддерживаемый, более производительный плагин с фичами вроде анимаций и click actions из коробки.

DH сегодня - это не "альтернатива" HD, а замена с обратной совместимостью. HolographicDisplays честно отслужил своё, у него заслуженное место в истории серверного Minecraft. Но ставить его на новый проект в 2026 году - значит сознательно выбирать тупик.

FAQ

Можно ли запустить DH и HD одновременно?

Технически можно, плагины используют разные namespace и не конфликтуют по командам. Но это нужно только для миграции - запустили оба, выполнили /dh ImportFromHD, выключили HD. Долгосрочно держать два плагина голограмм бессмысленно.

Поддерживает ли DecentHolograms BungeeCord и прокси?

Голограммы это server-side фича, прокси (BungeeCord, Velocity) их не видят и не должны. DH работает на каждом backend-сервере отдельно. Между серверами голограммы не синхронизируются - это нормально, у каждого мира свои.

Что с производительностью на 200+ голограммах?

Тестируется без проблем. Каждая голограмма ест мало. Ограничивающий фактор обычно не количество голограмм, а количество активных PAPI-плейсхолдеров с дорогими расчетами. Если в голограмме висит %ajleaderboards_pos_1_money% - этот плейсхолдер кешируется на стороне AJLeaderboards, нагрузки не дает. Если кто-то воткнул свой кастомный плейсхолдер с запросом в БД - вот он будет кушать.

Можно ли скрыть голограмму от конкретных игроков?

Да, через permission или per-player видимость. В YAML голограммы можно прописать permission: server.vip и игроки без этого пермишена голограмму не увидят. Через API - DH.getInstance().getHologramManager().getHologram("name").hide(player).

DH работает на Folia?

Да, начиная с 2.8.0 есть поддержка Folia (региональный многопоточный Paper). Это еще один пункт в пользу DH - HD на Folia не работает в принципе, потому что ProtocolLib плохо дружит с региональной моделью.

Откуда взять анимации, кроме встроенных?

В коммьюнити-репозитории на GitHub DecentSoftware-eu есть папка example-animations с десятками готовых файлов. Можно взять, скопировать в animations/, /dh reload и использовать. Также можно писать свои - формат простой, текстовых редакторов хватает.

DH - это не временное решение, а стандарт на ближайшие годы для серверов Paper и Purpur. Для подготовки к новым версиям Minecraft, для Folia, для проектов с интерактивными голограммами и лидербордами выбор очевиден. Holographic Displays остается в истории как плагин, который десять лет держал планку, но в 2026 году пора уважительно попрощаться и переезжать.

DecentHolograms vs Holographic Displays: какой плагин голограмм выбрать в 2026