MCXboxBroadcast

MCXboxBroadcast - серверный инструмент для владельцев Minecraft Java-серверов с поддержкой Bedrock через Geyser. Он показывает работающий сервер друзьям Xbox-аккаунта как доступную для подключения игровую сессию. Игрокам не нужно искать адрес сервера вручную: он появляется во вкладке Friends в игре.

Это не отдельный игровой мод и не новый сервер. MCXboxBroadcast связывает уже настроенный сервер Geyser/Bedrock с Xbox Live, передавая сведения о сессии и синхронизируя MOTD и другие данные сервера. Для сообщества с игроками на разных устройствах это удобный способ упростить подключение, хотя сам инструмент не заменяет Geyser и не настраивает Bedrock-доступ за вас.

Возможности MCXboxBroadcast

• Синхронизация MOTD и других сведений о сервере.
• Автоматическое управление списком друзей и подписчиков аккаунта.
• Установка в виде расширения Geyser или запуск отдельно.
• Отображение аккаунта как находящегося в сети и играющего в Minecraft в приложении и на сайте Xbox.
• Поддержка нескольких аккаунтов.
• Веб-менеджер для крупных сетей. Для него нужна работающая база данных MongoDB.
• Пользовательское изображение профиля Xbox-аккаунта.

В актуальных версиях проекта также заявлена совместимость с Minecraft Java 1.21.10-1.21.11, 26.1.x и 26.2. Перед установкой сверьте версию MCXboxBroadcast с версиями Minecraft и Geyser на сервере: серверный инструмент должен подходить к вашей текущей конфигурации.

Установка как расширения Geyser

Этот вариант подходит, если Geyser уже установлен на сервере.

1. Поместите MCXboxBroadcastExtension.jar в папку extensions Geyser.
2. Перезапустите сервер.
3. Дождитесь кода авторизации, который появится после запуска расширения.
4. Откройте указанный в сообщении адрес входа Microsoft и введите код.
5. Войдите в Xbox-аккаунт, который будет представлять сервер.
6. Добавьте этот аккаунт в друзья Xbox LIVE.
7. Откройте вкладку друзей в Minecraft и проверьте, отображается ли сервер.

Для расширения команды MCXboxBroadcast нужно вводить с префиксом /mcxboxbroadcast. Если сессия не появилась, сначала проверьте авторизацию аккаунта, список друзей и запуск Geyser, а затем перезапустите расширение.

Отдельный запуск

MCXboxBroadcast можно использовать и без установки в папку расширений Geyser. Для этого запустите MCXboxBroadcastStandalone.jar командой:

java -jar MCXboxBroadcastStandalone.jar

После появления кода авторизуйте Xbox-аккаунт и добавьте его в друзья. Затем укажите правильные IP-адрес и порт целевого сервера в config.yml и перезапустите инструмент. В отличие от расширения, здесь адрес сервера задаётся в конфигурации самого MCXboxBroadcast.

Для развёртывания также доступны Docker-образ и шаблон egg для Pterodactyl Panel. В Docker конфигурацию можно подключить как отдельный том:

docker run --rm -it -v /path/to/config:/opt/app/config ghcr.io/mcxboxbroadcast/standalone:latest

Команды

Для версии-расширения используйте префикс /mcxboxbroadcast.

Команда	Описание
exit	Завершает работу. Только для standalone-версии.
restart	Перезапускает инструмент.
dumpsession	Сохраняет данные текущей сессии в файлы для диагностики.
accounts list	Показывает используемые аккаунты и количество их подписчиков.
accounts add <sub-session-id>	Добавляет аккаунт в список используемых.
accounts remove <sub-session-id>	Удаляет аккаунт из списка используемых.

Изображение профиля и безопасность

Чтобы установить собственное изображение для профиля аккаунта, положите файл screenshot.jpg рядом с config.yml. Рекомендуемые параметры изображения: 1200x675 пикселей, качество 90 и цветовая субдискретизация 4:2:0. Обновление на стороне Xbox Live может занять несколько минут.

Учитывайте предупреждение разработчиков: MCXboxBroadcast имитирует некоторые функции клиента, и Microsoft может расценить такое поведение как нарушение правил Xbox Live. Для работы инструмента рекомендуется отдельный аккаунт, а не основной профиль. Используйте проект на свой риск; блокировка аккаунта может привести к потере доступа к нему.

MCXboxBroadcast полезен администраторам, которым нужно сделать существующий Geyser-сервер заметным для друзей в Xbox Live. Он упрощает вход в игру, но требует настроенного Bedrock-доступа, корректного адреса сервера и аккаунта с действующей авторизацией.