Вход игроков Bedrock на сервер Minecraft Java — Geyser и Floodgate

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску

У Minecraft две несовместимые версии: Java Edition для компьютеров и Bedrock Edition для телефонов, планшетов, консолей и Windows. Игрок с телефона не может зайти на сервер Java — если на сервере нет Geyser. Geyser — плагин-переводчик: он принимает подключения Bedrock и превращает их в понятные серверу Java. Его спутник Floodgate позволяет таким игрокам входить под своей учётной записью Xbox, не покупая Java Edition. В статье — установка обоих плагинов на сервер Paper, настройка, порты и проверка. Всё проверено 17 ноября 2026 года на Ubuntu 24.04.4: Paper 26.3, Geyser 2.12.1, Floodgate 2.2.5; снимки экрана сняты с настоящего сервера.

Сервер установлен по статье Установка и настройка Spigot-Paper сервера. Команды консоли в примерах отправляются скриптом mcc — он описан в статье Права и группы на сервере Minecraft — плагин LuckPerms.

Geyser или отдельный сервер Bedrock

Сервер Java с Geyser Сервер Bedrock
Кто может зайти Игроки Java и Bedrock вместе Только Bedrock
Плагины и моды Все плагины Paper Только дополнения Bedrock
Отличия для игроков Bedrock Мелкие: часть анимаций и предметов выглядит иначе Нет
Инструкция Эта статья Установка и настройка Minecraft Bedrock сервера

Если в компании есть игроки и с компьютеров, и с телефонов — нужен сервер Java с Geyser. Памяти Geyser добавляет немного; тариф выбирается как для обычного сервера Java — Какой VDS выбрать для игрового сервера.

1. Установка

sudo systemctl stop minecraft
sudo -u minecraft bash -c 'cd /opt/minecraft/server/plugins && curl -sL -o Geyser-Spigot.jar https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot && curl -sL -o floodgate-spigot.jar https://download.geysermc.org/v2/projects/floodgate/versions/latest/builds/latest/downloads/spigot && ls -l | cut -c24-90'
sudo systemctl start minecraft
grep -E "(floodgate|Geyser-Spigot)\] (Enabling|Done)|Done \(" /opt/minecraft/server/logs/latest.log | cut -c34-120

Оба файла скачиваются с официального сайта проекта; слово spigot в адресе — это вариант плагина для серверов Paper и Spigot. В журнале — «Enabling» для обоих плагинов и «Done» от Geyser.

Версия Bedrock у игроков обновляется сама, поэтому Geyser нужно обновлять сразу после выхода новой версии игры — иначе игроки с телефонов увидят «устаревший сервер».

2. Настройка

Остановите сервер и поменяйте три настройки Geyser:

sudo systemctl stop minecraft
sudo -u minecraft sed -i 's/^  auth-type: online/  auth-type: floodgate/; s/^  transport: nethernet/  transport: both/; s/^  webrtc-port: 0/  webrtc-port: 19133/' /opt/minecraft/server/plugins/Geyser-Spigot/config.yml
sudo grep -n -E "^  (port|webrtc-port|transport|auth-type):" /opt/minecraft/server/plugins/Geyser-Spigot/config.yml
sudo grep -E "^(key-file-name|username-prefix|replace-spaces):" /opt/minecraft/server/plugins/floodgate/config.yml
sudo ls -l /opt/minecraft/server/plugins/floodgate/ | cut -c1-70
sudo systemctl start minecraft
sudo ss -lntup | grep -E ":(25565|19132|19133) " | awk '{print $1, $5}'

Настройка Что означает
auth-type: floodgate Игроки Bedrock входят под учётной записью Xbox, без Java Edition. Со значением по умолчанию online каждому пришлось бы входить ещё и в учётную запись Java
port: 19132 Порт Bedrock — тот, что игра подставляет сама
transport: both Принимать оба способа подключения Bedrock: новый (NetherNet) и прежний (RakNet). По умолчанию включён только новый; с both зайти смогут и те, у кого игра ещё не обновилась
webrtc-port: 19133 Отдельный порт UDP для нового способа — он обязателен при transport: both

Последняя команда на снимке показывает, что сервер слушает порт Java 25565 и порты Bedrock 19132 и 19133.

В настройках Floodgate менять ничего не нужно, но две стоит знать:

  • username-prefix: "." — к именам игроков Bedrock добавляется точка: .Steve. Так они не совпадут с именами игроков Java. Под этим именем — с точкой — игрока добавляют в белый список, выдают права и ищут в журнале;
  • key.pem — ключ, которым Geyser и Floodgate узнают друг друга. В сети из нескольких серверов этот файл должен быть одинаковым на прокси и на всех серверах.

3. Порты

sudo ufw allow 19132/udp
sudo ufw allow 19132/tcp
sudo ufw allow 19133/udp
Порт Зачем
25565/tcp Игроки Java — открыт ещё при установке сервера
19132/udp Bedrock: прежний способ подключения и поиск сервера
19132/tcp Bedrock: согласование нового способа подключения
19133/udp Bedrock: новый способ подключения

4. Проверка

Проверить, что сервер отвечает игрокам Bedrock, можно без самой игры — маленькой программой, которая спрашивает сервер так же, как это делает список серверов в Bedrock:

sudo nano /usr/local/bin/bedrock-ping
#!/usr/bin/env python3
# bedrock-ping <адрес> [порт] — запрос состояния сервера Minecraft Bedrock
import socket, struct, sys, time
host = sys.argv[1]; port = int(sys.argv[2]) if len(sys.argv) > 2 else 19132
magic = bytes.fromhex('00ffff00fefefefefdfdfdfd12345678')
s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM); s.settimeout(4)
s.sendto(b'\x01' + struct.pack('>q', int(time.time() * 1000)) + magic + struct.pack('>q', 2), (host, port))
try:
    d, _ = s.recvfrom(2048)
except OSError:
    print('нет ответа'); sys.exit(1)
f = d[35:].decode('utf-8', 'replace').split(';')
print('сервер отвечает: %s | версия %s | игроков %s/%s | режим %s' % (f[1], f[3], f[4], f[5], f[8] if len(f) > 8 else '?'))
sudo chmod +x /usr/local/bin/bedrock-ping
sudo ss -lntup | grep -E ":(25565|19132|19133) " | awk '{print $1, $5}'
bedrock-ping 127.0.0.1 19132
grep -E "Geyser-Spigot\] (Done|Built-in)|STUN discovery has" /opt/minecraft/server/logs/latest.log | sed -E 's/^.{11}\[[^]]*\]: //; s/\[org[^]]*\] //' | cut -c1-105
mcc "geyser version" | head -n 1
mcc "geyser list" | tail -n 1

Что на снимке:

  • сервер ответил на запрос Bedrock: название, версия, число игроков — именно это увидит игрок в списке серверов. Тот же запрос с другого компьютера (с адресом VDS вместо 127.0.0.1) проверяет заодно и файрвол; на проверке сервер ответил и снаружи;
  • в журнале — строка о запуске нового способа подключения на портах 19132 и 19133;
  • два предупреждения «STUN discovery has had no answer»: Geyser пытался узнать внешний адрес сервера через сторонние службы и не получил ответа. На VDS это не мешает: внешний адрес назначен самому серверу, и Geyser сообщает игрокам его. Предупреждение важно, только если сервер стоит за маршрутизатором, — тогда адрес задают в настройке advertise-addresses;
  • geyser version — версия Geyser и версии Java и Bedrock, которые он понимает;
  • geyser list — игроки Bedrock, которые сейчас на сервере.

5. Как зайти игроку Bedrock

Телефон, планшет, Windows. «Играть» → вкладка «Серверы» → в самом низу «Добавить сервер»: название любое, адрес — IP-адрес или доменное имя VDS, порт — 19132.

Консоли (Xbox, PlayStation, Switch) не дают добавить свой сервер — это ограничение самих консолей. Его обходят программами на телефоне, которые показывают сервер консоли как игру «у друзей»; способы описаны в документации Geyser и меняются с обновлениями консолей.

Белый список. Если на сервере включён белый список (в версии 26.3 он включён сразу), игрока Bedrock добавляют командой Floodgate — она сама находит учётную запись Xbox по имени:

mcc "fwhitelist add ИмяИгрока"

Права. Для плагинов игрок Bedrock — обычный игрок с именем, начинающимся с точки: lp user .Steve parent add vip.

Что не проверено

Проверены: установка обоих плагинов, настройки, порты, ответ сервера на запрос Bedrock — с самого VDS и снаружи. Не проверены: вход игрока с настоящего устройства с Bedrock Edition, новый способ подключения (NetherNet) целиком, команда fwhitelist и подключение с консолей — для этого нужны устройства с игрой.

Если что-то пошло не так

Что видите Причина и решение
Сервер не виден с телефона, bedrock-ping с другого компьютера — «нет ответа» Закрыт порт 19132/udp. Откройте его в файрволе VDS; правило для TCP его не заменяет
«Устаревший сервер» или «устаревший клиент» Версии разошлись: обновите Geyser (шаг 1 заново) или игру на устройстве. Поддерживаемые версии — mcc "geyser version"
Игрока просят войти в учётную запись Java В настройках Geyser осталось auth-type: online — шаг 2
«Please connect through the official Geyser» Не совпадают ключи key.pem у Geyser и Floodgate — так бывает в сети с прокси, если файл не скопирован на все серверы
Игрок Bedrock не проходит белый список Он добавлен обычной командой whitelist add без точки. Используйте fwhitelist add
В журнале «STUN discovery has had no answer» Geyser не смог узнать внешний адрес через сторонние службы. На VDS с собственным внешним адресом это не мешает — шаг 4
После обновления сервера Geyser не запускается Вышла новая версия Minecraft: обновите оба плагина

Для размещения игровых серверов рекомендуем услуги ARK-HOSTER.RU: