Вайтлист в Майнкрафте — команда /whitelist и примеры
Вайтлист в Майнкрафте ограничивает вход на сервер. Как добавить игрока командой /whitelist, включить и отключить список, настроить Aternos и исправить ошибки.
Обновлено 18 октября 2026 г.
Вайтлист в Майнкрафте — белый список игроков, которым разрешён вход на сервер. Чтобы добавить игрока, выполните /whitelist add Steve, заменив Steve его ником, а для включения ограничения — /whitelist on. В Java Edition операторы могут входить и без записи в списке.
Как добавить игрока в вайтлист и включить его
Команда доступна на выделенном сервере Java Edition 26.3. На хостинге серверов откройте консоль в панели управления; если у вас есть нужные права, можно воспользоваться игровым чатом.
| Где вводить | Пример добавления | Какие права нужны |
|---|---|---|
| Чат игры | /whitelist add Steve | Оператор уровня 3 или 4 |
| Консоль сервера | whitelist add Steve | Доступ к консоли; права оператора для аккаунта не требуются |
- Запустите сервер и откройте его консоль.
- Добавьте свой ник:
whitelist add Steve. ЗаменитеSteveнастоящим ником. - Добавьте друзей отдельными командами, например
whitelist add Alex. - Выполните
whitelist on, затем проверьте записи черезwhitelist list.
После команд перезапуск сервера и перезагрузка списка не нужны. Если сервер сообщает, что вайтлист уже включён, переходите к проверке списка.
Синтаксис и все подкоманды /whitelist
| Команда Java Edition | Действие |
|---|---|
/whitelist add <targets> | Добавить игроков в список |
/whitelist remove <targets> | Удалить игроков из списка |
/whitelist list | Показать содержимое белого списка |
/whitelist on | Включить проверку списка при входе |
/whitelist off | Выключить проверку, сохранив записи |
/whitelist reload | Перечитать файл whitelist.json с диска |
Вместо <targets> укажите ник без угловых скобок. Несколько ников через пробел перечислять нельзя: добавляйте каждого отдельной командой. Поддерживаются селекторы игроков: /whitelist add @a добавит всех, кто сейчас подключён.
Права оператора, отключение игроков и блокировки описаны в справочнике серверных команд.
Как отключить вайтлист на сервере
Введите /whitelist off в игровом чате или whitelist off в консоли. Изменение применяется сразу: проверка белого списка отключится, а сохранённые игроки останутся в нём для следующего включения.
Чтобы закрыть вход одному игроку при включённом списке, используйте /whitelist remove Steve. Оператор Java-сервера по-прежнему сможет заходить без записи в списке.
Как добавить в вайтлист на Aternos
- Откройте панель своего сервера и раздел «Игроки» → «Белый список».
- Введите ник игрока и добавьте его. Повторите для себя и остальных друзей.
- В разделе «Настройки» включите «Белый список». Если меняли этот переключатель в настройках, перезапустите сервер.
На работающем Java-сервере можно воспользоваться консолью Aternos: whitelist add Steve, затем whitelist on. При таком способе перезапуск не требуется.
Настройки server.properties и файл whitelist.json
Белый список хранится в whitelist.json в папке сервера. Запись содержит имя и UUID — идентификатор игрока. Команды заполняют файл автоматически; вручную редактировать его для добавления друзей не нужно.
В server.properties для белого списка есть две разные настройки:
| Настройка | Что меняет |
|---|---|
white-list=true | Разрешает вход игрокам из списка и операторам Java-сервера |
white-list=false | Выключает проверку белого списка при входе |
enforce-whitelist=true | При включённом списке отключает игроков без доступа после его перезагрузки |
enforce-whitelist=false | После перезагрузки списка оставляет таких игроков онлайн; при следующем входе проверка действует |
Настройка enforce-whitelist сама по себе не включает вайтлист. Если нужно сразу отключить конкретного игрока, выполните /kick Steve после удаления из списка.
После ручного изменения whitelist.json выполните /whitelist reload. При ручном изменении server.properties остановите сервер, сохраните настройки и запустите его заново: команда перезагрузки списка эти настройки не перечитывает.
Начиная с Java Edition 26.3, в новом стандартном server.properties значение white-list по умолчанию равно true. Сохранённое значение на существующем сервере при обновлении не заменяется; панель хостинга может задавать свои настройки.
Почему вайтлист не работает или не пускает на сервер
- «You are not white-listed on this server!». Администратору нужно добавить точный ник вашего Java-профиля. Владелец сервера может сделать это через консоль, даже если сам не может войти.
- Команда неизвестна или нет доступа. Проверьте права оператора и вводите команду на сервере. В обычном одиночном мире она недоступна; плагины сервера могут отдельно менять права.
- Не удалось найти профиль игрока. Проверьте написание ника. При включённой проверке аккаунтов нужен существующий Java-профиль; ошибка возможна и при недоступности службы поиска профилей.
- После редактирования файла ничего не изменилось. Выполните
/whitelist reloadи проверьте записи через/whitelist list. - Игрок без записи заходит. Проверьте, включён ли список и не является ли игрок оператором. Проверяйте ограничение обычным аккаунтом без прав оператора.
Если сообщение при входе другое, проверьте ошибки подключения: добавление в вайтлист не исправляет несовпадение версий или ошибки авторизации.
Отличия Bedrock и старых версий Java
| Сервер | Что учитывать |
|---|---|
| Bedrock Dedicated Server | Используйте /allowlist add Steve; /whitelist — псевдоним. Для включения задайте allow-list=true в server.properties и перезапустите сервер. Файл списка — allowlist.json; операторов тоже нужно добавлять. |
| Java 1.12.2 | Команды с конкретным ником те же. По умолчанию список выключен; настройки enforce-whitelist ещё нет. |
| Java 1.16.5, 1.20.1 и 1.21.x | Основные команды работают так же, но стандартный белый список по умолчанию выключен. |
В Bedrock указывайте тег игрока Xbox. Если в нём есть пробелы, используйте кавычки: /allowlist add "Gamer Tag".
Играть интереснее на сервере — выбирайте в рейтинге серверов Майнкрафт и заходите прямо сейчас.
