YetAnotherWhitelistPlugin (YAWL) — лёгкий белый список для Velocity

YetAnotherWhitelistPlugin (YAWL)

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

Почему выбирают YetAnotherWhitelistPlugin (YAWL)?

В мире, где многие плагины стремятся добавить как можно больше функций, YAWL выделяется своей философией минимализма. Он делает ровно то, что должен, и делает это безупречно. Вот ключевые преимущества, которые оценили администраторы серверов Minecraft по всему миру.

• Предельная лёгкость. Плагин практически не потребляет ресурсы прокси, не вызывает лагов и не замедляет работу сети серверов. Вы забудете о его существовании, пока он надёжно фильтрует подключения.
• Управление через текстовый файл. Белый список хранится в обычном whitelist.txt. Вы можете редактировать его в любом текстовом редакторе, а затем применить изменения одной командой без перезагрузки прокси.
• Гибкая конфигурация. Файл config.toml позволяет включать и отключать белый список, менять язык сообщений, настраивать чувствительность к регистру и многое другое.
• Мультиязычность. YAWL поставляется с готовыми переводами на русский, английский, немецкий, французский, японский и другие языки. Плагин даже умеет автоматически показывать сообщения на языке клиента игрока.
• Мгновенная перезагрузка. Команда /yawl reload применяет все изменения конфигурации и белого списка за секунду, не требуя рестарта Velocity.
• Детальные права доступа. С помощью пермишенов вы можете точно разграничить, кто из администраторов может добавлять, удалять игроков или перезагружать плагин.

Установка YetAnotherWhitelistPlugin (YAWL) на Velocity

Процесс установки максимально прост и не требует специальных знаний. Скачать YetAnotherWhitelistPlugin (YAWL) можно с официальной страницы релизов или с Modrinth. Полученный .jar файл необходимо поместить в папку plugins вашего прокси Velocity. После запуска или перезапуска прокси плагин автоматически создаст структуру каталогов plugins/yawl с файлами config.toml, папкой locales и пустым whitelist.txt. Дальше останется лишь настроить всё под свои нужды.

Если вы предпочитаете автоматизацию, лаунчер foxygame.net предлагает YetAnotherWhitelistPlugin (YAWL) в своём каталоге дополнений — достаточно выбрать плагин, и лаунчер сам разместит его в нужной папке, а также будет следить за обновлениями, избавляя вас от ручной замены файлов.

Настройка и конфигурация

Все параметры плагина собраны в файле plugins/yawl/config.toml. Он написан в интуитивно понятном формате и содержит подробные комментарии. Рассмотрим основные опции.

• enabled — включает или отключает белый список. Если установлено false, плагин не будет никого отключать, что удобно для временного открытия сервера.
• locale — задаёт язык сообщений плагина по умолчанию. Доступны en, ru, de, es, fr, ja, uk, zh-cn, pt-br, tr и другие.
• use-client-locale — если включено, плагин будет автоматически определять язык клиента игрока и показывать сообщения на нём, при условии что соответствующий файл локали существует.
• case-sensitive — определяет, учитывать ли регистр имён в белом списке. Рекомендуется оставить false, чтобы избежать путаницы.
• kick-active-on-revoke — при удалении игрока из белого списка или истечении временного доступа он будет немедленно отключён, если установлено true.
• placeholder-reload-interval — интервал обновления плейсхолдера %yawl_duration% в минутах.

Команды и управление белым списком

Все команды YAWL начинаются с префикса /yawl. Они интуитивно понятны и покрывают все повседневные задачи администрирования.

• /yawl — показывает справочное сообщение со списком доступных команд.
• /yawl add <игрок> — добавляет игрока в белый список навсегда.
• /yawl add <игрок> [<длительность>] — добавляет игрока на ограниченное время. Длительность можно указать в формате типа 1d2h30m.
• /yawl extend <игрок> [<длительность>] [add|replace] — продлевает или заменяет временной лимит игрока. Если срок истёк, плагин предложит заменить время от текущего момента или добавить к старому.
• /yawl remove <игрок> — удаляет игрока из белого списка.
• /yawl list — выводит список всех игроков, находящихся в белом списке.
• /yawl reload — перезагружает конфигурацию и файл whitelist.txt без остановки прокси.

Права доступа и безопасность

YetAnotherWhitelistPlugin (YAWL) для Minecraft предлагает гибкую систему разрешений, которая позволяет точно настроить, кто из персонала может управлять белым списком. Все пермишены выдаются через любой совместимый плагин прав на Velocity.

• yawl.bypass — позволяет игроку обходить белый список и подключаться к серверу, даже если его нет в списке. Полезно для владельцев и администраторов.
• yawl.command.add — даёт доступ к команде /yawl add.
• yawl.command.extend — разрешает использовать /yawl extend.
• yawl.command.remove — разрешает удалять игроков из белого списка.
• yawl.command.list — позволяет просматривать список белого списка.
• yawl.command.reload — даёт право на перезагрузку конфигурации и файла белого списка.

Поддержка языков и плейсхолдеры

Одной из сильных сторон YAWL является встроенная мультиязычность. В папке locales вы найдёте готовые файлы для более чем десяти языков. Вы можете редактировать их под себя или создавать новые. Если включена опция use-client-locale, плагин автоматически подстроится под язык, установленный в клиенте игрока, что делает взаимодействие максимально комфортным.

Начиная с версии 1.2, YAWL поддерживает плейсхолдер %yawl_duration%, который показывает оставшееся время доступа для временно добавленных игроков. Чтобы использовать его, на бэкенд-серверах должны быть установлены YetAnotherWhitelistCompanion и PlaceholderAPI. Это позволяет выводить таймер обратного отсчёта в табах, сообщениях или любых других местах, где работают плейсхолдеры.

YetAnotherWhitelistPlugin (YAWL) — это образец того, каким должен быть современный плагин для Velocity: простым, быстрым и надёжным. Он не пытается быть всем сразу, а сосредоточен на одной задаче — управлении белым списком через текстовый файл. Отсутствие баз данных, мгновенная перезагрузка и поддержка множества языков делают его незаменимым инструментом для администраторов, которые ценят своё время и стабильность сервера. Скачайте YAWL, настройте за пару минут и забудьте о проблемах с нежелательными гостями.