С помощью whitelist Minecraft ты ограничиваешь доступ к своему серверу только явно разрешенным игрокам. Это полезно для приватных survival-миров, строительных проектов, ивентов или сообществ, где ты хочешь сохранять контроль над доступом. Важны три пункта: white-list=true, аккуратно поддерживаемые имена игроков и enforce-whitelist=true, чтобы изменения надежно применялись.

Требования

Тебе нужен доступ к консоли сервера, права OP в игре или доступ к файлу server.properties. Также тебе стоит знать точные Minecraft-имена игроков. Для Java-аккаунтов обычно достаточно имени игрока. Если игроки Bedrock подключаются через Geyser, имя может отображаться с префиксом в зависимости от конфигурации Geyser; в исходном примере используется точка.

Если ты сейчас настраиваешь сервер с нуля, тебе поможет подробный гайд Арендовать и настроить Minecraft Server — полный гайд 2026. Для других кооперативных сетапов с похожей логикой доступа ты также найдешь Арендовать и настроить Valheim Server — кооп-гайд 2026.

Настройка whitelist Minecraft

Что такое whitelist?

Whitelist — это контроль доступа для твоего сервера. Подключаться могут только игроки из списка. Он не заменяет модерацию, но не дает неизвестным аккаунтам просто зайти по адресу сервера. Для платного multi-game-хостинга это особенно удобно, потому что ты можешь четче разделять доступ к серверу, обращения в поддержку и рабочие процессы: кто не в списке, тот не попадет внутрь.

Microsoft документирует соответствующую команду Bedrock как /allowlist; там /whitelist указан как alias, а также описаны действия add, remove, list, off, on и reload: Microsoft Learn по allowlist/whitelist. Для Java-серверов практической основой остаются показанные ниже записи server.properties и команды /whitelist.

Включить whitelist

В server.properties:

white-list=true
enforce-whitelist=true

Раз уж ты сейчас в server.properties: строка motd задает запись твоего сервера в списке серверов — оформить ее цветами можно с нашим бесплатным MOTD-Generator.

Или командой в игре:

/whitelist on

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

Добавить игроков

/whitelist add <Spielername>

Для игроков Bedrock (через Geyser):

/whitelist add .<BedRockName>

Следи за написанием. Если игрок не может подключиться, хотя ты его добавил, сравни имя с отображением при попытке входа или в логах сервера. В сетапах с Geyser особенно важно, используется ли префикс и как обрабатывается регистр букв.

Управлять whitelist

Команда Описание
/whitelist list Показать всех игроков
/whitelist add <name> Добавить игрока
/whitelist remove <name> Удалить игрока
/whitelist reload Перезагрузить список
/whitelist on/off Включить/выключить whitelist

Используй /whitelist list после каждого крупного изменения. Так ты сразу заметишь опечатки или случайно продублированные имена. Если ты удаляешь игрока, важно иметь enforce-whitelist=true, чтобы исключение стало актуальным не только при следующей попытке подключения.

whitelist.json

Whitelist сохраняется в whitelist.json:

[
  {
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "ИмяИгрока"
  }
]

Редактируй этот файл только если понимаешь, что делаешь. Для обычной работы команды безопаснее, потому что сервер корректно управляет именами и UUID. Если ты меняешь файл вручную, затем используй /whitelist reload или перезапусти сервер.

Проверить результат

Сначала проверь через /whitelist list, что все нужные игроки есть в списке. После этого добавленный игрок должен суметь подключиться. Аккаунт, которого нет в списке, должен быть отклонен. Дополнительно проверь консоль сервера: там видно, из-за чего провалилась попытка входа — из-за whitelist, неверного имени или другой проблемы.

Для приватных проектов полезна короткая рутина: добавить игрока, протестировать вход, показать список, задокументировать изменение. Особенно при нескольких админах это предотвращает ситуации, когда вопросы поддержки позже остаются неясными.

Устранение проблем

Игрок есть в списке, но не может зайти

Проверь точное имя, режим игры и возможные префиксы у Geyser. Если сомневаешься, удали запись через /whitelist remove <name> и затем добавь ее заново.

Удаленные игроки остаются онлайн

Установи enforce-whitelist=true и перезагрузи список через /whitelist reload. Без этой настройки удаленные игроки в зависимости от состояния сервера могут оставаться подключенными до разрыва соединения.

Изменения в файле не применяются

Если ты вручную изменил server.properties или whitelist.json, перезагрузи whitelist или аккуратно перезапусти сервер. Также проверь, действительно ли ты редактировал файл активного экземпляра сервера.

Путаница между OP и whitelist

Права оператора — это права управления, а не аккуратный список доступа. Держи список OP коротким и веди whitelist отдельно. Так остается понятно, кто может администрировать, а кто только играть.

Советы

  • Enforce Whitelist: Включи enforce-whitelist=true, чтобы игроков кикало, когда их удаляют из списка
  • Ops: Операторы (OPs) могут заходить и без whitelist, если enforce-whitelist выключен
  • Автоматизация: Используй плагины вроде EasyWhitelist для веб-управления

Проверка, ограничения и безопасный откат

Инструкция «Настроить whitelist Minecraft Server — пускать только друзей» относится к типу сервера, описанному в статье, и к версии, видимой на момент проверки. Названия меню, доступные версии, совместимость модов или плагинов и необходимые ресурсы могут измениться после обновлений. Поэтому не переноси значения на другую версию игры, loader или сервера без проверки.

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

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

Успешный одиночный тест не является гарантией производительности или доступности. Размер мира, моды, плагины, количество игроков, сетевой маршрут и одновременная нагрузка могут изменить результат. Документируй версию, изменение и результат теста, чтобы позже понимать причины отклонений.

FAQ

Нужен ли перезапуск после каждого изменения?

Не обязательно. Если ты используешь команды вроде /whitelist add, /whitelist remove или /whitelist reload, списком можно управлять во время работы сервера. После ручных изменений файлов reload или перезапуск имеет смысл.

Whitelist лучше пароля?

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

Стоит ли всегда включать enforce-whitelist=true?

Для приватных серверов это чаще всего разумно. Эта настройка гарантирует, что удаленные игроки после reload не останутся онлайн, хотя их больше нет в списке.

Работает ли whitelist с модами и плагинами?

Да, базовый whitelist — это функция сервера. Плагины могут дать дополнительное управление, но их стоит выбирать осознанно и поддерживать в актуальном состоянии.

Что делать с игроками Bedrock через Geyser?

Проверь, как твой сетап Geyser отображает имена Bedrock. В примере используется .<BedRockName>. Если вход не удается, проверь фактически показанное имя в консоли или логах.