Skip to main content
GeyserMC is a free plugin that lets Minecraft Bedrock Edition players (phones, tablets, Windows and consoles) join a Java Edition server. On a FREAKHOSTING Paper server, install Geyser and Floodgate from the Plugins page, ask us for an extra port, set that port in Geyser’s config.yml and set auth-type to floodgate. Bedrock players then join with your IP and the extra port, without a Java account.

Before you start

  • Your server runs Paper or a Paper fork such as Purpur. If not, switch with Version Changer. See Paper vs Fabric vs Forge.
  • Geyser needs its own port. It can’t share your Java port. Open a ticket and ask for an extra port for Geyser. We tell you the number when it’s added.
  • Geyser supports the newest Java Edition version. If your server runs an older version, also install ViaVersion. See ViaVersion.
  • Make a backup.

What do Geyser and Floodgate do?


How to install Geyser and Floodgate

1

Install Geyser

Click Plugins, search for Geyser and install the version for your server.
Plugins page Browse tab in the FREAKHOSTING Game Panel with filters and a search box, used to find the GeyserMC plugin

Search the Plugins page for Geyser

2

Install Floodgate

Search for Floodgate and install it the same way.
3

Restart once

Restart the server so both plugins create their config files.

How to configure Geyser

1

Stop the server

Click Stop.
2

Open the config

In Files, open plugins/Geyser-Spigot/config.yml.
3

Set the Bedrock port

Under bedrock:, set port: to the extra port we gave you:
Use your own port number. 19133 is only an example. Geyser’s default is 19132.
4

Use Floodgate for logins

Find auth-type and set it to floodgate:
5

Save and start

Click Save Content, then Start. The console shows Geyser starting on your Bedrock port.
Geyser’s config layout changes between releases, and newer releases add network settings such as transport. Leave settings you don’t know at their defaults. If you can’t find a key, search the file for it, or check the GeyserMC setup guide.

Floodgate settings

Floodgate’s config is plugins/floodgate/config.yml. Bedrock players’ names get a prefix (set by username-prefix) so they never clash with Java names.
Never share Floodgate’s key.pem. Anyone with it can pretend to be any Bedrock player on your server.
To whitelist a Bedrock player, use fwhitelist add <name> in the console.

How do Bedrock players join?

Windows, phones and tablets

1

Open Servers

In Minecraft Bedrock, click Play, open the Servers tab and click Add Server.
2

Enter the details

Enter a name, your server’s IP without the port in Server Address (for example 203.0.113.10), and the extra Geyser port in Port.
3

Join

Save, then select the server.

Xbox, PlayStation and Switch

Consoles only show featured servers and can’t add a custom server directly. Players use third-party workarounds such as the BedrockTogether phone app or a BedrockConnect DNS server. Follow their own instructions.

Frequently asked questions

What port does GeyserMC use?

Geyser’s default is 19132. On our servers you use the extra port we add for you, because each port belongs to one server. Geyser uses it for both TCP and UDP.

Do Bedrock players need a Java account?

No, not with Floodgate installed and auth-type: floodgate. They sign in with their Microsoft account.

Does Geyser work on Fabric or NeoForge?

Geyser has versions for some mod loaders, installed from the Mods page. The steps differ, so follow the GeyserMC setup guide for your loader. For the simplest setup, use Paper.

Why do Bedrock players get “Unable to connect to world”?

Check that port: in Geyser’s config matches the extra port, that you restarted, and that players entered the IP and port in separate fields. Look in the console for Geyser errors at start-up.

Why do some items or menus look wrong on Bedrock?

Bedrock and Java differ in a few ways. Some custom items and inventory menus don’t translate perfectly. That’s a Geyser limitation, not a server problem.

Bedrock players see “Outdated client” or “Outdated server”. What now?

Bedrock players should update Minecraft, and you should update Geyser on Plugins > Installed > Check for updates. New Bedrock releases need a Geyser update.

Minecraft server guide

Every Minecraft guide in one place.

Install plugins

How the Plugins page works.

ViaVersion

Needed when your server isn’t on the newest version.

Set up a whitelist

Control who can join.

Can't connect

Fix connection problems.
Checked against the official GeyserMC documentation on 29 October 2026, and the plugin install tested on our Game Panel (Minecraft 26.1, Paper and Fabric). Steps may differ slightly if Geyser changes.

Need Extra Help?

If you encounter any issues, our support team is ready to assist:

Save on Your Hosting

Ready to upgrade your hosting? Use code KB20 at checkout for 20% off your first order!

Last Updated: October 2026