How to set up GeyserMC¶

Geyser lets Bedrock players join a Java server. For Bedrock logins without a premium Java account, Geyser is usually paired with Floodgate.

Requirements¶

• A Java server running Paper or Purpur.
• An additional UDP port for Bedrock connections.
• Access to the plugins folder.

Plugins you need¶

1. Geyser-Spigot
2. Floodgate-Spigot if you want Bedrock players to join without a premium Java account
3. ViaVersion if your Java server version does not match what Geyser recommends
4. ViaBackwards if you need support for older Java clients

Download from GeyserMC Download.

Step 1: Prepare the Bedrock port¶

1. Open https://panel.nexuscloud.id/.
2. Go to the Network tab.
3. Make sure you have an additional port you can use for Bedrock.
4. Note down:
5. the main Java port
6. the additional Bedrock port

Step 2: Upload the plugins¶

1. Go to Files.
2. Open the plugins folder.
3. Upload Geyser-Spigot.jar.
4. Upload Floodgate-Spigot.jar if needed.
5. Restart the server.

Step 3: Edit Geyser's config.yml¶

Open plugins/Geyser-Spigot/config.yml and adjust the following important sections:

bedrock:
  port: 19777
  clone-remote-port: false

remote:
  address: 0.0.0.0
  port: 25777
  auth-type: floodgate

Description:

• bedrock.port = the Bedrock port from the panel
• remote.port = the server's main Java port
• auth-type: floodgate is used when Floodgate is installed

If you are not using Floodgate, adjust auth-type to match the server mode you are using.

Step 4: Restart and test¶

1. Save the config file.
2. Restart the server.
3. Run the following command in the console to test the connection, as documented by Geyser:

geyser connectiontest <ip> <port>

Important notes¶

• Geyser is a protocol translator, so some Java features cannot be translated perfectly to Bedrock.
• The official Geyser documentation also notes certain limitations, such as some UI behaviours, clickable links, and Java-specific features.

How to join¶

• Java players: use the main Java host and port.
• Bedrock players: use the server host and the Bedrock port from your Geyser configuration.

Cheers, Team NexusCloud