CustomDecentHolograms

Плагин для Minecraft серверов на Paper 1.21.10, предоставляющий удобную обертку для работы с голограммами через DecentHolograms с системой лимитов и управлением правами доступа.

📋 Функциональность

• 🎯 Создание голограмм с лимитами для игроков
• 📝 Управление строками голограмм (добавление, редактирование, удаление)
• 🏃‍♂️ Перемещение голограмм
• 👁️ Скрытие/отображение голограмм
• 🎨 Сообщения отправляются с MiniMessages форматированием
• 🛡️ Интеграция с WorldGuard (опционально)
• 📊 Система лимитов через права доступа

🚀 Установка

1. Убедитесь, что установлены:

   • Paper 1.21.10
   • DecentHolograms
   • WorldGuard (опционально)

2. Скачайте последний релиз из раздела Releases

3. Поместите файл CustomDecentHolograms.jar в папку plugins/

4. Перезагрузите сервер

5. Настройте конфиг plugins/CustomDecentHolograms/config.yml

6. Выполните команду /hg reload

⚙️ Конфигурация

После первого запуска создастся файл plugins/CustomDecentHolograms/config.yml:

# CustomDecentHolograms Configuration

# Префикс для сообщений
prefix: "<gray>[<green>Голограммы</green>]</gray>"

# Настройки WorldGuard
worldguard:
  enabled: false

# Лимиты
limits:
  max-lines: 6
  max-line-length: 40

# Строки, добавляемые в голограмму по умолчанию
default-lines:
  - "<#5BA4FA>&n&lГолограмма игрока {player}</#FF0000>"
  - "<#EAEAEA>Редактировать строку <#A0A0A0>» <#5BFA6F>/hg edit {hologram} <строка> <текст>"
  - "<#EAEAEA>Добавить строку <#A0A0A0>» <#5BFA6F>/hg addline {hologram} <текст>"
  - "<#EAEAEA>Удалить строку <#A0A0A0>» <#5BFA6F>/hg removeline {hologram} <строка>"
  - "<#EAEAEA>Показать все ваши голограммы <#A0A0A0>» <#5BFA6F>/hg list"
  - "<#EAEAEA>Доступное форматирование <#A0A0A0>» <#5BFA6F>/hg formats"

# Сообщения
messages:
  no-permission: "<red>У вас нет доступа к командам голограмм!"
  player-only: "<red>Эта команда только для игроков!"
  hologram-created: "<green>Голограмма {hologram} успешно создана!"
  hologram-limit-reached: "<red>Вы достигли лимита голограмм! Ваш лимит: {limit}"
  worldguard-deny: "<red>Вы не можете создавать голограммы в этом регионе!"
  invalid-arguments: "<red>Неверные аргументы команды!"
  hologram-not-found: "<red>Голограмма не найдена!"
  line-not-found: "<red>Линия не найдена!"
  reload-success: "<green>Конфигурация перезагружена!"
  no-holograms: "<yellow>У вас нет созданных голограмм!"
  hologram-deleted: "<green>Голограмма {hologram} успешно удалена!"
  hologram-delete-failed: "<red>Не удалось удалить голограмму {hologram}!"

  # Список сообщений для команды help
  help-commands:
    - "<green>Доступные команды:"
    - "  <white>/hg create <имя></white> <gray>- Создать голограмму в текущем месте"
    - "  <white>/hg move <имя></white> <gray>- Переместить голограмму к себе"
    - "  <white>/hg edit <имя> <строка> <текст></white> <gray>- Изменить строку голограммы"
    - "  <white>/hg addline <имя> <текст></white> <gray>- Добавить строку к голограмме"
    - "  <white>/hg removeline <имя> <строка></white> <gray>- Удалить строку голограммы"
    - "  <white>/hg hide <имя></white> <gray>- Скрыть/показать голограмму(ы)"
    - "  <white>/hg delete <имя></white> <gray>- Удалить голограмму"
    - "  <white>/hg list</white> <gray>- Показать ваши голограммы"
    - "  <white>/hg formats</white> <gray>- Показать доступные форматы"
    - "  <white>/hg help</white> <gray>- Показать эту помощь"
    - "  <white>/hg reload</white> <gray>- Перезагрузить конфигурацию <dark_gray>(требует права)</dark_gray>"
  help-limit: "  <gray>Ваш лимит голограмм: <white>{limit}</white>"

🎮 Команды

Основная команда: /hg или /hologram

/hg create <имя>                 - Создать голограмму в текущем месте
/hg move <имя>                   - Переместить голограмму к себе
/hg edit <имя> <строка> <текст>  - Изменить строку голограммы
/hg addline <имя> <текст>        - Добавить строку к голограмме
/hg removeline <имя> <строка>    - Удалить строку голограммы
/hg hide <имя>                   - Скрыть/показать голограмму(ы)
/hg delete <имя>                 - Удалить голограмму
/hg list                         - Показать ваши голограммы
/hg formats                      - Показать доступные форматы
/hg help                         - Показать помощь
/hg reload                       - Перезагрузить конфигурацию (требует права)

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

cdh.use              - Основной доступ к командам (по умолчанию: true)
cdh.reload           - Перезагрузка конфигурации (по умолчанию: op)
cdh.bypass           - Обход ограничений (по умолчанию: op)
cdh.amount.<число>   - Лимит количества голограмм (по умолчанию: op)

Примеры установки лимитов:

cdh.amount.5   - 5 голограмм
cdh.amount.10  - 10 голограмм
cdh.amount.20  - 20 голограмм

🎨 Форматирование текста

Используйте /hg formats для просмотра доступных форматов.

🌍 Интеграция с WorldGuard

При включенной интеграции с WorldGuard в конфиге:

• Игроки могут создавать/перемещать голограммы только в:
  • Глобальных регионах (__global__)
  • Регионах, где они являются владельцами/участниками

📁 Структура данных

• Конфигурация: plugins/CustomDecentHolograms/config.yml
• Данные игроков: plugins/CustomDecentHolograms/playerdata/
• Голограммы: сохраняются через DecentHolograms API

🐛 Сообщения об ошибках

Если вы обнаружили ошибку, пожалуйста:

1. Убедитесь, что используете последнюю версию плагина
2. Проверьте логи сервера для подробной информации
3. Создайте issue на GitHub с описанием проблемы

🤝 Разработка

Плагин разработан с использованием:

• Java 21
• Paper API 1.21.10
• DecentHolograms API

📄 Лицензия

Этот проект лицензирован под MIT License - смотрите файл LICENSE для деталей.

---

Примечание: Этот плагин является оберткой для DecentHolograms и требует его установки для работы.