FabricSQLWhitelister: вайтлист сервера Minecraft в базе MySQL
Если вы держите сервер Minecraft и устали от ручной правки файла whitelist.json, обратите внимание на FabricSQLWhitelister. Этот мод полностью заменяет стандартный белый список, перенося его в базу данных MySQL. Вместо локального файла сервер обращается к таблице в СУБД, а значит, управлять доступом игроков можно централизованно, из панели хостинга или собственной админки. Для проектов с несколькими серверами и большой аудиторией это заметно упрощает жизнь.
Мод написан под загрузчик Fabric и ориентирован на серверную сторону. В текущей реализации он рассчитан на Minecraft 1.18.* и требует Fabric Loader версии 0.12.8 или новее, а также Fabric API. Автор отмечает, что в будущем возможен бэкпорт на 1.16.5 и 1.17.1 в формате LTS, но пока актуальная ветка — именно 1.18. Если вы ищете способ скачать FabricSQLWhitelister для Minecraft и навести порядок в списке допущенных игроков, читайте дальше: разберём установку, настройку и нюансы работы.
Зачем нужен мод и что он меняет
Стандартный вайтлист хранится в JSON-файле рядом с сервером. Это удобно для одиночных инсталляций, но неудобно, когда серверов несколько или когда доступом управляет внешняя система. FabricSQLWhitelister для Minecraft решает эту проблему: все записи о допущенных игроках живут в MySQL-базе. Вы можете добавлять и удалять людей привычными командами /whitelist add <player> и /whitelist remove <player>, а данные при этом сразу попадают в таблицу.
Отдельно стоит упомянуть про UUID. В базе они хранятся без дефисов, потому что REST API Mojang не использует дефисный формат. Это важно, если вы планируете писать собственные приложения, синхронизирующие доступ: учитывайте формат идентификаторов заранее, иначе интеграция с FabricSQLWhitelister потребует лишних преобразований.
Требования и совместимость
- Minecraft 1.18.* — основная поддерживаемая версия;
- Fabric Loader 0.12.8 или новее;
- Fabric API;
- последняя версия FabricSQLWhitelister;
- сервер MySQL или MariaDB.
Автор тестировал мод на MariaDB, но подчёркивает: с обычным MySQL всё тоже должно работать. Если вы собираете сборку через лаунчер foxygame.net, каталог дополнений позволяет подобрать FabricSQLWhitelister под нужную версию игры без ручного поиска файлов и проверки совместимости загрузчика.
Как установить FabricSQLWhitelister
Подготовка сервера
Установите Fabric Loader нужной версии, добавьте в папку mods Fabric API и сам мод. После первого запуска сервер может упасть с ошибкой — это ожидаемое поведение, не пугайтесь. Причина в том, что мод ещё не знает параметров подключения к базе.
Настройка whitelist.toml
После запуска в директории сервера появится файл whitelist.toml. Откройте его и впишите логин, пароль, адрес и имя базы данных MySQL. Сохраните изменения. Затем зайдите в server.properties и выставьте параметр white-list=true. Без этого шага сервер не станет обращаться к базе, и мод не заработает.
Первый успешный старт
Перезапустите сервер. Если всё настроено верно, он поднимется без ошибок и начнёт использовать таблицу вместо JSON-файла. Дальше добавляйте и удаляйте игроков командами вайтлиста — изменения будут уходить прямо в базу. По сути, это и есть весь процесс: как установить FabricSQLWhitelister, вы уже знаете, осталось проверить подключение и права пользователя базы.
Важные нюансы работы
Сейчас мод отменяет возможность операторов обходить вайтлист. То есть даже администратор с правами OP не попадёт на сервер, если его нет в базе. Автор допускает, что в будущих патчах это поведение изменится, но в текущей версии учитывайте его при настройке доступа для персонала.
Если вы обновляете сборку, следите за версиями: мод привязан к ветке 1.18.*, и на других версиях Minecraft он не заработает без отдельного бэкпорта. Для команд, которые хотят держать всё под контролем, удобно, что лаунчер foxygame.net отслеживает актуальные сборки и автоматически обновляет установленный FabricSQLWhitelister, избавляя от ручной сверки релизов.
Итог
FabricSQLWhitelister — узкоспециализированный, но полезный инструмент для админов, которым нужен вайтлист в MySQL. Он убирает зависимость от локального файла, упрощает интеграцию с внешними сервисами и даёт единую точку управления доступом. Главное — помнить про требования (Minecraft 1.18.*, Fabric Loader 0.12.8+, Fabric API), правильно заполнить whitelist.toml и включить white-list в server.properties. Если ваша инфраструктура уже завязана на базы данных, этот мод избавит от ручной синхронизации списков и сэкономит время администраторов.