Пусни Bedrock играчи на Java сървъра си: настройка на Geyser + Floodgate (Paper, Velocity)

Какво правят Geyser и Floodgate

Geyser превежда между двете версии. Към сървъра ти се държи като Java клиент, така че редстоунът, фермите и плъгините работят точно както за Java играчите. Floodgate позволява на Bedrock играчите да влизат с Xbox акаунта си вместо с Java акаунт.

Преди да започнеш: Java и версии

• Geyser изисква Java 21 или по-нова на машината, на която работи.
• Сървърът ти трябва да приема най-новата Java версия, защото Geyser имитира такъв клиент. По-старите сървъри се нуждаят от ViaVersion.
• Geyser-Spigot работи на Paper и Spigot от 1.20.5 нагоре. По-старите сървъри се нуждаят от прокси, Geyser Standalone или ViaProxy.
• Поддържат се само актуалните Bedrock версии (октомври 2026: Bedrock 26.30 до 26.52, Java 26.2). Дръж Geyser обновен, защото Bedrock се обновява сам.

Изтегли Geyser и Floodgate за своята платформа от официалната страница за изтегляне на GeyserMC.

Настройка на единичен Paper или Spigot сървър

1. Сложи Geyser-Spigot.jar и Floodgate-Spigot.jar в папката plugins.
2. Рестартирай сървъра. Geyser създава plugins/Geyser-Spigot/config.yml, а Floodgate – plugins/floodgate/ с config.yml и key.pem.
3. Отвори конфигурацията на Geyser и провери секцията bedrock. port е това, което Bedrock играчите ще въвеждат.
4. Задай типа автентикация на floodgate и рестартирай отново.

bedrock:
  address: 0.0.0.0
  port: 19132
  clone-remote-port: false

java:
  auth-type: floodgate

По-старите конфигурации на Geyser наричат втората секция remote, така че настройката е remote.auth-type. Актуалните билдове сами превключват на Floodgate, когато той работи на същия сървър; задаването ѝ не вреди.

На единичен сървър не копирай key.pem никъде. Geyser го чете от Floodgate, а забравено копие в папката на Geyser причинява грешки при вход.

Отвори Bedrock порта за UDP

Java използва TCP, Bedrock използва UDP. Повечето счупени настройки се провалят точно тук.

• Хостинг панел: добави допълнителен порт (много хостове го наричат allocation) и го въведи като bedrock.port. Някои хостове изискват Bedrock да ползва същия порт като Java или сменят Java порта при всяко стартиране; там clone-remote-port: true кара Geyser да използва Java порта. Страницата за настройка на Geyser има инструкции за много хостове.
• Pterodactyl: разпредели порта към сървъра в раздела Network.
• Собствена машина или VPS: отвори порта за UDP в защитната стена и, у дома, в рутера. OVH и Oracle Cloud блокират UDP и в собствената си защитна стена.

sudo ufw allow 19132/udp
sudo ufw reload

Плъгини за гласов чат или query не могат да делят порта с Geyser. Щом портът е отворен, изпълни geyser connectiontest <ip> <port> в конзолата; командата проверява порта и предлага решения.

Настройка в мрежа с Velocity или BungeeCord

В мрежа Bedrock играчите се свързват с проксито точно като Java играчите. Затова Geyser работи само на проксито.

1. Инсталирай Geyser и Floodgate за проксито си (Velocity или BungeeCord) и рестартирай проксито.
2. Задай bedrock.port и типа автентикация floodgate в конфигурацията на Geyser на проксито и отвори порта за UDP, както е описано по-горе.
3. Инсталирай Floodgate-Spigot на всеки бекенд. Той е нужен за плъгини, които ползват Floodgate API, и подобрява скиновете.
4. Настрой препращането: при BungeeCord задай ip_forward: true в неговия config.yml и bungeecord: true в spigot.yml на всеки бекенд; при Velocity настрой препращането на информация за играчите, както е описано в документацията на Velocity.
5. В конфигурацията на Floodgate на проксито задай send-floodgate-data: true.
6. Копирай key.pem от папката на Floodgate на проксито в папката на Floodgate на всеки бекенд сървър, след това рестартирай бекендите и проксито.

send-floodgate-data: true

Пази key.pem в тайна: той пуска акаунти покрай Java автентикацията. Качвай го по FTP в двоичен режим, иначе ще получиш грешки Tag mismatch.

Bedrock имена: префиксът с точка

Floodgate слага префикс пред всяко Bedrock име, за да не може то никога да съвпадне с Java име. По подразбиране това е точка, така че Xbox gamertag-ът Steve става .Steve на сървъра ти. Интервалите в gamertag-овете се заменят с _.

username-prefix: "."
replace-spaces: true

• В командите използвай цялото име с префикса. Ако някоя команда не го приема, сложи името в кавички: /tp ".Steve".
• За whitelist-а използвай fwhitelist add Steve. Там префиксът не е нужен.
• Ако LuckPerms има проблеми с Bedrock имената, задай allow-invalid-usernames: true в конфигурацията му.

GeyserMC съветва префиксът да се запази. Bedrock играчите гласуват и с това име: в BestMCServerList въвеждат .Steve – името, което вижда плъгинът ти за награди за гласуване.

Свързани акаунти и скинове (по желание)

Global Linking е включено по подразбиране във Floodgate. Играчите, които имат и двете версии, влизат в link.geysermc.org с двата акаунта и пишат /linkaccount. След това играят с Java инвентара и позицията си от всяко устройство, затова първо трябва да преместят Bedrock предметите си. Локална база данни за свързване изисква допълнително разширение за Floodgate.

Floodgate конвертира и качва Bedrock скиновете, за да ги виждат Java играчите. Това минава през опашка и може да отнеме известно време.

Чести грешки и решения

Някои неща не могат да се преведат: левият и десният клик в инвентарите изглеждат еднакво, командите без Brigadier нямат tab completion, линковете в чата не са кликаеми. Тествай менютата с истинско Bedrock устройство. Плъгините могат да показват нативни Bedrock форми чрез Floodgate API, което изисква Floodgate на техния сървър.

Покажи двата адреса в BestMCServerList

Bedrock играчите се свързват с адреса ти плюс Bedrock порта, например play.example.net и 19132. BestMCServerList показва Java и Bedrock адреса отделно на всяка страница на сървър, всеки с бутон за копиране.

1. Отвори Добави своя сървър и въведи Java адреса си.
2. Отметни Поддържа Bedrock играчи.
3. Въведи Bedrock порта от bedrock.port. Остави Bedrock IP празно, ако е същото като Java адреса.

Crossplay е истинско предимство за нов сървър. Виж как да намериш играчи за нов сървър за останалата част от плана.