How to configure GeyserMC to allow Bedrock Clients to join Java servers

Enable Bedrock players to join your Java Minecraft server with GeyserMC! It is the perfect bridge for cross-platform gameplay, allowing you to expand your player community across all devices.

GeyserMC is a powerful network protocol translator that allows Minecraft Bedrock Edition players (on Windows 10/11, mobile, and consoles) to join Java Edition servers without needing to purchase the Java version. It translates all necessary data between the two versions in real-time, creating a seamless cross-platform experience.

Step 1: Installing the GeyserMC Plugin

For most standard servers running Paper, Purpur, or Spigot, the plugin installation method is highly recommended.

1. Download the appropriate GeyserMC plugin from the official GeyserMC download page. You will want to grab the Geyser-Spigot version for standard Bukkit-based servers.
2. Log into your MintServers panel and navigate to the Files tab.
3. Open your plugins folder.
4. Click Upload and select the GeyserMC JAR file you just downloaded.
5. Navigate back to the Console and Start your server. This will generate the necessary configuration files!

Step 2: Allocating a Bedrock Port

Java Edition and Bedrock Edition use different network protocols. To allow Bedrock players to connect simultaneously, GeyserMC needs its own dedicated port on your server.

1. On your MintServers panel, navigate to the Network tab on the left sidebar.

2. Click the blue Create Allocation button on the right side of the screen.

3. A new port will appear in your network list. Copy this new port number, as you will need it for the next step!

Step 3: Configuring the Bedrock Port

Now we need to tell the GeyserMC plugin to listen to the new port you just created.

1. Stop your server.
2. Navigate to the Files tab and open the plugins folder, then open the Geyser-Spigot folder.
3. Click on the config.yml file to open the text editor.
4. Scroll down to the bedrock section and find the port setting (the default is 19132). Replace it with your newly allocated port number!

bedrock:
  # The IP address that will listen for connections
  address: 0.0.0.0
  # The port that will listen for connections
  port: YOUR_NEW_PORT_HERE
  # Whether to clone the expected port from the Java server
  clone-remote-port: false

Step 4: Authentication Setup (Floodgate)

By default, Geyser requires Bedrock players to log in with an official Java Edition account. To allow Bedrock players without Java accounts to join, you must install the Floodgate plugin.

1. Download the Floodgate plugin from the official Geyser website.
2. Upload the Floodgate JAR file into your plugins folder, right alongside GeyserMC.
3. Open your GeyserMC config.yml file again.
4. Scroll down to the remote section and change the auth-type from online to floodgate.

# Network settings for the Java server connection
java:
  # What type of authentication Bedrock players will be checked against when logging into the Java server.
  # Can be "floodgate" (see https://wiki.geysermc.org/floodgate/), "online", or "offline".
  auth-type: floodgate

5. Click Save Content at the top right of the editor, then Start your server.

With GeyserMC properly configured, your Minecraft server will become truly inclusive, allowing friends to play together regardless of which device they own. If you run into any trouble getting your Bedrock connection established, no worries! Just open a support ticket and our team will gladly jump in and get it sorted out together.