Pterohost docs

Голограммы на сервере Minecraft: DecentHolograms

Как установить DecentHolograms и создать голограммы с плейсхолдерами, анимациями и статистикой на сервере Minecraft.

Кратко: DecentHolograms - современный плагин для плавающих голограмм на Minecraft-серверах. Устанавливается как один .jar-файл, поддерживает PlaceholderAPI, анимации и иконки предметов. Команда создания - /dh create.

Голограммы на сервере Minecraft: DecentHolograms

Голограммы давно стали стандартом оформления любого серьёзного Minecraft-сервера. Они показывают топ игроков прямо в мире, отображают баланс и онлайн в реальном времени, украшают спавн и добавляют интерактивности без единого блока интерфейса. В 2026 году самым активно поддерживаемым решением остаётся DecentHolograms - лёгкий и гибкий плагин с открытым исходным кодом, который заменил устаревший HolographicDisplays и работает на Paper/Spigot 1.20-1.21. Установка занимает две минуты, а широкие возможности анимации и плейсхолдеров PlaceholderAPI делают его пригодным для любых задач.

Pterohost - игровой хостинг для Minecraft с NVMe-дисками, защитой от DDoS и поддержкой 24/7. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг

Установка DecentHolograms

DecentHolograms распространяется как единый JAR-файл без зависимостей (PlaceholderAPI опционален). Порядок действий:

  1. Скачай актуальный релиз с GitHub или со SpigotMC (поиск “DecentHolograms”).
  2. Помести JAR в папку plugins/ сервера.
  3. Перезапусти сервер или выполни /reload confirm (лучше полный рестарт).
  4. Убедись, что в логах появилась строка [DecentHolograms] Plugin enabled.

После первого запуска в plugins/DecentHolograms/ появятся:

plugins/DecentHolograms/
  config.yml          - основные настройки
  holograms/          - папка с файлами голограмм (по одному .yml на каждую)
  lang/               - языковые файлы

Никакой базы данных не нужно - всё хранится в YAML-файлах.

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

ПлагинЗачем
PlaceholderAPIДинамические строки: онлайн, баланс, топы
DecentHolograms-PAPI ExpansionРасширение для использования голограмм как источника плейсхолдеров
LuckPermsОграничение видимости голограмм по правам

Если PlaceholderAPI уже установлен - он подхватывается автоматически. Дополнительная конфигурация не нужна.

Первая голограмма: команда /dh create

Самый быстрый способ создать голограмму - встать на нужное место и выполнить команду:

/dh create <имя>

Пример:

/dh create welcome_board

Голограмма появится там, где стоит игрок. Она будет пустой - одна строка-заглушка. Теперь добавь строки:

/dh addline welcome_board Добро пожаловать на сервер!
/dh addline welcome_board &6Онлайн: &e%server_online%
/dh addline welcome_board &7Сервер работает с 2024 года

Флаг &6 и подобные - стандартные цветовые коды Minecraft. Символ % обрамляет плейсхолдеры PAPI.

Управление строками

КомандаДействие
/dh addline <name> <text>Добавить строку в конец
/dh setline <name> <line> <text>Заменить строку по номеру (с 1)
/dh removeline <name> <line>Удалить строку по номеру
/dh insertline <name> <line> <text>Вставить строку перед указанной
/dh delete <name>Удалить всю голограмму
/dh listСписок голограмм
/dh info <name>Подробности: координаты, строки, мир

Типы строк: текст, иконки, пустые

DecentHolograms поддерживает три вида строк в одной голограмме.

Текстовая строка

Обычный текст с цветовыми кодами и плейсхолдерами:

/dh addline my_holo &b&lTOP PLAYERS &7(обновляется раз в минуту)

Строка-иконка (#ICON)

Отображает парящую 3D-модель предмета:

/dh addline my_holo #ICON:DIAMOND_SWORD

Можно использовать любой Material из Bukkit API. Иконка вращается сама по себе - анимировать не нужно.

Примеры материалов:

КодЧто показывает
DIAMOND_SWORDАлмазный меч
EMERALDИзумруд
PLAYER_HEADГолова (стандартная)
NETHER_STARЗвезда Незера
WRITTEN_BOOKКнига

Пустая строка (#EMPTY)

Добавляет вертикальный пробел между строками:

/dh addline my_holo #EMPTY

Удобно для визуального разделения блоков.

Настройка расположения и смещения

После создания голограмму можно переместить:

/dh teleport <name>           - переместить к себе
/dh moveto <name> <x> <y> <z> - абсолютные координаты

Расстояние между строками задаётся в конфиге config.yml:

defaults:
  down-origin: false
  line-height: 0.275     # высота между строками, в блоках

Уменьши line-height до 0.22 для более компактных голограмм.

Плейсхолдеры PAPI: онлайн, баланс, топы

Это главная причина, по которой большинство администраторов выбирают DecentHolograms. Любой плейсхолдер PlaceholderAPI работает прямо в строках голограммы.

Онлайн сервера

/dh addline server_info &aОнлайн: &f%server_online%&7/&f%server_max_players%

Плейсхолдеры %server_online% и %server_max_players% входят в стандартный набор PAPI (расширение Server).

Баланс игрока (Vault + EssentialsX)

/dh addline balance_board &6Ваш баланс: &e$%vault_eco_balance_formatted%

Требует PAPI-расширение Vault. Установи его командой:

/papi ecloud download Vault
/papi reload

Топ игроков через PlayerStats

Для топ-листов по убийствам, смертям, блокам используй PAPI-расширение PlayerStats:

/papi ecloud download PlayerStats
/papi reload

Пример голограммы с топом по убийствам:

/dh create top_kills
/dh addline top_kills &c&lТОП УБИЙСТВ
/dh addline top_kills #EMPTY
/dh addline top_kills &71. &f%playerstats_top_kills_playername_1% &7- &c%playerstats_top_kills_1%
/dh addline top_kills &72. &f%playerstats_top_kills_playername_2% &7- &c%playerstats_top_kills_2%
/dh addline top_kills &73. &f%playerstats_top_kills_playername_3% &7- &c%playerstats_top_kills_3%
/dh addline top_kills #EMPTY
/dh addline top_kills &7Обновляется каждые 60 сек

Топ баланса через Vault

/papi ecloud download VaultLists
/papi reload
/dh create top_balance
/dh addline top_balance &6&lТОП БОГАЧЕЙ
/dh addline top_balance #ICON:GOLD_INGOT
/dh addline top_balance &71. &e%vaultlists_top_balance_1% &7- &6$%vaultlists_top_balance_amount_1%
/dh addline top_balance &72. &e%vaultlists_top_balance_2% &7- &6$%vaultlists_top_balance_amount_2%
/dh addline top_balance &73. &e%vaultlists_top_balance_3% &7- &6$%vaultlists_top_balance_amount_3%

Примечание: конкретные плейсхолдеры зависят от установленного PAPI-расширения. Актуальный список всегда на PlaceholderAPI Wiki.

Анимации

DecentHolograms поддерживает встроенные анимации через специальный синтаксис прямо в тексте строки.

Анимация смены цветов (RAINBOW)

/dh addline my_holo <animation:RAINBOW:5:0>Добро пожаловать!</animation>

Формат: <animation:ТИП:СКОРОСТЬ:OFFSET>текст</animation>

Тип анимацииЭффект
RAINBOWРадужная прокрутка цветов
WAVEВолна выделенного цвета
TYPEWRITERЭффект печатной машинки
SCROLLГоризонтальная прокрутка
BURNЭффект горения (сверху вниз)
FLASHМигание

Пример с волной:

/dh addline animated_holo <animation:WAVE:3:0>&b&lPTEROHOST SERVER</animation>

Анимации через файл голограммы

Файлы голограмм хранятся в plugins/DecentHolograms/holograms/<name>.yml. Прямое редактирование даёт больше возможностей:

# plugins/DecentHolograms/holograms/welcome_board.yml
name: welcome_board
location: world:128.5:65.0:256.5
pages:
  - lines:
      - type: TEXT
        height: 0.3
        content: "<animation:RAINBOW:4:0>&lДОБРО ПОЖАЛОВАТЬ</animation>"
      - type: TEXT
        height: 0.3
        content: "&7Игроков онлайн: &f%server_online%"
      - type: ICON
        height: 0.6
        content: NETHER_STAR
      - type: TEXT
        height: 0.3
        content: "&6Промо: &e4START &6- скидка -20%% на хостинг"

После редактирования файла выполни:

/dh reload <name>

или для всех голограмм сразу:

/dh reload

Привязка к статистике: примеры боевых конфигураций

Инфоборд на спавне

/dh create spawn_info
/dh addline spawn_info &b&l[ PTEROHOST SMP ]
/dh addline spawn_info #EMPTY
/dh addline spawn_info &7Онлайн: &f%server_online%&7/&f%server_max_players%
/dh addline spawn_info &7TPS: &a%server_tps_1%
/dh addline spawn_info &7Пинг: &e%player_ping%ms
/dh addline spawn_info #EMPTY
/dh addline spawn_info &6Ваш ник: &f%player_name%
/dh addline spawn_info &6Ваш баланс: &e$%vault_eco_balance_formatted%

Голограмма возле магазина

/dh create shop_sign
/dh addline shop_sign #ICON:CHEST
/dh addline shop_sign &e&lМАГАЗИН
/dh addline spawn_info #EMPTY
/dh addline shop_sign &7Нажми &fF &7или &fPKM &7для открытия
/dh addline shop_sign &aРаботает 24/7

Таблица рекордов по добыче блоков

/dh create top_mined
/dh addline top_mined &a&lТОП ШАХТЁРОВ
/dh addline top_mined #ICON:DIAMOND_PICKAXE
/dh addline top_mined &71. &f%playerstats_top_mine_block:STONE_playername_1% &7- &a%playerstats_top_mine_block:STONE_1%
/dh addline top_mined &72. &f%playerstats_top_mine_block:STONE_playername_2% &7- &a%playerstats_top_mine_block:STONE_2%
/dh addline top_mined &73. &f%playerstats_top_mine_block:STONE_playername_3% &7- &a%playerstats_top_mine_block:STONE_3%

Тонкая настройка: config.yml

# plugins/DecentHolograms/config.yml
version: "2"

defaults:
  down-origin: false      # если true - точка привязки снизу голограммы
  line-height: 0.275      # расстояние между строками
  text-update-interval: 20  # интервал обновления текста в тиках (20 = 1 сек)
  icon-update-interval: 20  # интервал обновления иконок

permissions:
  enabled: true           # включить систему прав видимости

save-on-stop: true        # сохранять голограммы при остановке сервера

Параметр text-update-interval напрямую влияет на нагрузку. При 10-20 голограммах с PAPI-плейсхолдерами значение 40 (2 секунды) - хороший баланс между актуальностью и производительностью.

Ограничение видимости по правам

/dh setperm <name> <permission.node>

Пример - голограмма видна только донаторам:

/dh setperm vip_info pterohost.vip

Игрок без права pterohost.vip голограмму не увидит вообще - не получит пакет спавна.

Убрать ограничение:

/dh setperm vip_info ""

Полезные консольные команды

Все команды работают и из консоли сервера (без слеша через RCON или консоль панели):

# Создать голограмму в конкретных координатах
dh create spawn_top world 128 65 256

# Переместить существующую
dh moveto spawn_top world 130 65 258

# Клонировать голограмму
dh clone spawn_top spawn_top_copy

# Экспортировать все голограммы
dh export

Устранение типичных проблем

ПроблемаПричинаРешение
Плейсхолдеры не заменяютсяPlaceholderAPI не установлен или нет нужного расширения/papi list - проверь наличие расширения
Голограмма не появляетсяКонфликт с другими плагинами на тот же ивентПроверь latest.log на ошибки при загрузке
Иконка показывает серый блокНеверный MaterialПроверь точное название в документации Bukkit API
Анимация не работаетОпечатка в синтаксисе тегаФормат строго <animation:ТИП:СКОРОСТЬ:OFFSET>
TPS падает при обновленииСлишком малый text-update-intervalПоставь 40-60 тиков вместо 20

Связанные материалы

Для полноценного оформления сервера пригодятся: настройка охраняемых зон через WorldGuard, выбор ядра для максимальной производительности в статье Ядра Minecraft, а также практические советы по снижению нагрузки в руководстве Оптимизация сервера Minecraft.

Заключение

DecentHolograms - один из немногих плагинов, который закрывает сразу несколько задач: визуальное оформление спавна, динамические топы, инфоборды с реальным временем. Установка занимает пять минут, а гибкость PlaceholderAPI позволяет выводить любые данные - от баланса до TPS. Начни с базовых текстовых голограмм на спавне, затем подключи PAPI-расширения для топов и постепенно добавляй анимации. Итог - профессиональный вид сервера без единого лишнего плагина.

Pterohost - стабильный хостинг для Minecraft-серверов с NVMe, защитой от DDoS и поддержкой 24/7. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг