BanTools: гибкое управление банами на Velocity серверах

Плагин BanTools: Эффективное управление банами на Velocity серверах Minecraft

Администрирование сервера Minecraft требует не только творческого подхода к строительству и настройке миров, но и строгого контроля над нарушителями. Плагин BanTools создан специально для Velocity-прокси и предлагает комплексное решение для блокировки нежелательных игроков. Благодаря гибкой системе банов по UUID, IP-адресу или нику, а также поддержке временных ограничений, этот инструмент становится незаменимым помощником для поддержания порядка в вашем игровом сообществе.

Ключевые возможности BanTools

Плагин разработан с учётом реальных потребностей администраторов и включает следующие механики:

• Мультикритериальный бан: блокировка игрока по нику, UUID или IP-адресу. Если хотя бы одно условие совпадает с записью в базе, нарушитель не сможет зайти на сервер.
• Временные ограничения: можно указать длительность бана в днях (например, 7d) или задать конкретный диапазон дат. По истечении срока игрок автоматически разбанивается.
• Мгновенный кик: команда /bantools kick позволяет выгнать игрока прямо во время сессии, с указанием своей причины или стандартной из конфигурации.
• Гибкое снятие бана: при разбане запись не удаляется, а помечается как неактивная — это сохраняет историю нарушений для дальнейшего анализа.
• Динамическая перезагрузка конфигурации: все изменения в файле config.conf применяются без перезапуска сервера командой /bantools reload.
• Синхронизация в реальном времени: любые операции с банами мгновенно распространяются на все downstream-серверы, подключённые к Velocity.

Установка плагина

Процесс добавления BanTools на ваш Velocity-сервер прост и состоит из трёх шагов:

1. Скачайте плагин: загрузите актуальную версию BanTools.jar с официального репозитория или страницы релизов на GitHub.
2. Поместите файл в директорию: скопируйте скачанный JAR в папку plugins/ вашего Velocity-сервера.
3. Запустите сервер: после старта Velocity плагин автоматически создаст конфигурационный файл plugins/BanTools/config.conf с настройками по умолчанию.

Для упрощения управления серверными модификациями многие администраторы используют лаунчер foxygame.net. Этот современный инструмент позволяет не только быстро устанавливать и обновлять плагины вроде BanTools, но и гибко настраивать серверную среду прямо из удобного интерфейса, экономя время на рутинных задачах.

Конфигурация: настройка под ваш сервер

Файл config.conf содержит все параметры работы плагина. Рассмотрим его структуру:

• defaults.ban_reason — причина бана по умолчанию (например, «Нарушение правил сервера»).
• defaults.kick_reason — стандартная причина для кика.
• bans — список всех банов. Каждая запись включает:
  • name — никнейм игрока.
  • uuid — уникальный идентификатор.
  • ip — IP-адрес.
  • reason — конкретная причина блокировки.
  • start_time — время начала бана в формате Unix timestamp.
  • end_time — время окончания (null для перманентного бана).
  • state — статус: true (активен) или false (снят).

Благодаря хранению данных в HOCON-формате вы можете редактировать список банов вручную, а затем применить изменения без перезапуска сервера командой /bantools reload.

Основные команды и примеры использования

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

• /bantools reload (право: bantools.command.reload) — перезагружает конфигурацию.
• /bantools ban <тип> <значение> [длительность] [причина] (право: bantools.command.ban) — банит игрока. Тип может быть name, uuid или ip. Если длительность не указана, бан перманентный.
• /bantools unban <игрок> (право: bantools.command.unban) — снимает бан, помечая запись как неактивную.
• /bantools kick <игрок> [причина] (право: bantools.command.kick) — немедленно выгоняет игрока с сервера.

Примеры:

• Забанить игрока Bianpao_xiaohai навсегда: /bantools ban name Bianpao_xiaohai
• Забанить по IP на 30 дней: /bantools ban ip 192.168.1.100 30d Использование читов
• Разбанить Steve: /bantools unban Steve
• Кикнуть игрока с кастомной причиной: /bantools kick Steve Спам в чате

Поддержка и лицензия

Плагин BanTools распространяется под лицензией GNU General Public License v3.0, что даёт вам свободу использовать, модифицировать и распространять его. Разработчик не несёт ответственности за возможные проблемы, возникшие при использовании. Обратная связь и сообщения об ошибках принимаются через GitHub Issues.

Стоит отметить, что плагин создан с использованием технологий Velocity API, Typesafe Config и Adventure API, а его разработка велась при помощи искусственного интеллекта для обеспечения максимальной эффективности.

Заключение

BanTools — это мощный и лёгкий в настройке плагин для Velocity, который закрывает все потребности в управлении банами. Мультикритериальный поиск, временные ограничения, автоматическое снятие и синхронизация между серверами делают администрирование прозрачным и удобным. Благодаря поддержке динамической перезагрузки конфигурации вы можете оперативно реагировать на нарушения, не прерывая игровой процесс. Если вы стремитесь к порядку на своём сервере Minecraft, BanTools станет надёжным элементом вашего набора инструментов.