#Как настроить ванильный whitelist на Minecraft-сервере

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

В этой статье рассматривается стандартный whitelist Minecraft Java Edition, который доступен в Vanilla и других ядрах на базе официального сервера.

#Что важно знать заранее

Whitelist не заменяет пароль, авторизацию или защиту аккаунта. Он только ограничивает список игроков, которым разрешено подключение.

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

#Как включить whitelist

#Через консоль панели

1. Откройте нужный сервер в панели управления.

2. Перейдите в раздел Консоль.

3. Выполните команду:

   textwhitelist on

В консоли команду обычно вводят без символа / в начале.

#Из игры

Если у вас есть права оператора, откройте игровой чат клавишей T и выполните:

text/whitelist on

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

#Как добавить игрока

Чтобы разрешить игроку подключаться к серверу, выполните:

Через консоль:

textwhitelist add НикИгрока

В игре:

text/whitelist add НикИгрока

Пример:

textwhitelist add Alex

Если игрок уже находится на сервере, команда добавит его в список, но не изменит его текущую игровую сессию.

#Как удалить игрока из whitelist

Через консоль:

textwhitelist remove НикИгрока

В игре:

text/whitelist remove НикИгрока

Пример:

textwhitelist remove Alex

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

#Как посмотреть список игроков

Чтобы вывести текущий список:

Через консоль:

textwhitelist list

В игре:

text/whitelist list

Команда покажет игроков, которым разрешено подключение.

#Как обновить whitelist

Если файл whitelist изменялся вручную через файловый менеджер или SFTP, обновите его командой:

Через консоль:

textwhitelist reload

В игре:

text/whitelist reload

Без необходимости не редактируйте whitelist.json вручную. Проще и безопаснее добавлять и удалять игроков командами.

#Как отключить whitelist

Чтобы снова разрешить подключение всем игрокам:

Через консоль:

textwhitelist off

В игре:

text/whitelist off

Список игроков при этом не удаляется. Если снова выполнить whitelist on, сервер будет использовать сохраненный список.

#Принудительно применять whitelist к уже подключенным игрокам

Параметр enforce-whitelist определяет, будет ли сервер отключать игроков, которых нет в whitelist, когда список обновляется.

В файле server.properties можно указать:

Propertiesenforce-whitelist=true

При значении true сервер применяет whitelist к уже подключенным игрокам после обновления списка. При значении false whitelist обычно проверяется при новом подключении.

После изменения server.properties перезапустите сервер, чтобы настройка точно применилась.

Не путайте enforce-whitelist с white-list:

Propertieswhite-list=true

Параметр white-list задает включенное или выключенное состояние whitelist в конфигурации. Для управления в процессе работы удобнее использовать команды whitelist on и whitelist off.

#Где хранятся данные whitelist

Список игроков сохраняется в файле:

textwhitelist.json

Файл находится в основной папке сервера рядом с server.properties.

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

#Особенности пиратского сервера

На сервере с пиратским режимом установлен параметр:

Propertiesonline-mode=false

В таком режиме сервер не проверяет через официальный API, принадлежит ли введенное игровое имя настоящему аккаунту Minecraft. Это позволяет подключаться неофициальным клиентам, но снижает надежность стандартной идентификации игроков.

У ванильного whitelist в таком режиме могут возникать проблемы из-за UUID:

• в online-mode=true UUID игрока подтверждается официальной авторизацией Minecraft;
• в online-mode=false сервер не подтверждает аккаунт через Mojang и создает локальный UUID;
• если игрок изменит имя, для него может будет рассчитан уже другой UUID, поэтому он потеряет доступ к старой записи и данные игрока могут выглядеть как данные нового игрока;
• другой человек может зайти под тем же именем, потому что сервер не проверяет, кому оно принадлежит;
• записи whitelist, созданные в одном режиме авторизации, могут не совпасть с записями в другом режиме;
• перенос whitelist.json между серверами или смена режима авторизации может привести к тому, что ожидаемый игрок не пройдет проверку.

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

#Что использовать на пиратском сервере

Если сервер работает в пиратском режиме, вместо стандартного whitelist можно использовать систему доступа, которая умеет работать с offline-игроками и не полагается на случайно сохраненный UUID.

Например, можно рассмотреть Monban на Modrinth. Monban — альтернативный whitelist и система управления доступом, которая явно разделяет ONLINE- и OFFLINE-идентичности игроков. Благодаря этому offline-игроков можно добавлять и проверять по игровому имени, а не пытаться определить их как официальные аккаунты по UUID.

На обычном сервере Monban заменяет стандартный whitelist. Нативный whitelist при этом нужно отключить в server.properties:

Propertieswhite-list=false

Доступом управляют командами Monban, указанными в его официальной документации. Перед установкой выберите сборку под свое ядро: Monban поддерживает Bukkit/Spigot, Paper/Purpur/Folia и Velocity.

На Velocity Monban может работать как центральная система доступа для сети серверов. Помимо общего whitelist, он позволяет настраивать доступ к отдельным backend-серверам и группам серверов, группы игроков и права, а также синхронизировать настройки с подключенными backend-серверами. Это особенно удобно, если у пользователя есть доступ, например, к лобби и выживанию, но нет доступа к закрытому тестовому серверу.

Перед установкой проверьте:

• поддерживает ли плагин ваше ядро;
• совместим ли он с версией Minecraft;
• какие команды и настройки он использует;
• есть ли резервная копия сервера;
• не установлен ли другой плагин с конфликтующей системой авторизации.

Monban и ванильный whitelist решают одну основную задачу — ограничивают доступ к серверу, но используют разные модели идентификации и управления. Не включайте их одновременно без необходимости: две независимые системы доступа могут привести к непонятным отказам во входе.

Для Fabric, Forge, NeoForge или Quilt ищите мод на whitelist, совместимый именно с вашим загрузчиком и версией Minecraft. Мод для одного загрузчика не обязательно будет работать на другом.

#Частые проблемы

#Игрок не может подключиться после добавления

Проверьте:

• whitelist действительно включен командой whitelist on;
• игровое имя указано точно;
• не перепутан нужный сервер;
• игрок использует тот же режим авторизации, под который создавалась запись;
• после изменения файла выполнена команда whitelist reload или сервер перезапущен.

#Команда не выполняется

Для выполнения команд в игре нужны права оператора. Если OP нет, выполните команду через консоль панели.

#Игрока нет в списке после добавления

Выполните:

textwhitelist list

Если игрок не отображается, повторите команду whitelist add и проверьте написание имени.

#После отключения whitelist игроки все еще не могут зайти

Проверьте, нет ли других ограничений:

• плагина авторизации;
• блокировки игрока в banned-players.json;
• блокировки IP в banned-ips.json;
• лимита подключений;
• ошибки версии Minecraft или модов.

#После смены имени игрок потерял доступ

На сервере с официальной авторизацией UUID обычно позволяет корректнее связать игрока с аккаунтом. На пиратском сервере смена имени может привести к другой идентификации и проблемам с whitelist. Для такого сервера используйте систему авторизации и заранее проверьте ее настройки.

#Краткая памятка

Включить whitelist:

textwhitelist on

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

textwhitelist add НикИгрока

Удалить игрока:

textwhitelist remove НикИгрока

Посмотреть список:

textwhitelist list

Обновить список:

textwhitelist reload

Отключить whitelist:

textwhitelist off