EN

Game servers

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.

7 min read, updated on 18 November 2026

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-console command 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

Terminal
sudo ufw allow 19132/tcp
sudo ufw allow 19132/udp
sudo ufw reload

With iptables

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

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

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

Install Geyser and Floodgate

Download the versions for Paper and Spigot from the official service:

Terminal
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
exit

Restart the server to generate the configuration files, then wait for the Done line:

Terminal
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -f

Exit the log view with Ctrl+C.

Configure Geyser

Open the configuration file:

Terminal
sudo -u minecraft nano /opt/minecraft/server/plugins/Geyser-Spigot/config.yml

Check the bedrock section, then set auth-type to floodgate in the java section. Edit the existing lines without duplicating them:

YAML
bedrock:
  address: 0.0.0.0
  port: 19132
  transport: nethernet

java:
  auth-type: floodgate

You can also customize the name shown to Bedrock players with server-name, in the gameplay section.

Restart the server to apply these changes:

Terminal
sudo systemctl restart minecraft.service
sudo journalctl -u minecraft.service -f

Verify the Result

Check that the plugins are loaded and that the server is listening on both protocols:

Terminal
sudo mc-console plugins
sudo mc-console 'geyser version'
sudo MC_CONSOLE_WAIT=5 mc-console 'geyser nethernet'
sudo ss -tulpn | grep 19132

You should see:

  • Geyser-Spigot and floodgate in the plugin list
  • a Built-in signaling started on line in the startup logs
  • port 19132 as tcp and udp in the ss output

Then test access from outside. The following command asks Geyser to check that your server is reachable:

Terminal
sudo MC_CONSOLE_WAIT=15 mc-console 'geyser connectiontest SERVER_IP 19132'

From another computer, you can also check the TCP port:

Terminal
nc -vz SERVER_IP 19132

Connect from Bedrock

In Minecraft Bedrock:

  1. Open Play, then the Servers tab
  2. Choose Add Server
  3. Enter a name, the address SERVER_IP and the port 19132
  4. 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:

Terminal
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:

Terminal
sudo mc-console 'fwhitelist add Steve'

Permissions with LuckPerms

By default, LuckPerms rejects usernames containing a dot. Allow them in its configuration file:

Terminal
sudo -u minecraft nano /opt/minecraft/server/plugins/LuckPerms/config.yml
YAML
allow-invalid-usernames: true

Restart the server. Once the player has connected, you can place them in a rank using their full username:

Terminal
sudo mc-console 'lp user .Steve parent add vip'

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:

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

Troubleshooting

"Unable to connect to world" or server not found

  1. Check that the TCP and UDP ports are open with sudo ufw status, sudo iptables -L INPUT -n or sudo nft list ruleset
  2. Check that the server is listening with sudo ss -tulpn | grep 19132
  3. Run geyser connectiontest SERVER_IP 19132 from the console
  4. 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:

Terminal
findmnt -no OPTIONS /tmp
df -h /tmp

The 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:

YAML
advanced:
  bedrock:
    mtu: 1300

The 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:

YAML
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:

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

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