Объединение игроков Minecraft Java Edition и Bedrock Edition (смартфоны, планшеты, консоли Xbox, PlayStation, Nintendo Switch и ПК с Windows) на одном сервере — одна из самых востребованных задач для владельцев серверов. Плагин Geyser выполняет трансляцию сетевых пакетов между протоколами, однако по умолчанию он требует от игроков Bedrock наличия купленной лицензии Java Edition. Решением этой проблемы является установка вспомогательного плагина Floodgate, который обеспечивает бесшовную авторизацию через Xbox Live.
В этой статье подробно разобран процесс установки и тонкой настройки Geyser и Floodgate на серверах Paper и Purpur, генерация ключей шифрования, настройка префиксов ников и открытие сетевых портов UDP 19132.
Принцип работы связки Geyser и Floodgate#
Minecraft Java Edition и Bedrock Edition используют кардинально разные сетевые протоколы, системы рендеринга и форматы данных:
- Java Edition: Сетевой транспорт работает поверх протокола TCP (порт по умолчанию 25565), авторизация проверяется через сессионные серверы Mojang.
- Bedrock Edition: Сетевой транспорт функционирует поверх протокола UDP с библиотекой RakNet (порт по умолчанию 19132), авторизация привязана к учётным записям Microsoft Xbox Live.
Плагин Geyser выступает в роли эмулирующего шлюза: он слушает подключения Bedrock по UDP, переводит их в пакеты Java и отправляет локальному серверу.
Плагин Floodgate дополняет Geyser: он перехватывает этап рукопожатия и проверяет зашифрованный токен Xbox Live игрока Bedrock. На стороне Java-сервера создаётся виртуальный профиль с уникальным UUID. Благодаря этому игрокам Bedrock не требуется покупать копию Java Edition для совместной игры.
Установка плагинов на сервер Paper или Purpur#
Для работы связки скачайте последние версии Geyser-Spigot и floodgate-spigot в папку plugins/:
cd /opt/minecraft/plugins
wget https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot -O Geyser-Spigot.jar
wget https://download.geysermc.org/v2/projects/floodgate/versions/latest/builds/latest/downloads/spigot -O floodgate-spigot.jar
Перезапустите сервер Minecraft для первичной генерации конфигурационных файлов:
sudo systemctl restart minecraft
sudo journalctl -u minecraft -n 30 --no-pager | grep -i "geyser"
После перезапуска в каталоге plugins/ появятся рабочие папки plugins/Geyser-Spigot/ и plugins/floodgate/.
Настройка конфигурации Geyser: порты и режим авторизации#
Откройте файл конфигурации Geyser:
/opt/minecraft/plugins/Geyser-Spigot/config.yml
Отредактируйте параметры прослушивания сети и связывания с локальным сервером:
bedrock:
address: 0.0.0.0
port: 19132
clone-remote-port: false
motd1: "Geyser Crossplay Server"
motd2: "Java & Bedrock Together"
remote:
address: 127.0.0.1
port: 25565
auth-type: floodgate
Ключевой параметр — auth-type: floodgate. Он отключает требование Java-аккаунта и передаёт функции аутентификации локальному плагину Floodgate.
Настройка Floodgate: префиксы ников и безопасность ключей#
Откройте файл конфигурации Floodgate:
/opt/minecraft/plugins/floodgate/config.yml
Настройте префикс имени игрока:
username-prefix: "."
replace-spaces: true
username-prefix: "."— добавляет точку перед никнеймом игроков Bedrock (например,.Alex). Это защищает от конфликтов имён, если на сервер зайдёт игрок Bedrock с ником, идентичным существующему игроку Java.replace-spaces: true— заменяет пробелы в никнеймах Xbox Live на нижнее подчёркивание, исключая ошибки в командах плагинов прав (LuckPerms).
Floodgate автоматически генерирует симметричный ключ шифрования plugins/floodgate/key.pem и передаёт его Geyser. Убедитесь, что файл ключа имеет закрытые права доступа:
ls -l /opt/minecraft/plugins/floodgate/key.pem
chmod 600 /opt/minecraft/plugins/floodgate/key.pem
При использовании современной панели управления серверами кроссплей-модули и порты для мобильных устройств настраиваются автоматически без необходимости вручную редактировать YAML-файлы конфигурации.
Настройка брандмауэра и проброс порта UDP 19132#
Главная ошибка начинающих администраторов — открытие порта 19132 по протоколу TCP вместо UDP. Клиенты Bedrock отправляют пакеты исключительно по UDP.
Настройте фаервол UFW на сервере:
sudo ufw allow 25565/tcp comment "Minecraft Java Edition"
sudo ufw allow 19132/udp comment "Minecraft Bedrock Geyser"
sudo ufw status verbose
Проверьте, что сервер успешно связал сокет UDP:
sudo ss -ulnp | grep 19132
Перезапустите сервер для применения всех изменений:
sudo systemctl restart minecraft
sudo journalctl -u minecraft -f --no-pager
В журнале появится сообщение:
Started Geyser on 0.0.0.0:19132Теперь игроки с телефонов, планшетов, приставок и компьютеров могут комфортно подключаться к единому игровому миру на вашем Java-сервере.
