Configuring Floodgate 2.0 for Geyser Authentication

What is Floodgate?

Floodgate is a plugin for Geyser which allows Bedrock players to authenticate to Java servers without needing to purchase a Java Minecraft account.

Floodgate 2.0 is a major update which adds many new features to Floodgate 1.0. The most notable feature is the Global API.

Installation on a New Server

  1. Install Geyser using this guide
  2. After you have successfully installed Geyser, download Floodgate 2.0 and upload it to your plugins directory
  3. Edit the config.yml file in the /plugins/Geyser-Spigot directory to set your auth-type to floodgate:
    auth-type: floodgate

Migrating from Floodgate 1.0 to Floodgate 2.0

NOTE: Floodgate 1.0 and Floodgate 2.0 are not cross-compatible, and cannot be swapped out for each other.
  1. Stop your server
  2. Download the Geyser MC Floodgate 2.0 version and upload it to your plugins directory, replacing the original JAR
  3. Download the Floodgate 2.0 version and upload it to your plugins directory
  4. If you had floodgate-bukkit installed, delete the JAR and relevant folder
  5. Restart your server
  6. Review the new configuration file in /plugins/floodgate/config.yml
    • In particular, change the username-prefix from . back to * if you would like to keep the old prefix. Whatever you choose, you will not lose any player data as it will just act as a normal username change.

The Global API

The Global API is a service that links your Bedrock account between every Floodgate 2.0 server, making it easier than ever to use your Bedrock account on multiple, different servers.

Global Linking

Global Linking allows you to link your Java and Bedrock account once by connecting to a central server

NOTE: When your Java and Bedrock accounts are linked, your Bedrock playerdata (inventory, etc.) will be lost.
  1. Join with your Java account
  2. Join port 19132 with your Bedrock account
  3. Enter /linkaccount on your Java or Bedrock account
    A screenshot of the process
  4. Use the code received on your other account by entering /linkaccount <code>
  5. You should be kicked on both accounts, with a success message

Although Global Linking is enabled by default, it can be disabled on your server in the Floodgate configuration file:

# Configuration for player linking
# Whether to enable the linking system. Turning this off will prevent
# players from using the linking feature even if they are already linked.
enabled: false

Configuration File

Floodgate can be configured using the config.yml found in /plugins/floodgate-spigot/config.yml.

The common settings that you might want to change are:

username-prefix: "." # The prefix for unlinked Bedrock account usernames, e.g. a the 'Shockbyte' Bedrock account would be called '.Shockbyte'
replace-spaces: true # Whether spaces in usernames should be replaced with _
enabled: true # Whether Bedrock and Java accounts can be linked to share player data
require-link: false # Whether Bedrock clients must be linked to a Java account to join
If you require any further assistance, please contact our support at:

Mitchell Smith

Managing Director @ Shockbyte

  • bedrock, Bedrock edition, geyser, geysermc, Java Edition, floodgate, authentication, floodgate 2.0, bridge, proxy, plugins, mods
  • 22 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...