Как разрешить игрокам Bedrock заходить на ваш сервер Java через Geyser

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

Панель настраивает оба плагина одной кнопкой. В этом руководстве рассказано об этой кнопке, о том, как подключаются игроки Bedrock, и о том, что делать вручную, если кнопки нет.

Что работает, а что нет

• Игроки Bedrock заходят в тот же мир, что и игроки Java, и общаются с ними в чате.
• Geyser не может перевести то, что добавляет большинство модов, например новые блоки и предметы. На странице поддерживаемых версий Geyser сказано, что Geyser эмулирует клиент Java одной конкретной версии, на момент написания это 26.2, поэтому ваш сервер Java должен принимать игроков этой версии. Игроки Bedrock не могут устанавливать моды Java, поэтому сервер, контент которого создают моды, не подходит.
• Geyser не превращает ресурспаки Java в ресурспаки Bedrock.
• Игроки Bedrock используют управление Bedrock, поэтому некоторые детали игры отличаются от Java.

На странице самого Geyser перечислены версии Java и Bedrock, которые он поддерживает в данный момент. См. geysermc.org. Новые версии Minecraft могут выйти раньше, чем их поддержит Geyser.

Включите кроссплей в панели

Кнопка есть на сервере Java, на котором работает Paper, Purpur, Spigot, Folia, Magma, Ketting, Velocity, BungeeCord или Waterfall. Для серверов Fabric, Forge, NeoForge, Quilt, Vanilla, Sponge, Mohist, Custom Jar, модпаков и Bedrock она не предлагается. В этих случаях создайте тикет и расскажите, что вы хотите сделать.

1. Откройте сервер в панели и нажмите Порты и сеть в меню слева.
2. Найдите карточку Кроссплей с Bedrock. Если в ней сказано, что сервер не может быть мостом, там указана причина, например версия Minecraft слишком новая для любого выпуска Geyser или нужна более новая Java, чем у вас. Следуйте указанной причине.
3. Нажмите Включить кроссплей. Нужны права на создание файлов и на создание портов. Если вы приглашённый помощник без обоих прав, обратитесь к владельцу.
4. Панель устанавливает Geyser и Floodgate в папку plugins, добавляет вашему серверу второй порт для трафика Bedrock и указывает Geyser использовать его. Затем в карточке появляется Игроки Bedrock подключаются к с адресом и портом и кнопкой копирования. Это показывается только до перезагрузки страницы. После этого в карточке сказано только, что кроссплей настроен, поэтому скопируйте адрес сразу. Порт всегда можно найти снова в списке Все порты ниже на странице Порты и сеть: дополнительный порт там это порт Bedrock, а имя хоста то же, что и в вашем Адресе сервера для Java.
5. Перезапустите сервер. Карточка напоминает, что кроссплей не будет готов до этого.
6. Дайте игрокам Bedrock этот адрес и порт. Первая часть это адрес, а число после двоеточия это порт.

Трафик Bedrock отделён от трафика Java, поэтому игроки Bedrock используют адрес и порт Bedrock, а не Адрес сервера для Java со страницы «Обзор». У них то же имя хоста и другой порт. Ваши игроки Java по-прежнему используют Адрес сервера.

Как заходят игроки Bedrock

Игроки на Windows, телефонах и планшетах:

1. Запускают Minecraft Bedrock Edition, выбирают Играть, затем вкладку Серверы и Добавить сервер.
2. Вводят любое имя в поле Название сервера.
3. Вводят адрес (всё, что до двоеточия) в поле Адрес сервера, а число после двоеточия в поле Порт.
4. Сохраняют, выбирают сервер и заходят.

О правилах версий см. Как зайти на сервер Minecraft. Игроки на Xbox, PlayStation и Nintendo Switch не могут добавить сторонний сервер по адресу. По словам Minecraft Wiki, они могут заходить только через собственный DNS или подключение по локальной сети, поэтому игроку с консолью нужен один из этих способов.

Игроки Bedrock входят с собственным аккаунтом Microsoft. Оставьте Онлайн-режим включённым в разделе Настройки, Server Properties (Java). См. Свойства сервера Minecraft: разбор настроек. Вход игроков Bedrock обрабатывает Floodgate, поэтому выключать онлайн-режим не нужно.

Ники, вайтлист и команды

Floodgate ставит префикс перед ником каждого игрока Bedrock, чтобы он не совпал с ником игрока Java. В его файле конфигурации по умолчанию префиксом служит точка, например .Steve, а пробелы в никах заменяются подчёркиваниями. И то и другое можно изменить в config.yml Floodgate.

• Чтобы добавить игрока Bedrock в вайтлист, введите в Console команду fwhitelist add Name без косой черты. В документации Floodgate сказано, что префикс указывать не нужно и что вместо ника можно указать UUID игрока. Команда fwhitelist remove Name удаляет его. См. Как настроить вайтлист и банить игроков на сервере Minecraft.
• В командах, где указывается игрок Bedrock, используйте ник так, как его показывает игра, с префиксом.

Храните ключ Floodgate в тайне

Floodgate создаёт файл key.pem в собственной папке внутри plugins. В документации Floodgate сказано, что этот ключ позволяет аккаунтам Bedrock обходить вход Java, а любой, кто его получит, может серьёзно навредить вашему серверу. Не делитесь им, не публикуйте его в тикете и не оставляйте его в бэкапе, который передаёте другим людям.

Если кнопкой воспользоваться нельзя

То же самое можно сделать вручную на Paper, Purpur или Spigot:

1. В разделе Моддинг, затем Плагины установите Geyser и Floodgate или загрузите их jar-файлы в папку plugins. Берите их из официальных загрузок Geyser. См. Как установить плагины на Paper, Spigot и Purpur.
2. На странице Порты и сеть используйте Добавить порт, если ваш тариф позволяет ещё один. Выбрать номер нельзя. См. Как найти порты и IP-адрес сервера и добавить выделенный IP.
3. Один раз запустите сервер, чтобы Geyser создал свои настройки. В Files откройте plugins, затем папку Geyser (на этих типах серверов она называется Geyser-Spigot) и отредактируйте config.yml. Задайте port в разделе bedrock равным номеру нового порта. По умолчанию у Geyser 19132, и он использует только UDP.
4. Перезапустите сервер и дайте игрокам Bedrock адрес и новый порт.

Другие плагины, которые используют UDP, например голосовой чат или query, не могут делить порт с Geyser. Это же сказано в документации Geyser.

Для сети с прокси Geyser и Floodgate ставятся на прокси. На странице настройки Floodgate добавлен ещё один шаг, если вы ставите Floodgate и на бэкенд-серверы: задайте send-floodgate-data равным true в конфигурации Floodgate на прокси и скопируйте key.pem из папки Floodgate на прокси в папку Floodgate каждого бэкенд-сервера. Относитесь к этому ключу как к секрету, которым он и является, как описано выше. См. Как построить сеть Minecraft с Velocity или BungeeCord.

Если игроки Bedrock не могут подключиться

Если ничего из этого не помогло, создайте тикет с названием сервера и последними строками Console. См. Как создать тикет в поддержку.