Вайтлист Minecraft: назначение и управление¶

Вайтлист (whitelist) в Minecraft — механизм управления доступом к игровому серверу, ограничивающий подключение только заранее занесёнными в список игроками. Когда вайтлист включён, любой пользователь, не добавленный в список, получает отказ при попытке подключиться, даже при корректном адресе сервера и версии игры. Функция доступна в одноразновидностях (Java Edition) и Bedrock Edition, используется как на выделенных, так и на локальных серверах, а также в режиме аренды миров.

¶Назначение

Вайтлист решает несколько задач:

• Защита от незваных гостей — предотвращает подключение случайных игроков, griefers и пользователей с неадекватным поведением.
• Контроль состава — позволяет администратору формировать закрытый круг участников, например для ролевых проектов или приватных миров.
• Снижение нагрузки — ограничивает число одновременных подключений, что важно для серверов со скромными ресурсами.

Вайтлист не является средством аутентификации: он не защищает от подбора пароля и не заменяет полноценные системы доступа. При этом включение вайтлиста — одна из первых рекомендаций по защите публичного сервера.

¶Способы добавления игроков

¶Через игровые команды

В Minecraft: Java Edition основной способ управления вайтлистом — команды /whitelist (сокращённо /wl). Для их выполнения требуется уровень прав 3 (оператор сервера). Доступные варианты:

Пример: whitelist add Steve добавляет игрока с ником Steve. Ник чувствителен к регистру в старых версиях, в актуальных релизах Minecraft автоматически приводит его к правильному написанию. После выполнения whitelist on подключение незарегистрированных игроков блокируется немедленно, без перезапуска сервера.

В Bedrock Edition команды имеют схожий синтаксис: /whitelist add <имя игрока>, /whitelist remove <имя игрока>, /whitelist on, /whitelist off. В некоторых сборках Bedrock вместо них используется allowlist — команда allowlist add <имя>.

¶Через файл конфигурации

Сервер Java Edition хранит список в файле whitelist.json, расположенном в корне серверной папки (рядом с server.properties). Формат — JSON-массив объектов:

``json [ { "uuid": "069a79f4-44e9-4726-a5be-fca90e38aaf5", "name": "Notch" } ] ``

Поле uuid содержит уникальный идентификатор игрока в системе Mojang, name — ник. Файл можно редактировать вручную, однако при отсутствии корректного UUID сервер при следующем запуске выполнит его разрешение по нику автоматически. Изменения вступают в силу после перезапуска сервера или выполнения команды whitelist reload.

В server.properties вайтлист управляется параметром white-list=true|false. Значение true эквивалентно команде whitelist on. Дополнительный параметр enforce-whitelist=true отключает игроков, не находящихся в списке, даже если они уже были подключены в момент его изменения.

¶Через панель управления

Большинство хостинг-провайдеров и панелей управления (Pterodactyl, Multicraft, консоль выделенного сервера) предоставляют вкладку «Whitelist» или «Игроки», где можно добавить ник в поле и сохранить изменения. Такой способ не требует доступа к консоли игры и удобен для администраторов без опыта работы с командной строкой. Принципиально он выполняет те же команды или редактирует тот же whitelist.json.

¶Особенности и ограничения

• Оффлайн-серверы (с online-mode=false) не могут корректно проверить UUID, поэтому вайтлист на них работает только по нику — это делает защиту условной, так как ник можно подделать.
• Операторы сервера не обязаны находиться в вайтлисте: команда op даёт приоритетный доступ.
• Локальная сеть — при запуске одиночного мира с открытым доступом по сети вайтлист настраивается аналогично через консоль.
• Клиент не видит список вайтлиста; отказ при подключении отображается сообщением «You are not whitelisted on this server».

Вайтлист в Minecraft — встроенный и не требующий модов инструмент, доступный любому администратору сервера независимо от версии игры и способа развёртывания.

¶Источники

• Официальная документация Minecraft: команды сервера
• Справочник по файлам конфигурации Minecraft: server.properties, whitelist.json
• Руководства по администрированию Minecraft-серверов