MCXboxBroadcast / Broadcaster

A simple Geyser extension that broadcasts the server over Xbox Live.
GNU General Public License v3.0
235 stars 45 forks source link

MCXboxBroadcast

License: GPL-3.0 Build Release HitCount Discord

A simple tool that broadcasts an existing Geyser/Bedrock server over Xbox Live.

This shows up to the authenticated accounts friends in-game as a joinable session and then anyone thats friends with someone who joined through that method will also see the session as joinable ingame.

Example screenshot

DISCLAIMER

You use this project at your own risk, the contributors are not responsible for any damage or loss caused by the software. We suggest you use an alt account for running the tool in case the account is banned as we emulate some features of a client which may or may not be against TOS.

Features

Pterodactyl Panel

There is an egg for easy instance creation supplied for Pterodactyl Panel, this being egg-m-c-xbox-broadcast.json

Docker

There is a docker image available for the standalone version of the tool, this can be found at ghcr.io/mcxboxbroadcast/standalone:latest

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

Installation

Extension

  1. Download the latest release file MCXboxBroadcastExtension.jar
  2. Drop the extension into the Geyser extensions folder
  3. Restart the server
  4. Wait for the extension to start and present you with an authentication code
    • To sign in, use a web browser to open the page https://www.microsoft.com/link and enter the code XXXXXXXX to authenticate.
  5. Follow the link and enter the code
  6. Login to the account you want to use
  7. Follow the account on Xbox LIVE
  8. Check the friends tab ingame and you should see the server listed

Standalone

  1. Download the latest release file MCXboxBroadcastStandalone.jar
  2. Start the jar file using java -jar MCXboxBroadcastStandalone.jar
  3. Wait for the extension to start and present you with an authentication code
    • To sign in, use a web browser to open the page https://www.microsoft.com/link and enter the code XXXXXXXX to authenticate.
  4. Follow the link and enter the code
  5. Login to the account you want to use
  6. Follow the account on Xbox LIVE
  7. Edit the config.yml to have the correct ip and port for the target server
  8. Restart the tool
  9. Check the friends tab ingame and you should see the server listed

Manager

There is a web manager available for donators. After joining the relevent GitHub sponsors tier you will be able to access its builds at https://github.com/MCXboxBroadcast/Manager/releases

Note: This also requires a MongoDB instance to be running

Screenshots ![Bots view](https://github.com/user-attachments/assets/e4760c93-a146-45b9-b029-fd3c5c6e7bea) ![Bot info](https://github.com/user-attachments/assets/462f1d8b-c8ab-42e0-ab0e-cb335fc00ab4) ![Bot options](https://github.com/user-attachments/assets/f603d51f-f59e-4a49-b2a5-ffeb074109e8) ![Server options](https://github.com/user-attachments/assets/e203eac3-7190-4510-9f5b-ef87de507cab) ![Manager settings](https://github.com/user-attachments/assets/11f85c70-9b50-4039-bddb-961833b7d11e)

Commands

For the extension version prefix with /mcxboxbroadcast

Command Description
exit (Standalone Only) Exits the program
restart Restarts the tool
dumpsession Dumps the current session data to files for debugging
accounts list Lists the accounts that are currently in use and their followers count
accounts add <sub-session-id> Adds an account to the list of accounts to use
accounts remove <sub-session-id> Removes an account from the list of accounts to use