Friend Connect
WARNING
BEFORE YOU USE THIS TOOL, PLEASE READ THE FOLLOWING: WE AS CONTRIBUTORS ARE NOT RESPONSIBLE FOR ANY DAMAGE OR LOSS CAUSED BY THIS APP. USE AN ALT ACCOUNT, JUST IN CASE THERE IS AN ISSUE WITH THIS METHOD.
About
This is a project for minecraft bedrock that allows you to join servers via the in game friends tab. Allowing console players to connect to servers. This project is still in development, so please be patient if there are issues.
The best way to use this tool at the moment is as a node module. Read the tutorial below for more information of how to set this up.
How it works in game
How to use it:
You can use any tool to get the token, for this tutorial I will use prismarine-auth.
$ npm install friend-connect prismarine-auth
Create a file and name it whatever you want. Then paste this example into it:
import { Session } from "friend-connect";
import auth from "prismarine-auth";
const { Authflow, Titles } = auth;
const token = await new Authflow("TailvileMC", "./auth", {
authTitle: Titles.MinecraftNintendoSwitch,
deviceType: "Nintendo",
}).getXboxToken();
new Session(
{
hostName: "Server Name", // The hostname of the server
worldName: "Message of the Day: Hello World", // Use as a MOTD
version: "1.19.10", //The client of the server you are connecting to.
protocol: 534, //The protocol of the server you are connecting to.
players: 0, // Used as a fallback if pinging the server fails.
maxPlayers: 20, // Used as a fallback if pinging the server fails.
ip: "example.com", // The ip of the server you are using.
port: 19132,
log: true,
connectionType: 6, // I don't recommend changing this.
keepVersionAndProtocolConstant: true, // Set this to true if you want to set a constant protocol version. Otherwise it will ping the server to get the protocol version and use the one above if the server has an error on ping.
autoFriending: true, // Set this to true if you want to automatically add people who follow you
},
token
);
Set type to module in the package.json file.
You can run the file with node --es-module-specifier-resolution=node ./path/to/file.js.
To Do List
- Add a way to fetch the version and protocol of the server on session Update.
- Add automatically querying the player numbers from the server on session Update.
- Add the ability to provide an array of strings to be chosen from for the hostName and worldName that is rotated through on session Update.
- Check if the user owns any games if so send an error telling them to use an alt account.
- Add an option to disable auto friending.
- Make a user friendly way to use this tool like a discord bot or something.
- Add a cli tool maybe.
Credit
This project is a js port of the rtm516/MCXboxBroadcast from java.
Friend Connect adds a key feature that makes the friending automated.
I worked with rtm516 to figure out the uri and headers for finding the followers of an xbox profile.
4 Mar 13, 2022
3 Jun 28, 2022
7 Nov 2, 2022
7 Sep 30, 2022
6 Oct 4, 2022
41 Dec 5, 2022
13 Aug 22, 2022
4 Dec 20, 2022
9 Apr 17, 2022
9 Jan 21, 2022
6 Mar 29, 2022
2 Apr 6, 2022
1.5k Dec 26, 2022
3 Jan 13, 2022
9 Jun 23, 2022
4 Jul 10, 2022
4 Oct 31, 2022
7 Sep 22, 2022
25 Dec 21, 2022