Руководство по установке и настройке Geyser и Floodgate, чтобы игроки Minecraft: Bedrock Edition могли подключаться к вашему серверу Java Edition. Это руководство охватывает Spigot/Paper, Fabric, NeoForge, BungeeCord, Velocity, ViaProxy и standalone-сборку.
Geyser — это мост, который переводит данные между двумя редакциями Minecraft. Он заставляет ваш сервер Java Edition выглядеть для клиента Bedrock так, будто это сервер Bedrock, а значит игроки на телефонах, планшетах, консолях и в редакции для Windows 10/11 могут подключиться к серверу, который иначе они бы даже не увидели. Floodgate — его напарник, и именно он позволяет этим игрокам Bedrock заходить без наличия аккаунта Java Edition.
Requirements
- Сервер Minecraft: Java Edition, файлы которого вы контролируете. Хостинг, не позволяющий загружать jar-файлы, не сможет запустить Geyser.
- Java 21 или новее — это в любом случае требование современного серверного ПО Minecraft.
- UDP-порт, который можно открыть и пробросить. Bedrock Edition использует UDP, а не TCP, и это самая частая ошибка, которую здесь допускают.
- Если вы на общем (shared) хостинге, проверьте, разрешают ли они использовать второй порт. Некоторые дают только один.
How Geyser and Floodgate Work Together
Хочу вкратце объяснить, как эти два плагина работают вместе, потому что установка одного без другого может привести к тому, что игроки Bedrock не смогут нормально подключиться (например, им всё равно потребуется привязать аккаунт Java).
Geyser выполняет перевод Java <-> Bedrock. Он слушает UDP-порт, принимает подключения Bedrock и общается с вашим сервером по протоколу Java Edition. Сам по себе Geyser позволит игроку Bedrock подключиться, но этому игроку всё ещё придётся авторизоваться как владельцу аккаунта Java Edition, которого у большинства игроков Bedrock нет.
Floodgate снимает это требование. Он сообщает серверу Java, что нужно принять игрока, одобренного Geyser, без необходимости в аккаунте Java. Именно поэтому оба плагина почти всегда устанавливаются вместе, и именно поэтому Floodgate поставляется с файлом key.pem, который вас довольно настойчиво просят никому не передавать. Именно этот ключ позволяет аккаунту пропустить авторизацию Java.
Geyser устанавливается один раз, в том месте, к которому будут подключаться ваши игроки Bedrock. Floodgate устанавливается на сервере, который владеет списком игроков. На одиночном сервере это одна и та же машина. В сети с прокси и Geyser, и Floodgate ставятся на прокси.
Downloading
Всё берётся с официальной страницы загрузок. Скачивать откуда-либо ещё мы не рекомендуем.
На момент написания этой статьи актуальные сборки — это Geyser build #1234 (2 сентября 2026) и Floodgate build #140 (9 августа 2026). Оба проекта публикуются непрерывно, так что номера сборок, которые увидите вы, будут выше. Это нормально и ожидаемо.
Which File Do I Need?
Geyser публикует сборку для каждой платформы. Floodgate — нет, и на этом многие попадаются:
| Platform | Geyser | Floodgate |
|---|---|---|
| Spigot / Paper | Geyser-Spigot.jar |
floodgate-spigot.jar |
| Fabric | Geyser-Fabric.jar |
floodgate-fabric.jar |
| NeoForge | Geyser-NeoForge.jar |
floodgate-neoforge.jar |
| BungeeCord | Geyser-BungeeCord.jar |
floodgate-bungee.jar |
| Velocity | Geyser-Velocity.jar |
floodgate-velocity.jar |
| ViaProxy | Geyser-ViaProxy.jar |
Недоступно |
| Standalone | Geyser-Standalone.jar |
Недоступно |
Сборки Floodgate для ViaProxy или для standalone-версии Geyser не существует. Floodgate обязан работать внутри сервера Java, владеющего списком игроков, а в этих двух конфигурациях Geyser работает извне. Вам нужно установить jar Floodgate под нужную платформу на тот сервер Java, на который указывает Geyser, а затем скопировать key.pem этого сервера в Geyser. Об этом подробнее рассказано ниже.
Direct Download Links
Эти URL всегда указывают на самую свежую сборку, так что их можно спокойно добавлять в закладки или использовать в скриптах!
- Spigot
- Fabric
- NeoForge
- BungeeCord
- Velocity
- ViaProxy
- Standalone
- Floodgate Spigot
- Floodgate Bungee
- Floodgate Velocity
На Linux-сервере можно скачать файл напрямую:
wget -O plugins/Geyser-Spigot.jar \
https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot
Installing Geyser
Выберите один раздел, соответствующий вашей конфигурации сервера. Следовать нужно только инструкциям для этой конфигурации.
Spigot & Paper
- Скачайте
Geyser-Spigot.jar. - Поместите его в папку
plugins/вашего сервера. - Перезапустите сервер. Не используйте
/reload— перезагрузка плагинов на лету создаёт больше проблем, чем решает. - Geyser сгенерирует конфиг по пути
plugins/Geyser-Spigot/config.yml.
Fabric
- Скачайте
Geyser-Fabric.jar. - Поместите его в папку
mods/вашего сервера. - Fabric-серверам также нужен мод Fabric API в той же папке.
- Перезапустите сервер. Конфиг появится в
config/Geyser-Fabric/config.yml.
NeoForge
- Скачайте
Geyser-NeoForge.jar. - Поместите его в папку
mods/вашего сервера. - Перезапустите сервер. Конфиг появится в
config/Geyser-NeoForge/config.yml.
BungeeCord
Установите Geyser на прокси, а не на бэкенд-серверы. Именно к прокси будут подключаться Bedrock-игроки.
- Скачайте
Geyser-BungeeCord.jar. - Поместите его в папку
plugins/прокси. - Перезапустите прокси. Конфиг появится в
plugins/Geyser-BungeeCord/config.yml.
Velocity
Та же идея, что и с BungeeCord. Geyser устанавливается на прокси.
- Скачайте
Geyser-Velocity.jar. - Поместите его в папку
plugins/прокси. - Перезапустите прокси. Конфиг появится в
plugins/Geyser-Velocity/config.yml.
ViaProxy
ViaProxy — это самостоятельный прокси, позволяющий клиентам одной версии Minecraft подключаться к серверу другой версии. Geyser подключается к нему как аддон.
- Скачайте
Geyser-ViaProxy.jar. - Поместите его в папку
plugins/ViaProxy. - Запустите ViaProxy один раз, чтобы Geyser сгенерировал конфиг, затем остановите его.
- Поскольку в этом случае Geyser работает вне вашего Java-сервера, нужно указать ему, где этот сервер находится. См. Раздел Remote.
Standalone
Standalone — это Geyser, работающий как самостоятельная программа, отдельно, указывающая на Java-сервер по сети. Это правильный выбор, когда вы не можете установить плагины или моды на сам сервер, и неправильный почти во всех остальных случаях, поскольку он добавляет лишний сетевой переход и не может использовать Floodgate без дополнительной настройки.
- Скачайте
Geyser-Standalone.jar. - Поместите его в отдельную папку.
- Запустите его:
java -Xmx1G -jar Geyser-Standalone.jar
- Он сгенерирует
config.ymlрядом с собой, а затем завершится или будет ждать. Остановите его, отредактируйте конфиг и запустите снова.
Настройка Geyser
Откройте config.yml для вашей платформы. Два важных раздела — это bedrock и, для standalone и ViaProxy, remote.
Раздел Bedrock
Это то, к чему подключаются Bedrock-игроки:
bedrock:
# The IP address that will listen for connections.
# Generally, you should only change this if you want to limit what IPs can connect to your server.
address: 0.0.0.0
# The port that will Geyser will listen on for incoming Bedrock connections.
# Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic.
port: 19132
# Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock.
# This option makes the Bedrock port the same as the Java port every time you start the server.
clone-remote-port: false
Порт — это то, что действительно важно. 19132 — стандартный порт Bedrock Edition, и если оставить его таким, игроки смогут добавить ваш сервер только по адресу, без указания порта. Меняйте его только если 19132 уже занят или хост назначил вам что-то другое.
clone-remote-port предназначен для хостов, которые выдают новый порт при каждом перезапуске и ожидают Bedrock-трафик на том же порту. Если включить эту опцию, она перезапишет значение port выше, так что если задать оба значения и удивляться, почему порт игнорируется — вот в чём причина.
address: 0.0.0.0 означает «слушать на всех сетевых интерфейсах», что и требуется, если только вы намеренно не ограничиваете доступ.
Раздел Remote (только для Standalone и ViaProxy)
Когда Geyser работает как плагин или мод, он уже знает, где находится сервер, потому что находится внутри него. Когда он работает как standalone или под ViaProxy, вам нужно настроить раздел remote, указав на ваш Java-сервер.
remote:
address: 127.0.0.1
port: 25565
auth-type: floodgate
Используйте 127.0.0.1 (localhost), если Java-сервер находится на той же машине. Используйте его реальный адрес, если это не так, и учтите, что вы только что создали незашифрованное Minecraft-соединение по сети между двумя машинами.
Установка Floodgate
Floodgate следует установить на тот Minecraft Java Server, который владеет списком игроков.
Spigot & Paper
- Скачайте
floodgate-spigot.jarсо страницы загрузок. - Поместите его в папку
plugins/. - Перезапустите сервер.
Fabric & NeoForge
- Скачайте мод со страницы Modrinth или со страницы загрузок.
- Поместите файл в папку
mods/. Fabric-серверам также требуется установленный Fabric API. - Перезапустите сервер.
Если Fabric-сервер находится за прокси Velocity, вам также нужно настроить FabricProxyLite, чтобы Fabric-сервер принимал переданные данные игроков от Velocity.
BungeeCord & Velocity
Установите Floodgate только на прокси. На бэкенд-серверах он не нужен, если только вы специально не хотите использовать Floodgate API там или чтобы Bedrock-скины корректно отображались на бэкенде.
- Скачайте
floodgate-bungee.jarилиfloodgate-velocity.jar. - Поместите файл в папку
plugins/прокси. - Перезапустите прокси.
Установка auth-type в floodgate
Это тот шаг, который действительно впускает Bedrock-игроков, и многие случайно его пропускают (включая меня самого, когда я впервые устанавливал Geyser и Floodgate много лет назад, лол).
Откройте конфигурационный файл Geyser (не Floodgate), найдите ключ auth-type и установите его в floodgate:
auth-type: floodgate
Он принимает три значения:
floodgate— Bedrock-игроки заходят без учётной записи Java Edition. Это то, что вам нужно, и для этого требуется установленный Floodgate.online— каждый игрок должен владеть и авторизовать учётную запись Java Edition. Это значение по умолчанию.offline— аутентификация полностью отсутствует. Не рекомендуется на публичных серверах.
Перезапустите сервер после применения любых изменений. Geyser считывает эту настройку при запуске сервера.
Запуск Floodgate за прокси
Если у вас есть прокси с бэкенд-серверами за ним, и вы хотите, чтобы Floodgate API был доступен на этих бэкендах, нужно сделать немного больше. Полностью пропустите этот раздел, если у вас всего один сервер.
- Сначала установите Floodgate на прокси, как описано выше.
- Установите Floodgate также на каждый бэкенд-сервер, используя
floodgate-spigot.jarилиfloodgate-fabric.jar. - Включите пересылку информации об игроках:
- BungeeCord: установите
ip_forwardвtrueвconfig.ymlпрокси, и установитеbungeecordвtrueвspigot.ymlкаждого бэкенда. - Velocity: настройте пересылку информации об игроках. У Velocity есть несколько режимов, и каждый требует своей настройки на бэкенде, так что следуйте их руководству, а не догадкам.
- BungeeCord: установите
- Запустите прокси, чтобы Floodgate сгенерировал свои файлы.
- В конфиге Floodgate на прокси установите
send-floodgate-dataвtrue. - Скопируйте файл
key.pemиз папки конфига Floodgate на прокси в папку конфига Floodgate на каждом бэкенд-сервере. - Перезапустите бэкенды и прокси.
ПРЕДУПРЕЖДЕНИЕ: Как уже говорилось, не передавайте key.pem никому и не вставляйте его в канал поддержки, когда просите о помощи. Этот файл позволяет аккаунтам Bedrock обходить аутентификацию Java Edition. Любой, у кого есть его копия, сможет зайти на ваш сервер практически под кем угодно, если у него есть на то возможности.
Та же самая копия key.pem используется, если вы хотите использовать Floodgate вместе со standalone-версией Geyser или с ViaProxy. Установите платформенный jar-файл Floodgate на Java-сервер, а затем скопируйте файл key.pem этого сервера в собственную папку конфига Geyser.
Открытие порта
Bedrock Edition использует UDP. Если вы откроете только TCP, сервер не будет отображаться в списке серверов для клиентов Bedrock.
На Linux-сервере обычно это можно сделать с помощью установленного файрвола.
# IPTables (underlying firewall used by ufw on many Linux distributions)
iptables -A INPUT -p udp --dport 19132 -j ACCEPT
# UFW (Uncomplicated Firewall)
sudo ufw allow 19132/udp
# Firewalld (used by many Linux distributions)
sudo firewall-cmd --permanent --add-port=19132/udp
sudo firewall-cmd --reload
Если вы хостите сервер дома, вам, скорее всего, понадобится пробросить UDP порт 19132 на роутере на машину, где работает Geyser. Если вы используете хостинг-провайдера, это обычно делается через выделение порта в панели управления, а не через правило файрвола, и вам может понадобиться открыть тикет, чтобы получить второй порт.
Подключение с Bedrock
В клиенте Bedrock перейдите в Play, затем на вкладку Servers, прокрутите вниз и выберите Add Server.
- Server Name: любое, какое захотите.
- Server Address: IP-адрес или хост вашего сервера.
- Port:
19132, либо то, что вы указали в конфиге.
ПРИМЕЧАНИЕ: С консольными игроками всё работает немного иначе. PlayStation, Xbox и Nintendo Switch не позволяют напрямую добавлять адрес сервера, и обычным обходным путём является DNS-трюк, перенаправляющий один из рекомендуемых серверов на ваш. Это выходит за рамки данного руководства, но стоит изучить при необходимости.
Примечания
Вот несколько полезных заметок.
Старым версиям Minecraft нужен ViaVersion
Geyser ориентирован на актуальную версию Minecraft. Если ваш Java-сервер работает на версии старше 26.2 (или последней версии Minecraft), вам также понадобится ViaVersion, чтобы старые сетевые протоколы могли быть поняты. Рекомендуем свериться со страницей поддерживаемых версий самого Geyser.
Связывание аккаунтов Java и Bedrock
По умолчанию игрок Bedrock, заходящий через Floodgate, получает отдельный аккаунт на вашем сервере с префиксом перед именем (по умолчанию — точка). Если вы хотите, чтобы игрок мог использовать один и тот же инвентарь, права и время игры вне зависимости от того, заходит он с Java или с Bedrock, это называется связыванием аккаунтов.
Есть два способа это сделать. Глобальное связывание, которое использует link.geysermc.org и не требует настройки с вашей стороны. Локальное связывание хранит связи в вашей собственной базе данных и требует одного из расширений базы данных Floodgate, опубликованных на той же странице загрузки:
floodgate-sqlite-database.jar: самый простой (локальный) вариант, подходит для одиночного сервера.floodgate-mysql-database.jar: для баз данных MySQL.floodgate-mongo-database.jar: для баз данных MongoDB.
Большинство владельцев серверов выбирают глобальное связывание, так как оно не требует дополнительной настройки. Обязательно предупредите своих игроков, что им нужно связать аккаунты на link.geysermc.org!
Игроки Bedrock и Java-моды
Geyser переводит ванильный сетевой протокол, который использует Minecraft. Он не переводит пользовательские блоки и предметы, добавленные модами, которые могут выглядеть неправильно или быть невидимыми для игрока с Bedrock. Hydraulic — это собственный проект GeyserMC для решения этой проблемы, преобразующий ассеты модов в ресурс-пак для Bedrock. Настоятельно рекомендуем ознакомиться с ним, если вы планируете запускать моды на своём сервере.
Вещи, которые не могут делить порт
Любая другая служба на вашем сервере, желающая использовать UDP на том же порте, будет конфликтовать с Geyser. Обычно это плагины голосового чата (в частности, Simple Voice Chat) и протокол Minecraft Query. Они должны работать на своём собственном порту.
Смотрите также
- Как установить сервер Minecraft (Java Edition)
- Сколько ОЗУ нужно для сервера Minecraft
- Вики Geyser
- Вики Floodgate
Заключение
Кроссплей — это задача из двух частей. Geyser открывает UDP-дверь, через которую могут пройти клиенты Bedrock, а Floodgate — это то, что избавляет их от необходимости регистрировать аккаунт Java Edition при входе. Установите оба компонента, установите auth-type в значение floodgate, откройте порт как UDP, а всё остальное сводится к проверке того, что каждый jar-файл помещён в папку, которую действительно читает соответствующая платформа.
Если что-то не работает, порядок проверки почти всегда один и тот же: открыт ли порт как UDP, установлен ли auth-type в значение floodgate в конфиге Geyser, а не Floodgate, и установлен ли Floodgate на сервере, который владеет списком игроков, а не на бэкенде за прокси.
Если у вас есть вопросы или вы ищете модифицирующее сообщество, к которому можно присоединиться, рассмотрите возможность вступить в наш Discord-сервер!
Наши гайды всегда открыты для правок и улучшений, поэтому если у вас есть предложения или вы заметили какие-либо проблемы, не стесняйтесь внести свой вклад, создав pull request в нашем репозитории на GitHub!
Удачного моддинга!