Зачем нужен whitelist
Белый список (whitelist, «вайт-лист») ограничивает вход на сервер только теми игроками, чьи никнеймы вы туда добавили. Все остальные при попытке зайти получают сообщение о запрете подключения. Это базовый способ держать сервер приватным для друзей или закрытого сообщества, не поднимая пароль или сложную систему прав.
По умолчанию whitelist в Minecraft выключен — любой, кто знает IP сервера, может зайти.
Способ 1: включить через server.properties
Самый надёжный способ, который сработает даже если сервер выключен:
- Откройте файл
server.propertiesв панели хостинга или в папке сервера. - Найдите строку
white-list=falseи замените наwhite-list=true. - Сохраните файл и перезапустите сервер — изменение вступает в силу только после рестарта.
Способ 2: включить через консоль или игровой чат
Если сервер уже запущен, включать через properties не обязательно — есть команды:
| Команда | Что делает |
|---|---|
/whitelist on |
включает белый список |
/whitelist off |
выключает белый список |
/whitelist add <ник> |
добавляет игрока в список |
/whitelist remove <ник> |
убирает игрока из списка |
/whitelist list |
показывает всех, кто в списке |
/whitelist reload |
перечитывает файл whitelist.json с диска |
Через консоль (без прав оператора) слэш / перед командой не нужен — пишете сразу whitelist add ник. В игровом чате с правами оператора — с слэшем.
Учтите: изменения в whitelist иногда применяются не сразу, особенно на некоторых хостингах — если игрока только что добавили, а зайти он всё равно не может, попробуйте /whitelist reload или полный рестарт сервера.
Главная проблема ванильного whitelist
У встроенного whitelist есть три неприятных ограничения:
- Игрок должен хотя бы раз зайти на сервер (или иметь лицензию), чтобы его UUID корректно привязался. Пока whitelist включён с самого начала, добавить «заочно» никого не игравшего пользователя проблематично — система ищет его ID по базе Mojang, а без лицензии или предыдущего захода это не всегда срабатывает.
- Регистр никнейма имеет значение. Если игрок пишет ник с маленькой буквы, а вы добавили с заглавной (или наоборот), whitelist может не опознать совпадение — и человека не пускает при формально верном нике.
- Не работает с игроками без лицензии на пиратских/оффлайн-серверах — ванильная система рассчитана на UUID лицензионных аккаунтов.
Способ 3: плагин-замена (EasyWhitelist и аналоги)
Именно из-за этих проблем на серверах с плагинами (Spigot/Paper/Purpur) ставят альтернативные whitelist-плагины — самый распространённый пример — EasyWhitelist. Он создаёт список сразу при добавлении ника, без привязки к предыдущему входу, и одинаково работает и с лицензионными, и с пиратскими аккаунтами.
Установка:
- Скачайте плагин под версию вашего сервера (Spigot/Paper/Purpur — версии почти всегда указаны в описании на площадке загрузки).
- Закиньте
.jarфайл в папкуplugins. - Перезапустите сервер.
- Включите список командой вида
/easywl on(для консоли — без слэша) и добавьте себя первым, иначе не зайдёте даже с правами администратора. - Дальше добавляйте игроков командой
/easywl add <ник>.
После установки в папке плагина появляется конфиг, где можно:
- изменить текст сообщения об отказе в доступе (в том числе перевести на русский);
- заранее вписать список ников вручную в файл, а не только командами;
- включать/выключать whitelist без переустановки.
Ванильный whitelist vs плагин — что выбрать
| Ванильный whitelist | Плагин (EasyWhitelist и подобные) | |
|---|---|---|
| Нужна лицензия/предыдущий вход | Да, для корректной работы | Нет |
| Чувствительность к регистру ника | Часто вызывает проблемы | Обычно решена |
| Настройка сообщений | Нет | Да |
| Нужна установка плагина | Не нужна | Нужна (Spigot/Paper и совместимые) |
| Подходит для | Простых ванильных серверов | Серверов с плагинами, пиратских серверов |
Если сервер чисто ванильный (без Spigot/Paper) — доступен только встроенный whitelist, и тогда просто следите за регистром никнеймов при добавлении. Если сервер на модифицированном ядре — плагин избавит от большинства головной боли.
FAQ
Как добавить игрока в whitelist, если он ещё ни разу не заходил на сервер?
На ванильном whitelist это может не сработать сразу из-за отсутствия привязанного UUID — надёжнее временно выключить whitelist, дать игроку зайти один раз, включить обратно, либо сразу использовать плагин типа EasyWhitelist, который добавляет по нику без предварительного захода.
Обязательно ли перезапускать сервер после включения whitelist?
Если включаете через server.properties, перезапуск обязателен. Если через команду /whitelist on в уже работающем сервере — рестарт не нужен, изменение действует сразу.
Можно ли автоматически обновлять whitelist по расписанию?
Да, через панель хостинга с планировщиком задач можно добавить команду whitelist reload в расписание, чтобы список подтягивал изменения из файла whitelist.json без ручного вмешательства.
Что делать, если игрока добавили, а зайти он всё равно не может?
Проверьте точное совпадение регистра ника и выполните /whitelist reload. Если не помогло — перезапустите сервер целиком.