Geyser is a plugin which allows Bedrock clients to join your Java server. This guide walks you through setting it up on your Modrinth server.
Getting started
In order to get Geyser working, you'll need to have:
The latest version of Geyser installed on your version of Minecraft
A mod or plugin loader setup on your server
If you're currently using vanilla Minecraft, you can switch to a compatible platform by going into Options -> Platform on the server panel. If you're unsure which platform to use, Fabric is a good choice, and won't change vanilla Minecraft by default.
Installing Geyser onto your server
⚠️ Ensure your server is offline and keep it offline for the duration of this guide.
On your server's dashboard, click the Content tab
Click Add mod or Add plugin
Search for 'geyser' and click Install
Creating a new allocation
For Bedrock players to connect, you'll need to create a new allocation:
On your server's dashboard, navigate to Options -> Network, and scroll down to Allocations
Click 'New allocation' and name it whatever you'd like, then click 'Create allocation'
Once created, find and remember the allocation's port number (e.g. 26024)
Configuring Geyser
We now need to configure Geyser to use the new allocation we just created:
Start then stop your server to generate the configuration
Navigate to the Files tab, then to the 'plugins' folder if you're using Paper or Purpur, or to the 'config' folder if you're using Fabric, Quilt, NeoForge, or Forge
Click into the Geyser-<loader> folder, then click the
config.yml
file to open the configurationFind the line, close to the top of the file, that starts with
port:
Replace the number that follows with the port number of the allocation you previously created. In my case, the new allocation's port number was 26024, meaning the edited line would beport=26024
Save the configuration by clicking the Save icon, then selecting Save
Ensuring Geyser is configured
Navigate to the Overview tab, then start the server
Once it's finished starting, you should see a line at the bottom of the console saying something similar to
Started Geyser on UDP port 26024
:
As long as the line contains your previously created allocation's port number, Geyser is installed and configured correctly! Join the server and you should see it working. 😄
If the port number is incorrect, stop your server and retry the 'Configuring Geyser' section of this guide.