How to Set Up a Hybrid Java-Bedrock Server with GeyserMC

GeyserMC is a free bridge that lets Minecraft: Bedrock Edition players (mobile, console, and Windows Bedrock) join your Minecraft: Java Edition server. Together with Floodgate, Bedrock players can join without needing a paid Java account.

This guide covers installing and configuring Geyser on Paper/Spigot, Fabric, NeoForge, or proxy software (Velocity/BungeeCord) using PloxPanel.

1. Download Geyser

1. Go to the official download page: https://geysermc.org/download
2. Select the correct build for your software:
   • Paper / Spigot / Purpur → Geyser-Spigot
   • Fabric → Geyser-Fabric (requires Fabric API)
   • NeoForge → Geyser-NeoForge
   • Velocity / BungeeCord → Geyser-Velocity or Geyser-Bungee

2. Install Geyser on Your Server

• Paper / Spigot / Purpur: Place the Geyser-Spigot.jar in the /plugins/ folder.
• Fabric / NeoForge: Place the corresponding jar in the /mods/ folder.
• Velocity / BungeeCord: Place the jar in the proxy’s /plugins/ folder.

3. Restart Your Server

Restart the server (or proxy) so Geyser can generate its configuration files.

4. Create a New Port Allocation in PloxPanel

Bedrock Edition uses UDP. You need a dedicated port for Geyser.

1. In PloxPanel, go to Network.
2. Click Create Allocation.
3. Note the new port that is assigned to your server. You will use this port in the Geyser config.

5. Configure Geyser

Open the correct config file depending on your software:

• Paper / Spigot: /plugins/Geyser-Spigot/config.yml
• Fabric: /mods/Geyser-Fabric/config.yml (or config/Geyser-Fabric/config.yml)
• NeoForge: /mods/Geyser-NeoForge/config.yml
• Velocity / BungeeCord: /plugins/Geyser-Velocity/config.yml or /plugins/Geyser-Bungee/config.yml

Find the bedrock: section and update it:

bedrock:
  # The IP address that will listen for connections.
  # Generally, you should only change this if you want to limit what IPs can connect to your server.
  address: 0.0.0.0
  # The port that Geyser will listen on for incoming Bedrock connections.
  # Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic.
  port: 19132          # ← Change this to the port you created in PloxPanel
  # Some hosting services change your Java port every time you start the server
  # and require the same port to be used for Bedrock.
  # This option makes the Bedrock port the same as the Java port every time you start the server.
  clone-remote-port: false

After editing, save the file and restart the server.

6. Install and Configure Floodgate (Strongly Recommended)

Why use Floodgate?

• Allows Bedrock players to join without owning a Java Edition account.
• Authenticates players via their Microsoft/Xbox account.
• Provides proper Bedrock skins for Java players.
• Exposes a useful API for other plugins.
• Prevents username conflicts by adding a configurable prefix (default: .).

How to install Floodgate:

1. Download Floodgate from https://geysermc.org/download/?project=floodgate (choose the matching platform: Spigot, Fabric, Velocity, etc.).
2. Place the jar in the same plugins/ or mods/ folder as Geyser.
3. Restart the server to generate Floodgate’s config.
4. Open Geyser’s config.yml and set:
   
   

   auth-type: floodgate

   
   (This is usually under the remote: or java: section depending on your Geyser version.)
   
   
5. Restart the server again.

Full official instructions: https://geysermc.org/wiki/floodgate/setup/

7. Connecting from Bedrock

Bedrock players should add a server using:

• Address: Your server IP or domain
• Port: The port you set in the Geyser bedrock: section

Java players continue to connect normally using the original Java port.

If Bedrock players still cannot connect, run geyser connectiontest <your-ip> <bedrock-port> in the console for diagnostics, or contact support with the results.