> For the complete documentation index, see [llms.txt](https://hyleadstudios.gitbook.io/hyleadstudios-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hyleadstudios.gitbook.io/hyleadstudios-docs/crossplay.md).

# Crossplay

Hylead Setups are built for everyone. We provide native support for Bedrock players, allowing your community to connect from PC, Console, Mobile, and even Nintendo Switch.

### 📱 Bedrock Edition Support

* ✅ All-Inclusive: No extra charges or paid add-ons. Cross-play compatibility is a standard feature of our base package.

#### ⚙️ Setting Up Bedrock

Step 1: Download & install plugins

* [Geyser](https://download.geysermc.org/v2/projects/geyser/versions/latest/builds/latest/downloads/spigot) — Enables seamless cross-play for Bedrock users. 
* [Floodgate](https://download.geysermc.org/v2/projects/floodgate/versions/latest/builds/latest/downloads/spigot) — Bedrock Authentication. 
* [GeyserModelEngine](https://github.com/GeyserExtensionists/GeyserModelEngine/releases/download/latest/GeyserModelEngine-1.0.8.jar) —  Custom Models for Bedrock
* [GeyserUtils-Spigot](https://github.com/GeyserExtensionists/GeyserUtils/releases/download/latest/geyserutils-spigot-1.0-SNAPSHOT.jar) —  Custom Entity for Bedrock

> Deployment Simply drop the downloaded `.jar` files into your server's 📁 plugins/ folder and restart the server.

Step 2: You need to download and install the following Geyser extensions:

* [GeyserUtils-Geyser](https://github.com/GeyserExtensionists/GeyserUtils/releases/download/latest/geyserutils-geyser-1.0-SNAPSHOT.jar)
* [GeyserModelEngineExtension](https://github.com/GeyserExtensionists/GeyserModelEngine/releases/download/latest/GeyserModelEngineExtension-1.0.8.jar)
* [GeyserDisplayEntity](https://github.com/GeyserExtensionists/GeyserDisplayEntity/releases/download/latest/GeyserDisplayEntity-1.0.10.jar)

> Install it on: 📁 plugins\Geyser-Spigot\extensions

* Port Forwarding: Ensure you have an extra open port dedicated to Bedrock connections.
* Configuration: Assign that port in your `📁 plugins/Geyser-Spigot/config.yml`.

> (We recommend enabling port 19132 or a similar one and setting clone-remote-port: to false)

```
bedrock:
  # The IP address that Geyser will bind on to listen for incoming Bedrock connections.
  # Generally, you should only change this if you want to limit what IPs can connect to your server.
  address: 0.0.0.0

  # The port that will Geyser will listen on for incoming Bedrock connections.
  # Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic.
  port: 19132

  # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock.
  # This option makes the Bedrock port the same as the Java port every time you start the server.
  clone-remote-port: true
```

#### 🛠️ Maintenance & Updates

⚡ Heads up! Bedrock updates much more frequently than Java. To keep your server accessible to mobile and console players, the Geyser plugin must be kept up-to-date.

* It is common to update Geyser multiple times a month—or even a week—to keep up with Mojang's releases.
* ⬇️ Stay Current: You can always download the latest build from the [Official Geyser Page](https://geysermc.org/download) or try this plugin <https://modrinth.com/plugin/geyserupdater?version=1.21#download>.

#### 🔁 Proxy Installation (Velocity / BungeeCord)

If you are running a network rather than a single server:

1. Remove `Geyser-Spigot.jar` from your individual server's `/plugins/` folder.
2. Move all files from your `📁 Geyser-Spigot/` folder into your proxy's plugin folder (`📁 Geyser-Velocity/` or `📁 Geyser-Bungee/`).
3. Floodgate Config: In your Floodgate configuration, ensure this setting is enabled: `send-floodgate-data: true`
4. Install [GeyserUtils-velocity.jar](https://github.com/GeyserExtensionists/GeyserUtils/releases/download/latest/geyserutils-velocity-1.0-SNAPSHOT.jar) into your proxy's plugin folder

***

#### ⚠️ Known Bedrock Limitations

Due to the technical differences between Java and Bedrock (Geyser limitations), a few specific features may not function for Bedrock players:

* Clickable links in chat.
* Custom Mob Riding
* Thirst Bar
* Distinguishing between left and right clicks in inventories
* Some custom enchantment.
* For a comprehensive list of technical gaps, please visit the [Geyser Wiki](https://geysermc.org/wiki/geyser/current-limitations/).