Whitelist for Geyser: фикс вайтлиста для Bedrock-игроков

Whitelist for Geyser: решение проблем с вайтлистом на серверах с Bedrock-игроками Каждый администратор Minecraft-сервера рано или поздно сталкивается с необходимостью ограничить доступ. Стандартный вайтлист — штука надёжная, но ровно до того момента, пока вы не решите подружить Java Edition с Bed...

Скачать Whitelist для Minecraft 1.9

Оригинальное название: Whitelist

Версии Minecraft: 1.9

ФайлВерсияЗагрузчикРазмер
Whitelist-2.1.jar1.9—28 КБСкачать

Whitelist for Geyser: решение проблем с вайтлистом на серверах с Bedrock-игроками

Каждый администратор Minecraft-сервера рано или поздно сталкивается с необходимостью ограничить доступ. Стандартный вайтлист — штука надёжная, но ровно до того момента, пока вы не решите подружить Java Edition с Bedrock через Geyser и Floodgate. Встроенная система начинает капризничать: она упорно пытается добавить в белый список Mojang UUID, которого у оффлайн-игроков или владельцев Bedrock-аккаунтов попросту нет. Результат — бесконечные правки whitelist.json вручную или опасная практика временного отключения защиты. Плагин Whitelist for Geyser создан, чтобы забыть об этой головной боли.

Почему стандартный вайтлист не дружит с Geyser

Корень проблемы кроется в архитектуре идентификации. Когда вы выполняете команду /whitelist add PlayerName на сервере с включённым онлайн-режимом, ядро сначала пытается получить UUID игрока у Mojang. Если сервер работает в оффлайн-режиме или игрок заходит через Geyser с Floodgate (где авторизация идёт через Bedrock-аккаунт), Mojang API возвращает ошибку или неверный идентификатор. UUID, сгенерированный Floodgate, не совпадает с ожидаемым, и игрок остаётся за бортом. Администратору приходится либо лезть в JSON-файл и править идентификаторы, либо на время отключать whitelist, чтобы игрок зашёл, а потом добавлять его вручную. Оба варианта неудобны и небезопасны.

Как работает плагин Whitelist for Geyser

Автор плагина написал его для личных нужд, а затем выложил в открытый доступ. Принцип элегантен: вместо того чтобы сразу требовать UUID, плагин позволяет добавить в белый список просто никнейм. При этом поле UUID остаётся пустым. Когда игрок впервые заходит на сервер, плагин перехватывает событие входа, берёт его реальный UUID (тот самый, который присвоил Floodgate или оффлайн-режим) и автоматически подставляет в запись вайтлиста. Таким образом, вам не нужно гадать, какой идентификатор окажется у конкретного Bedrock-пользователя, и не нужно выключать защиту сервера даже на секунду.

Интересная деталь: если у вас уже был включён стандартный вайтлист до установки плагина, Whitelist for Geyser импортирует всех существующих игроков и отключит встроенную систему. Это делает переход плавным и безболезненным. Для игроков, которые заходят с Bedrock-устройств, настройка клиента может показаться запутанной, но современные лаунчеры вроде foxygame.net позволяют быстро подобрать нужную версию и установить вспомогательные моды прямо из меню, что особенно ценно, когда хочется сосредоточиться на игре, а не на технических нюансах подключения.

Установка и первые шаги

Плагин распространяется как обычный JAR-файл для серверов на базе Paper, Spigot или их форков. Достаточно поместить его в папку plugins и перезапустить сервер. Никаких дополнительных зависимостей не требуется — он работает автономно. После запуска плагин создаст собственный файл конфигурации, где будет хранить белый список. Если стандартный whitelist был активен, данные автоматически перенесутся, а встроенный механизм отключится. С этого момента все операции по управлению доступом выполняются только через команды плагина.

Команды и управление

Whitelist for Geyser предлагает интуитивный набор команд, которые покрывают все базовые сценарии:

  • /whitelist — показывает список всех доступных подкоманд.
  • /whitelist add <никнеймы через пробел> — добавляет одного или нескольких игроков по нику. UUID не требуется.
  • /whitelist addUUID <UUID> — добавляет конкретный UUID. Пока поддерживается только по одному за раз.
  • /whitelist remove <никнеймы через пробел> — удаляет игроков из белого списка.
  • /whitelist removeUUID <UUID> — удаляет запись по UUID (по одному).
  • /whitelist list — выводит список всех, кто внесён в вайтлист. Если добавлен UUID, а игрок ещё не заходил, отобразится строка "UUID:" с идентификатором.

Главное преимущество — команда add принимает имена, а не идентификаторы. Вы можете добавить сразу несколько ников, разделяя их пробелами, и не задумываться о том, какой UUID им присвоит Floodgate. После первого входа игрока плагин сам обновит запись, заменив ник на реальный UUID. Это особенно удобно, когда вы массово приглашаете друзей с Bedrock-версии: достаточно скопировать их геймертеги, и доступ открыт.

Сравнение с ручными методами

До появления подобных решений администраторам приходилось идти на ухищрения. Кто-то писал скрипты для автоматической правки whitelist.json, кто-то настраивал прокси-плагины, а кто-то просто отключал вайтлист на время первого входа. Все эти подходы либо требовали технических знаний, либо создавали окно уязвимости. Whitelist for Geyser же работает прозрачно и не нарушает привычного workflow. Вы по-прежнему контролируете доступ, но теперь система понимает особенности гибридных серверов.

Ещё один плюс — плагин не конфликтует с другими средствами защиты. Он просто заменяет логику обработки белого списка, не затрагивая права операторов, системы банов или анти-чит. Это точечное решение конкретной проблемы, а не громоздкий комбайн.

Кому пригодится этот плагин

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

Заключение

Плагин Whitelist for Geyser закрывает досадный пробел в экосистеме Minecraft-серверов. Он превращает мучительный процесс добавления Bedrock-игроков в белый список в тривиальную операцию с никами, а автоматическая замена UUID после входа делает работу администратора по-настоящему незаметной. Если вы устали бороться с whitelist.json и хотите, чтобы ваши игроки с телефонов, консолей и ПК заходили без задержек, просто добавьте этот инструмент в свою сборку. Никаких компромиссов по безопасности, никаких ручных правок — только работающий белый список, который понимает особенности Geyser и оффлайн-режима.