Are you interested in running a cross-platform play Minecraft server and want both Java and Bedrock players to join the fun? GeyserMC lets you bridge the gap between Minecraft: Java Edition and Minecraft: Bedrock Edition, so PC/Java gamers and mobile/console Bedrock users can team up on the same world. In this guide, we’ll walk you through how to install GeyserMC on your Minecraft server, outline the key benefits, share configuration tips, and highlight a few things to be aware of.

What Is GeyserMC & Why Use It?

GeyserMC is an open-source proxy that translates network packets between a Java Edition and Bedrock Edition server. In simple terms, it makes a Minecraft Java server speak “Bedrock language” so Bedrock clients can connect.

Why it’s so popular:

  • Cross-platform play: Java + Bedrock players on a single server
  • One community, one world: No need to manage separate Java and Bedrock servers
  • Flexible setup: Works with Paper, Spigot, Fabric and other server types

If you want to grow your community and invite players from phones, consoles, and Windows Bedrock to your existing Java world, GeyserMC is the way to go.

GeyserMC Requirements For Your Minecraft Server

Before installing GeyserMC, double-check that your server is running a compatible version and platform. GeyserMC works with popular server types like Paper, Spigot, Fabric and more, so make sure you’ve already set up the correct one for your needs.

In other words:

  • Make sure your server is already running a supported Java server type (Paper, Spigot, or Fabric are the most common with GeyserMC).
  • Confirm it’s on a modern version of Minecraft that GeyserMC currently supports.
  • If you’re using Fabric, ensure Fabric Loader (and usually Fabric API) is already installed and working.

Once that’s done, you’re ready to install GeyserMC.

Installing GeyserMC And Floodgate On Your Minecraft Server (Spigot-Geyser)

Step 1: Stop Your Server

Always stop the server before adding or changing plugins. This prevents file corruption and ensures new configs generate correctly.

Step 2: Download GeyserMC and Floodgate

  1. Download the latest GeyserMC version for Spigot/Paper.
  2. Download the latest Floodgate version for Spigot/Paper (optional but recommended if you want Bedrock players to join without owning Java).

Step 3: Upload The Plugins

  1. Open your server files (via your panel’s File Manager or Use SFTP).
  2. Navigate to the /plugins/ folder.
  3. Upload both Geyser and Floodgate jar files into this folder.

Step 4: Start The Server To Generate Configs

Start the server once. GeyserMC and Floodgate will create their own folders and configuration files.

After it’s fully started, stop the server again so you can edit the configs safely.

Step 5: Configure GeyserMC (Ports & IP)

  1. Go to /plugins/Geyser-Spigot/ and open config.yml.
  2. In the bedrock: section, set:

port: – to a free port that will be used for Bedrock connections (different from your Java port)

In the remote: section:

port: – your Java server port (commonly 25565).

💡 This plugin requires an empty port in order to set it up. Each Minecraft server we provide comes with 3 ports. If your game port is for example "25505", then the 2 other free ports will be +1 and +2. Example: "25506" and "25507".

Step 6: Disable Secure Profile (Newer Versions)

If you’re running a 1.19.1+ Minecraft server, open your server.properties file and set:

enforce-secure-profile=false

This is important to prevent connection issues for Floodgate/Bedrock players.

Step 7: Restart And Test

Start the server again.

  • Java players connect as usual:
    yourdomain.com:25565 (or your normal Java port)
  • Bedrock players use:
    • Server IP: same as Java
    • Port: the Bedrock port you configured in config.yml

If both can connect, your GeyserMC setup is working!

Fabric Geyser And Floodgate Installation (Geyser-Fabric)

If you’re running a Fabric Minecraft server instead of Paper/Spigot, GeyserMC can run as a mod.

Basic Outline

  1. Stop the server.
  2. Download the Geyser-Fabric and Floodgate-Fabric jars.
  3. Upload them into the /mods/ folder (along with Fabric API if required).
  4. Start the server once to generate configs.
  5. Edit the Geyser config (similar to the plugin version: configure bedrock port and remote address/port).
  6. Restart and test from both Java and Bedrock clients.

The logic is the same: one port for Java, a separate port for Bedrock, and Geyser sitting in-between to translate traffic.

Tips & Best Practices For GeyserMC

  • Keep everything updated – GeyserMC and Floodgate update frequently to match new Minecraft releases.
  • Expect minor differences – Bedrock and Java aren’t identical. Hitboxes, skins, and some features may behave slightly differently.
  • Test plugins with Bedrock players – Some Java plugins weren’t designed with Bedrock clients in mind; always test gameplay features.
  • Use Floodgate if you don’t want to require Java accounts – Otherwise, you can configure Geyser to use online mode where Bedrock players must sign in with a Java/Microsoft account.

Why Use Pine Hosting For Your GeyserMC Server?

If you want the easiest possible way to run a stable and smooth GeyserMC setup, Pine Hosting is an excellent choice. Our environment is optimized for GeyserMC Minecraft servers.

With Pine Hosting you get:

  • Powerful Hardware for Cross-Play
    GeyserMC adds a translation layer between Java and Bedrock, so strong CPU performance and fast NVMe storage make a big difference—especially with many players online.
  • Easy Port Management
    Pine Hosting provides multiple ports per server, making it straightforward to assign a separate Bedrock port for GeyserMC without confusing networking setups.
  • Simple File Manager & SFTP
    Uploading Geyser, Floodgate, and other plugins is quick and painless through their panel or SFTP access.
  • DDoS Protection & Reliable Network
    A stable network is crucial for Bedrock players on consoles and mobile devices. Pine Hosting protects your server from attacks so your players can stay online.
  • Friendly Support Team
    Stuck on config, ports, or Floodgate? Our support can walk you through the process and help troubleshoot issues with your GeyserMC setup.

If you’re serious about making your server accessible to everyone: Java, mobile, console, and Windows Bedrock, then pairing GeyserMC with Pine Hosting is a powerful combination to host a Minecraft server.