Установите мост для одного Paper-сервера
Откройте загрузки Geyser, выберите Geyser для Spigot и скачайте Geyser-Spigot.jar. На той же странице выберите Floodgate для Spigot, если Bedrock-игрок должен входить своим Bedrock-аккаунтом без отдельного Java-аккаунта. Остановите Paper командой stop, положите оба JAR в plugins и запустите сервер.
Проверьте поддерживаемые версии Geyser: текущему мосту может требоваться ViaVersion для более старого Paper. Скачивайте ViaVersion с сайта автора, только если он нужен вашему сочетанию выпусков. Для сети Velocity используйте отдельную инструкцию Floodgate, поскольку этот пример относится к одиночному Paper.
Измените созданный конфиг
После первого старта выполните stop. Откройте plugins/Geyser-Spigot/config.yml и измените существующие поля. В секции bedrock задайте address: 0.0.0.0, port: 19132 и clone-remote-port: false, как в инструкции Geyser для Paper. Затем найдите уже имеющуюся строку auth-type и замените её значение на floodgate по установке Floodgate. Сохраните её текущие отступы и родительскую секцию из созданного вашим выпуском файла; не добавляйте второй ключ auth-type в другое место. Сохраните YAML и запустите Paper снова.
Оставьте online-mode=true у прямого Paper-сервера: Floodgate не требует отключать проверку Java-аккаунтов. Не публикуйте файл ключа Floodgate. Запустите сервер; в журнале найдите включение Geyser/Floodgate и прослушивание выбранного Bedrock-порта.
Откройте именно UDP и выполните сетевой тест
Если Linux-хост уже использует UFW, разрешите порт командой sudo ufw allow 19132/udp. Для контейнера добавьте публикацию 19132:19132/udp в его конфигурацию. На домашнем маршрутизаторе настройте перенаправление UDP 19132 на локальный IPv4 компьютера с сервером. Это три разных границы: контейнер, ОС и маршрутизатор.
В консоли сервера выполните geyser connectiontest ВашПубличныйАдрес 19132, подставив действительный IP/домен. Команда из списка Geyser проверяет внешнюю доступность; успешная TCP-проверка порта Java для неё недостаточна. При CGNAT обычное домашнее перенаправление может не дать внешнего входа.
Подключитесь и проверьте профиль
На Bedrock для Windows/телефона выберите Играть → Серверы → Добавить сервер. Имя произвольное, адрес — домен или IP без https://, порт — 19132 в отдельном поле. На консолях интерфейс добавления произвольного адреса отличается; сначала прочитайте Using Geyser with Consoles.
- Войдите Bedrock-аккаунтом, положите обычный предмет в сундук и выйдите. После повторного входа проверьте инвентарь и тот же профиль; запишите фактический ник и UUID из административного инструмента.
- Откройте игровое меню, нажмите обычную кнопку и
Назад. Купите недорогой тестовый товар, затем повторите с недостаточным балансом: отказ должен сохранять валюту. - Завершите одну мини-игру штатным выходом и сравните вещи, деньги и права. Сервер остаётся Java: Bedrock-клиент через Geyser не меняет правила ферм и не запускает обязательные клиентские Java-моды.
Начните с одного Java-сервера
Для простой установки на Paper нужен соответствующий Geyser-Spigot, а для выбранного способа входа — Floodgate либо поддерживаемая Java-аутентификация. Сначала добейтесь стабильного подключения обычным Java-клиентом. Затем добавляйте перевод Bedrock-протокола. Иначе неизвестно, сломан исходный сервер или только мост.
Проверенная 7 октября 2026 года инструкция Geyser требует, чтобы сервер принимал Java 26.2; для более старого сервера указывает ViaVersion. Это требование текущего выпуска Geyser, а не обещание совместимости любого старого ядра со всеми будущими клиентами. Установка для модовых платформ также имеет собственные ограничения. Перед выбором файлов сверяйте официальный раздел поддерживаемых версий.
После первого запуска откройте конфигурацию и проверьте адрес и порт bedrock. Пример порта 19132 является обычным значением, но хостинг может назначить другое. Если включён clone-remote-port, значение переопределяется Java-портом по правилам настройки. Запишите фактически опубликованное число, чтобы инструкция игроку не расходилась с реальной конфигурацией.
Не путайте TCP и UDP
Контейнер должен публиковать UDP, брандмауэр пропускать UDP, а маршрутизатор направлять UDP к нужному хосту. Правило только для TCP того же номера не делает Bedrock доступным. Убедитесь, что другой сервис, например голосовой чат или Query, не использует тот же UDP-порт. Два приложения не могут независимо слушать одну одинаковую точку.
Проверяйте локальный вход, внешний маршрут и точный текст Bedrock-ошибки. Разбор сетевого отказа.
Настройте идентичность до выдачи прав
Floodgate позволяет поддерживаемый вход Bedrock-аккаунта без отдельного платного Java-аккаунта. Он не отменяет необходимость доверенной связи компонентов. Способ установки зависит от того, стоит ли Geyser на Paper или прокси; используйте именно соответствующую инструкцию. Не переносите настройки одиночного сервера на сеть с открытыми backend-портами без проверки.
У Bedrock могут быть особенности имени и UUID. Сначала проверьте, как игрок записывается в систему прав, приват и экономику. Используйте фактический устойчивый идентификатор, не угадывайте аккаунт по видимой строке ника. Если включается связывание аккаунтов, изучите его эффект на уже существующий прогресс и протестируйте копию данных.
Секретный материал доверия Floodgate нельзя раздавать клиентам и публиковать в общем репозитории. На сети каждый уровень должен доверять только предусмотренному источнику. Ошибка здесь способна влиять на идентичность входящего игрока, поэтому удобный проход тестового клиента ещё не завершает проверку схемы.
Проверьте интерфейсы именно с Bedrock
Java-инвентарь на телефоне отображается и управляется иначе. Подсказка «нажмите ПКМ» может нуждаться в объяснении соответствующего действия Bedrock, а маленькая кнопка — в проверке сенсорного ввода. Не считайте красивый скриншот GUI доказательством, что игрок способен подтвердить и отменить покупку.
- Войдите с реального совместимого Bedrock-устройства.
- Проверьте чат, команды и идентификатор аккаунта.
- Откройте меню, выполните обычный клик и кнопку возврата.
- Купите тестовый товар с достаточным и недостаточным балансом.
- Посетите отдельные миры и закончите мини-игру.
- Переподключитесь и сравните инвентарь, баланс и права.
Логика кликов и покупок должна защищаться независимо от клиентского представления. Проверка серверного GUI.
Возможности и ограничения перевода
Сервер определяет механику мира: Java-фермы на Java-сервере не превращаются в Bedrock-фермы от смены клиента. При этом доступные отображение, анимации и пользовательские ресурсы могут требовать отдельных решений. Мод с обязательной клиентской установкой Java не становится доступным телефону через Geyser.
Пользовательские предметы проверяйте отдельно: текстура, модель, взаимодействие и сохранение могут иметь разные ограничения. Официальная документация проекта описывает поддерживаемый custom content. Для сложной функции сначала создайте маленький пример и проверьте действие на обеих сторонах, затем переносите всю игровую систему.
Составьте инструкцию для игроков
Опубликуйте отдельные адреса и порты Java и Bedrock, поддерживаемые выпуски и шаги входа. Для консоли учтите особенности интерфейса произвольных серверов; не обещайте одинаковую кнопку на всех устройствах. При обновлении Geyser повторяйте проверку реальным клиентом, поскольку Bedrock-протокол обновляется независимо от вашей игровой сборки.
У администратора должны быть записаны версия Geyser, Floodgate, способ входа и результат сетевого теста. Команда geyser connectiontest с фактическим адресом и портом помогает проверить доступность по официальной инструкции. Она дополняет реальное подключение, но не проверяет все меню, права и игровую механику.
