---
title: "How to set up GeyserMC"
icon: lucide/shuffle
description: "How to set up the Geyser and Floodgate plugins for Java and Bedrock crossplay, plus UDP port configuration."
---

# 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.

!!! info "Server version"
    The Geyser documentation recommends that your Java server version follow the version Geyser supports. If your server version does not match the Geyser target version, you may need to install **ViaVersion**. **ViaBackwards** is optional and only needed for compatibility with older clients.

## 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](https://geysermc.org/download).

## 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:
   - The main Java port
   - The additional Bedrock port

!!! warning "UDP"
    Geyser uses **UDP** for Bedrock connections. This port must not clash with other UDP services such as voice chat.

## 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.

## Edit Geyser's `config.yml`

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

```yaml
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.

## 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:

```text
geyser connectiontest <ip> <port>
```

## 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.

---

!!! tip "Help us out"
    If you found this tutorial useful, please leave a review on [Trustpilot](https://www.trustpilot.com/evaluate/nexuscloud.id)! Your rating helps us make more useful guides :sparkles:

**Cheers, Team NexusCloud**

---