Bedrock players on your Java server (Geyser)

Geyser is a proxy that translates Bedrock connections onto your Java server, so phone, console, and Windows Bedrock players join your Paper server without owning Java Edition. Floodgate is the companion plugin that lets them in without a Microsoft-linked Java account [3].

Requirements

• A plugin server: Paper, Purpur, or Spigot. This doesn't work on Vanilla. (Fabric and NeoForge have their own Geyser builds and the config lives at /config/Geyser-Fabric/config.yml instead, same idea [2].)

• A second port allocation on your Network tab, because Bedrock and Java use different ports by design. Bedrock traffic is also UDP, and your Java port is TCP, which is why you can't just reuse the main one [2].

1. Request the extra port (if you need one)

Check the Network tab for a spare allocation. Each allocation is listed with the node IP and a port. No spare one: open a ticket and we'll add one.

2. Install the jars

Download both from geysermc.org:

• Geyser (Spigot build)

• Floodgate

Upload both to /plugins (Files tab or SFTP). Restart. You should see both in /plugins output after boot, green.

3. Configure Geyser

Open plugins/Geyser-Spigot/config.yml and set three things [1][2]:

bedrock:
  address: 0.0.0.0
  port: <your extra allocation port>

Leave address at 0.0.0.0, set the port to the extra allocation from your Network tab, NOT the default 19132 (that port is taken or firewalled on a shared node; your assigned one is the one that's mapped).

Then set auth so Floodgate handles logins instead of requiring Java accounts [1][3]:

remote:
  auth-type: floodgate

Save. Restart the server.

4. How Bedrock players join

On Bedrock: Play → Servers tab → Add Server:

• Address: your node IP (same IP as the Network tab shows, e.g. 65.87.223.68)

• Port: the Geyser port you set in the config

What to know after

• Bedrock usernames appear in game with a prefix, by default a dot, like .Steve [3]. Keep that in mind when giving OP or setting permissions; you need the prefix in the name.

• Console players (Xbox, PlayStation, Switch) can't type a custom IP directly. They join through workarounds like BedrockTogether or a LAN proxy app. That's a Bedrock limitation, not something on your end.

• Custom domains: Bedrock ignores SRV records, so play.yourdomain.com from the domains guide only works for Java. Bedrock players still need IP:port literally.

• Geyser updates when Minecraft updates. If Bedrock players suddenly can't join after a game update, update the Geyser and Floodgate jars first before touching anything else.