RU

Игровые серверы

Как подключить игроков Bedrock с помощью Geyser и Floodgate

Откройте сервер Minecraft Java для игроков Bedrock с помощью Geyser и Floodgate на Paper: установка, порты TCP и UDP, брандмауэр, подключение и устранение неполадок.

6 мин чтения, обновлено 18 ноября 2026 г.

На этой странице

Ваши значения

Укажите их один раз, и команды в руководстве обновятся.

Minecraft Java и Minecraft Bedrock (мобильные устройства, Windows, консоли) используют разные сетевые протоколы. Это руководство объясняет, как установить на сервер Paper два плагина, чтобы игроки Bedrock могли к нему присоединиться:

  • Geyser переводит обмен данными между Bedrock и Java
  • Floodgate позволяет игрокам Bedrock входить со своей учётной записью Microsoft, не имея Minecraft Java

Предварительные требования

  • Сервер на Paper с командой mc-console, настроенной по руководству Установка и обновление плагинов на Paper
  • Включённый онлайн-режим в server.properties: online-mode=true
  • Доступ к брандмауэру сервера
  • Актуальный клиент Minecraft Bedrock для проверки

Какие порты используются

Bedrock теперь использует протокол подключения NetherNet, включённый в Geyser по умолчанию. Ему нужен один и тот же номер порта в обоих протоколах:

Порт Протокол Назначение
19132 TCP Сигнальный обмен: клиент находит сервер и подготавливает соединение
19132 UDP Игровой трафик
25565 TCP Игроки Java, порт уже открыт

Настройка брандмауэра

Используйте только один инструмент брандмауэра — тот, который уже активен на вашем сервере.

С UFW

Терминал
sudo ufw allow 19132/tcp
sudo ufw allow 19132/udp
sudo ufw reload

С iptables

Терминал
sudo iptables -A INPUT -p tcp --dport 19132 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 19132 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4

Сохранение правил после перезагрузки требует пакета iptables-persistent.

С nftables

Эти команды используют таблицу inet filter и цепочку input, присутствующие по умолчанию в /etc/nftables.conf в Debian.

Терминал
sudo nft add rule inet filter input tcp dport 19132 accept
sudo nft add rule inet filter input udp dport 19132 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.conf

Установка Geyser и Floodgate

Загрузите версии для Paper и Spigot из официального сервиса:

Терминал
sudo -u minecraft bash
cd /opt/minecraft/server/plugins
curl -fL -o Geyser-Spigot.jar https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot
curl -fL -o floodgate-spigot.jar https://download.geysermc.org/v2/projects/floodgate/versions/latest/builds/latest/downloads/spigot
ls -l Geyser-Spigot.jar floodgate-spigot.jar
exit

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

Терминал
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -f

Выйдите из просмотра журнала клавишами Ctrl+C.

Настройка Geyser

Откройте файл конфигурации:

Терминал
sudo -u minecraft nano /opt/minecraft/server/plugins/Geyser-Spigot/config.yml

Проверьте раздел bedrock, затем установите для auth-type значение floodgate в разделе java. Изменяйте существующие строки, не дублируя их:

YAML
bedrock:
  address: 0.0.0.0
  port: 19132
  transport: nethernet

java:
  auth-type: floodgate

Вы также можете изменить имя, которое видят игроки Bedrock, с помощью параметра server-name в разделе gameplay.

Перезапустите сервер, чтобы применить изменения:

Терминал
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -f

Проверка результата

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

Терминал
sudo mc-console plugins
sudo mc-console 'geyser version'
sudo MC_CONSOLE_WAIT=5 mc-console 'geyser nethernet'
sudo ss -tulpn | grep 19132

Вы должны увидеть:

  • Geyser-Spigot и floodgate в списке плагинов
  • строку Built-in signaling started on в журнале запуска
  • порт 19132 в tcp и в udp в выводе ss

Затем проверьте доступ извне. Следующая команда просит Geyser проверить, доступен ли ваш сервер:

Терминал
sudo MC_CONSOLE_WAIT=15 mc-console 'geyser connectiontest IP_СЕРВЕРА 19132'

С другого компьютера можно также проверить порт TCP:

Терминал
nc -vz IP_СЕРВЕРА 19132

Подключение из Bedrock

В Minecraft Bedrock:

  1. Откройте Играть, затем вкладку Серверы
  2. Выберите Добавить сервер
  3. Введите название, адрес IP_СЕРВЕРА и порт 19132
  4. Сохраните настройки, затем подключитесь к серверу

При первом подключении игра спрашивает, доверять ли серверу. Это нормально при подключении по IP-адресу или без HTTPS. Чтобы убрать это сообщение, можно обслуживать сигнальный обмен по HTTPS с доменным именем и сертификатом.

Когда игрок войдёт в игру, убедитесь, что он присутствует на сервере:

Терминал
sudo mc-console 'geyser list'

Управление игроками Bedrock

Ники

Floodgate добавляет точку перед никами Bedrock, чтобы избежать конфликтов с учётными записями Java: Steve становится .Steve. Пробелы заменяются на _. За это отвечают параметры username-prefix и replace-spaces в plugins/floodgate/config.yml.

Whitelist

Если включён white-list=true, добавляйте игроков Bedrock командой Floodgate, без точки:

Терминал
sudo mc-console 'fwhitelist add Steve'

Права с LuckPerms

По умолчанию LuckPerms отклоняет ники с точкой. Разрешите их в его файле конфигурации:

Терминал
sudo -u minecraft nano /opt/minecraft/server/plugins/LuckPerms/config.yml
YAML
allow-invalid-usernames: true

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

Терминал
sudo mc-console 'lp user .Steve parent add vip'

Привязка учётных записей Java и Bedrock

Игрок, у которого есть обе версии игры, может связать их, зайдя на сервер link.geysermc.org с каждой учётной записи и использовав /linkaccount. Эта глобальная привязка включена по умолчанию.

Обновление Geyser и Floodgate

Bedrock часто меняется, и новая версия игры может помешать игрокам подключаться, пока Geyser не обновлён. Регулярно обновляйте его:

Терминал
sudo -u minecraft bash
mkdir -p /opt/minecraft/server/plugins/update
cd /opt/minecraft/server/plugins/update
curl -fL -o Geyser-Spigot.jar https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot
curl -fL -o floodgate-spigot.jar https://download.geysermc.org/v2/projects/floodgate/versions/latest/builds/latest/downloads/spigot
exit
sudo systemctl restart minecraft.service

При возникновении проблем

«Unable to connect to world» или сервер не найден

  1. Проверьте, что порты TCP и UDP открыты: sudo ufw status, sudo iptables -L INPUT -n или sudo nft list ruleset
  2. Проверьте, что порт прослушивается: sudo ss -tulpn | grep 19132
  3. Выполните geyser connectiontest IP_СЕРВЕРА 19132 из консоли
  4. Посмотрите в журнале, приходит ли попытка подключения. Если ничего не появляется, блокировка находится на уровне сети

Если брандмауэр сервера настроен правильно, но порт по-прежнему недоступен извне, обратитесь в поддержку из личного кабинета, чтобы проверить, не применяется ли сетевая фильтрация.

«NetherNet will not start! Could not load its WebRTC native library»

Geyser не смог загрузить свою сетевую библиотеку, которую он извлекает во временную папку. Убедитесь, что /tmp не смонтирован с параметром noexec и что на нём есть свободное место:

Терминал
findmnt -no OPTIONS /tmp
df -h /tmp

Клиент зависает на поиске сервера («Locating Server»)

Уменьшайте размер пакетов шагами по 100 в plugins/Geyser-Spigot/config.yml, перезапуская сервер и проверяя подключение после каждого изменения:

YAML
advanced:
  bedrock:
    mtu: 1300

Сервер сообщает неверный адрес

Обычно Geyser сам определяет публичный адрес. Если у сервера несколько адресов или определить адрес не удаётся, укажите тот, который должны использовать игроки:

YAML
bedrock:
  signaling:
    advertise-addresses:
      - IP_СЕРВЕРА

«Address already in use»

Порт 19132 уже занят другой программой, часто это второй экземпляр Geyser. Определите её с помощью sudo ss -tulpn | grep 19132.

«Auth-type set to Floodgate but Floodgate is not installed!»

Floodgate отсутствует или не запустился. Проверьте наличие floodgate-spigot.jar в plugins, затем найдите его ошибки в журнале.

«Cannot reply to EncryptionRequestPacket without profile and access token»

Floodgate не активен, или для auth-type не задано значение floodgate. Проверьте оба пункта. Если в папке Geyser есть копия key.pem, удалите её.

«javax.crypto.AEADBadTagException: Tag mismatch!»

Ключ Floodgate не согласован. Остановите сервер, удалите папку plugins/floodgate и любой ключ в plugins/Geyser-Spigot, затем снова запустите сервер:

Терминал
sudo systemctl stop minecraft.service
sudo rm -rf /opt/minecraft/server/plugins/floodgate
sudo rm -f /opt/minecraft/server/plugins/Geyser-Spigot/key.pem
sudo systemctl start minecraft.service

Если вы меняли конфигурацию Floodgate, эти настройки придётся выполнить заново.

«Please connect through the official Geyser»

Geyser и Floodgate несовместимы между собой. Обновите оба плагина.

«Failed to verify username!»

В config/paper-global.yml установите для perform-username-validation значение false в разделе unsupported-settings, затем перезапустите сервер.

«Outdated client» или «Outdated server»

Клиент Bedrock и Geyser больше не соответствуют друг другу. Обновите Geyser, затем игру. Если ваш сервер Java работает не на версии 26.3, установите ViaVersion.

Подробнее читайте в официальной документации Geyser и документации Floodgate.