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
   • On Step 1, download the Geyser MC Floodgate 2.0 version instead
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:

   remote:
       
       ...
       
       auth-type: floodgate
       
       ...
   

Migrating from Floodgate 1.0 to Floodgate 2.0

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

1. Join link.geysermc.org with your Java account
2. Join link.geysermc.org port 19132 with your Bedrock account
3. Enter /linkaccount on your Java or Bedrock account
   
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
    
player-link:
    
    # 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 _
    
 ...
    
player-link:
    
    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
    
    ...