Setup Geyser on a Spigot Server

Geyser allows you to connect to a Java based Minecraft server using a Bedrock edition of Minecraft. Find more information at the Geyser website.

This article assumes you have already installed a Spigot Minecraft server and started it at least once.

Install Geyser to your Server

1. Login to your server's SFTP.
2. Upload the Geyser plugin you downloaded from the above website to the server's plugins folder.
3. Start the server at least once to create the config files for Geyser, then stop the server.

Once installed and the files have been generated, you will now need to setup Geyser's config. It is recommended the server is set up for NetherNet.

Set up Geyser using NetherNet

Geyser will need to be set up for Bedrock connections. NetherNet is the recommended option for all servers.

Open the Port using Port Forwarding

1. Login to the Server Dashboard.
2. Click on the server you want to edit.
3. Click on Port Forwarding on the left of the server manager and create two ports with the following information:
   1. Port Type: Other
      Original Port: 19132
      Port Range: 0
      Protocol: TCP
      One to One: Checked
   2. Port Type: Other
      Original Port: 19132
      Port Range: 0
      Protocol: UDP
      One to One: Checked
4. Make note of the port that is created. Both ports should have a matching number - if these two ports do not match, make sure all port settings have been correctly selected. You will need this port for the Geyser config, as well as for players connecting to the server via Bedrock.

Edit the Geyser config

1. Click on the Files tab, then navigate to the /spigot/plugins/Geyser-Spigot folder.
2. Click on config.yml to edit it.
3. Change the following config settings:
   1. port - Change this to the port you created in Port Forwarding.
   2. transport - Set this to nethernet.
4. Set your server to offline mode in your server.properties.
5. Start your server.

Set up Geyser using RakNet

RakNet is a legacy option for setting up connections for Bedrock players. As this is a legacy option, this option is not recommended.

Open the Port using Port Forwarding

1. Login to the Server Dashboard.
2. Click on the server you want to edit.
3. Click on Port Forwarding on the left of the server manager and forward a port with the following information:
   Port Type: Other
   Original Port: 19132
   Port Range: 0
   Protocol: UDP
   One to One: Checked
4. Make note of the port that is created. You will need this port for the Geyser config, as well as for players connecting to the server via Bedrock.

Edit the Geyser config

1. Click on the Files tab, then navigate to the /spigot/plugins/Geyser-Spigot folder.
2. Click on config.yml to edit it.
3. Change the following config settings:
   1. port - Change this to the port you created in Port Forwarding.
   2. transport - Set this to raknet.
4. Set your server to offline mode in your server.properties.
5. Start your server.

Connect to your Server via Bedrock Edition

When you connect with a Bedrock edition of Minecraft, make sure to use the IP address of your server as listed at the top of Command Center, but use the port you just added to the config file. You'll also need a Java Edition account to connect to the server.

Note that players connecting through Java Edition can use the server address without the Geyser port.

1. Start Minecraft: Bedrock Edition.
2. Click Play, then click on the Servers tab.
3. Click Add Server, then fill in the following details:
   1. Server name - The name for your server. This can be anything as long as it is easily identifiable for you.
   2. Server address - The address of the Geyser server. This can be the friendly address, or the IP address without the Port number
   3. Port - Set this to the port that was created in the previous Port Forwarding steps.
4. Join your server. You may be prompted to log into your Java Edition account on successful connection.

Setup Floodgate with Geyser

When connecting to a server with Geyser installed, all players will need to have a copy of Java Edition for authentication. Some Bedrock Edition players may not have a copy of Java Edition, which can make it difficult to log in.

Floodgate is an additional plugin that can be installed alongside Geyser. It can be used to allow Bedrock Edition players on the server without needing a Java Edition account. All you need is the Floodgate plugin.

1. Download the Floodgate plugin from the Geyser website.
2. Login to your server's SFTP.
3. Copy the Floodgate plugin into the server's plugins folder.
4. Open the Geyser-Spigot folder, then open the config.yml file
   1. If you have not got the config for Geyser setup yet, make sure to run the server once to generate the config.
5. Change the auth-type setting to floodgate.
6. Start the server.

You should now be able to have any Bedrock Edition players join the server. By default, any Bedrock player connecting to the server will have a . prepended to their username. This is set by the Floodgate config, and it is recommended that a prefix is set up and that the prefix does not contain letters and numbers to prevent any username configs.