Floodgate

Floodgate is an add-on to Geyser (GeyserMC). It doesn't display anything by itself — it solves one thing that is very awkward to work around without it: how to identify on the server a player who came from Bedrock Edition (phone, console) and doesn't have a Java account.

Without Floodgate, Bedrock players have to register (typically via AuthMe), because the server doesn't know their account. They therefore have different names than in Java, causing confusion in permissions and statistics.

Floodgate solves this by assigning Bedrock players a name with a prefix (the default is a dot, another can be set). The server then recognizes that it's a Bedrock player and can treat that differently — different permissions, different restrictions, different verification.

Practical consequence: players with a dot at the beginning of their name are people from phone or console. Set permissions accordingly — for example, don't give them permissions that require keyboard shortcuts that Bedrock doesn't have.

Floodgate is installed in the same place as Geyser (usually on the proxy, if you use one) and must be in sync with Geyser's settings (auth-type). When settings diverge, players connect but are without an account and behave strangely.

Some plugins on the server don't recognize Bedrock players. Floodgate won't solve that — those plugins simply don't know about Bedrock. If you run into this, look for an alternative (menu instead of command, different verification).

1. First, install Geyser (Floodgate is pointless without it) — see the Geyser guide.
2. Download Floodgate from geysermc.org/download in the version matching your server type (proxy, or directly on the server).
3. Upload the .jar to the same place as Geyser (on the proxy, if you use a proxy) and restart the server.
4. Check the console: Floodgate must load and must be compatible with Geyser.
5. In the Geyser settings (plugins/Geyser-Spigot/config.yml), switch authentication to Floodgate (the item is called auth-type) and restart.
6. Test it on yourself: connect from your phone and check that you appear in the game with a name that starts with a dot.
7. Set permissions for Bedrock players according to what is actually possible from a phone — limit commands that require keyboard shortcuts.
8. Verify that Bedrock players are counted in the online player count and that they are visible in /list.
9. If a player connects from a phone but is without an account (has no permissions, doesn't appear in the tab list), check that Floodgate and Geyser are aligned (auth-type) and their versions.
10. Update Floodgate together with Geyser — mismatched versions cause the most common problems.

Floodgate and Geyser must have matching authentication settings (auth-type). When they fall out of sync, phone players connect, but without an account — they have no permissions, don't appear in the tab list, and it looks like a server error.
Bedrock players have a prefix in their name (default dot). Use it to set permissions and any restrictions — and keep in mind that regular Java names don't have a dot.
Some commands and features can't be used from a phone (keyboard shortcuts, part of the menu). It's worth offering Bedrock players a way without them — ideally via a menu.
Plugins that don't account for Bedrock won't recognize phone players. Floodgate won't solve that; look for an alternative approach.
Update Floodgate and Geyser together. Mismatched versions are the most common cause of connection problems.
If you have registration on the server (AuthMe), set it so it doesn't require Bedrock players to register twice — otherwise a phone player gets stuck at a registration they've already completed.