Содержание:

Вы хотите сделать свой Minecraft сервер приватным, чтобы только избранные игроки могли попасть в ваш мир? Или, может, вы уже пытались добавить друзей в whitelist, но что-то пошло не так? В этом посте вы узнаете всё про whitelist Minecraft — как добавить пользователя, как управлять списком, что делать с особыми никами и как избежать типичных ошибок. Готовы? Поехали!

Что такое whitelist и зачем он нужен

Whitelist (или allowlist) — это список игроков, которым разрешён доступ на сервер. Если whitelist включён, то попасть на сервер смогут только те, кто в этом списке. Это отличный способ защитить ваш мир от незваных гостей и гриферов.

Java Edition использует термин whitelist, а Bedrock Edition — allowlist, но суть одна: контроль доступа.

Как добавить пользователя в whitelist — точный синтаксис и примеры

В игре (Java Edition)

Команда для добавления одного пользователя:

/whitelist add USERNAME

Где USERNAME — ник игрока. Если в нике есть специальные символы (например, подчёркивания, цифры, точки), просто вводите ник точно так, как он есть. Minecraft не требует никаких дополнительных кавычек или экранирования.

Пример:

/whitelist add Player_123
/whitelist add Cool.Guy

Через консоль или панель управления (например, G-Portal)

  • В панели G-Portal зайдите в раздел Basic Settings.
  • Включите опцию Whitelist.
  • Введите Player ID (ник или UUID).
  • Сохраните и перезапустите сервер.

Почему нельзя добавить сразу много пользователей и что делать

Minecraft не поддерживает массовое добавление в whitelist одной командой. Это связано с архитектурой сервера — каждое добавление требует отдельной проверки.

Практические советы для админов:

  • Используйте скрипты или автоматизацию в панели управления, если она поддерживает импорт списков.
  • Добавляйте пользователей по одному, но быстро — команды работают мгновенно.
  • Для больших списков создайте JSON-файл whitelist.json с нужными UUID и никами (подробнее ниже).

Что происходит, если whitelist отключить

  • Игроки, которые уже на сервере, останутся на месте.
  • Но новые подключения будут разрешены всем, независимо от списка.
  • Это значит, что сервер становится открытым для всех — будьте осторожны!

Вступают ли в силу изменения whitelist сразу?

Да! После добавления или удаления пользователя из whitelist изменения применяются моментально. Перезапуск сервера не требуется.

Взаимодействие whitelist и банов

Если игрок забанен, то даже если он в whitelist, он не сможет зайти. Бан всегда имеет приоритет над whitelist.

Особенности работы с никами со спецсимволами

  • Ник должен вводиться точно так же, включая все символы.
  • Minecraft не чувствителен к регистру в никах, но лучше использовать точное написание.
  • Ограничений на символы в whitelist командах нет — просто копируйте ник.

Быстрое предоставление и отзыв доступа

  • Для временного доступа используйте команды:
/whitelist add USERNAME
/whitelist remove USERNAME
  • Для аудита изменений ведите список добавленных и удалённых игроков.
  • В G-Portal OP-пользователи автоматически попадают в whitelist, что упрощает управление.

Безопасность при временном отключении whitelist

  • Отключая whitelist, вы открываете сервер для всех.
  • Рекомендуется мониторить логи и активность игроков.
  • Включайте whitelist обратно как можно скорее.

Как включить whitelist вручную через файлы конфигурации

  1. В файле server.properties найдите строку:
white-list=false

и замените на

white-list=true
  1. Создайте или отредактируйте файл whitelist.json с таким содержимым:
[
  { "uuid": "player-uuid-1", "name": "playername1" },
  { "uuid": "player-uuid-2", "name": "playername2" }
]

UUID можно получить через Mojang API:

https://api.mojang.com/users/profiles/minecraft/USERNAME

Просто замените USERNAME на ник игрока.

Таблица основных команд whitelist для Java и Bedrock

Java Edition Команда Bedrock Edition Команда Описание
/whitelist on / /off allowlist on / off Включить или отключить whitelist
/whitelist add USERNAME allowlist add USERNAME Добавить игрока в whitelist
/whitelist remove USERNAME allowlist remove USERNAME Удалить игрока из whitelist
/whitelist list allowlist list Показать список игроков в whitelist
/whitelist reload allowlist reload Перезагрузить whitelist (если редактировали вручную)

Особенности whitelist в Bedrock и кроссплей

  • В Bedrock whitelist называется allowlist.
  • Добавлять игроков нужно через консоль панели.
  • В кроссплей-серверах (Java + Bedrock) игроки Bedrock должны зайти первым, чтобы сервер запомнил их ник.
  • Для Bedrock игроков в whitelist добавляйте ник с точкой в начале: .USERNAME

Частые ошибки и как их избежать

Ошибка Как избежать
Неправильный ник или UUID Используйте Mojang API для проверки UUID
Забыл включить whitelist Включите через /whitelist on или в настройках
Не хватает прав оператора Получите OP права через /op USERNAME
Использование слэша в консоли В консоли убирайте / перед командами
Не перезапустил сервер после ручных изменений Перезапустите сервер для применения настроек

Проверка работы whitelist

  • Попробуйте зайти с аккаунта, который есть в whitelist — должен зайти.
  • Попробуйте зайти с аккаунта, которого нет — должен получить отказ.
  • Проверьте логи сервера на предмет ошибок.

Минимальные требования и влияние модпаков

  • Whitelist работает одинаково на всех популярных сборках: Spigot, Paper, Forge, Fabric.
  • Установка модпаков через панели (например, ScalaCube) не влияет на whitelist.
  • Минимальные требования зависят от модпаков, но whitelist — лёгкая функция, не влияющая на производительность.

Итоговая шпаргалка для быстрого старта

Действие Команда / Действие в панели
Включить whitelist /whitelist on или в панели включить опцию
Добавить игрока /whitelist add USERNAME
Удалить игрока /whitelist remove USERNAME
Посмотреть список /whitelist list
Отключить whitelist /whitelist off
Получить UUID игрока Запрос к https://api.mojang.com/users/profiles/minecraft/USERNAME
Ручное редактирование файла Изменить whitelist.json и перезапустить сервер

Полезные ссылки

Теперь вы вооружены знаниями, чтобы сделать ваш Minecraft сервер настоящей крепостью, куда войдут только избранные! Не забывайте проверять права, внимательно вводить ники и следить за безопасностью. А если что-то пойдёт не так — возвращайтесь к этому гайду, и всё станет на свои места. Удачной игры! 🎮✨