Skip to main content

GeyserMC and Floodgate - Configuration

General Information​

GeyserMC is a plugin that allows players using Minecraft: Bedrock Edition to join Java Edition servers. This solution lets you connect players from different platforms on a single server. The plugin acts as a bridge between the two versions of the game.

WARNING:

Before making any changes, create a backup of your server files.

Installing GeyserMC​

  1. Go to the official GeyserMC website and download the latest version of the plugin for your server core (e.g., Geyser-Spigot.jar for Spigot/Paper).

  2. Go to the plugins folder on your server and upload the downloaded .jar file there.

  3. If you want to allow players without a Java Edition account to play, download and install the FloodGate plugin the same way as GeyserMC.
    (If your server is non-premium)

  4. After uploading the files, restart the server so the plugins load and generate configuration files.

Configuring GeyserMC​

After the first startup, a config.yml file will appear in the plugins/Geyser-Spigot/ folder.

  1. Stop the server.

  2. Go to the Files tab.

  3. Find the plugins folder, then the Geyser-Spigot folder, and open the config.yml file.

  4. Bedrock section:

  • address: The IP address Geyser listens on. Default is 0.0.0.0 — do not change it.

  • port: The port on which Bedrock will connect to the server. Default is 19132. Change it to the port assigned to you, which you can find in the server panel.

  1. The final configuration should look like this:

  2. Save the file, go to the Console tab, and click START to launch the server.

Configuring Floodgate​

After the first startup, in the plugins/floodgate folder, find the key.pem file, download it to your computer, and upload it to the plugins/GeyserMC-Spigot folder to avoid issues.

  1. Stop the server.

  2. Go to the Files tab.

  3. Find the plugins folder, then the Geyser-Spigot folder, and open the config.yml file.

  4. Remote section:

  • address:
    The Java server address. If GeyserMC runs as a plugin, set this to auto.

  • port:
    The Java server port. If GeyserMC runs as a plugin, set this to auto.

  • auth-type:
    Authentication type:

    • online — requires a premium Java Edition account
    • offline — offline mode (e.g., non-premium servers)
    • floodgate — allows Bedrock players to join without a Java account (requires the Floodgate plugin)

    Recommended setting: floodgate.

  1. The final configuration should look like this:

  2. Save the file, go to the Console tab, and click START to launch the server.