DecentHolograms: команды и как пользоваться

Установка: какую версию брать на 1.21 и 1.16.5

1. Скачайте jar с Modrinth или SpigotMC.
2. Остановите сервер, положите jar в plugins и запустите снова. Появится папка plugins/DecentHolograms с конфигами.
3. Обязательных зависимостей нет. С PlaceholderAPI в строках работают его плейсхолдеры, с HeadDatabase можно писать головы как HEADDATABASE_<id>.

Отдельной сборки под 1.16.5 или 1.21 не нужно: версия 2.10.1 по Modrinth идёт одним файлом на 1.8–1.21.x и 26.1–26.2. Предметы и мобы в строках доступны только те, что есть в версии вашего сервера.

Как сделать голограмму: первые команды

Встаньте на нужное место и выполните по очереди:

/dh h create welcome &6Добро пожаловать
/dh l add welcome 1 &7Привет, {player}
/dh l add welcome 1 #ICON: DIAMOND
/dh l set welcome 1 2 &aНовый текст второй строки
/dh h movehere welcome

• h это hologram, l это line, p это page. Полные имена тоже работают.
• Страницы и строки нумеруются с 1: в /dh l set welcome 1 2 первая цифра страница, вторая строка.
• Создать сразу по координатам: /dh h create top -l:world:0:100:0, по центру блока: флаг --center.
• Если текст не указан, берётся строка по умолчанию из config.yml.

С версии 2.10.0 есть второй тип: голограммы на Display-сущностях, команда /dh displays create <type> <name>. Они хранятся отдельно, страниц и клик-действий у них нет.

Что можно написать в строку

RGB пишется в форматах #rrggbb, &#rrggbb, <#rrggbb> и {#rrggbb}. Встроенные анимации: colors, wave, burn, typewriter, scroll, например <#ANIM:wave:&f,&b&l>Hello World</#ANIM>. В строках работают {player}, {page} и {pages}, плейсхолдеры PlaceholderAPI внутри анимаций разбираются только при включённой опции allow-placeholders-inside-animations.

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

Действия вешаются на страницу голограммы: /dh p addaction <голограмма> <страница> <клик> <действие>. Клики: LEFT, RIGHT, SHIFT_LEFT, SHIFT_RIGHT.

/dh p addaction welcome 1 RIGHT COMMAND:/spawn
/dh p addaction welcome 1 LEFT MESSAGE:&aHello {player}!
/dh p addaction welcome 1 RIGHT SOUND:ENTITY_CREEPER_PRIMED:0.5:0.5

• COMMAND:/help: команда от игрока. Без слэша текст уйдёт в чат.
• CONSOLE:say {player} clicked: команда от консоли, прокси-команды так не работают.
• CONNECT:lobby: перенос на сервер за прокси, имя берётся из конфига прокси.
• TELEPORT:world:0:100:0: телепорт.
• PERMISSION:some.permission: если права нет, следующие действия не выполняются.
• NEXT_PAGE, PREV_PAGE, PAGE:1: листать страницы.

Права: кому что выдать

Все команды, кроме /dh version, по умолчанию доступны только OP. Полный доступ даёт dh.admin. Права устроены ветками: dh.command.holograms, dh.command.lines, dh.command.pages, dh.command.displays, внутри каждой отдельные подкоманды, например dh.command.lines.add. Плагин сначала проверяет право ветки, поэтому одно право подкоманды без права ветки не сработает.

Для строителя, который только правит строки, достаточно:

/lp user <ник> permission set dh.command.lines true

Для /dh p addaction вики и plugin.yml называют право dh.command.pages.addaction, а код проверяет dh.command.pages.addactions. Надёжнее выдать всю ветку dh.command.pages или dh.admin.

Перенос из HolographicDisplays и других плагинов

Команда /dh convert <plugin> [file] переносит голограммы из HolographicDisplays, CMI, FutureHolograms, GHolo и Holograms. Сам старый плагин на сервере не нужен, достаточно его файла с голограммами в стандартной папке. Если файл лежит в другом месте, укажите путь вторым аргументом. Цветовой код &u из HolographicDisplays DecentHolograms понимает.