Пусти игроков Bedrock на свой Java-сервер: настройка Geyser + Floodgate (Paper, Velocity)

Что делают Geyser и Floodgate

Geyser переводит между двумя версиями. Для твоего сервера он выглядит как Java-клиент, поэтому редстоун, фермы и плагины работают точно так же, как для игроков Java. Floodgate позволяет игрокам Bedrock входить через аккаунт Xbox, а не через Java-аккаунт.

Перед началом: Java и версии

• Geyser нужна Java 21 или новее на машине, где он запущен.
• Твой сервер должен принимать новейшую версию Java, потому что Geyser имитирует такой клиент. Старым серверам нужен ViaVersion.
• Geyser-Spigot работает на Paper и Spigot начиная с 1.20.5. Старым серверам нужен прокси, Geyser Standalone или ViaProxy.
• Поддерживаются только актуальные версии Bedrock (октябрь 2026: Bedrock от 26.30 до 26.52, Java 26.2). Обновляй Geyser вовремя, потому что Bedrock обновляется сам.

Скачай Geyser и Floodgate для своей платформы с официальной страницы загрузки GeyserMC.

Настройка на одиночном сервере Paper или Spigot

1. Положи Geyser-Spigot.jar и Floodgate-Spigot.jar в папку plugins.
2. Перезапусти сервер. Geyser создаст plugins/Geyser-Spigot/config.yml, Floodgate – plugins/floodgate/ с config.yml и key.pem.
3. Открой конфиг Geyser и проверь раздел bedrock. Значение port – это то, что будут вводить игроки Bedrock.
4. Поставь тип аутентификации floodgate и снова перезапусти сервер.

bedrock:
  address: 0.0.0.0
  port: 19132
  clone-remote-port: false

java:
  auth-type: floodgate

В старых конфигах Geyser второй раздел называется remote, поэтому настройка – remote.auth-type. Текущие сборки сами переключаются на Floodgate, если он работает на том же сервере; указать её явно не повредит.

На одиночном сервере никуда не копируй key.pem. Geyser читает его из Floodgate, а забытая копия в папке Geyser вызывает ошибки входа.

Открой порт Bedrock для UDP

Java использует TCP, Bedrock – UDP. Большинство сломанных настроек спотыкаются именно здесь.

• Панель хостинга: добавь дополнительный порт (многие хостеры называют это allocation) и укажи его как bedrock.port. Некоторые хостеры требуют, чтобы Bedrock использовал тот же порт, что и Java, или меняют порт Java при каждом запуске; там clone-remote-port: true заставляет Geyser брать порт Java. На странице настройки Geyser есть инструкции для многих хостеров.
• Pterodactyl: выдели порт серверу на вкладке Network.
• Своя машина или VPS: открой порт для UDP в файрволе, а дома – ещё и в роутере. OVH и Oracle Cloud тоже блокируют UDP в своём собственном файрволе.

sudo ufw allow 19132/udp
sudo ufw reload

Плагины голосового чата и query не могут делить порт с Geyser. Когда порт открыт, выполни в консоли geyser connectiontest <ip> <port> – команда проверит порт и подскажет, что исправить.

Настройка в сети на Velocity или BungeeCord

В сети серверов игроки Bedrock подключаются к прокси точно так же, как игроки Java. Поэтому Geyser работает только на прокси.

1. Установи Geyser и Floodgate для своего прокси (Velocity или BungeeCord) и перезапусти прокси.
2. Укажи bedrock.port и тип аутентификации floodgate в конфиге Geyser на прокси и открой порт для UDP, как описано выше.
3. Установи Floodgate-Spigot на каждый бэкенд. Он нужен плагинам, которые используют Floodgate API, и улучшает скины.
4. Настрой форвардинг: в BungeeCord поставь ip_forward: true в его config.yml и bungeecord: true в spigot.yml каждого бэкенда; в Velocity настрой форвардинг информации об игроках, как описано в документации Velocity.
5. В конфиге Floodgate на прокси поставь send-floodgate-data: true.
6. Скопируй key.pem из папки Floodgate на прокси в папку Floodgate каждого бэкенд-сервера, затем перезапусти бэкенды и прокси.

send-floodgate-data: true

Держи key.pem в секрете: он пропускает аккаунты в обход Java-аутентификации. Загружай его по FTP в двоичном режиме, иначе получишь ошибки Tag mismatch.

Ники Bedrock: префикс-точка

Floodgate ставит перед каждым ником Bedrock префикс, чтобы он никогда не совпал с ником Java. По умолчанию это точка, так что gamertag Xbox Steve на твоём сервере становится .Steve. Пробелы в gamertag заменяются на _.

username-prefix: "."
replace-spaces: true

• В командах используй полный ник с префиксом. Если команда его не принимает, возьми ник в кавычки: /tp ".Steve".
• Для вайтлиста используй fwhitelist add Steve. Префикс там не нужен.
• Если у LuckPerms проблемы с никами Bedrock, поставь в его конфиге allow-invalid-usernames: true.

GeyserMC советует префикс оставить. Игроки Bedrock и голосуют с этим ником: на BestMCServerList они вводят .Steve – именно этот ник увидит твой плагин наград за голоса.

Связанные аккаунты и скины (по желанию)

Global Linking в Floodgate включён по умолчанию. Игроки, у которых есть обе версии, заходят на link.geysermc.org с обоих аккаунтов и вводят /linkaccount. После этого они играют с Java-инвентарём и Java-позицией с любого устройства, так что сначала им стоит перенести свои вещи из Bedrock. Для локальной базы связей нужно отдельное расширение Floodgate.

Floodgate конвертирует и загружает скины Bedrock, чтобы игроки Java их видели. Это идёт через очередь и может занять время.

Частые ошибки и их решение

Кое-что перевести невозможно: левый и правый клик в инвентаре выглядят одинаково, команды без Brigadier не получают автодополнения по Tab, ссылки в чате не кликабельны. Проверяй меню на настоящем устройстве с Bedrock. Плагины могут показывать нативные формы Bedrock через Floodgate API, для этого Floodgate должен стоять на их сервере.

Покажи оба адреса на BestMCServerList

Игроки Bedrock подключаются по твоему адресу плюс порт Bedrock, например play.example.net и 19132. BestMCServerList показывает адреса Java и Bedrock на каждой странице сервера отдельно, у каждого своя кнопка копирования.

1. Открой страницу Добавить сервер и введи адрес Java.
2. Отметь Игроки Bedrock поддерживаются.
3. Введи порт Bedrock из bedrock.port. Оставь IP Bedrock пустым, если он совпадает с адресом Java.

Кроссплей – настоящее преимущество для нового сервера. Остальной план смотри в гайде как найти игроков для нового сервера.