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
- Install Geyser using this guide
- On Step 1, download the Geyser MC Floodgate 2.0 version instead
- After you have successfully installed Geyser, download Floodgate 2.0 and upload it to your plugins directory
- Edit the
config.yml
file in the/plugins/Geyser-Spigot
directory to set yourauth-type
tofloodgate
:remote:
...
auth-type: floodgate
...
Migrating from Floodgate 1.0 to Floodgate 2.0
- Stop your server
- Download the Geyser MC Floodgate 2.0 version and upload it to your plugins directory, replacing the original JAR
- Download the Floodgate 2.0 version and upload it to your plugins directory
- If you had floodgate-bukkit installed, delete the JAR and relevant folder
- Restart your server
- 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.
- In particular, change the
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
- Join
link.geysermc.org
with your Java account - Join
link.geysermc.org
port19132
with your Bedrock account - Enter
/linkaccount
on your Java or Bedrock account - Use the code received on your other account by entering
/linkaccount <code>
- 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:
...If you require any further assistance, please contact our support at: https://shockbyte.com/billing/submitticket.php
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
...