Как сделать белый список на сервере Minecraft: полное руководство

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

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

По умолчанию белый список выключен, поэтому любой, кто знает IP-адрес сервера, может присоединиться. Включение whitelist полезно в нескольких ситуациях:

• Вы хотите создать приватный сервер для друзей или закрытого сообщества.
• Нужно временно ограничить вход во время технических работ или обновлений.
• Вы хотите защитить сервер от случайных посетителей и гриферов.

Белый список не требует установки пароля или сложной системы прав — это простой и надежный способ контроля доступа.

Включение белого списка через server.properties

Самый надежный способ включить whitelist — изменить файл server.properties, который находится в корневой папке сервера. Этот метод работает даже когда сервер выключен.

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

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

После перезапуска белый список будет активен. Обратите внимание: если вы меняете файл, когда сервер работает, изменения не применятся до полного рестарта.

На некоторых хостингах параметр может называться allow-list — это особенно актуально для ядер Minecraft Bedrock Edition. В любом случае принцип одинаков: установите значение true.

Управление белым списком через консоль и игровой чат

Если сервер уже запущен, можно управлять белым списком с помощью команд. В консоли команды вводятся без слэша, а в игровом чате — со слэшем (для операторов).

Основные команды:

• whitelist on — включить белый список.
• whitelist off — выключить белый список.
• whitelist add <ник> — добавить игрока.
• whitelist remove <ник> — удалить игрока.
• whitelist list — показать всех добавленных игроков.
• whitelist reload — перечитать файл списка с диска.

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

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

Работа с файлом белого списка

Помимо команд, список можно редактировать напрямую в файле. В зависимости от ядра файл может называться whitelist.txt, white-list.txt, whitelist.json, white-list.json или allowlist.json.

Формат файла:

• txt — обычный текстовый файл, где каждый ник записан с новой строки.
• json — структурированный документ, в котором указываются ники и/или UUID игроков.

Чтобы добавить игрока вручную, нужно знать его UUID (уникальный идентификатор). Получить UUID можно в консоли сервера или через онлайн-сервисы. Для Bedrock Edition используется XUID.

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

Пример содержимого whitelist.json:

[
  {
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "Steve"
  }
]

В текстовом файле достаточно просто вписать ник, например:

Steve
Alex

Особенности для пиратских и оффлайн-серверов

Встроенный whitelist в ванильном Minecraft рассчитан на лицензионные аккаунты и использует UUID, которые выдаются Mojang. На пиратских (оффлайн) серверах, где onlinemode=false, система работает иначе.

Главная проблема: чтобы добавить игрока в whitelist на оффлайн-сервере, он должен хотя бы раз зайти на сервер. Только после этого его UUID будет привязан к нику, и команда whitelist add сработает корректно.

Если вы пытаетесь добавить игрока, который еще ни разу не заходил, система может не найти его в базе и выдать ошибку. В этом случае есть два пути:

1. Временно выключить whitelist, дать игроку зайти один раз, затем включить обратно.
2. Использовать плагин, который добавляет игроков по нику без предварительного входа.

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

Плагины для расширения возможностей whitelist

Встроенный whitelist имеет несколько ограничений, которые особенно заметны на серверах с плагинами. Для решения этих проблем существуют специальные плагины, например EasyWhitelist.

Преимущества плагинов:

• Добавление игрока по нику без предварительного захода.
• Работа с пиратскими и лицензионными аккаунтами одинаково.
• Настройка сообщения об отказе в доступе (можно перевести на русский).
• Возможность заранее вписать список ников в файл конфигурации.
• Управление без переустановки плагина.

Установка плагина:

1. Скачайте плагин, совместимый с вашим ядром (Spigot, Paper, Purpur и т.д.).
2. Поместите .jar файл в папку plugins.
3. Перезапустите сервер.
4. Включите whitelist командой /easywl on (в консоли — без слэша).
5. Добавьте себя первым, иначе не сможете зайти даже с правами администратора.
6. Добавляйте игроков командой /easywl add <ник>.

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

Сравнение ванильного whitelist и плагинов

Чтобы выбрать подходящий способ, важно понимать различия между встроенным whitelist и плагинами.

| Критерий | Ванильный whitelist | Плагин (EasyWhitelist и аналоги) | |---------------------------|----------------------------------|----------------------------------| | Требуется лицензия/вход | Да, для корректной работы | Нет | | Чувствительность к регистру | Часто вызывает проблемы | Обычно решена | | Настройка сообщений | Нет | Да | | Необходимость установки | Не требуется | Требуется (Spigot/Paper) | | Подходит для | Простых ванильных серверов | Серверов с плагинами, пиратских |

Если у вас чистый ванильный сервер без Spigot/Paper, доступен только встроенный whitelist. В этом случае внимательно следите за регистром ников при добавлении.

Если сервер работает на модифицированном ядре, плагин избавит от большинства проблем и даст больше гибкости в настройке.

Частые проблемы и их решение

При использовании whitelist могут возникать типичные сложности. Рассмотрим их и способы решения.

Игрок добавлен, но не может зайти.

Проверьте точное совпадение регистра ника. Выполните whitelist reload, чтобы перечитать файл. Если не помогло — перезапустите сервер полностью.

Не удается добавить игрока, который ни разу не заходил.

На ванильном whitelist это может не сработать из-за отсутствия UUID. Временно отключите whitelist, дайте игроку зайти, затем включите обратно. Либо используйте плагин.

Изменения в server.properties не применяются.

Убедитесь, что вы сохранили файл и полностью перезапустили сервер. Некоторые хостинги требуют остановки сервера перед редактированием.

Сообщение об отказе на английском.

В ванильном сервере текст изменить нельзя. Если у вас Spigot/Paper, отредактируйте файл spigot.yml или используйте плагин для настройки сообщений.

Автоматизация и дополнительные советы

Белый список можно автоматизировать. Например, на хостингах с планировщиком задач можно настроить периодическое выполнение команды whitelist reload, чтобы список подтягивал изменения из файла без ручного вмешательства.

Полезные рекомендации:

• Всегда добавляйте себя в whitelist первым, иначе рискуете потерять доступ к серверу.
• Регулярно проверяйте список командой whitelist list, чтобы удалять неактивных игроков.
• Если используете плагин, настройте сообщение об отказе на русском языке для удобства игроков.
• При редактировании файла белого списка останавливайте сервер, чтобы избежать конфликтов.
• Для больших серверов рассмотрите возможность использования базы данных или внешних плагинов для управления доступом.

Эти советы помогут сделать управление доступом более удобным и безопасным.

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