cwhitelist — современный подход к управлению вайтлистом
Каждый администратор Minecraft-сервера рано или поздно сталкивается с проблемой: стандартный вайтлист слишком примитивен. Он проверяет только ник игрока, не даёт гибких настроек и уж точно не умеет синхронизироваться с внешними системами. Мод cwhitelist решает все эти задачи разом, предлагая по-настоящему профессиональный инструмент для защиты вашего сервера.
Что умеет cwhitelist для Minecraft
В отличие от ванильного решения, cwhitelist для Minecraft поддерживает три независимых метода аутентификации. Вы можете включить проверку по традиционному нику, по UUID игрока или по IP-адресу с поддержкой масок вроде 192.168.*.*. Каждый метод включается и отключается отдельно, что позволяет выстроить систему защиты под конкретные нужды вашего проекта.
Мод работает на Minecraft 1.21.x и использует загрузчик NeoForge. Установка не требует сложных манипуляций: достаточно скачать jar-файл и положить его в папку mods. После первого запуска сгенерируется конфигурационный файл, в котором вы сможете настроить всё под себя.
Три режима работы
Разработчики предусмотрели три сценария использования, и это одна из главных фишек мода.
Локальный режим
Всё работает на самом сервере, без обращения к внешним сервисам. Проверка по нику, UUID и IP выполняется локально, логи пишутся в файлы. Этот режим подходит для небольших проектов, где не требуется централизованное управление.
Гибридный режим с API
Здесь уже подключается API-сервер. Основная синхронизация идёт через него, но при недоступности API мод автоматически переключается на локальный кеш. Это идеальный вариант для сетей из нескольких серверов, где нужна единая база игроков, но хочется подстраховаться на случай сбоев.
Режим API-Only
Все операции выполняются только через API. Локального хранилища вайтлиста нет вообще, что даёт максимальную централизацию. Правда, такой подход требует стабильного соединения с API-сервером, так что подходит не всем.
Кстати, если вы пользуетесь лаунчером foxygame.net, то найти и подключить cwhitelist можно прямо из каталога дополнений — там есть удобная интеграция, и мод будет автоматически обновляться до актуальных версий, совместимых с вашим клиентом.
Интеллектуальная система логирования
Безопасность — это не только доступ, но и контроль. cwhitelist ведёт подробный журнал всех попыток входа с временными метками. Логи автоматически ротируются: вы задаёте максимальный размер файла и срок хранения, а мод сам следит за тем, чтобы диски не забивались.
В конфигурации config/cwhitelist-common.toml вы можете настроить параметры logRetentionDays (сколько дней хранить логи) и logCutSizeMB (максимальный размер файла). А если включить logLoginEvents, события входа будут отправляться на API-сервер для удалённого мониторинга.
Команды и управление
Для администраторов предусмотрен полный набор команд. Добавить игрока можно тремя способами:
/cwhitelist add name <username>— по нику/cwhitelist add uuid <uuid>— по UUID/cwhitelist add ip <ip-address>— по IP
Удаление работает аналогично через /cwhitelist remove. Просмотр списка — командой /cwhitelist list, а перезагрузка конфигурации — /cwhitelist reload. Все команды требуют 4 уровня прав администратора, так что обычные игроки не смогут вмешаться в процесс.
Работа с API
API-интеграция — это сердце мода для крупных проектов. cwhitelist поддерживает токен-аутентификацию с разграничением прав: чтение, запись, удаление. Встроенный мониторинг здоровья API позволяет быстро обнаружить проблемы, а при сбоях мод gracefully переходит в локальный режим, не блокируя вход игрокам.
Настройка API в конфиге выглядит так:
[api]
enableApi = true
baseUrl = "http://your-api-server.com/api"
token = "your-secure-api-token-here"
timeoutSeconds = 10
syncOnStartup = trueВажно помнить про безопасность: используйте HTTPS для API-соединений, храните токены только в конфигурации, а не в коде, и регулярно проверяйте логи на подозрительную активность.
Производительность и кеширование
Мод работает асинхронно: HTTP-запросы выполняются в отдельных потоках, не блокируя основной поток сервера. Кеширование с настраиваемой длительностью (по умолчанию 30 секунд) снижает нагрузку на API-сервер. При операциях добавления или удаления кеш автоматически сбрасывается, так что данные всегда актуальны.
Как установить cwhitelist
Процесс установки максимально прост. Сначала убедитесь, что у вас установлен Java 17 или выше и NeoForge для Minecraft 1.21.x. Затем скачать cwhitelist можно с официальной страницы релизов проекта. Файл с именем вида cwhitelist-x.x-NeoForge-1.21.x.jar нужно поместить в папку mods вашего сервера.
После первого запуска сервера появится конфигурационный файл. Отредактируйте его под свои нужды и перезапустите сервер. Всё, мод готов к работе. Если вы используете лаунчер foxygame.net, установка станет ещё проще: достаточно найти cwhitelist в каталоге дополнений и активировать его в один клик — лаунчер сам позаботится о совместимости версий и загрузке.
Заключение
Cwhitelist — это не просто очередной мод на вайтлист, а полноценная система управления доступом с API-интеграцией, гибкой настройкой и продуманным логированием. Он подойдёт как небольшим серверам, которым нужен простой и надёжный контроль, так и крупным сетям с централизованным управлением. Учитывая активную разработку и поддержку NeoForge, этот мод — отличный выбор для современных серверов Minecraft.