VeinGuard (Вейнгард)

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

Возможности

• Отслеживает выбранные типы блоков и скорость их разрушения за заданный промежуток времени.
• Начисляет уровень нарушений (VL): он уменьшается со временем, а при достижении порога выполняются настроенные команды, например кик или заморозка.
• Объединяет последовательные срабатывания в один инцидент добычи и поддерживает задержки уведомлений, чтобы не засорять чат персонала.
• Отправляет оповещения в чат или строку действия, консоль и Discord через вебхук.
• Показывает подробный отчёт по игроку, историю инцидентов и таблицу лидеров. Данные хранятся в SQLite или MySQL.
• Позволяет патрулировать игроков в режиме наблюдателя: переключаться между ними, следить за статусом через боссбар, приостанавливать и продолжать патруль.
• Игроков можно исключать из проверки целиком либо для отдельных блоков. Также можно не учитывать творческий режим, отдельные миры и добычу выше указанной высоты.
• При наличии WorldGuard проверку в регионе включает или отключает флаг veinguard-check.

Команды

• /vg check <player> — отчёт о недавней добыче игрока.
• /vg history <player> [time] — история инцидентов, в том числе для игроков не в сети.
• /vg top [time] — таблица игроков с высокими уровнями нарушений, количеством блоков и срабатываний.
• /vg patrol <start|stop|pause|resume|next|back> — управление патрулём.
• /vg mute <player> и /vg unmute <player> — отключить или вернуть оповещения об игроке.
• /vg toggle-alerts [player] — переключить получение оповещений.
• /vg tracked-blocks <add|list|remove> — изменить список отслеживаемых блоков без перезапуска.
• /vg reload — перечитать файлы настроек и языка.
• /vg reset <player> и /vg resetall — очистить текущую историю добычи и VL одного игрока или всех игроков в сети.
• /vg purge <time> [player] — удалить старые данные из базы.
• /vg help [page] — список команд; /vg msg <player> <msg> — сообщение игроку; /vg staffmsg <msg> — сообщение персоналу.

Права

• veinguard.admin — полный доступ.
• veinguard.mod — стандартный набор прав модератора.
• veinguard.notify — получение игровых оповещений.
• veinguard.bypass — полное исключение из отслеживания.
• veinguard.bypass.[MATERIAL] — исключение для конкретного блока, например veinguard.bypass.DIAMOND_ORE.
• veinguard.unmute — снятие заглушения оповещений об игроке.
• veinguard.resetall — очистка данных всех игроков в сети.

Настройка

В config.yml укажите блоки для проверки, например DIAMOND_ORE и ANCIENT_DEBRIS, их лимиты threshold и временные интервалы. Там же настраиваются вес срабатываний для VL, автоматические действия, фильтры миров и высоты, задержки уведомлений и подключение базы данных. Файл lang.yml содержит сообщения плагина.

Требования

Работает на серверах Spigot, Paper, Purpur и совместимых ядрах. Требуется Java 17 или новее. Для региональных правил нужен WorldGuard.