MobTag

MobTag позволяет отображать настраиваемые теги здоровья над мобами и игроками в реальном времени. Система оптимизирована для работы по принципу «от игрока», что исключает лишнюю нагрузку на сервер при большом количестве существ.

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

Система обновления работает «от каждого игрока»: плагин проверяет только тех существ, которые находятся рядом с конкретным пользователем, а не сканирует весь мир. Это обеспечивает масштабируемость производительности, так как нагрузка зависит от количества активных объектов в зоне видимости игрока, а не от общей численности мобов на сервере.

Каждый тег рендерится индивидуально для каждого игрока. Это означает, что два человека, стоящие рядом, могут видеть разные теги или не видеть их вовсе. В версии 2.1.0 плагин получил поддержку MiniMessage для использования градиентов и современных тегов, а также обновленный цикл обработки, который стал значительно быстрее.

Плагин поддерживает два движка рендеринга. Режим AUTO автоматически выбирает оптимальный вариант: пакетная передача данных через PacketEvents (обеспечивает плавное движение и нулевую нагрузку на сервер) или использование невидимых стоек для брони (ArmorStands) в качестве универсального решения.

Для тех, кто использует ArmorStands, доступен режим ride-mob, который прикрепляет тег как реального пассажира. Это обеспечивает идеально плавное движение, однако в этом режиме смещение высоты тега перестает применяться, а моб становится непригодным для езды.

✨ Основные возможности визуализации включают:

• Полностью настраиваемый формат тегов с поддержкой цветов, символов, кастомных имен и градиентных полосок здоровья.
• Динамическая полоска здоровья, которая меняет цвет в зависимости от процента оставшегося HP.
• Специфические форматы для разных типов сущностей: можно настроить уникальный вид для боссов или любых других мобов.
• Настройка масштаба тега и радиуса их отображения.
• Анимация урона: теги визуально реагируют (вспышка и подпрыгивание) при получении повреждений.
• Индикаторы урона: плавающие цифры с анимацией, затуханием и форматированием критических ударов для ближнего боя, луков, арбалетов, трезубцев, снежков и эффектов взрывного зелья.

Индикаторы урона обладают продвинутыми функциями для предотвращения визуального мусора:

• Слияние урона: повторяющиеся удары по одной цели объединяются в общую сумму в течение заданного времени.
• Ограничение на игрока: устанавливается лимит на количество одновременно отображаемых цифр урона, чтобы избежать перегрузки клиента при использовании AoE-атак или гриндеров.
• Позиционирование: цифры появляются на поверхности моба лицом к атакующему, а не внутри модели.

👁️ Видимость и фильтрация

Администраторы могут детально настроить условия отображения тегов:

• Режимы видимости: ALL (всем в радиусе), DAMAGER (только тому, кто нанес последний удар) или LOOKING_AT (только на то, на что смотрит игрок).
• Требование прямой видимости: в режиме LOOKING_AT теги не будут отображаться сквозь стены.
• Умное скрытие: теги автоматически скрываются, когда у моба полное здоровье, он не находится в бою, является невидимым или исчез (vanished) через интеграции с Essentials, CMI, SuperVanish или PremiumVanish.
• Игнорирование объектов: возможность скрывать NPC, питомцев (через список метаданных) и пассивных животных (коровы, овцы и т.д.) на основе их поведения.
• Обработка боссов: специальные настройки для Вардена, Древнего Стража и других сущностей из пользовательского списка.
• Черный список миров: возможность полностью отключить отображение тегов в определенных локациях.

⚙️ Конфигурация и управление

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

• Внутриигровое меню настроек: каждый игрок может самостоятельно включать или выключать теги мобов, теги игроков и индикаторы урона.
• Командные переключатели: возможность быстрого управления функциями без открытия меню.
• Сохранение предпочтений: настройки игроков сохраняются после перезапуска сервера.
• Админ-команды: инструменты для перезагрузки конфигурации и отладки (просмотр количества тегов, времени цикла и статуса хуков).

/mobtag
/mobtag toggle mobs
/mobtag toggle players
/mobtag toggle damage
/mobtag admin reload
/mobtag admin debug

🔌 Интеграции и совместимость

MobTag эффективно взаимодействует с популярными инструментами:

• PlaceholderAPI: работа внутри форматов тегов и предоставление собственных плейсхолдеров.
• MythicMobs: поддержка кастомных форматов и отображение внутренних имен сущностей.
• PacketEvents: обеспечивает плавную работу тегов и индикаторов урона без нагрузки на сервер.
• Floodgate / Geyser: специальные настройки смещения высоты для игроков с Bedrock, так как Geyser иначе привязывает теги.
• MiniMessage: поддержка современных тегов (градиенты и т.д.) с автоматическим откатом к легаси-кодам, если сервер не поддерживает Adventure.

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

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

Доступные переменные в форматах тегов:

• {name} — кастомное имя моба (или тип, если имя отсутствует)
• {type} — тип сущности (например, ZOMBIE)
• {current} — текущее здоровье
• {max} — максимальное здоровье
• {bar} — полоска здоровья
• {percent} — процент здоровья (например, 75.0)
• {mythic_name} — внутреннее имя MythicMob

Поддерживаются стандартные цветовые коды &, шестнадцатеричные цвета &#RRGGBB и теги MiniMessage (например, <gradient:#ff0000:#00ff00>).

❓ FAQ

Как избежать нагромождения цифр урона при быстрых атаках?
Плагин автоматически объединяет несколько ударов по одной цели в одну цифру в течение заданного времени (merge_window_ticks), чтобы не засорять экран.

Что произойдет, если мой сервер не поддерживает MiniMessage?
Если сервер не поддерживает Adventure, плагин автоматически откатится к использованию стандартных цветовых кодов.

Поддерживаются ли мобы из сторонних модов?
Плагин автоматически определяет модов и новых животных на основе их поведения, поэтому пассивные мобы из модов будут корректно обрабатываться.