Geyser and Floodgate: let Bedrock players join your Java server

Geyser lets Minecraft Bedrock players (phone, Windows, console) join your Java server. Floodgate lets those players join without owning a Java account. Install both, give Geyser its own port, and Bedrock players connect using your server address and that port.

What you need

• A Java server running Paper, Purpur or another Paper/Spigot-family software. (Geyser also has Fabric, NeoForge and proxy versions; this guide covers the plugin.)

• One extra port from the Network tab. Geyser cannot share your Java port. Every plan includes at least 2 extra ports.

• Geyser follows the newest Minecraft version. If your server runs an older version, also install ViaVersion.

Step 1: Get an extra port

1. In the Game Panel, open your server and go to Network.

2. Click Create Allocation and note the new port number (for example 45570). Type what it is for in the Notes column. See How to add extra ports.

Step 2: Install Geyser and Floodgate

1. Open Plugins → Browse Plugins, set Plugin Loader to your server software (for example Paper), search for Geyser and click Install. If it doesn't show on one platform, try Modrinth or Hangar.

2. Search for Floodgate and click Install.

3. Start (or restart) the server once so both plugins create their config files, then Stop it.

If either plugin is not listed, download Geyser-Spigot and Floodgate-Spigot from the official site geysermc.org/download and upload them to the plugins folder.

Step 3: Set Geyser's port

1. Open Files and edit plugins/Geyser-Spigot/config.yml.

2. Find the bedrock: section and set port to your extra port. Leave address as 0.0.0.0.

3. If you see clone-remote-port, keep it false. Setting it to true would put Geyser on your Java port.

4. Find auth-type (under java: in new versions, remote: in older ones) and make sure it is floodgate.

5. Save the file and start the server.

bedrock:
  address: 0.0.0.0
  port: 45570

Use your own port number. In the Console, Geyser prints a message when it has started, including the port. If it shows an error about the port, check the number again.

Step 4: Join from Bedrock

1. In Bedrock, go to Play → Servers and add a server.

2. Server Address: your server's address without the port. Use the hostname from the panel header (for example in6.endercloud.in) or the Server IP shown on the Dashboard.

3. Port: your Geyser port, not the Java port.

Bedrock player names and Floodgate

• Floodgate adds a prefix to Bedrock names, a dot by default, so Steve on Bedrock becomes .Steve. Use that name with op, bans and LuckPerms. The prefix is set by username-prefix in Floodgate's config.

• Whitelist: new Endercloud servers have the whitelist on, so Bedrock players must be added too. Floodgate has its own command for them: fwhitelist add <name> (use their Bedrock gamertag).

Using a Velocity or BungeeCord proxy?

Install Geyser and Floodgate on the proxy only, and give the proxy server the extra port. If you also want Floodgate on the backend servers, set send-floodgate-data: true in the proxy's Floodgate config, install Floodgate on each backend, and copy key.pem from the proxy's Floodgate folder to every backend's Floodgate folder. Player forwarding must already work. See Velocity and BungeeCord proxy networks.

Frequently asked questions

Still stuck? Open a ticket with a screenshot of your Geyser config and console.