GeyserMC is a revolutionary translator plugin that allows players using Minecraft: Bedrock Edition (iOS, Android, Xbox, PlayStation, Switch) to join your Minecraft: Java Edition server. This enables seamless cross-platform play for your gaming community. In this guide, we will walk you through installing Geyser Spigot, configuring ports, and validating connections.
Step-by-Step Geyser Installation Guide
Follow these simple steps to install and set up Geyser on your Spigot or Paper server:
Download the Plugin
Download the latest Geyser-Spigot plugin file from the official GeyserMC download page.
Upload and Restart Server
Place the downloaded Geyser-Spigot.jar file into the plugins folder inside your server directory via the Pterodactyl File Manager. Once uploaded, restart your server to generate the configuration files.
Configure Bedrock Settings
Open your Geyser configuration file, located in /plugins/Geyser-Spigot/config.yml. Find the following block of code:
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
# Some hosting services change your Java port everytime 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: falseUnderstand the Port Settings
The vital part is the port. This is the port that Bedrock players will use to connect to your server. Follow the instructions provided by your host—change the port, and if necessary, adjust clone-remote-port and address.
Important: If clone-remote-port is set to true, Geyser will overwrite the bedrock port with your server's default Java port on startup!
Verify Connection
Once configured and saved, restart the server. Verify whether Bedrock connections are possible by running:
geyser connectiontest <ip> <port>
in your server console.
⚠️ CRITICAL: UDP Port Restrictions Minecraft Bedrock uses UDP protocols. Therefore, any other services or plugins running on your server that rely on UDP ports (such as proximity Voice Chats, SimpleVoiceChat, or query protocols) cannot share the same port as Geyser. Ensure Geyser's port has its own dedicated allocation.
Allow Offline/Cracked Bedrock Players
By default, Geyser requires Bedrock players to log in with a paid Java edition account to link and play. To allow Bedrock Edition players to join your server without needing to log in to a paid Java Edition account, you can install the **Floodgate** plugin alongside Geyser.
Floodgate automatically generates hybrid offline profiles for Bedrock players, letting them connect directly using their Xbox Live gamertags with no Java login required!