Configuring GeyserMC to Allow Bedrock Clients to Connect to Java Servers

GeyserMC is a proxy for Minecraft that allows Bedrock edition players to join Java/PC edition servers.

Since GeyserMC is just a proxy, worlds and players cannot actually exist on a GeyserMC instance. GeyserMC simply bridges the connection between a Bedrock player and an existing Java server. You can prevent the need for two servers by installing GeyserMC as a plugin, we also recommend this as it is the easiest way to setup GeyserMC.

Important: If you’d like to allow Bedrock players that do not own a Java account to connect, please also install Floodgate using our guide here. We would highly advise not using the offline authentication type, as this will allow anybody to join as anybody else.

What Bedrock Clients Can Connect?

While some server hosts are unable to provide support for some bedrock platforms, Shockbyte offers support for the following platforms:

Unfortunately, due to platform limitations, PlayStation 4 and 5 users cannot connect to GeyserMC servers without requiring further modification of the device.

Installing GeyserMC as a Plugin

The easiest way to use GeyserMC is to install it as a plugin on your existing Java server.

  1. Download the latest version of the plugin from GeyserMC’s website based on the server platform that you are running. For this example, we will be using the PaperMC (Spigot fork) server type.
  2. Access your control panel and Stop your server.
  3. Navigate to Files > FTP File Access and log in.
  4. Locate and open the plugins folder.
  5. Click the Upload button on the left-hand menu and upload your GeyserMC JAR file.

    We recommend you also install ViaVersion at this step (if your server type supports it). ViaVersion helps ensure version compatibility between Java and Bedrock.
  6. Return to your server's Multicraft dashboard and Start your server.
  7. You can test your Bedrock connection by typing geyser connectiontest IP:PORT into your server's console command line.

    Your GeyserMC configuration should automatically adjust to your active IP and Port, so you can test/connect with your normal server IP. If the connection test fails, try restarting your server and checking the port in your GeyerMC config.yml file. Refer to the GeyserMC setup wiki for more information.

  8. In some cases, you may need to disable enforce-secure-profile in your server properties for GeyserMC to work correctly. You can fix this by either installing Floodgate or following this guide.

Congratulations, compatible Minecraft Bedrock clients should now be able to connect to your Java server!

Standalone Setup of GeyserMC

A standalone GeyserMC setup requires you to have a server for both the GeyserMC instance itself and the Java edition server you would like to connect the proxy to. This is often used when you have many Bedrock players.

The requirements for a standalone setup are the following:

  • One Minecraft Java edition server that you wish to connect to the proxy (this can be Vanilla, Spigot, Craftbukkit etc.).
  • An additional Minecraft server to run the GeyserMC software.


The installation steps for the standalone version are almost identical to installing GeyserMC as a plugin. In particular, however:

  1. Download and run Geyser.jar instead of downloading the plugin versions. You’ll need to install this as a Custom JAR using this guide.
  2. Access the config file which is now located in the main server directory.
  3. You will need to edit the remote: address to reflect the address of your Java Minecraft server, instead of setting it to auto.

Related Links

If you require any further assistance, please contact our support at:

Mitchell Smith

Managing Director @ Shockbyte

  • geysermc, dragonproxy, proxy, dragon, geyser, bedrock, bridge, Bedrock edition, Java Edition, plugins, mods
  • 74 Users Found This Useful
Was this answer helpful?

Related Articles

How to Convert Worlds from Vanilla to Spigot

This guide is for converting your worlds from Vanilla to Spigot. If you're looking to convert...

How to Get Help Managing your Minecraft Server

When you are stuck and need help with managing your Minecraft server, there are resources...

How to Join a Minecraft Server (PC / Java Edition)

We have a video tutorial on how to connect to your Minecraft server: If you would like to join...

How to Use Colour Codes on Your Minecraft Server

If you’ve played on other Minecraft servers before, the chances are that you’ll have seen them...

How to: Edit configuration files manually with Notepad++

We have a video tutorial on editing configuration files with Notepad++:   When editing...