Simple Whitelist - простой вайтлист по никнеймам

Simple Whitelist - это мод для Майнкрафт и одновременно серверный плагин, который решает одну конкретную задачу: пускать на сервер только тех, кого вы сами одобрили. Причём вайтлист здесь строится по никнеймам, а не по UUID, как в ванилле. Звучит как мелочь, но на практике это меняет подход к управлению доступом.

Зачем вообще нужен отдельный вайтлист

В ванильном Minecraft уже есть команда /whitelist, и многие админы ей пользуются. Но у стандартного механизма есть свои ограничения. Во-первых, ванильный вайтлист привязан к UUID игрока, а не к нику. Это значит, что если игрок сменил никнейм, его UUID остаётся прежним, и вы не всегда можете быстро понять, кто именно находится в списке. Во-вторых, ванильный вайтлист хранится в одном файле и не умеет работать с MySQL, что для крупных проектов с несколькими серверами становится проблемой.

Simple Whitelist закрывает оба этих момента. Он запоминает игроков по никнеймам, причём с учётом регистра: Steve и steve - это два разных игрока. Такой подход удобен, когда вы точно знаете, кого хотите видеть на сервере, и не хотите возиться с UUID. А возможность хранить данные в MySQL открывает дорогу для синхронизации вайтлиста между несколькими серверами в сети.

Проект существует в двух форматах: как мод для Fabric и как плагин для Bukkit-совместимых серверов. Оба варианта используют одни и те же правила и одну и ту же схему хранения, так что переносить данные между ними не придётся.

Ключевые особенности

• Вайтлист по никнеймам. Список привязан к именам игроков, а не к UUID. Регистр букв имеет значение.
• Два типа хранилища. Данные можно держать в обычном JSON-файле или в базе MySQL. Для небольшого приватного сервера хватит JSON, а для сети из нескольких серверов логичнее подключить MySQL.
• Экран настроек через ModMenu. Если вы играете на Fabric-клиенте с установленным ModMenu, появляется минималистичный экран конфигурации, где можно включить или выключить вайтлист. Это особенно удобно, когда вы открываете одиночный мир для игры по локальной сети и хотите быстро ограничить доступ.
• Единые правила для мода и плагина. Конфигурация и логика работы одинаковые в обоих вариантах, так что не возникает путаницы.

Fabric-мод: установка и зависимости

Для работы мода на Fabric потребуются две обязательные зависимости:

• Fabric API - базовая библиотека, без неё мод просто не запустится.
• Fabric Language Kotlin - поскольку мод написан на Kotlin, эта библиотека тоже обязательна.

Есть и опциональная зависимость: если вы хотите управлять доступом к командам через систему разрешений, установите провайдер fabric-permissions-api, например LuckPerms. Без него команды будут доступны только игрокам с уровнем оператора 4, что соответствует ванильному поведению.

Установка стандартная: скачайте .jar файл для вашей версии Minecraft и положите его в папку mods. Мод поддерживает широкий диапазон версий - от 1.18.x до актуальных 1.21.x и даже новых 26.x, так что проблем с совместимостью быть не должно.

Серверный плагин: один jar для всего

Если вы держите сервер на Spigot, Paper, Purpur или Folia, вам подойдёт плагин-версия Simple Whitelist. Один и тот же jar-файл работает на всех четырёх платформах, что приятно упрощает жизнь. Клиентский мод при этом не нужен - игроки подключаются как обычно.

Конфигурация плагина лежит в plugins/SimpleWhitelist/config.json, и схема полностью совпадает с модовой. Разрешение на использование команд - simplewhitelist.command, по умолчанию выдаётся операторам. Если у вас стоит LuckPerms или другой плагин разрешений, можете раздать доступ более тонко.

Единственное, что есть только в моде и отсутствует в плагине - это экран настроек через ModMenu. На сервере всё управление идёт через команды и конфиг-файл.

Настройка

Файл конфигурации находится по пути config/SimpleWhitelist/config.json для мода или plugins/SimpleWhitelist/config.json для плагина. Выглядит он так:

{
    "whitelist": true,
    "databaseType": "json",
    "mysqlUrl": "jdbc:mysql://<username>:<password>@<host>:<port>/<database>",
    "jsonFileName": "whitelist.json"
}

Разберём каждый параметр:

• whitelist - включает или выключает вайтлист. Поставьте false, если нужно временно пустить всех.
• databaseType - тип хранилища: json для файла или mysql для базы данных.
• mysqlUrl - строка подключения к MySQL. Заполняется только если выбран тип mysql.
• jsonFileName - имя JSON-файла, в котором хранится список. Актуально при типе json.

Настроек немного, и это скорее плюс. Не нужно разбираться в десятках параметров - указал тип хранилища, включил вайтлист, и всё работает.

Команды

Управление вайтлистом происходит через простой набор команд:

• simplewhitelist list - показать всех игроков в списке.
• simplewhitelist add <ник> - добавить игрока.
• simplewhitelist remove <ник> - убрать игрока.
• simplewhitelist on - включить вайтлист.
• simplewhitelist off - выключить.

Длинную команду simplewhitelist можно сократить до swl, swh или swhitelist - все алиасы работают одинаково. На сервере с плагином разрешение simplewhitelist.command по умолчанию есть у операторов.

Нюансы, которые стоит знать

Чувствительность к регистру - это палка о двух концах. С одной стороны, она даёт точный контроль. С другой - легко ошибиться при добавлении. Если вы напишете simplewhitelist add steve, а игрок заходит под ником Steve, его не пустит. Поэтому добавляйте ники точно так, как они написаны, с учётом заглавных букв.

Ещё один момент касается MySQL. Если вы используете базу данных и планируете подключить несколько серверов к одному вайтлисту, убедитесь, что строка подключения mysqlUrl указана корректно на каждом из них. Ошибка в порте или имени базы - и сервер просто не увидит список.

Для Fabric-версии не забудьте про Fabric Language Kotlin. Это частая причина, почему мод не запускается: Fabric API стоит, а Kotlin-библиотеку забыли. Лаунчер выдаст ошибку, но не всегда понятно с первого взгляда, в чём именно дело.

Кому пригодится

Simple Whitelist - находка для владельцев приватных серверов. Если вы играете с друзьями и не хотите, чтобы на сервер заходили посторонние, этот инструмент справится на отлично. Особенно удобно, что один и тот же проект покрывает и Fabric, и Bukkit-экосистему.

Для сетей серверов с MySQL тоже всё продумано: один вайтлист на все сервера, централизованное управление, никакой рассинхронизации. А если вы просто открываете мир для LAN и хотите ограничить доступ, экран ModMenu позволяет сделать это в пару кликов, не трогая конфиги.

Скачать Simple Whitelist стоит, если ванильный вайтлист вас не устраивает и хочется более гибкого решения с поддержкой MySQL и привязкой к никнеймам. Проект простой, но свою задачу выполняет чётко.