How to Enable Minecraft Crossplay with GeyserMC

Introduction to GeyserMC

GeyserMC is a plugin that allows crossplay between Java and Bedrock players on your Minecraft server. It can be installed as a plugin or mod, or as a proxy. For easy installation, it's recommended to set up GeyserMC as a plugin or mod instead of a proxy.

Important Considerations

Crossplay is best suited for vanilla servers, or servers that only have utility mods or plugins. Bedrock users have limited functionality with custom content as the server will be Java-based.

Supported Bedrock Clients

The following Bedrock platforms are supported:

• PC (Windows 10 Edition)
• Mobile Devices (iOS, Android & Windows)
• Kindle Fire
• Fire TV
• Gear VR/Oculus VR
• Nintendo Switch (With further configuration)
• Xbox 360/One (With further configuration) Unfortunately, due to platform limitations, PlayStation 4 and 5 users cannot connect to GeyserMC servers without requiring further modification of the device.

Downloading GeyserMC, Floodgate, and ViaVersion

To use GeyserMC, download the following files based on your server type:

• GeyserMC
• Floodgate
• ViaVersion Certain versions or server types may require more than one ViaVersion mod or plugin to be installed. For example, when using the latest version of Minecraft with PaperMC, both ViaVersion and ViaBackwards are needed to ensure proper version compatibility for Bedrock.

Installing GeyserMC on Your Server

To install GeyserMC, follow these steps:

1. Open your Server Control Panel.
2. Stop the server and wait for it to go Offline.
3. Navigate to the Files and open the /plugins folder. If using a modded server type, open the /mods folder instead.
4. Upload your GeyserMC, Floodgate, and ViaVersion files to the folder.
5. Start your server. If using Floodgate, Global linking and Whitelisting can be configured further by referring to our article on the topic.

Testing Your Bedrock Connection

To test your Bedrock connection, type geyser connectiontest IP:PORT into your server's console while the server is online. Your GeyserMC configuration should automatically adjust to your active IP and Port, so you can test/connect with your normal server IP. If the connection test fails, try restarting your server and checking the port in your config.yml file. Refer to the GeyserMC setup wiki for more information.

Troubleshooting

In some cases, you may need to disable enforce-secure-profile in your server properties for GeyserMC to work correctly. You can fix this by either installing Floodgate or following this guide.

Standalone Setup of GeyserMC

A standalone GeyserMC setup requires you to have a server for both the GeyserMC instance itself and the Java edition server you would like to connect the proxy to. This is often used when you have many Bedrock players.

The requirements for a standalone setup are the following:

• One Minecraft Java edition server that you wish to connect to the proxy (this can be Vanilla, Spigot, Craftbukkit, etc.).
• An additional Minecraft server to run the GeyserMC software.

The installation steps for the standalone version are almost identical to installing GeyserMC as a plugin or mod. In particular:

• Download and run Geyser.jar instead of downloading the plugin versions. You’ll need to install this as a Custom JAR using this guide.
• Access the config file, which is now located in the main server directory.
• Edit the remote: address to reflect the address of your Java Minecraft server, instead of setting it to auto.