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.

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:

     bedrock:
         
         ...
         
         address: 0.0.0.0
         
         port: 19132
         
         clone-remote-port: true
         
         ...
         
     remote:
         
         ...
         
         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 https://github.com/GeyserMC/Geyser/wiki/Understanding-the-Config
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

Installation

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

• Configuring Floodgate 2.0 for Geyser Authentication
• How to install Plugins on your Minecraft Server
• Minecraft Server Types
• How to Install a Custom JAR