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:
    remote:
        
    ...
    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 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
    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
    
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
...
If you require any further assistance, please contact our support at: https://shockbyte.com/billing/submitticket.php

Mitchell Smith

Managing Director @ Shockbyte

  • bedrock, Bedrock edition, geyser, geysermc, Java Edition, floodgate, authentication, floodgate 2.0, bridge, proxy
  • 11 Users Found This Useful
Was this answer helpful?

Related Articles

Customize Your Server Icon

We have a video tutorial on how to add an icon to your server:   A server icon is an image...

How To Change The Mob Spawn Rate On Your Server

This guide will explain how to increase the mob spawn rates in Minecraft. Please note that to use...

How to Change Your Minecraft Skin

Changing your Minecraft skin is a fun way to breath a little life into your Minecraft experience...

How to Convert Worlds from Spigot to Vanilla

This guide is for converting worlds from Spigot to Vanilla. If you're looking to convert your...

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...