Как подключить игроков Bedrock с помощью Geyser и Floodgate
Откройте сервер Minecraft Java для игроков Bedrock с помощью Geyser и Floodgate на Paper: установка, порты TCP и UDP, брандмауэр, подключение и устранение неполадок.
На этой странице
Ваши значения
Укажите их один раз, и команды в руководстве обновятся.
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. Изменяйте существующие строки, не дублируя их:
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:
- Откройте Играть, затем вкладку Серверы
- Выберите Добавить сервер
- Введите название, адрес
IP_СЕРВЕРАи порт19132 - Сохраните настройки, затем подключитесь к серверу
При первом подключении игра спрашивает, доверять ли серверу. Это нормально при подключении по 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.ymlallow-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» или сервер не найден
- Проверьте, что порты TCP и UDP открыты:
sudo ufw status,sudo iptables -L INPUT -nилиsudo nft list ruleset - Проверьте, что порт прослушивается:
sudo ss -tulpn | grep 19132 - Выполните
geyser connectiontest IP_СЕРВЕРА 19132из консоли - Посмотрите в журнале, приходит ли попытка подключения. Если ничего не появляется, блокировка находится на уровне сети
Если брандмауэр сервера настроен правильно, но порт по-прежнему недоступен извне, обратитесь в поддержку из личного кабинета, чтобы проверить, не применяется ли сетевая фильтрация.
«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, перезапуская сервер и проверяя подключение после каждого изменения:
advanced:
bedrock:
mtu: 1300Сервер сообщает неверный адрес
Обычно Geyser сам определяет публичный адрес. Если у сервера несколько адресов или определить адрес не удаётся, укажите тот, который должны использовать игроки:
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.