Geyser и Floodgate: как пустить Bedrock-игроков на Java-сервер

Коротко: положите Geyser-Spigot.jar в plugins/ сервера на Paper или Geyser-Velocity.jar на прокси, перезапустите и откройте порт Geyser — по умолчанию 19132, сейчас и TCP, и UDP. Чтобы Bedrock-игрокам не нужен был Java-аккаунт, рядом ставят Floodgate и переключают auth-type в конфиге Geyser на floodgate. Geyser притворяется клиентом Java 26.3, поэтому сервер на другой версии, например на 1.21.11, должен пускать такие клиенты через ViaVersion.

Как это устроено и куда ставить#

Geyser — переводчик протокола между двумя разными играми. Bedrock-клиент подключается к Geyser, а Geyser заходит на Java-сервер как обычный Java-клиент. На октябрь 2026 года он поддерживает Bedrock 26.30–26.52 и Java 26.3; старые версии Bedrock не поддерживаются — Bedrock на всех платформах обновляется сам.

В сети серверов Geyser ставят на прокси, а не на каждый сервер: игрок подключается к прокси. Как устроена сеть — в статьях Velocity или BungeeCord и настройка Velocity.

Установка на Paper#

1. 1

   Проверьте версию сервера

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

2. 2

   Поставьте Geyser

   Скачайте Geyser-Spigot.jar со страницы загрузок GeyserMC, положите в plugins/ и перезапустите сервер. Появится plugins/Geyser-Spigot/config.yml.

3. 3

   Настройте порт

   В разделе bedrock: оставьте port: 19132 или выберите свой. Этот порт не может совпадать с портом Java-сервера и не должен быть занят другой программой — ни по TCP, ни по UDP: голосовым чатом, Query, веб-картой, сайтом.

4. 4

   Откройте порт наружу

   Пробросьте порт Geyser и по TCP, и по UDP в роутере и файрволе. Раньше хватало UDP, но теперь Bedrock ищет сервер по TCP, а играет по UDP: без TCP сервер не появится. Если открыть порт нельзя, документация предлагает туннель playit.gg; ngrok не подойдёт — он не умеет UDP. На хостинге порт обычно выдаёт сам хостинг — GeyserMC держит инструкции для многих из них.

bedrock:
  port: 19132
  transport: nethernet

transport: nethernet полностью работает с Bedrock 26.50 и новее. Документация описывает и режим both — NetherNet вместе с RakNet: некоторые версии, например 26.40, запрашивают MOTD и число игроков по RakNet. Для него нужен отдельный UDP-порт webrtc-port, его тоже открывают. Общие правила про порты и файрвол — в статье IP и порт сервера.

Floodgate: вход без Java-аккаунта#

Без Floodgate Geyser либо авторизует игрока в Mojang — тогда Bedrock-игроку нужен купленный Java-аккаунт, — либо пускает без проверки на сервер с offline-mode, что GeyserMC называет опасным и нарушением EULA. Floodgate пускает игроков с Bedrock-аккаунтом Microsoft, показывает их скины Java-игрокам, даёт плагинам Bedrock-формы и связку аккаунтов Bedrock и Java.

1. 1

   Поставьте Floodgate

   Скачайте Floodgate-Spigot.jar со страницы загрузок GeyserMC, положите в plugins/ и перезапустите сервер.

2. 2

   Переключите Geyser

   В конфиге Geyser поставьте auth-type: floodgate и перезапустите сервер ещё раз.

3. 3

   Сеть с прокси

   Floodgate достаточно поставить на прокси. На серверы за ним — только если плагинам там нужен Floodgate API: тогда настраивают передачу данных игроков с прокси, на прокси включают send-floodgate-data, а файл key.pem копируют на каждый сервер.

• Ключ `key.pem` — секрет. Документация прямо пишет: никому его не отдавайте. Кто получил ключ, может заходить Bedrock-аккаунтами в обход проверки Java.
• Префикс ника. Floodgate добавляет к никам Bedrock-игроков префикс, чтобы они не совпали с Java-никами: по умолчанию точка (username-prefix: "."), пробелы заменяются на _.
• Белый список. Bedrock-игроков добавляют командой fwhitelist add <ник> без префикса, право — floodgate.command.fwhitelist. Как устроен whitelist — в статье OP и белый список.

Чего Geyser не умеет#

Bedrock и Java — разные игры с разным кодом, и часть различий Geyser закрыть не может. Из списка «Current limitations»:

• кликабельные ссылки в чате и эффект свечения;
• различие левого и правого клика в инвентарях;
• всё, что завязано на автодополнение и ввод в окне чата, и аргументы команд, которые не используют библиотеку Brigadier;
• больше 6 слоёв на баннере, свои рецепты наковальни и кузнечного стола, свои чары;
• движение рядом с бамбуком — из-за разницы смещений между версиями; обходится плагином Hurricane;
• высоты ниже −512 и выше 512 в верхнем мире;
• полёт без элитр и свои элитры, разная максимальная длина табличек.

Часть отличий — позы стоек для брони, частицы ударов, анимации второй руки, ширина скорборда — исправляет ресурспак GeyserIntegratedPack, который идёт с Geyser. Перед открытием проверьте свои ключевые механики с Bedrock-клиента: меню на кликах, команды с подсказками, кастомные предметы.

Geyser и античит#

Bedrock-клиент двигается и бьёт по своей физике, а античит, рассчитанный на Java-клиент, может принять разницу за чит. GeyserMC ведёт общественный список совместимости античитов в трёх группах: проверяют Bedrock-игроков точно; не проверяют или пропускают их; дают ложные срабатывания. Сами авторы оговариваются, что список составлен сообществом и не является рекомендацией. Почему вообще бывают ложные баны — в статье ложные баны.

DGuard — лучший античит для современного сервера Minecraft — делает исключения для игроков Bedrock, которые заходят через Floodgate. Java-игроков он проверяет на всех фронтах: бой, движение, пакеты, инвентарь, постройка и мир. DGuard работает за Velocity и BungeeCord и проверяет клиентов 1.21–26.x, зашедших через ViaVersion. Если пускаете Bedrock в сеть с прокси, уточните в поддержке, как лучше поставить Floodgate для вашей схемы.

Частые вопросы#