How to install GeyserMC

Want bedrock players to be able to join your Java server? Follow this guide to learn how.


Note: Bedrock players will need a Java edition account to connect to a Java server. There is a plugin actively in development called Floodgate that will remove this requirement in the future, but as of right now it is not complete.

Step 1: Downloading Paper 1.16.1

As mentioned in the note above you will need to use the 1.16.1 version of Spigot/Paper. To switch your server to 1.16.1 you can follow this guide:

How to install a custom .jar file guide (Embedded Guide)

Once you upgraded to 1.16.1 you cannot downgrade your server to 1.15 without wiping it!

Step 2: Downloading Geyser 1.16

You will need to download the plugin version of Geyser 1.16.

First go to GeyserMCs website here and click on the Download Button in the top right​

Then you should download the Geyser-Spigot.jar file. This has been updated to work with 1.16 and the newest version of Bedrock.

Step 3: Installing Geyser

You can install the Geyser plugin like any other plugin. If you haven’t installed a plugin before or need help you can follow this guide:

​How to install Plugins​

Step 4: Configuring Geyser

Now we need to configure Geyser to allow connections from Bedrock Edition. After installing the Geyser plugin start your server to generate the Geyser config file.

Then we will need to edit port settings in the config as the default Bedrock port is not the same as the default Java port. The config file can be found in the Geyser plugin folder.

In the config file you want to replace the port under bedrock and the port under remote with the port of your Java server. In this case our server port is 25565. You do not need to edit either address.

If you do not know your port it can be found in Server Details

In the config you can also edit the MOTD that will show up to Bedrock players, but note the MOTD window on Bedrock is pretty small.

Once you have your port and MOTD in we can save the file and go back to the console.

In the console type:

And you should see Geyser using the new port we just set.

Note: It may show you a warning about running in a Docker image. DedicatedMC are configured correctly and this will not be an issue.

Step 5: Connecting to the server

Geyser is now up and running! Congrats!

For your Bedrock players to be able to connect to your Java Server they need to add it to their server list.

Once added use the IP of your server and the port we configured earlier.

You should now see the server in the list of Bedrock servers with the MOTD we configured!

The players can now connect like normal, but they will be prompted to log in with a Java account. They do not need Java Edition installed, but they will need a Java Edition account.

Once this is done they will be on the server and can play with other Java players! It will use the skin of the Java account that was used to log in, not the Bedrock skin.


This Article was created by a Member of our Community. Join our Discord to do the same!