- Документация
- https://modrinth.com/plugin/noble-whitelist
Noble Whitelist — серверный плагин для управления белым списком Minecraft. Он позволяет проверять доступ по имени игрока, UUID или разрешению, а отдельные способы проверки можно сделать обязательными, необязательными либо отключить. Проект распространяется по лицензии MIT и не требует клиентского компонента.
Плагин относится к управлению и служебным инструментам. Подтверждены локальное и SQL-хранение, общий список через MySQL, автоматическая регистрация и настраиваемые проверки входа.
Обычный белый список чаще всего опирается на один способ идентификации. Noble Whitelist расширяет эту модель тремя заявленными основаниями:
• имя игрока;
• UUID;
• наличие разрешения.
Каждое основание можно сделать обязательным, необязательным или отключить. Логика сочетания условий и формат настроек не раскрыты.
Поддержаны все три варианта, но их приоритет при расхождении данных не описан.
Перед запуском следует определить:
• какой идентификатор считается основным;
• нужен ли дополнительный контроль по разрешению;
• какие проверки должны быть обязательными;
• что происходит с ранее добавленными игроками;
• как обрабатываются изменения имени;
• кто имеет право менять список.
Наличие отдельного параметра для каждого пункта не подтверждено.
Заявлены настраиваемые проверки входа, разрешения и обхода.
Право обхода следует выдавать осторожно. Для теста нужны три аккаунта:
• внесённый в белый список;
• не внесённый;
• имеющий разрешение обхода.
Последовательность условий и реакция на недоступное хранилище не описаны.
Noble Whitelist поддерживает плоские файлы и SQL-хранилища.
Формат локальных файлов и полный перечень СУБД не раскрыты. Прямо названа только MySQL для общего списка.
При выборе хранения стоит учитывать:
• число серверов;
• необходимость общего списка;
• резервное копирование;
• доступность базы данных;
• порядок переноса существующих записей.
Автоматическая миграция не подтверждена.
Общий список между серверами заявлен через MySQL.
Синхронизация локальных файлов и автоматическое устранение конфликтов не заявлены. Нужно проверить:
• подключение каждого тестового сервера;
• появление одной записи на другом узле;
• удаление и повторное добавление;
• поведение при временной недоступности MySQL;
• сохранность резервной копии.
Поведение при сбое заранее не гарантировано.
Заявлена автоматическая регистрация whitelist, но её условие и момент не уточнены.
Перед включением следует проверить, кто добавляется и какая запись создаётся.
Регистрация во внешних системах не подтверждена.
Заявлена поддержка PlaceholderAPI и MiniPlaceholders, но список плейсхолдеров не приведён.
Noble Whitelist Discord Integration указана как необязательная зависимость. Её команды и формат уведомлений не описаны.
API обозначено как планируемое, поэтому считать его готовой функцией нельзя.
Подтверждены Bukkit, Folia, Paper, Purpur и Spigot; в исходном тексте Paper рекомендован. Особенности Folia не описаны.
Заявлены версии Minecraft:
• ветка 1.18, включая 1.18.1 и 1.18.2;
• выпуски 1.19–1.19.4;
• выпуски 1.20–1.20.6;
• выпуски 1.21–1.21.11;
• 26.1, 26.1.1, 26.1.2 и 26.2.
Указана Java 17+, рекомендована Java 21+; среду нужно согласовать с ядром.
JAR помещают в папку plugins совместимого сервера. Практический порядок:
• выбрать файл для нужной версии;
• создать резервную копию сервера и старых данных whitelist;
• поместить один JAR в plugins;
• выполнить полноценный перезапуск;
• убедиться, что плагин загрузился;
• выбрать и проверить способ хранения;
• протестировать вход по имени, UUID и разрешению;
• отдельно проверить обход и общий MySQL-список, если они используются.
Команды, параметры подключения и структура конфигурации не раскрыты.
Подтверждены два файла:
• NobleWhitelist-1.2.24.jar, версия 1.2.24, 281 942 байта;
• NobleWhitelist-1.2.23.jar, версия 1.2.23, 281 929 байт.
Для 1.2.24 опубликованы SHA-512 39e25b0fc3d009f3860a3de731eb14cde295ac7f94ea2b2a152d517044bbe1c685e1021bf90f98a3fffa360d3cc7aed7d3ebdfa70056459ed5122169a6327613 и SHA-1 6b612963ddd1bb38f7df1f3c1d8579b21722ed32.
Для 1.2.23 указаны SHA-512 b30f20bdc4637a69884053f786d550908aaa2eb1f87e3740e90559112240e9266d8cf905793876447227ceb3d4271056c431c5afe68d3e6de97112f7d4f17b8d и SHA-1 be834a5bc90f5c224de92df5debeebe52a6b4e79.
Версию определяют по имени, размеру и хешу.
До переноса на основной сервер стоит составить матрицу сценариев:
• корректное имя и UUID;
• запись только по одному идентификатору;
• наличие и отсутствие требуемого разрешения;
• пользователь с обходом;
• автоматическая регистрация;
• вход после перезапуска;
• подключение к двум серверам с общей MySQL-базой;
• недоступность SQL-хранилища;
• работа PlaceholderAPI или MiniPlaceholders, если они установлены.
Пограничные случаи следует фиксировать для выбранной версии.
Проверку желательно повторить после перезапуска каждого узла. Для MySQL-сценария полезно поочерёдно добавить и удалить тестовую запись на разных серверах, затем убедиться, что решение о входе опирается на общий список. При локальном хранении, напротив, не следует ожидать межсерверного обмена, поскольку он подтверждён только для режима с MySQL.
Не подтверждены команды, точная структура конфигурации, полный список SQL-систем, алгоритм миграции и поведение при отказе базы. Не описаны также приоритет условий, кэширование, аудит изменений и готовый публичный API.
Плагин не заменяет резервное копирование и контроль административных прав.
Noble Whitelist распространяется по MIT. Файлы получены по официальному HTTPS, локально сверены с опубликованными хешами и прошли статическую проверку структуры и путей. Динамический запуск не выполнялся.
Совпадение сумм не подтверждает работу входа, базы и интеграций на конкретном сервере.
Нет. Noble Whitelist устанавливается на сервер, клиентская сторона не поддерживается.
Имя, UUID и разрешение. Каждый способ можно сделать обязательным, необязательным или отключить.
Да, общий whitelist между серверами заявлен через MySQL.
Нет. Отдельный проект Noble Whitelist Discord Integration указан как необязательная зависимость.
Да, Folia присутствует в подтверждённом перечне платформ.
В исходном описании API помечено как будущая возможность. Считать его доступным без дополнительного подтверждения нельзя.
Плагин относится к управлению и служебным инструментам. Подтверждены локальное и SQL-хранение, общий список через MySQL, автоматическая регистрация и настраиваемые проверки входа.
Назначение Noble Whitelist
Обычный белый список чаще всего опирается на один способ идентификации. Noble Whitelist расширяет эту модель тремя заявленными основаниями:
• имя игрока;
• UUID;
• наличие разрешения.
Каждое основание можно сделать обязательным, необязательным или отключить. Логика сочетания условий и формат настроек не раскрыты.
Скриншоты и внешний вид
Проверка по имени, UUID и разрешению
Поддержаны все три варианта, но их приоритет при расхождении данных не описан.
Перед запуском следует определить:
• какой идентификатор считается основным;
• нужен ли дополнительный контроль по разрешению;
• какие проверки должны быть обязательными;
• что происходит с ранее добавленными игроками;
• как обрабатываются изменения имени;
• кто имеет право менять список.
Наличие отдельного параметра для каждого пункта не подтверждено.
Режимы проверок при входе
Заявлены настраиваемые проверки входа, разрешения и обхода.
Право обхода следует выдавать осторожно. Для теста нужны три аккаунта:
• внесённый в белый список;
• не внесённый;
• имеющий разрешение обхода.
Последовательность условий и реакция на недоступное хранилище не описаны.
Хранение данных
Noble Whitelist поддерживает плоские файлы и SQL-хранилища.
Формат локальных файлов и полный перечень СУБД не раскрыты. Прямо названа только MySQL для общего списка.
При выборе хранения стоит учитывать:
• число серверов;
• необходимость общего списка;
• резервное копирование;
• доступность базы данных;
• порядок переноса существующих записей.
Автоматическая миграция не подтверждена.
Общий белый список между серверами
Общий список между серверами заявлен через MySQL.
Синхронизация локальных файлов и автоматическое устранение конфликтов не заявлены. Нужно проверить:
• подключение каждого тестового сервера;
• появление одной записи на другом узле;
• удаление и повторное добавление;
• поведение при временной недоступности MySQL;
• сохранность резервной копии.
Поведение при сбое заранее не гарантировано.
Автоматическая регистрация
Заявлена автоматическая регистрация whitelist, но её условие и момент не уточнены.
Перед включением следует проверить, кто добавляется и какая запись создаётся.
Регистрация во внешних системах не подтверждена.
Интеграции
Заявлена поддержка PlaceholderAPI и MiniPlaceholders, но список плейсхолдеров не приведён.
Noble Whitelist Discord Integration указана как необязательная зависимость. Её команды и формат уведомлений не описаны.
API обозначено как планируемое, поэтому считать его готовой функцией нельзя.
Совместимость
Подтверждены Bukkit, Folia, Paper, Purpur и Spigot; в исходном тексте Paper рекомендован. Особенности Folia не описаны.
Заявлены версии Minecraft:
• ветка 1.18, включая 1.18.1 и 1.18.2;
• выпуски 1.19–1.19.4;
• выпуски 1.20–1.20.6;
• выпуски 1.21–1.21.11;
• 26.1, 26.1.1, 26.1.2 и 26.2.
Указана Java 17+, рекомендована Java 21+; среду нужно согласовать с ядром.
Установка
JAR помещают в папку plugins совместимого сервера. Практический порядок:
• выбрать файл для нужной версии;
• создать резервную копию сервера и старых данных whitelist;
• поместить один JAR в plugins;
• выполнить полноценный перезапуск;
• убедиться, что плагин загрузился;
• выбрать и проверить способ хранения;
• протестировать вход по имени, UUID и разрешению;
• отдельно проверить обход и общий MySQL-список, если они используются.
Команды, параметры подключения и структура конфигурации не раскрыты.
Файлы и версии
Подтверждены два файла:
• NobleWhitelist-1.2.24.jar, версия 1.2.24, 281 942 байта;
• NobleWhitelist-1.2.23.jar, версия 1.2.23, 281 929 байт.
Для 1.2.24 опубликованы SHA-512 39e25b0fc3d009f3860a3de731eb14cde295ac7f94ea2b2a152d517044bbe1c685e1021bf90f98a3fffa360d3cc7aed7d3ebdfa70056459ed5122169a6327613 и SHA-1 6b612963ddd1bb38f7df1f3c1d8579b21722ed32.
Для 1.2.23 указаны SHA-512 b30f20bdc4637a69884053f786d550908aaa2eb1f87e3740e90559112240e9266d8cf905793876447227ceb3d4271056c431c5afe68d3e6de97112f7d4f17b8d и SHA-1 be834a5bc90f5c224de92df5debeebe52a6b4e79.
Версию определяют по имени, размеру и хешу.
Практическая проверка доступа
До переноса на основной сервер стоит составить матрицу сценариев:
• корректное имя и UUID;
• запись только по одному идентификатору;
• наличие и отсутствие требуемого разрешения;
• пользователь с обходом;
• автоматическая регистрация;
• вход после перезапуска;
• подключение к двум серверам с общей MySQL-базой;
• недоступность SQL-хранилища;
• работа PlaceholderAPI или MiniPlaceholders, если они установлены.
Пограничные случаи следует фиксировать для выбранной версии.
Проверку желательно повторить после перезапуска каждого узла. Для MySQL-сценария полезно поочерёдно добавить и удалить тестовую запись на разных серверах, затем убедиться, что решение о входе опирается на общий список. При локальном хранении, напротив, не следует ожидать межсерверного обмена, поскольку он подтверждён только для режима с MySQL.
Ограничения
Не подтверждены команды, точная структура конфигурации, полный список SQL-систем, алгоритм миграции и поведение при отказе базы. Не описаны также приоритет условий, кэширование, аудит изменений и готовый публичный API.
Плагин не заменяет резервное копирование и контроль административных прав.
Лицензия и безопасность
Noble Whitelist распространяется по MIT. Файлы получены по официальному HTTPS, локально сверены с опубликованными хешами и прошли статическую проверку структуры и путей. Динамический запуск не выполнялся.
Совпадение сумм не подтверждает работу входа, базы и интеграций на конкретном сервере.
FAQ
Нужен ли плагин на клиенте?
Нет. Noble Whitelist устанавливается на сервер, клиентская сторона не поддерживается.
Какие способы допуска подтверждены?
Имя, UUID и разрешение. Каждый способ можно сделать обязательным, необязательным или отключить.
Можно ли использовать один список на нескольких серверах?
Да, общий whitelist между серверами заявлен через MySQL.
Обязательна ли Discord-интеграция?
Нет. Отдельный проект Noble Whitelist Discord Integration указан как необязательная зависимость.
Поддерживается ли Folia?
Да, Folia присутствует в подтверждённом перечне платформ.
Есть ли готовый API?
В исходном описании API помечено как будущая возможность. Считать его доступным без дополнительного подтверждения нельзя.