How to Set Up Geyser and Floodgate for Minecraft Crossplay

Geyser and Floodgate are two mods/plugins that work together to make it possible to join a Minecraft Java Edition server with a Bedrock client. This allows for crossplay between the two different versions of Minecraft. In this article you will learn how to install, update, and configure your Geyser server!

Setup and Plugin Installation

Note: We recommend to fully stop your Minecraft server before making any edits or config changes.

To get started, you need to install a supported server platform for Geyser and Floodgate. The following platforms are currently supported: BungeeCord, Fabric, NeoForge, Spigot, Paper, Velocity, ViaProxy. For this tutorial, we will be using Paper as the server platform.

1. Install your desired server platform using the One Click Installer or one of the download links from above.

2. Download the .jar files for Geyser and Floodgate that match your chosen Minecraft version.

3. Upload them to your server’s plugins folder located in the Server Files.

   Note: If you are using Fabric or Neoforge, put the jar file into the mods folder instead.

   

   If the plugins folder hasn’t been generated yet, turn the server online at least once for it to generate, or manually create it.

4. Restart the server for the plugin to take effect and generate the neccessary configuration files.

5. Depending on where you are hosting your server, you’ll also need port 19132 to be open. If running a Nodecraft server, this should already be open for you.

Changing the Settings for Floodgate

Floodgate is an optional plugin that integrates with Geyser, allowing Minecraft Bedrock players to join without needing a separate Java Edition account. It also enables allowlist functionality and custom player skins for Bedrock users.

1. Go to the Geyser config.yml. This file will be in /plugins/Geyser-Spigot.

   

2. Change the line auth-type: online to auth-type: floodgate

Changing Optional Geyser Settings

There are several customizable settings within Geyser’s configuration that can enhance the quality of life for players on your Minecraft server. Below are some commonly adjusted settings:

• You can change the port if you would like. However, you’ll need to verify that the UDP port for the port listed is open depending on how you are hosting your server (See list of supported hosts here). Additionally, the default for Bedrock clients to connect to is 19132 as listed by default in the config.

• motd1 and motd2 are settings for if you want your Message of the Day (motd) to show differently in Bedrock and Java.

• server-name can be changed to display a custom name on Bedrock Edition when players see and connect to your server.

• passthrough-motd can be used to copy the motd that is set in your game settings to Bedrock Edition if you don’t want to have a separate motd for Bedrock.

• allow-third-party-capes allows the capes from third party mods such as Optifine, LabyMod etc. to be shown.

• show-cooldown allows the cooldown for weapon attack speeds to be displayed on Bedrock Edition.

• emote-offhand-workaround allows Bedrock players to put any item in their offhand like Java can by using emotes. There are 3 options for this. By default, it is disabled meaning the workaround isn’t applied. The no-emotes option prevents the emote from being seen by other Bedrock clients and swaps the item in the offhand. The emotes-and-offhand option allows the emote animation to be seen by other Bedrock users and swaps the item in the offhand.

• above-bedrock-nether-building allows Bedrock Edition players to see above the Nether’s ceiling and build on it which it does not normally allow. It does this by changing the ID of the world which can cause the per-biome fog to be displayed incorrectly.

• Adding Bedrock Players to the Allowlist Using Floodgate

Adding Bedrock Players to the Allowlist Using Floodgate

If you want to use an allowlist on your server, you can use Floodgate to add Bedrock players.

• Use /fwhitelist add UserName or /fwhitelist add floodgateUUID to add Bedrock Edition players to the allowlist.

• Java Edition players should still be added using the default /whitelist command.

Additionally, do not include the prefix set in the floodgate config when entering the username to the allowlist.

Getting a FloodgateUUID

In some cases, if the system doesn’t pick up on the username, you’ll need to use the floodgateUUID to add the player to the allowlist. The floodgateUUID is derived from the XUID and in a specific format so that the Java Edition can read it. The format is 00000000-0000-0000-xxxx-xxxxxxxxxxxx.

1. Get the players XUID. You can use a tool such as Cakes XUID Grabber to do this.

2. Take the hex value and replace the x characters in the format mentioned with the hex value.

   • For example, if the hex XUID was 1234567890123456, the floodgateUUID would be 00000000-0000-0000-1234-567890123456

Checking for Updates

Geyser and Floodgate do not include their version in the file download, so you will need to use commands to check the installed version. You can check for updates to Geyser or Floodgate using the following commands in the Console or in-game as a server operator.

• /geyser version Shows the current Geyser version and checks for updates.

• /floodgate version Shows the current Floodgate version and checks for updates.

Conclusion

By following this guide, you can learn to set up, configure, and update your server for optimal crossplay functionality. If you encounter any issues, make sure to review the configuration settings and check for updates regularly to ensure smooth gameplay for all players.

The Nodecraft Customer Support team is always standing by if you need assistance!