How to Welcome Bedrock Players with Geyser and Floodgate
Open your Minecraft Java server to Bedrock players with Geyser and Floodgate on Paper: installation, TCP and UDP ports, firewall, connection and troubleshooting.
On this page
Your values
Enter them once and the commands in this guide update.
Minecraft Java and Minecraft Bedrock (mobile, Windows, consoles) do not speak the same network language. This guide explains how to install two plugins on your Paper server so that Bedrock players can join it:
- Geyser translates the traffic between Bedrock and Java
- Floodgate lets Bedrock players join with their Microsoft account, without owning Minecraft Java
Prerequisites
- A Paper server, with the
mc-consolecommand set up in the Install and Update Plugins on Paper guide - Online mode kept in
server.properties:online-mode=true - Access to the server's firewall
- An up-to-date Minecraft Bedrock client for testing
Understanding the Ports
Bedrock now uses the NetherNet connection protocol, enabled by default in Geyser. It needs the same port number on both protocols:
| Port | Protocol | Usage |
|---|---|---|
| 19132 | TCP | Signaling: the client finds the server and prepares the connection |
| 19132 | UDP | Game traffic |
| 25565 | TCP | Java players, already open |
Open the Firewall
Use a single firewall tool, the one already active on your server.
With UFW
sudo ufw allow 19132/tcp
sudo ufw allow 19132/udp
sudo ufw reloadWith iptables
sudo iptables -A INPUT -p tcp --dport 19132 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 19132 -j ACCEPT
sudo iptables-save | sudo tee /etc/iptables/rules.v4Saving the rules across reboots requires the iptables-persistent package.
With nftables
These commands use the inet filter table and the input chain, present by default in /etc/nftables.conf on Debian.
sudo nft add rule inet filter input tcp dport 19132 accept
sudo nft add rule inet filter input udp dport 19132 accept
(echo "flush ruleset"; sudo nft list ruleset) | sudo tee /etc/nftables.confInstall Geyser and Floodgate
Download the versions for Paper and Spigot from the official service:
sudo -u minecraft bash
cd /opt/minecraft/server/plugins
curl -fL -o Geyser-Spigot.jar https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot
curl -fL -o floodgate-spigot.jar https://download.geysermc.org/v2/projects/floodgate/versions/latest/builds/latest/downloads/spigot
ls -l Geyser-Spigot.jar floodgate-spigot.jar
exitRestart the server to generate the configuration files, then wait for the Done line:
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -fExit the log view with Ctrl+C.
Configure Geyser
Open the configuration file:
sudo -u minecraft nano /opt/minecraft/server/plugins/Geyser-Spigot/config.ymlCheck the bedrock section, then set auth-type to floodgate in the java section. Edit the existing lines without duplicating them:
bedrock:
address: 0.0.0.0
port: 19132
transport: nethernet
java:
auth-type: floodgateYou can also customize the name shown to Bedrock players with server-name, in the gameplay section.
Restart the server to apply these changes:
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -fVerify the Result
Check that the plugins are loaded and that the server is listening on both protocols:
sudo mc-console plugins
sudo mc-console 'geyser version'
sudo MC_CONSOLE_WAIT=5 mc-console 'geyser nethernet'
sudo ss -tulpn | grep 19132You should see:
Geyser-Spigotandfloodgatein the plugin list- a
Built-in signaling started online in the startup logs - port
19132astcpandudpin thessoutput
Then test access from outside. The following command asks Geyser to check that your server is reachable:
sudo MC_CONSOLE_WAIT=15 mc-console 'geyser connectiontest SERVER_IP 19132'From another computer, you can also check the TCP port:
nc -vz SERVER_IP 19132Connect from Bedrock
In Minecraft Bedrock:
- Open Play, then the Servers tab
- Choose Add Server
- Enter a name, the address
SERVER_IPand the port19132 - Save, then join the server
On first connection, the game asks whether it should trust the server. This is normal when connecting through an IP address or without HTTPS. To remove this message, you can serve signaling over HTTPS with a domain name and a certificate.
Once in-game, check that the player is present:
sudo mc-console 'geyser list'Manage Bedrock Players
Usernames
Floodgate adds a dot in front of Bedrock usernames to avoid conflicts with Java accounts: Steve becomes .Steve. Spaces are replaced with _. These settings correspond to username-prefix and replace-spaces in plugins/floodgate/config.yml.
Whitelist
If white-list=true is active, add Bedrock players with the Floodgate command, without the dot:
sudo mc-console 'fwhitelist add Steve'Permissions with LuckPerms
By default, LuckPerms rejects usernames containing a dot. Allow them in its configuration file:
sudo -u minecraft nano /opt/minecraft/server/plugins/LuckPerms/config.ymlallow-invalid-usernames: trueRestart the server. Once the player has connected, you can place them in a rank using their full username:
sudo mc-console 'lp user .Steve parent add vip'Link a Java Account and a Bedrock Account
A player who owns both editions can link them by joining the link.geysermc.org server with each account and using /linkaccount. This global linking is enabled by default.
Update Geyser and Floodgate
Bedrock changes often, and a new version of the game can prevent players from connecting until Geyser is updated. Update it regularly:
sudo -u minecraft bash
mkdir -p /opt/minecraft/server/plugins/update
cd /opt/minecraft/server/plugins/update
curl -fL -o Geyser-Spigot.jar https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot
curl -fL -o floodgate-spigot.jar https://download.geysermc.org/v2/projects/floodgate/versions/latest/builds/latest/downloads/spigot
exit
sudo systemctl restart minecraft.serviceTroubleshooting
"Unable to connect to world" or server not found
- Check that the TCP and UDP ports are open with
sudo ufw status,sudo iptables -L INPUT -norsudo nft list ruleset - Check that the server is listening with
sudo ss -tulpn | grep 19132 - Run
geyser connectiontest SERVER_IP 19132from the console - Check the logs to see whether a connection attempt arrives. If nothing appears, the block is on the network
If the server's firewall is correct and the port remains unreachable from outside, contact support from your customer area to check that no network filtering applies.
"NetherNet will not start! Could not load its WebRTC native library"
Geyser could not load its network library, which it extracts to the temporary folder. Check that /tmp is not mounted with the noexec option and that it still has free space:
findmnt -no OPTIONS /tmp
df -h /tmpThe client stays stuck searching for the server ("Locating Server")
Lower the packet size in steps of 100 in plugins/Geyser-Spigot/config.yml, restarting and testing after each change:
advanced:
bedrock:
mtu: 1300The server advertises the wrong address
Geyser normally detects the public address on its own. If the server has several addresses, or if detection fails, specify the one players should use:
bedrock:
signaling:
advertise-addresses:
- SERVER_IP"Address already in use"
Another program is already using port 19132, often a second instance of Geyser. Identify it with sudo ss -tulpn | grep 19132.
"Auth-type set to Floodgate but Floodgate is not installed!"
Floodgate is missing or did not start. Check that floodgate-spigot.jar is in plugins, then look for its errors in the logs.
"Cannot reply to EncryptionRequestPacket without profile and access token"
Floodgate is not active, or auth-type is not set to floodgate. Check both points. If a copy of key.pem is in the Geyser folder, delete it.
"javax.crypto.AEADBadTagException: Tag mismatch!"
The Floodgate key is inconsistent. Stop the server, delete the plugins/floodgate folder and any key in plugins/Geyser-Spigot, then restart:
sudo systemctl stop minecraft.service
sudo rm -rf /opt/minecraft/server/plugins/floodgate
sudo rm -f /opt/minecraft/server/plugins/Geyser-Spigot/key.pem
sudo systemctl start minecraft.serviceIf you had changed the Floodgate configuration, you will need to redo those settings.
"Please connect through the official Geyser"
Geyser and Floodgate are not compatible with each other. Update both.
"Failed to verify username!"
In config/paper-global.yml, set perform-username-validation to false in the unsupported-settings section, then restart the server.
"Outdated client" or "Outdated server"
The Bedrock client and Geyser no longer match. Update Geyser, then the game. If your Java server is not on version 26.3, install ViaVersion.
To go further, see the official Geyser documentation and the Floodgate documentation.