📽️ Video Guide 📽️

In this article, we will guide you on how to install and use the GeyserMC plugin on your server, a bridge between Java and Bedrock that allows Bedrock players to connect to Java servers.
If you want to install Geyser for BungeeCord, you only need to install the plugin on the proxy server, following a similar guide, then all the target servers will have Geyser implemented.

Getting started

To begin, you can first download the plugin file from https://ci.opencollab.dev//job/GeyserMC/job/Geyser/job/master/



Download the plugin file for your respective server software (Note - download Geyser-spigot.jar if your server software is Purpur/Tuinity/Paper/Spigot/Bukkit).
Once downloaded, upload your plugin to the plugins directory in your server files, using the file manager in the WitherHosting dashboard or by using sFTP.
Make sure your server is stopped while uploading the plugin!
Now, start and stop your server to generate the files required for Geyser.

🤖 Configuration 🤖

Edit the config.yml file (located in plugins --> geyser) to have the following values:

Set the address as 0.0.0.0 in the bedrock IP address. (Line 13)
Set the port as your server port provided by WitherHosting in the port section. (Line 15)
Set the address as your IP address for your server provided by WitherHosting in the address field. (Line 42)
Set the port as your server port provided by WitherHosting in the port section. (Line 45)

Your port is the last 5 digits of your server IP in the dashboard!
In lines 22, 23, and 25, you can set your server name, MOTD, and other information to appear on Bedrock clients.

🔐 Authentication mode 🔐

In line 49, you need to set your authentication type. This will decide how you want players to join your server. There are multiple options, all explained below:

online - This means that Bedrock players need a Java account to log in and play on Bedrock. Players using cracked versions of Minecraft cannot play in this type.
offline - This means that Bedrock players don't need a Java account to log in. This can support players who use cracked versions of Minecraft to play as well.
floodgate - This means that Bedrock players don't need a Java account to log in. This does not support players who use cracked versions of Minecraft.

If you require floodgate-type authentication, continue reading this article; otherwise, you can stop here, and Geyser will be set up!
Floodgate is a separate plugin that is required if you want Bedrock players to play without a Java account on servers that do not support cracked versions of Minecraft.

Getting started

Download Floodgate from https://ci.opencollab.dev/job/GeyserMC/job/Floodgate/job/master/.



Download the plugin file for your respective server software (Note - download floodgate-bukkit.jar if your server software is Paper/Spigot/Bukkit).
Once downloaded, upload your plugin to the plugins directory in your server files, using the file manager in the WitherHosting dashboard or by using sFTP.
Make sure your server is stopped while uploading the plugin!
Now, start and stop your server to generate the files required for Floodgate.

🤖 Configuration 🤖

Open Floodgate config.yml (located in plugins --> Floodgate).

Set the username-prefix to any single character. Floodgate appends a prefix to Bedrock player's usernames to prevent conflicting usernames between Java and Bedrock. You can remove the prefix too, but there will be problems when a Java and Bedrock player connect with the same name (line 9).

If your server is version 1.19 and above, then you will need to change enforce-secure-profiles to false in server.properties to make sure Bedrock players can join.

If you want Bedrock player's names, for example, John Doe, to become John_Doe when they connect, set replace-spaces to true. If not required, set to false. (line 12).

Now, you should be all set up to run Geyser and Floodgate on your server!

Updated on: 02/06/2024