Чтобы пустить Bedrock-игроков в работающий Java-мир, установите Geyser на точке входа и отдельно настройте авторизацию. Существующую защиту Java-входа сохраняйте; новый маршрут сначала проверьте с одним Bedrock-игроком.
Пример рассчитан на один Paper-сервер под вашим управлением, Geyser-Spigot и Floodgate-Spigot. Java-игроки уже должны подключаться, а у администратора должна быть резервная копия, сделанная после штатной остановки. Превращение сборки с обязательными клиентскими модами в игру для консолей здесь не рассматривается.
До загрузки плагинов проверьте версии#
На 20 октября 2026 года в таблице совместимости Geyser указаны Bedrock 26.30–26.52 и эмуляция Java-клиента 26.3. Запишите конкретные версии Paper, Geyser, Floodgate и клиентов. После обновления Bedrock заново сверяйте эту таблицу.
Geyser требует Java 21 или новее, но выбранному Paper может потребоваться более свежая Java. Ориентируйтесь на требования всей связки, а не только моста. Перед изменением исполняемого файла Java в службе откройте инструкцию установки Paper.
Если Java-сервер не принимает протокол клиента, который эмулирует Geyser, понадобится подходящий мост версий, например ViaVersion. Это не обещание совместимости любых модов и плагинов. Мод, который требует установки на Java-клиент каждого игрока, остаётся отдельным препятствием для Bedrock.
Установите мост на правильной точке входа#
Для нашего одиночного Paper нужны сборки плагинов Paper/Spigot. Штатно остановите сервер, сохраните нынешние плагины и конфигурацию, положите соответствующие JAR Geyser и Floodgate в plugins. Запустите сервер один раз для создания файлов и прочитайте ошибки старта до ручной настройки. Загружайте файлы с официальной страницы проекта.
Если вход уже идёт через Velocity, используйте сборку для этого прокси на точке входа. Не создавайте случайно несколько независимых публичных слушателей Geyser. Standalone — отдельный процесс со своим конфигом и адресом Java-сервера; помещение его JAR в папку плагинов Paper таким запуском не является.
Прокси-сети нужна защищённая передача данных игрока и закрытый прямой доступ к backend. Перед изменением авторизации backend изучите инструкцию безопасности Velocity. Настройка закрытого сервера за прокси не даёт основания выставлять обычный одиночный Paper в интернет с выключенной проверкой аккаунтов.
Сохраните авторизацию и защитите ключ#
Floodgate позволяет проверенным Bedrock-аккаунтам входить без отдельной Java-лицензии. Для плагинов на Paper выполните инструкцию Floodgate: в созданном конфиге Geyser задайте java.auth-type равным floodgate. В Paper оставьте online-mode=true; отключение этого параметра не исправляет несогласованную конфигурацию моста.
Не отправляйте key.pem в публичное обсуждение или репозиторий конфигураций. Для Standalone требуется совпадающий ключ Floodgate по его инструкции. Для плагинов на одном сервере не нужно подкладывать случайную копию ключа из старого руководства. Если вы не управляете целевым сервером, остановитесь: установка Geyser отдельно не даёт права устанавливать Floodgate на чужой стороне.
Перед общим приглашением проверьте фактическую идентичность первого Bedrock-игрока в журналах. Настройте список допуска и права именно для неё. Совпадение видимого имени с Java-игроком само по себе не доказывает, что будет использован его прежний инвентарь.
Настройте актуальный Bedrock-транспорт#
Измените существующие разделы plugins/Geyser-Spigot/config.yml. Фрагмент ниже не заменяет весь созданный файл:
bedrock:
port: 19132
transport: nethernet
java:
auth-type: floodgate
Для этой современной схемы NetherNet порт 19132 нужен по TCP для сигнализации и по UDP для игрового обмена. Старая инструкция, открывающая только UDP, уже неполна. Полная поддержка NetherNet начинается с Bedrock 26.50; некоторые более старые поддерживаемые клиенты получают описание и число игроков через RakNet. Для этой совместимости списка серверов выбирайте transport: both, дополнительно выделяя отдельный webrtc-port с доступом по UDP. Сверьте созданный конфиг с актуальным руководством настройки, прежде чем открывать порты.
Не занимайте Geyser-портом TCP-порт Java-сервера или другого сервиса. Для контейнеров проверьте публикацию портов, затем firewall хоста, роутера и провайдера. Выделенный в панели порт ещё не доказывает, что процесс создал нужный слушатель. Проброс на домашнем роутере не устраняет CGNAT выше него.
Для встроенной сигнализации настройте HTTPS с доменом и сертификатом по инструкции Geyser. Веб-прокси может обслуживать сигнализацию, но игровому обмену всё равно нужен собственный UDP-маршрут. Успешный HTTPS-ответ не заменяет проверку настоящего входа в игру.
Сначала проверьте игровой сеанс, затем консоль#
После обычного перезапуска выполните в серверной консоли без начального слеша:
geyser version
geyser list
Эти проверки описаны в справочнике команд. Версия и загруженный плагин полезны для диагностики, но не доказывают, что внешний игрок способен войти.
Сначала используйте Bedrock на Windows или телефоне: введите Bedrock-адрес и его порт. Для интернет-сервера проверяйте из другой сети. Загрузите ожидаемый мир, проверьте обычные права, безопасно переложите предмет, выйдите и подключитесь снова. В согласованное окно обслуживания штатно остановите и запустите сервер, затем убедитесь, что состояние игрока сохранилось.
После этого отдельно разбирайтесь с приставками. Возможность выбрать произвольный адрес на консоли — другая задача. Откройте руководство подключения консолей: установка Geyser сама не добавляет поле адреса на Xbox, PlayStation или Switch.
Выбирайте проверку по наблюдаемой ошибке#
| Что происходит | Что проверять дальше |
|---|---|
| Слушатель не запускается | Синтаксис конфига, Java и владельца порта |
| Сервер виден, вход зависает | UDP-маршрут игрового обмена и выбранный транспорт |
| Отказ авторизации | Загрузку Floodgate, auth-type и соответствующую схеме работу с ключом |
| Не входит только консоль | Обнаружение, разрешения аккаунта и ограничения платформы |
Храните прежние JAR, конфигурацию и совместимую копию мира вместе. После обновлений повторяйте вход Bedrock-игрока и проверку его личности. При откате восстанавливайте согласованный набор: старые плагины рядом с уже обновлённым миром не образуют надёжную точку возврата. Сохраните журнал неудачного запуска, чтобы следующая правка устраняла конкретную причину.
