Как добавить игрока в белый список Minecraft: команды whitelist и настройка server.properties

Что такое белый список и зачем он нужен

Белый список (whitelist) — это механизм контроля доступа, который разрешает подключение к серверу только тем игрокам, чьи имена внесены в специальный список. Когда whitelist включён, все остальные пользователи получают отказ при попытке войти, даже если сервер публичный и виден в списке.

Основные сценарии использования:

• Приватные серверы для друзей или закрытого сообщества.
• Технические работы, когда нужно ограничить вход, чтобы избежать помех.
• Защита от нежелательных игроков, гриферов или ботов.
• Организация мероприятий с ограниченным составом участников.

В отличие от бана, whitelist не блокирует игрока навсегда — он просто не пускает его, пока имя не добавлено в список. Это гибкий инструмент, который легко настраивается и отключается.

Основные команды whitelist: add, remove, list, on, off

Управление белым списком в Minecraft осуществляется через консоль сервера или игровой чат (если у вас есть права оператора). Вот полный набор команд:

• /whitelist on — включает белый список. После этой команды доступ получат только те, кто есть в списке.
• /whitelist off — отключает белый список, и сервер снова становится открытым для всех.
• /whitelist add [ник] — добавляет игрока в белый список. Например: /whitelist add Steve.
• /whitelist remove [ник] — удаляет игрока из списка. Например: /whitelist remove Steve.
• /whitelist list — показывает всех игроков, которые находятся в белом списке.
• /whitelist reload — перезагружает список из файла white-list.json (полезно, если вы редактировали файл вручную).

Команды можно вводить как в консоли сервера, так и в игре, если у вас есть статус оператора (OP). В игре команда начинается со слеша /, в консоли слеш не обязателен, но обычно работает.

Настройка server.properties: включение whitelist на уровне конфигурации

Прежде чем использовать команды, важно правильно настроить файл server.properties, который находится в корневой папке сервера. Этот файл содержит основные параметры сервера, включая флаг white-list.

Пошаговая инструкция:

1. Остановите сервер, чтобы изменения не конфликтовали с работой.
2. Откройте server.properties в текстовом редакторе.
3. Найдите строку white-list=false (или white-list=true, если уже включали).
4. Измените значение на true, чтобы активировать белый список.
5. Сохраните файл и запустите сервер.

После этого можно использовать команды /whitelist on и /whitelist off для временного включения/отключения без правки файла. Однако если в server.properties стоит white-list=false, команда /whitelist on всё равно включит список, но при перезапуске сервера настройка вернётся к false. Поэтому для постоянного включения лучше менять именно файл.

Особенности офлайн-режима: почему игрок должен зайти хотя бы раз

Если ваш сервер работает в офлайн-режиме (в server.properties параметр online-mode=false), то есть не проверяет лицензию Minecraft, возникает важное ограничение: добавить игрока в белый список можно только после того, как он хотя бы раз зайдёт на сервер.

Это связано с тем, что в офлайн-режиме сервер не получает уникальный UUID игрока из официальных серверов Mojang. Вместо этого UUID генерируется на основе ника, но для этого игрок должен появиться на сервере. Если вы попытаетесь добавить игрока, который никогда не заходил, команда может выдать ошибку или добавить запись с некорректным UUID.

Практическое решение: попросите игрока зайти на сервер один раз (даже если whitelist ещё выключен), затем добавьте его в список. После этого он сможет заходить свободно. В лицензионном режиме (online-mode=true) такой проблемы нет — можно добавлять игроков сразу, даже если они ещё ни разу не заходили.

Как проверить, что белый список работает корректно

После настройки важно убедиться, что whitelist функционирует правильно. Вот несколько шагов для проверки:

1. Включите белый список командой /whitelist on или через server.properties.
2. Добавьте тестового игрока в список: /whitelist add TestPlayer.
3. Попробуйте зайти на сервер с ником, который есть в списке. Если вход успешен — всё в порядке.
4. Попробуйте зайти с ником, которого нет в списке. Вы должны получить сообщение о том, что доступ запрещён (например, "You are not whitelisted on this server").
5. Удалите тестового игрока из списка и снова попробуйте зайти — доступ должен быть закрыт.

Также можно использовать команду /whitelist list, чтобы убедиться, что список содержит нужные ники. Если вы редактировали файл white-list.json вручную, не забудьте выполнить /whitelist reload, чтобы изменения вступили в силу.

Работа с файлом white-list.json: ручное редактирование

Помимо команд, белый список можно редактировать напрямую в файле white-list.json, который находится в корневой папке сервера. Этот файл содержит JSON-массив с записями об игроках, включая их ники и UUID.

Пример содержимого:

[
  {
    "uuid": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Steve"
  }
]

Ручное редактирование удобно, когда нужно добавить сразу много игроков или скопировать список с другого сервера. Однако будьте осторожны: ошибка в JSON (например, пропущенная запятая) может привести к тому, что сервер не запустится или не сможет прочитать список. После редактирования обязательно выполните /whitelist reload или перезапустите сервер.

Важно: в офлайн-режиме UUID генерируется автоматически, поэтому вручную вписывать UUID не обязательно — достаточно указать имя, но лучше дать игроку зайти один раз, чтобы сервер сам создал корректную запись.

Частые ошибки и их решение

При настройке whitelist пользователи часто сталкиваются с типичными проблемами. Вот основные из них и способы их решения:

• Игрок не может зайти, хотя добавлен в список. Проверьте, что вы добавили ник без опечаток и с правильным регистром (Minecraft чувствителен к регистру). Также убедитесь, что whitelist включён (/whitelist on).
• Команда /whitelist add выдаёт ошибку "Player not found". Это происходит в офлайн-режиме, если игрок ещё ни разу не заходил. Попросите его зайти один раз.
• После перезапуска сервера whitelist отключился. Проверьте, что в server.properties стоит white-list=true, а не только команда /whitelist on.
• Список не обновляется после ручного редактирования файла. Выполните /whitelist reload или перезапустите сервер.
• Игроки с пиратской версии не могут зайти. В офлайн-режиме это нормально, но убедитесь, что они добавлены в список и что online-mode=false.

Если проблема не решается, проверьте права оператора: команды whitelist требуют прав администратора (OP).

Дополнительные советы: интеграция с плагинами и ядрами

На серверах с ядрами Spigot, Paper или Purpur белый список работает стандартно, но есть нюансы. Например, в файле spigot.yml можно изменить сообщение, которое видит игрок при попытке зайти, если он не в списке. Это полезно для кастомизации.

Некоторые плагины, такие как LuckPerms или EssentialsX, могут предоставлять собственные команды для управления доступом, но они не заменяют стандартный whitelist. Если вы используете прокси-сервер (например, BungeeCord или Velocity), whitelist настраивается на каждом бэкенд-сервере отдельно, либо через плагины прокси.

Также стоит помнить, что whitelist не защищает от DDoS-атак или других сетевых угроз — это только контроль доступа на уровне игроков. Для защиты сервера используйте дополнительные меры, такие как фаерволы и анти-DDoS-сервисы.

Заключение: краткий чек-лист настройки

Чтобы быстро настроить белый список на сервере Minecraft, следуйте этому чек-листу:

1. Остановите сервер.
2. Откройте server.properties и установите white-list=true.
3. Запустите сервер.
4. В консоли или в игре выполните /whitelist add [ник] для каждого игрока.
5. Проверьте список командой /whitelist list.
6. Если сервер в офлайн-режиме, убедитесь, что игроки заходили хотя бы раз.
7. При необходимости отключите whitelist командой /whitelist off или изменив white-list=false.

Эти шаги подходят для большинства серверов, включая ванильные, Spigot, Paper и их форки. Если у вас возникли сложности, обратитесь к документации вашего хостинга или в поддержку.

Вопросы и ответы