Что такое белый список (whitelist) и зачем он нужен
Белый список (whitelist) — это механизм, который ограничивает доступ к серверу только теми игроками, чьи никнеймы были заранее добавлены администратором. Все остальные при попытке подключения получают сообщение об отказе. Это один из самых простых и эффективных способов сделать сервер приватным, защитить его от гриферов и посторонних, а также снизить риск DDoS-атак, так как сервер не рекламируется для широкой аудитории. Белый список особенно полезен для закрытых сообществ, дружеских серверов или во время технических работ, когда нужно временно ограничить вход.
Основные команды для управления белым списком
Управление белым списком в Minecraft осуществляется через консоль сервера или игровой чат (с правами оператора). Вот ключевые команды:
/whitelist on— включает белый список./whitelist off— выключает белый список./whitelist add <ник>— добавляет игрока в белый список./whitelist remove <ник>— удаляет игрока из белого списка./whitelist list— показывает всех игроков, находящихся в белом списке./whitelist reload— перезагружает файлwhitelist.jsonс диска, применяя изменения без перезапуска сервера.
В консоли сервера команды вводятся без слэша /, например: whitelist add Alex. В игровом чате с правами оператора — со слэшем: /whitelist add Alex.
Как включить белый список через файл server.properties
Самый надёжный способ включить белый список — через файл server.properties, который находится в корневой папке сервера. Этот метод сработает даже если сервер выключен.
- Откройте файл
server.properties. - Найдите строку
white-list=falseи измените её наwhite-list=true. - Сохраните файл.
- Перезапустите сервер — изменение вступает в силу только после рестарта.
После этого можно добавлять игроков командами. Если вы включаете whitelist через команду /whitelist on на уже работающем сервере, перезапуск не требуется.
Как добавить игрока в белый список: пошаговая инструкция
Добавить игрока в белый список можно двумя способами:
Через команду: Введите в консоли или чате: /whitelist add <ник игрока>. Например: /whitelist add Alex. После этого игрок сможет зайти на сервер.
Через файл whitelist.json:
- Остановите сервер.
- Откройте файл
whitelist.jsonв папке сервера. - Добавьте запись в формате:
{"uuid": "UUID_игрока", "name": "ник_игрока"}. - Сохраните файл и запустите сервер.
Этот способ удобен, если нужно добавить много игроков сразу. Обратите внимание: на ванильном сервере (без плагинов) для корректной работы белого списка игрок должен хотя бы раз зайти на сервер (или иметь лицензию), чтобы его UUID привязался. Если сервер работает в офлайн-режиме (online-mode=false), это требование также актуально.
Как удалить игрока из белого списка
Удалить игрока из белого списка можно командой: /whitelist remove <ник игрока>. Например: /whitelist remove Alex.
Также можно отредактировать файл whitelist.json вручную: удалите соответствующую запись и перезапустите сервер или выполните /whitelist reload.
Если вы хотите временно отключить белый список для всех (например, для тестов), используйте команду /whitelist off. Чтобы снова включить — /whitelist on.
Проблемы ванильного whitelist и их решения
Встроенный белый список Minecraft имеет несколько ограничений:
- Привязка к UUID. Игрок должен хотя бы раз зайти на сервер (или иметь лицензию), чтобы его UUID корректно привязался. Если сервер новый и никто не заходил, добавить игрока «заочно» может не получиться.
- Чувствительность к регистру. Регистр никнейма имеет значение. Если вы добавили
Alex, а игрок пытается зайти какalex, белый список может не пропустить его. - Не работает с пиратскими аккаунтами. На серверах с
online-mode=falseванильный whitelist может не функционировать корректно, так как он рассчитан на UUID лицензионных аккаунтов.
Решения:
- Временно выключите whitelist, дайте игроку зайти один раз, затем включите обратно.
- Используйте плагины, такие как EasyWhitelist, которые решают эти проблемы.
- Внимательно проверяйте регистр при добавлении ников.
Плагины для белого списка: EasyWhitelist и альтернативы
На серверах с модифицированными ядрами (Spigot, Paper, Purpur) можно установить плагины, которые расширяют функциональность белого списка и решают проблемы ванильного варианта. Самый популярный — EasyWhitelist.
Преимущества EasyWhitelist:
- Добавляет игроков по нику без предварительного захода на сервер.
- Работает одинаково хорошо с лицензионными и пиратскими аккаунтами.
- Не чувствителен к регистру ника (обычно).
- Позволяет настраивать сообщение об отказе в доступе (например, перевести на русский).
- Можно заранее вписать список ников в конфигурационный файл.
Установка:
- Скачайте плагин под версию вашего сервера.
- Поместите
.jarфайл в папкуplugins. - Перезапустите сервер.
- Включите белый список командой
/easywl on(в консоли — без слэша). - Добавьте себя и других игроков командой
/easywl add <ник>.
Сравнение:
- Ванильный whitelist: не требует установки, но имеет ограничения.
- Плагин: решает проблемы с UUID, регистром и пиратками, но требует Spigot/Paper.
Настройка белого списка через панель управления хостинга
Многие хостинги для Minecraft серверов предоставляют удобную панель управления, где можно настроить белый список без ввода команд.
- Зайдите в панель управления сервером.
- Найдите раздел «Настройки» или «Белый список».
- Включите переключатель «Белый список».
- Введите ники игроков в соответствующее поле.
- Нажмите «Сохранить».
Этот способ особенно удобен для начинающих администраторов, так как не требует знания команд. Однако помните, что после изменения настроек может потребоваться перезапуск сервера.
Частые проблемы и их решения
Проблема: Игрок не может зайти, хотя его добавили.
- Проверьте точное совпадение регистра ника.
- Выполните
/whitelist reload. - Если не помогло, перезапустите сервер.
Проблема: Ник не сохраняется в whitelist.json.
- Проверьте права на запись в файл. Убедитесь, что файл не заблокирован.
Проблема: Сервер не запускается после редактирования whitelist.json.
- Проверьте синтаксис JSON. Каждая запись должна быть в формате
{"uuid": "...", "name": "..."}, а все записи должны быть заключены в квадратные скобки и разделены запятыми.
Проблема: Игрок с пиратским аккаунтом не может зайти.
- Используйте плагин типа EasyWhitelist, который поддерживает офлайн-режим.
Проблема: Забыли добавить себя в белый список.
- Используйте консоль хостинга: введите
whitelist add <ваш ник>, затемwhitelist on.
Вопросы и ответы
Какая команда чтобы добавить в белый список игрока в Minecraft?
Команда: /whitelist add <ник игрока>. Например: /whitelist add Alex. В консоли сервера команда вводится без слэша: whitelist add Alex.
Как добавить игрока в whitelist, если он ещё ни разу не заходил на сервер?
На ванильном whitelist это может не сработать из-за отсутствия UUID. Решение: временно выключите whitelist, дайте игроку зайти один раз, затем включите обратно. Или используйте плагин EasyWhitelist, который добавляет по нику без предварительного захода.
Обязательно ли перезапускать сервер после включения whitelist?
Если вы включаете whitelist через файл server.properties, перезапуск обязателен. Если через команду /whitelist on на уже работающем сервере, рестарт не нужен — изменение действует сразу.
Можно ли автоматически обновлять whitelist по расписанию?
Да, через панель хостинга с планировщиком задач можно добавить команду whitelist reload в расписание, чтобы список подтягивал изменения из файла whitelist.json без ручного вмешательства.
Что делать, если игрока добавили, а зайти он всё равно не может?
Проверьте точное совпадение регистра ника и выполните /whitelist reload. Если не помогло — перезапустите сервер целиком.
Работает ли whitelist на пиратских серверах (offline-mode)?
Ванильный whitelist может работать некорректно на серверах с online-mode=false, так как он привязан к UUID лицензионных аккаунтов. Рекомендуется использовать плагин EasyWhitelist, который поддерживает офлайн-режим.
Как изменить сообщение об отказе в доступе для игроков не из whitelist?
На серверах с ядром Spigot или его форками (Paper, Purpur) можно изменить сообщение в файле spigot.yml. Также плагины типа EasyWhitelist позволяют настроить текст сообщения в конфигурации.