GeyserMC Setup Guide - Join Java Servers from Bedrock

Minecraft Guide • Updated Jan 16, 2026

GeyserMC: Crossplay Made Simple

GeyserMC is a proxy that bridges the gap between Minecraft: Java Edition and Minecraft: Bedrock Edition (Mobile, Console, Windows 10). It allows Bedrock players to join Java servers.

Prerequisites

A Java Edition Server (Paper, Spigot, or Fabric). Vanilla is not supported.
An extra open UDP port (usually 19132).
Geyser-Spigot.jar or Geyser-Fabric.jar.
Floodgate.jar (Allows joining without a Java account).

Installation Steps

1. Install the Plugin

Upload Geyser-Spigot.jar and Floodgate-Spigot.jar to your server's /plugins/ folder.

Restart the server to generate config files.

2. Configure the Port

Open plugins/Geyser-Spigot/config.yml.

Find the bedrock section:

bedrock:
  address: 0.0.0.0
  port: 19132         # Change this to your allocated UDP port
  clone-remote-port: false
        

3. Configure Remote Address

In the remote section of the same config, ensure the address and port match your Java Server's IP and Port.

remote:
  address: 127.0.0.1
  port: 25565         # Your Main Java Port
  auth-type: floodgate
        

4. Restart

Restart the server. You should see "Geyser started on port..." in the console.

How to Connect (Bedrock Players)

Bedrock players (phones, consoles) should add a new server:

Server Name: Any Name
Server Address: Your Server IP
Port: The Geyser UDP Port (e.g. 19132), NOT the 25565 port.

Common Issues

"Unable to Connect to World": This usually means the UDP port is blocked by a firewall or not forwarded properly.

"Invalid Signature": Ensure enforce-secure-profile is set to false in server.properties if you are having issues with chat signing.

← Back to Minecraft Guides

Menu