Skip to main content
Install Geyser as a plugin on a compatible Java server, start the server once to generate its files, then add a port and update the Geyser configuration.
This guide covers the normal plugin installation for compatible Java server software. Modded servers and proxy networks use different Geyser files and locations.

​
How cross-play works

Geyser accepts connections from Minecraft Bedrock Edition and translates them for the Java server. Java players continue using the normal Java address. Bedrock players use the server address and the port configured for Geyser. Geyser does not convert Java worlds, plugins, or mods into native Bedrock formats.

​
Before you begin

You need:
  • A running Purpify Minecraft Java server with plugin-compatible software
  • Access to the plugin installer or /plugins folder
  • Permission to add an allocation in the Purpify game panel
  • A server backup
Give Geyser its own allocation. Do not reuse a port assigned to another server feature.

​
Install and configure Geyser

1

Install Geyser

Use Purpify’s plugin installer to install Geyser. For a manual installation, download Geyser-Spigot.jar from GeyserMC and upload it to /plugins.
2

Start the server once

Start the server and wait until startup completes. Geyser creates its configuration files during this start.
3

Stop the server

Stop the server normally before editing the Geyser configuration.
4

Add a port

Go to Network in the server management view and select Add Allocation. Copy the new port number.
5

Open the configuration

Open /plugins/Geyser-Spigot/config.yml in the Purpify file manager.
6

Configure Geyser

Find the bedrock section. Paste the port from Network after port:.
Geyser config
For example, if Add Allocation gives you port 19150, change the line to port: 19150.
7

Start and test

Save the file and start the server. Check the console for Geyser errors, then connect from Bedrock using the server address and the configured port.
Cross-play works when Java players can connect normally and a Bedrock player can join through the Geyser port.

​
Add Floodgate

Floodgate lets Bedrock players join without signing in with a paid Java Edition account.
1

Install Floodgate

Download the Floodgate plugin for Spigot from GeyserMC, then upload the Floodgate .jar to /plugins.
2

Generate the Floodgate files

Start the server once, wait for startup to complete, then stop it.
3

Change Geyser authentication

Open /plugins/Geyser-Spigot/config.yml. Near the top of the file, find the java section directly below the bedrock section. Change auth-type from online to floodgate.
Geyser authentication
4

Restart and test

Start the server and connect with a Bedrock account.
Never share Floodgate’s key.pem file. Anyone with this key may be able to bypass the intended Java authentication path.

​
Test the Geyser port

Run this command in the server console with your public server address and configured Bedrock port:
The connection test helps determine whether the Geyser port is reachable from outside the server.

​
Troubleshoot cross-play

Confirm that the server is running, Geyser enabled successfully, and the Bedrock client uses the exact port from config.yml. Check that another service is not using the same allocation.
Go to Network and confirm that port contains the number created through Add Allocation. Check that clone-remote-port has not overwritten it. Copy the first relevant Geyser error from the console when contacting support.
Confirm that the Floodgate .jar is in /plugins. In /plugins/Geyser-Spigot/config.yml, find the top-level java section and set auth-type: floodgate, then restart the server.
Update Geyser and verify that the Java server version is supported. Some older Java server versions also require a compatible ViaVersion installation.
Geyser only supports server-side Java mods. Mods that require installation on the Java client cannot be translated for a Bedrock client.

​
Detailed video guide

Watch the complete walkthrough when you want to follow the setup visually.
Open the detailed Geyser video guide on YouTube For configuration details, see the official Geyser setup guide and official Floodgate setup guide.