Knowledge Base

Minecraft servers typically run separately for Java Edition or Bedrock Edition. However, players now want to join the same server from both different versions. This is where GeyserMC comes in. Geyser is an open-source proxy plugin that allows Bedrock players to join Java servers.

In this guide, we explain what GeyserMC is, how to install it on different systems, and how to configure it step by step and with technical details. Also, common errors and their solutions are included.

What is GeyserMC? What Does It Do?

• Geyser is a Minecraft proxy software.

• It allows Bedrock players (mobile, console, Windows 10) to connect to a Java server.

• It works without interfering with the Java server. So your server.jar file does not change.

Installation Types

You can install GeyserMC in the following ways:

1. Standalone Mode: Works like a proxy. Runs separately from the Java server.

2. Plugin Mode: Integrated as a plugin into Spigot, PaperMC, or BungeeCord systems.

⚙️ System Requirements

• Java 17+ (Geyser now requires Java 17)

• Open 19132 UDP port (for Bedrock connections)

• screen or tmux for Linux servers (recommended for Standalone use)

️ 1. Installing GeyserMC Plugin on Spigot/PaperMC Server

1. Download the Geyser-Spigot.jar file from https://geysermc.org/download.

2. Place it in the plugins folder.

3. Start the server. plugins/Geyser-Spigot/config.yml will be created automatically.

4. Check the following settings:

bedrock:
  port: 19132
  address: 0.0.0.0
remote:
  address: 127.0.0.1
  port: 25565
  auth-type: floodgate

5. If you are going to use auth-type: floodgate, you also need to install the Floodgate plugin (explained below).

2. What is Floodgate? How to Use It with Geyser?

Floodgate allows Bedrock players to log in to the server without a premium Java account.

1. Download the Floodgate.jar file from https://geysermc.org/download as well.

2. Place it in the plugins folder.

3. Set the auth-type setting in Geyser config.yml to floodgate.

4. Edit the UUID and name options in Floodgate config.yml.

3. Standalone GeyserMC Installation (Proxy Mode)

1. Download the Geyser Standalone .jar file.

2. Run it in the terminal:

java -jar geyser-standalone.jar

3. Make the settings in the generated config.yml file:

bedrock:
  address: 0.0.0.0
  port: 19132
remote:
  address: java.sunucu.ip
  port: 25565
  auth-type: online

4. Make sure port 19132 is open as UDP.

Common Errors and Solutions

• Bedrock user cannot enter ➜ Is port 19132 UDP open? Check the firewall.

• Username already taken ➜ This error occurs if auth-type is floodgate but Floodgate is not installed.

• Join failed ➜ Minecraft versions may be incompatible. Is the Geyser version up to date?

Performance and Compatibility Notes

• There may be slight visual differences between Bedrock and Java (skin, movement, inventory).

• GeyserMC does not require high CPU performance, but UDP traffic control should be done well.

• If IP forwarding (Bungee/Paper) is enabled on the proxy server, careful configuration is required.

Conclusion

GeyserMC makes your Minecraft server much more accessible. By bringing mobile, console, and PC players together under one roof, it allows you to increase your player count. It is especially advantageous for community servers and minigame servers.

With correct installation and configuration, you can create a highly interactive system with low resources.