What is GeyserMC?

GeyserMC (formerly known as DragonProxy) is a proxy for Minecraft that allows for Bedrock edition players to join Java/PC edition servers. DragonProxy was replaced with GeyserMC when the two teams united. This article covers the basics of GeyserMC.

GeyserMC cannot run worlds, players, etc.

Since GeyserMC is not Minecraft software and does not run any of the Minecraft code, worlds and players cannot actually exist on a GeyserMC instance. GeyserMC is not a Minecraft server — rather, it is a proxy that simply bridges the connection between the player and server. It pretends to be a Minecraft server, but it isn’t. It’s only purpose is to forward a Bedrock/MCPE edition player to the Java edition Minecraft server configured.

GeyserMC as a plugin

The easiest solution to using GeyserMC is to install it as a plugin on your already existing Java edition server. This means that you do not require a separate server for the proxy instance itself.

Note that this feature is not supported by DragonProxy.

Installation:

Download the GeyserMC plugin based on the server platform you are running: https://geysermc.org/download/

Install the GeyserMC plugin just like any other plugin. Guide: How to Install Plugins on a Minecraft Server

Restart your server to load the newly installed plugin.

We will now need to edit the GeyserMC configuration by navigating to Files > FTP File Access.



Enter your control panel password in the Multicraft Password textbox. Then, click Login.



Navigate to the plugins folder.



Open the GeyserMC-Spigot folder. This may be different based on the platform you've installed GeyserMC on.



Locate the config.yml file and click Edit.



Under the bedrock section of the GeyserMC config.yml file, change the following:
port: your server port
clone-remote-port: true

So, if your server address is 198.111.222.333:55555, the port should be set to 55555 (Guide: What is my server IP address and port?). Your GeyserMC config.yml file should look something like this:

The server used for this tutorial has a Minecraft Java dedicated IP so the port is set to 25565. You should use the port of your server.



Click Save and restart your server.



Once your server has successfully restarted, you may if GeyserMC is correctly installed by using the command geyser connectiontest IP:PORT in your server console. Replace IP with your server IP and PORT with your server port.

Standalone setup of GeyserMC

A standalone GeyserMC setup requires you to have a server for both the GeyserMC instance itself and the Java edition server you would like to connect the proxy to.

The requirements for a standalone setup are following:

One Minecraft Java edition server that you wish to connect to the proxy (this can be Vanilla, Spigot, Craftbukkit etc.).
An additional Minecraft server to run the GeyserMC software.

Installation:

Download (https://geysermc.org/) or select the preferred GeyserMC version from the Server Type list on Multicraft (to be added soon)
Start the server in order to generate the necessary configuration files
Stop the server and edit the file config.yml to include the remote (Java edition) server's IP and port. Here you can also modify options such as the GeyserMC server's MOTD, authentication type etc. You can learn more about the configuration file here: https://github.com/GeyserMC/Geyser/wiki/Understanding-the-Config

remote:
  # The IP of the remote (Java Edition) server
  address: my.ip.address.here
  # The port of the remote (Java Edition) server
  port: 25565
  # Authentication type. Can be offline, online, or floodgate 
  # (see https://github.com/GeyserMC/Geyser/wiki/Floodgate).
  auth-type: online

Save the configuration file and start the server. Your GeyserMC server should now operate as intended.

If you require any further assistance, please contact our support on our live chat.

Updated on: 07/27/2024