Плагин 🔥NearManager | Многофункциональный плагин на команду /near для слежки игроков v2.1

И этим плагином моим я тоже решился заняться, так как я его очень давно не обновлял, да и ошибок в нём есть много. В общем, я решил полностью сделать полный рефакторинг кода и сделать его более похожим по структуре, классам и коду, как мои другие плагины. Я исправил множество багов, возникающих в классе HexColors, недочёты в пермишенах, где они частенько ломались, поработал над жёсткой оптимизации кода, добавил новые некоторые классы улучшил методы и так далее. В общем, это обновление очень важное, так что лучше всего обновится)

Список всех изменений и улучшений:

— Полный архитектурный рефакторинг всего плагина и кода
— Значительно улучшена оптимизация плагина благодаря устранению скрытых нагрузок в тикерах и оптимизации часто вызываемых методов
— Добавлена новая система миграций и автоматического обновления конфигурации ConfigUpdater
— Полностью переработана работа с цветами класса HexColors, где добавлена нормальная поддержка MiniMessage для 1.17+ и обратная совместимость со старыми версиями
— Полностью переработана система команд с переходом на подкоманды
— Добавлена поддержка отображения любых плейсхолдеров плагина PlaceholderAPI для каждого найденного игрока в списке неара
— Улучшена совместимость с плагинами в коде (например с EssentialsX, CMI, SuperVanish, PremiumVanish и другими)
— Исправлен баг, из-за которого мёртвые игроки на экране возрождения могли ошибочно отображаться в списке поблизости
— Исправлена логика работы и приоритетов радиусов поиска при одновременном использовании пермишена и привилегии из плагина LuckPerms
— Улучшена работа трекера BossBar, где теперь вся математика и сборка строк вынесены в асинхронный поток, а также добавлено автоснятие при смерти или уходе цели в ваниш
— Улучшено вычисление направлений взгляда игрока в классе DirectionUtils для более точного и быстрого отображения стрелочек в чате и боссбаре
— Исправлен баг в системе проверки обновлений UpdateChecker, вызвавший ложные уведомления о новых версиях на GitHub
— Исправлены различные мелкие ошибки и недочёты, возникавшие при перезагрузке плагина или сервера

Стоит обновить плагин?

Да, думаю стоит, и так всегда я говорю. И всё так же, удалять конфиг и папку плагина не стоит, так как всё что надо, обновится автоматически )

Итак, я решил плагин прям полностью переписать, хотя почти функции не изменились, но код стал намного лучше. Ещё хочу подметить, что я сильно поработал с оптимизацией, да и вообще почти со всеми методами, теперь плагин должен работать идеально)

Так что же именно сделано в новой версии?

— Полный рефакторинг кода
— Добавлен новый класс для отслеживания обновлений
— Добавлены новые классы для поддержки PlaceholderApi и bStats
— Добавлено много новых сообщений в конфиг
— Сообщения были полностью переделаны под систему акшонов
— Добавлено несколько параметров новых в конфиг
— И остальное ещё по-мелочи

В общем, обновление очень неплохое, давненько я вообще не обновлял этот плагин. Если думаете стоит ли поставить новую версию — конечно стоит, так как она в разы лучше и эффективнее старой. И да, если всё-таки будете обновляться, то сохраните и удалите старый конфиг, чтобы появился новый )

Новые добавления/исправления:

• В конфигурацию добавлен новый параметр "near-cooldown". Он позволяет включать/выключать задержку при использовании команды /near. Также добавлено сообщение в конфиг и звук в sounds.yml для этого параметра
• Добавлен параметр в конфигурацию "hide-vanished-players", который позволяет включать/выключать скрытие игроков в невидимости (или в ванише) при использовании /near. Добавлен пермишен "nearmanager.near.bypass-vanish" для обхода этого ограничения
• В конфиг добавлен параметр ignored-players, который позволяет включать/выключать скрытие игроков с указанными никнеймами из /near
• Добавлено новое сообщение "player-offline" вместе с новым звуком, которое говорит о том, что игрок вышел и боссбар исчез
• Добавлено ещё одно сообщение "too-far" вместе с новым звуком, которое говорит о том, что игрок слишком далеко для активации боссбара
• Добавлен ещё новый параметр "custom-radius-selection", при включении которого игрок может сам выбирать любой радиус до своёго максимального. Также добавлено к этому параметру новое сообщение и звук
• Исправлен баг, связанный с последнем выданным пермишеном для радиуса

Новые параметры config.yml:

Спойлер: [Открыть]

YAML:

settings:
  # Настройка задержки для команды /near
  # Для обхода данной задержки нужно использовать пермишен "nearmanager.near.bypass-cooldown"
  near-cooldown:
    # Включить задержку для команды /near (true/false)
    enabled: true
    # Время задержки (В секундах)
    time: 5

  # Настройка скрытия игроков в невидимости, отображаемых в /near (или в ванише, например, через CMI или Essentials)
  # Для обхода скрытия, чтобы в невидимости игроки были видны, нужно использовать пермишен  "nearmanager.near.bypass-vanish"
  hide-vanished-players:
    # Включить скрытие игроков в невидимости (true/false)
    enabled: true

  # Настройка скрытия определённых игроков по никнеймам, отображаемых в /near
  ignored-players:
    # Включить скрытие указанных игроков (true/false)
    enabled: false
    # Список никнеймов игроков, которые не будут отображаться в /near
    players:
      - "Player1"
      - "Player2"
      - "Player3"
      - "_Player3"

  # Настройка возможности игрокам выбирать радиус для команды /near
  custom-radius-selection:
    # Включить возможность выбора радиуса (true/false)
    enabled: true
    # Минимальный радиус, который можно указать (0 или больше)
    min-radius: 0

messages:
  near-messages:
    cooldown: "&#FB8808◆ &fПодождите &#FFFF00{time} сек.&f, чтобы использовать команду снова!"
    invalid-max-radius: "&#FB8808◆ Стоп! &fВаш максимальный радиус &#FB8808{max-radius} &fблока(ов)!"
  plugin-messages:
    bossbar-messages:
      too-far: "&#FB8808◆ &fВы &#FB8808слишком далеко &fот игрока &#FB8808{player} &fдля боссбара!"
      player-offline: "&#FB8808◆ &fБоссбар исчез, так как игрок &#FB8808{player} &fвышел из сети..."

Новый звук в sounds.yml:

Спойлер: [Открыть]

YAML:

sounds:
  near-messages:   
    cooldown:     
      enabled: true
      sound: BLOCK_ANVIL_LAND
      volume: 1.0
      pitch: 1.0
    invalid-max-radius:
      enabled: true
      sound: BLOCK_ANVIL_LAND
      pitch: 1.0
      volume: 1.0

[/CODE]