Back to Knowledge BaseMinecraft

How to Use GeyserMC

In this guide, we'll show you step-by-step instructions on how to set up and configure GeyserMC on your Minecraft Java server. Whether you're new to the plugin or just curious about it, these simple instructions will help you get started quickly.

Let's dive in and make your Minecraft server work for both Java and Bedrock players!

What is GeyserMC

  • Geyser is a proxy server that bridges the gap between Minecraft: Bedrock Edition and Minecraft: Java Edition servers, allowing Bedrock and Java players to connect and play together.
  • The goal of GeyserMC is to allow Bedrock Edition users to join Java Edition servers seamlessly, supporting platforms like PlayStation, Nintendo Switch, iOS, and Android.

How Does GeyserMC Work?

Your Minecraft server must support Bukkit/Spigot plugins for GeyserMC to work. If your server is not running 1.21.9-1.21.10, you will need to install ViaVersion.

  • Geyser acts as a translator between Bedrock clients and Java servers. It converts data from Bedrock players into Java-compatible data so that they can connect to your server.

How to Download and Install GeyserMC

  1. Download the Geyser-Spigot.jar plugin from the official GeyserMC download page at https://geysermc.org/download.
  2. Select Geyser-Spigot.jar to download the latest version for Paper/Spigot servers.
  3. Open the File Manager tab in your server control panel.
  4. Navigate to the plugins folder on your server.
  5. Upload the Geyser-Spigot.jar file to the plugins folder.
  6. Restart your server to activate GeyserMC. The plugin will generate its configuration files automatically.

How to Configure GeyserMC

  • After restarting, open your Geyser config file, located at /plugins/Geyser-Spigot/config.yml.
  • Find the bedrock section in the configuration file. This section contains the vital settings for Bedrock connections.
  • Open your Geyser config and find the following configuration block:
bedrock: # The IP address that will listen for connections. # Generally, you should only change this if you want to limit what IPs can connect to your server. address: 0.0.0.0 # The port that will Geyser will listen on for incoming Bedrock connections. # Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic. port: 19132 # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock. # This option makes the Bedrock port the same as the Java port every time you start the server. clone-remote-port: false
  • The vital part is the port. This is the port that Bedrock players will use to connect to your server.
  • address: 0.0.0.0 - The IP address that will listen for connections. Generally, you should only change this if you want to limit what IPs can connect to your server.
  • port: 19132 - The port that Geyser will listen on for incoming Bedrock connections. Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic. This is the port that Bedrock players will use to connect to your server.
  • clone-remote-port: false - Some hosting services change your Java port every time you start the server and require the same port to be used for Bedrock. This option makes the Bedrock port the same as the Java port every time you start the server. If clone-remote-port is enabled, the bedrock port will be overwritten with the Java port!
  • Important: Other services/plugins that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser.
  • Change the port value to match your hosting provider's requirements, or leave it as 19132 if you're self-hosting.
  • If your hosting provider requires it, you may need to enable clone-remote-port and adjust the address setting.

Verifying Your Setup

  1. After configuring Geyser, verify whether connections are possible by running the command: geyser connectiontest <ip> <port> in your server console.
  2. Replace <ip> with your server's IP address and <port> with the Bedrock port you configured.
  3. This test will help you confirm that Bedrock players can connect to your server.

Optional: Setup Floodgate for Bedrock Players

  1. Floodgate allows Bedrock players to join your server without needing a paid Java Edition account.
  2. To set up Floodgate:
  3. Download Floodgate from the official GeyserMC download page at https://geysermc.org/download.
  4. Select floodgate-spigot.jar for Paper/Spigot servers.
  5. Open the File Manager and navigate to the plugins folder.
  6. Upload the floodgate-spigot.jar file to the plugins folder.
  7. Open your Geyser config.yml file and find the auth-type setting in the remote section.
  8. Change auth-type from online to floodgate.
  9. Restart your server, and Bedrock players should now be able to join without a Java account!
  10. Note: When using Floodgate, you can install it on all servers in your network for better skin support and network-wide Floodgate API availability for other plugins.

Additional Notes

  • Geyser only works with server-side mods. Mods that require a client-side install will not work!
  • All servers on a network must accept 1.21.9-1.21.10 Java clients, as Geyser imitates one.
  • For proxy servers (BungeeCord, Velocity), install Geyser only on the proxy server, not on the backend servers.
  • For more detailed information and hosting provider-specific instructions, visit the official GeyserMC wiki at https://geysermc.org/wiki/geyser/setup.
NexusVM | Game & Web Hosting in India & APAC