Гравці 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. Налаштуй forwarding: на BungeeCord задай ip_forward: true у його config.yml і bungeecord: true у spigot.yml кожного бекенда; на Velocity налаштуй player information forwarding за документацією 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 Steve на твоєму сервері стає .Steve. Пробіли в гамертегах замінюються на _.

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

• У командах використовуй повний нік із префіксом. Якщо команда його не приймає, візьми нік у лапки: /tp ".Steve".
• Для вайтлиста використовуй 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 не мають автодоповнення, посилання в чаті не клікабельні. Тестуй меню на справжньому пристрої з Bedrock. Плагіни можуть показувати нативні форми Bedrock через Floodgate API, для чого Floodgate має бути на їхньому сервері.

Покажи обидві адреси на BestMCServerList

Гравці Bedrock підключаються за твоєю адресою плюс порт Bedrock, наприклад play.example.net і 19132. BestMCServerList показує адреси Java і Bedrock окремо на кожній сторінці сервера, кожну з кнопкою копіювання.

1. Відкрий Додати сервер і введи свою адресу Java.
2. Постав позначку Гравці Bedrock підтримуються.
3. Введи порт Bedrock з bedrock.port. Залиш IP Bedrock порожнім, якщо він збігається з адресою Java.

Кросплей – справжня перевага для нового сервера. Решту плану дивись у посібнику як знайти гравців для нового сервера.