Configuring GeyserMC to Allow Bedrock Clients to Connect to Java Servers

What is GeyserMC?

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

GeyserMC cannot run worlds or players itself unless installed as a plugin.

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 2 servers by installing GeyserMC as a plugin, we also recommend this as it is the easiest way to setup GeyserMC.

NOTE: 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 auth type, as this will allow anybody to join as anybody else.

What Bedrock Clients Can Connect?

Any Bedrock client that can connect to a 3rd party Bedrock server can connect to a GeyserMC server.

These are:

  • PC (Windows 10 Edition)
  • Mobile Devices (iOS, Android & Windows)
  • Kindle Fire
  • Fire TV
  • Gear VR/Oculus VR

Unfortunately, due to platform limitations, the following platforms cannot connect to GeyserMC servers without requiring further modification of the device:

  • Nintendo Switch
  • Xbox 360/One
  • PlayStation 4/5

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
    • Use Geyser-Spigot for Spigot or Paper
    • Use Geyser-Bungee for Bungeecord or Waterfall
    • Use Geyser-Velocity for Velocity
    • Use Geyser-Sponge for SpongeVanilla or SpongeForge
  2. Upload this JAR file into your plugins directory
  3. Restart your server to generate GeyserMC's configuration files
  4. Edit the newly generated config.yml file present in the /plugins/Geyser-Spigot directory
    • In particular, you’ll need to change the bedrock and remote settings to reflect your server, only the settings that are shown in blue should be changed: 

      port: 19132
      clone-remote-port: true
      address: auto

      port: 25565
      auth-type: online # Either set this online, offline or floodgate (please see our Floodgate guide for more information)
      passthrough-motd: false # If you’d like to show the MOTD to Bedrock players
      passthrough-player-counts: false # If you’d like to show the player count to Bedrock players
      max-players: 100 # The maximum number of Bedrock players that can connect to your server
    • You can learn more about the configuration file at
  5. Save the changes you have made to the GeyserMC config file and restart your server
  6. You should now be able to join your Java Edition server on Bedrock Edition by using the same IP and port as your Java Edition 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 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
  • 65 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 Set / Change Your Server Type

We have a video tutorial on how to set and change your Minecraft server type Set Your Server...

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...