Описание Geyser

• проект GeyserMC для связи Minecraft: Bedrock Edition с серверами Minecraft: Java Edition. Он работает как мост или proxy: принимает подключение Bedrock-клиента, переводит сетевые пакеты между двумя редакциями и передает игрока на Java-сервер. Цель проекта сформулирована осторожно: сделать вход игроков Bedrock на Java-серверы максимально бесшовным, насколько это возможно при различиях двух игр. Это не клиентский мод для Bedrock и не способ превратить Java-сервер в полноценный Bedrock-сервер. Geyser находится на серверной стороне или запускается отдельно рядом с сервером. В зависимости от инфраструктуры он ставится как плагин для Paper/Spigot, BungeeCord или Velocity, как мод для Fabric/NeoForge, либо как Geyser Standalone. На Modrinth ресурс опубликован как серверный, клиентская сторона отмечена как unsupported, серверная как required. > Важное ограничение: Geyser переводит протоколы двух разных игр, поэтому не все механики Java Edition могут отображаться или вести себя на Bedrock точно так же. Официальная документация поддерживает отдельную страницу с текущими ограничениями, и ее стоит читать перед запуском публичного сервера.

Что делает ресурс Geyser позволяет игрокам Bedrock подключаться к Java-инфраструктуре без установки Java Edition на их устройстве. На практике Bedrock-игрок вводит адрес и порт, которые слушает Geyser, а Geyser уже общается с Java-сервером. Если нужна авторизация Bedrock-игроков без платного Java-аккаунта, документация рекомендует рассматривать Floodgate; сам Geyser при этом остается слоем трансляции протокола. Ресурс решает несколько типичных задач администрирования:

• открывает Java-сервер для игроков с телефонов, консолей и Windows Bedrock;
• дает единый мир для Java- и Bedrock-аудитории при сохранении Java-серверной базы;
• поддерживает разные варианты установки под плагины, моды и отдельный proxy;
• позволяет проверить доступность подключения командой connection test;
• документирует несовместимости, чтобы администратор заранее понимал риски;
• развивается как open collaboration проект с открытым исходным кодом на GitHub. Важная деталь для модовых серверов: официальная setup-страница предупреждает, что Geyser работает только с серверными модами. Моды, которые требуют клиентскую установку на Java-клиенте, не станут автоматически доступны Bedrock-игроку. Это не недостаток конкретной сборки, а следствие различий между клиентами и протоколами. | Сценарий установки | Где запускается Geyser | Когда подходит | |---|---|---| | Paper/Spigot plugin | в папке plugins Java-сервера | обычный сервер на Bukkit-платформе | | BungeeCord/Velocity | на proxy-слое сети | сеть серверов с общим входом | | Fabric/NeoForge mod | в папке mods серверной сборки | сервер на поддерживаемом модлоадере | | Standalone | отдельной Java-программой рядом с сервером | когда нельзя ставить плагин или нужен внешний proxy | | Floodgate рядом с Geyser | отдельный компонент авторизации | когда Bedrock-игроки должны входить без Java-аккаунта |

Особенности Сильная сторона Geyser

• гибкость размещения. Администратор может выбрать вариант, который соответствует серверной архитектуре: поставить jar в plugins на Paper, добавить мод в серверную сборку, вынести Geyser на proxy или запустить standalone-процесс. Официальная документация отдельно подчеркивает, что standalone
• не плагин и не мод, а отдельная Java-программа. Вторая особенность
• прозрачная работа с ограничениями. Документация не обещает идеального совпадения Java и Bedrock. На странице current limitations перечислены вещи, которые нельзя исправить без изменений в Bedrock или Java-протоколе: например часть поведения чата, отдельные визуальные эффекты, некоторые различия инвентарей, лимиты баннеров, нестандартные рецепты наковальни или кузнечного стола и другие случаи. Часть визуальных расхождений закрывается встроенным GeyserIntegratedPack, а отдельные проблемы движения вокруг bamboo можно обходить через Hurricane, но это уже дополнительные серверные изменения. Третья особенность
• сетевые требования. Bedrock использует UDP, поэтому порт Geyser должен быть открыт именно для UDP-трафика. Документация указывает стандартный порт 19132 и рекомендует проверять подключение командой geyser connectiontest. Это особенно важно на домашних серверах, VPS с firewall и хостингах, где разные сервисы не могут делить один UDP-порт. Короткий список практических выводов:
• Geyser ставится на серверную сторону, Bedrock-игроку не нужен отдельный мод;
• для публичного доступа требуется корректный UDP-порт, часто 19132;
• для входа Bedrock без Java-аккаунта обычно нужен Floodgate;
• plugin-версии предпочтительны там, где доступны оптимизации платформы;
• модовые серверы должны учитывать, что клиентские Java-моды через Geyser не передаются;
• перед релизом сервера стоит проверить ограничения конкретных механик и мини-игр.

Совместимость и установка В исходных данных Modrinth для Geyser указаны загрузчики BungeeCord, Fabric, NeoForge, Paper, Spigot и Velocity, а также широкий набор версий Minecraft. Официальная страница setup на момент проверки требует Java 21 или выше для запуска Geyser и отдельно отмечает, что для серверов старее актуальной целевой версии может понадобиться ViaVersion. Поскольку поддерживаемые версии Minecraft быстро меняются, перед обновлением лучше сверяться с официальной страницей supported versions и свежей сборкой на сайте GeyserMC. Базовый принцип установки одинаковый: скачать подходящий build, положить его в нужную папку или запустить standalone, затем открыть конфиг и настроить секции bedrock и remote/java. Для плагина путь обычно находится внутри plugins, для Fabric и NeoForge

• в config соответствующего варианта Geyser, для standalone
• в config.yml рядом с jar. ```yaml

Пример фрагмента config.yml для Geyser Standalone или похожей установки.

Значения нужно адаптировать под свой сервер и firewall. bedrock: address: 0.0.0.0 port: 19132 java: address: 127.0.0.1 port: 25565 auth-type: online

Проверка из консоли Geyser:

geyser connectiontest example.org 19132 ``` После настройки проверьте подключение из локальной сети и с внешней сети. Если игроки Bedrock видят сервер локально, но не могут зайти извне, проблема часто находится не в Geyser, а в пробросе UDP-порта, firewall или панели хостинга. Если сервер использует Floodgate, auth-type и установка ключей должны соответствовать официальной инструкции Floodgate, иначе вход Bedrock-аккаунтов будет работать некорректно.

Вопросы и ответы

Geyser делает Java-сервер полностью Bedrock-совместимым? Нет. Он переводит протоколы и закрывает большую часть обычного игрового взаимодействия, но официальная документация прямо говорит о неизбежных ограничениях между двумя редакциями. Для ванильного выживания результат обычно проще, чем для серверов с нестандартными механиками.

Нужно ли игроку Bedrock устанавливать мод? Нет. Игрок Bedrock подключается к адресу и порту Geyser как к серверу Bedrock. Вся основная работа происходит на стороне сервера или standalone-процесса.

Можно ли использовать Geyser на модовом сервере? Можно, если речь о серверных модах и поддерживаемой платформе, но клиентские Java-моды не появятся у Bedrock-игрока. Если геймплей зависит от Java-клиентского мода, ресурспака с нестандартной логикой или GUI, совместимость нужно проверять отдельно.

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

Какой порт открывать? В стандартной конфигурации Bedrock-порт Geyser

• 19132, и он работает по UDP. Если вы меняете порт, игрокам нужно сообщить новый порт, а firewall и роутер должны пропускать UDP-трафик.

Почему часть функций Java не работает у Bedrock-игроков? Причина в различиях клиентов и протоколов. Некоторые вещи не передаются в Bedrock в нужном виде или отсутствуют в самой Bedrock Edition. Официальная страница current limitations перечисляет такие случаи и отдельно отмечает, что часть из них не исправляется на стороне Geyser.