Geyser: подключение Bedrock-клиентов к Java-серверу Minecraft в 2026

Установка и настройка Geyser и Floodgate для подключения игроков с Bedrock Edition к Java-серверу. Конфиги, порты, плагины, ограничения.

Кратко: Geyser - это open-source прокси, который переводит протокол Bedrock в Java и позволяет игрокам с телефонов, консолей и Windows 10/11 Edition заходить на Java-сервер. На Paper 1.21+ ставится как плагин Geyser-Spigot в plugins/, слушает UDP 19132, требует Floodgate для online-mode серверов.

Java и Bedrock - это две разные версии Minecraft с несовместимыми протоколами. Java работает на PC по протоколу TCP 25565, Bedrock - на телефонах, консолях, Windows 10/11 по UDP 19132. До появления Geyser объединить аудитории было невозможно. Теперь же один Java-сервер может одновременно обслуживать обе платформы. Разберём, как поставить Geyser, настроить Floodgate, открыть порты и обойти типичные ограничения.

Pterohost - игровой хостинг с DDoS-защитой L4+L7, NVMe SSD и 24/7 поддержкой. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг

Что такое Geyser

Geyser - это бесплатный open-source прокси-протокол от команды GeyserMC, который динамически переводит пакеты Minecraft Bedrock в Java и обратно. Запускается либо как плагин на Java-сервере (Geyser-Spigot, Geyser-Fabric, Geyser-Velocity, Geyser-BungeeCord), либо как отдельный standalone-прокси.

Что Geyser делает:

• Принимает Bedrock-клиента на UDP-порту 19132.
• Переводит пакеты Bedrock-протокола (v1.21.x) в Java-пакеты текущей версии.
• Эмулирует Bedrock-инвентарь поверх Java-инвентаря.
• Конвертирует чанки и блоки.
• Передаёт чат, команды, скины (через Floodgate).

Что Geyser НЕ делает:

• Не запускает Bedrock-моды (их в Minecraft Bedrock практически нет).
• Не работает с Java-модами Forge/Fabric, требующими клиентский мод.
• Не конвертирует кастомные блоки автоматически (нужен ResourcePack Converter).
• Не запускает Java-плагины на Bedrock-стороне.

Geyser-Spigot vs Geyser-Standalone vs Geyser-Velocity

Для большинства - Geyser-Spigot для одиночного Paper или Geyser-Velocity для сети.

Установка Geyser-Spigot: пошагово

Шаг 1. Скачать JAR

Зайдите на geysermc.org/download, выберите Geyser-Spigot и скачайте последний build (на май 2026 - Geyser 2.6+).

Шаг 2. Положить в plugins/

Загрузите Geyser-Spigot.jar в plugins/ на сервере и перезапустите Paper. В консоли появятся строки:

[Geyser-Spigot] Loading Geyser...
[Geyser-Spigot] Started Geyser on 0.0.0.0:19132
[Geyser-Spigot] Done (1.2s)! Run /geyser help for help!

Шаг 3. Настроить config.yml

Файл plugins/Geyser-Spigot/config.yml. Ключевые секции:

bedrock:
  address: 0.0.0.0
  port: 19132
  clone-remote-port: false
  motd1: "Pterohost Server"
  motd2: "Survival 1.21"
  server-name: "Pterohost"

remote:
  address: 127.0.0.1
  port: 25565
  auth-type: floodgate    # online | offline | floodgate

floodgate-key-file: key.pem
allow-third-party-capes: true
allow-third-party-ears: false
show-cooldown: title
show-coordinates: true
disable-bedrock-scaffolding: false
emote-offhand-workaround: "disabled"

config-version: 4

Главные параметры:

• bedrock.port: 19132 - UDP-порт, который слушает Geyser. Должен быть открыт.
• remote.address: 127.0.0.1 - адрес Java-сервера. Локальный, если Geyser - плагин.
• auth-type: floodgate - режим аутентификации (см. ниже).

Шаг 4. Открыть порт UDP 19132

В файрволе:

sudo ufw allow 19132/udp

Или через iptables:

sudo iptables -A INPUT -p udp --dport 19132 -j ACCEPT

Без UDP-открытия Bedrock-клиенты не подключатся.

Шаг 5. Перезапуск

/restart или перезагрузка сервера. Geyser готов.

Floodgate: подключение Bedrock к online-mode серверу

Floodgate - это плагин-компаньон Geyser, который позволяет Bedrock-игрокам зайти на сервер с online-mode=true без Java-аккаунта.

Зачем нужен Floodgate:

• Bedrock-игрок не имеет Mojang/Microsoft Java-аккаунта.
• На online-mode сервере без Floodgate Bedrock-игрок не пройдёт аутентификацию.
• Floodgate создаёт виртуальный UUID для Bedrock-аккаунта по его Xbox Live ID.
• Префикс ника (по умолчанию .) отделяет Bedrock-игроков от Java.

Установка Floodgate

1. Скачать Floodgate-Spigot.jar с geysermc.org/download.
2. Положить в plugins/.
3. Перезапустить сервер - сгенерируется key.pem в plugins/floodgate/.
4. В Geyser-Spigot/config.yml указать auth-type: floodgate.

Floodgate config.yml

key-file-name: key.pem
username-prefix: "."
replace-spaces: true
default-locale: ru_RU
disable-version-check: false
metrics:
  enabled: true
  uuid: <auto>
config-version: 3

username-prefix: "." - префикс к нику Bedrock-игроков (например .Pixel). Можно поставить пустую строку, но тогда возможны коллизии с Java-никами.

replace-spaces: true - пробелы в Bedrock-никах заменяются на _ (Java не разрешает пробелы в нике).

Совместимость плагинов с Geyser

Большинство плагинов работают с Bedrock-игроками прозрачно: EssentialsX, LuckPerms, WorldEdit, WorldGuard, AuthMe. Но есть нюансы:

• PlaceholderAPI - работает, плейсхолдеры показываются в чате/scoreboard.
• Кастомные предметы (ItemsAdder, Oraxen) - нужен Hydraulic (Geyser-плагин) или ResourcePack Converter, чтобы предметы выглядели правильно у Bedrock.
• Скрипты с GUI на Anvil/Beacon - частично работают, Bedrock-инвентари упрощённые.
• Scoreboard - работает, но Bedrock показывает максимум 15 строк (Java - 16).
• Boss bar - работает.
• Title/Subtitle/Actionbar - работает.
• Команды с TabComplete - работает, но Bedrock не показывает советы автодополнения.
• Анти-чит (AAC, Matrix, Vulcan) - много false-positive на Bedrock-игроках из-за разницы в движении и хитбоксах. Нужно либо исключение для Bedrock-UUID, либо специальная конфигурация.
• AuthMe / nLogin - Bedrock не должен проходить login (он уже аутентифицирован Xbox). Настройте исключения.

Скины и плащи

Скины Bedrock-игроков по умолчанию подтягиваются через FloodgateAPI и видны Java-игрокам. Если скины не отображаются:

• Включить allow-third-party-capes: true в config.yml.
• Поставить SkinsRestorer как fallback.
• Проверить, что Bedrock-аккаунт имеет публичный скин в Xbox-профиле.

Кастомные предметы и ResourcePack

Bedrock не поддерживает Java resourcepack напрямую. Решения:

1. Hydraulic - официальный Geyser-плагин, конвертирует кастомные предметы ItemsAdder/Oraxen в Bedrock-ресурспак на лету.
2. ResourcePack Converter (RPC) от Camotoy - ручная конвертация Java zip-пака в Bedrock mcpack.
3. Geyser-плагин для ItemsAdder - официальный модуль ItemsAdder.

Без конвертации кастомные блоки/предметы у Bedrock выглядят как stick/dirt.

Geyser-Standalone для Forge

Forge не поддерживает Bukkit-плагины, поэтому Geyser-Spigot туда не поставить. Используйте Geyser-Standalone:

1. Скачать Geyser-Standalone.jar.
2. Положить в отдельную папку (не в Forge).
3. Запустить: java -Xms256M -Xmx512M -jar Geyser-Standalone.jar.
4. В сгенерированном config.yml:

bedrock:
  port: 19132
remote:
  address: 127.0.0.1
  port: 25565        # Forge-сервер
  auth-type: offline # или online, если Forge не требует premium

5. Открыть UDP 19132, оставить Forge на 25565.
6. Запускать Geyser-Standalone в screen/tmux или systemd-unit рядом с Forge.

Floodgate-Standalone тоже есть, ставится аналогично.

Geyser в сети с Velocity

Если у вас сеть на Velocity, ставьте Geyser-Velocity в plugins/ Velocity, не на каждый бэкенд.

Конфиг:

remote:
  address: 127.0.0.1
  port: 25577        # порт самого Velocity
  auth-type: floodgate

Floodgate тоже ставится на Velocity. Бэкенд-серверы получают Floodgate-Spigot для расшифровки данных Bedrock-игроков.

Версии Minecraft и поддержка

Geyser обновляется быстро. На май 2026:

• Geyser 2.6+ поддерживает Bedrock 1.21.x и Java 1.20.4 - 1.21.5.
• Старые Bedrock-версии (1.20-) отваливаются через 1-2 месяца после релиза новой.
• Если Bedrock-игрок видит “outdated client/server” - обновите Geyser или клиент.

ViaVersion на Java-сервере помогает: можно держать Java 1.21.5 и принимать Java-клиентов с 1.13+. С Bedrock-стороны ViaVersion-Bedrock тоже существует.

Производительность

Бенчмарк (Paper 1.21, 16 GB RAM, AMD EPYC):

Накладные расходы Geyser - около 10% CPU на 50 Bedrock-игроков. RAM - +100-200 MB. На современном железе это незаметно.

Pterohost - игровой хостинг с DDoS-защитой L4+L7, NVMe SSD и 24/7 поддержкой. Промокод 4START даёт -20% на первый заказ. Заказать Minecraft хостинг

Решение типичных проблем

“Unable to connect to world” на Bedrock-клиенте. Закрыт UDP-порт 19132 или Geyser не запустился. Проверьте /geyser status в консоли Java-сервера и файрвол.

“Could not connect: Outdated client” Bedrock-версия игрока новее, чем поддерживает Geyser. Обновите Geyser.

“Could not connect: Outdated server” Bedrock-версия старее, чем минимум Geyser. Игрок должен обновить Minecraft Bedrock.

Игрок заходит, но видит “Authentication failed” auth-type: floodgate указан, но Floodgate не установлен или не сгенерирован key.pem. Проверьте plugins/floodgate/key.pem.

Имя игрока с префиксом . ломает плагины Уберите префикс в Floodgate/config.yml: username-prefix: "" (или поменяйте на пустую строку с поправкой на коллизии).

Чанки прогружаются медленно у Bedrock Bedrock использует другой алгоритм рендеринга чанков. Увеличьте view-distance в server.properties или используйте плагины типа PacketLimiter.

Кастомные блоки выглядят как dirt Не настроен Hydraulic или ResourcePack Converter. Конвертируйте java-resourcepack в bedrock-pack.

Чек-лист подключения Bedrock к Java-серверу

1. Paper 1.20+ на бэкенде.
2. Скачать Geyser-Spigot.jar и Floodgate-Spigot.jar.
3. Положить оба в plugins/, перезапустить.
4. Открыть UDP 19132 в файрволе.
5. Geyser/config.yml: auth-type: floodgate.
6. Floodgate/config.yml: проверить key.pem, оставить префикс . или убрать.
7. Для кастомных предметов - Hydraulic.
8. Зайти с телефона/консоли через “Add Server” в Bedrock-клиенте, IP сервера, порт 19132.
9. Проверить плагины на false-positive (AuthMe, анти-чит).
10. Опционально - SkinsRestorer для надёжных скинов.

Geyser в 2026 - стабильное и зрелое решение, объединяющее обе аудитории Minecraft на одном Java-сервере. Если ваш проект уже работает на Java, добавление Geyser - вопрос 15 минут.