Skip to main content

Minecraft | How to install GeyserMC

GeyserMC, created by the team at https://geysermc.org/, is a proxy server that forms a crucial component of the Open Collaboration Project at https://twitter.com/opencollabdev.

With Geyser, you can seamlessly connect and bridge your Minecraft Java server with Minecraft: Bedrock edition servers, enabling them to join your Java edition server.

In the following guide, we will demonstrate the step-by-step process of installing GeyserMC and Floodgate.

Ensure you have the latest PaperMC version installed on your Minecraft server. Our servers deploy with PaperMC out-of-the-box.

tip

if you are unsure how to easily install different flavours of Minecraft, you can learn how to do that here.

Once you have confirmed the latest PaperMC version is installed, follow these steps:

  1. Access the mod manager and click on the dropdown labeled Geyser.
  2. Click the Install button for Geyser Spigot and let the installation process complete.

  1. After Geyser Spigot is installed, click the Install button for Floodgate Spigot.
  2. Verify that you see the two JAR files in your plugins folder.

  1. Start your server.

  2. Let the Geyser-spigot and Floodgate folders generate in the plugins folder.

  1. Stop the server again.

  2. Go to the configuration files tab and find your assigned Geyser port in the _assigned-ports.txt file.

tip

if you are not sure where to find your _assigned-ports.txt file you can follow this guide

Main yml​

  1. Go to plugins/Geyser-spigot and edit the config.yml file. Copy the following values into your config.yml:
    • Uncomment the (remove the #) #address line and enter your server's address.

  • Set the port to the assigned port in _assigned-ports.txt.
  • Set clone-remote-port to true.
  • Configure the motd and server name according to your preferences.

Remote Section​

  • In the remote section, set the following:

    • address - to your server's IP address.
    • port - to your Minecraft server's assigned port.

    • Set auth-type to floodgate.

  • Specify the desired max-players number.

  1. Save and exit the config.yml file.

  2. Start your server.

You should now be able to join your Java and Bedrock server using the same port.

Last updated on