FabricSQLWhitelister — вайтлист на MySQL для Minecraft

FabricSQLWhitelister переносит вайтлист сервера Minecraft в базу MySQL и упрощает управление доступом игроков. Узнайте, как установить и настроить мод.

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. Если ваша инфраструктура уже завязана на базы данных, этот мод избавит от ручной синхронизации списков и сэкономит время администраторов.