How to use GeyserMC

Introduction to GeyserMC

GeyserMC is a bridge that allows players on Bedrock Edition (mobile, console, and Windows 10/11) to join Minecraft Java Edition servers. By translating packets between the two versions, it enables cross-platform play without requiring Bedrock players to own a Java account.

Installing GeyserMC

On AwakeNode

AwakeNode makes cross-play setup straightforward. You can install GeyserMC directly through our Plugin Installer located in the server panel. Simply search for "Geyser" and click install. The panel will automatically place the files in the correct directory.

On other hosts / manually

1. Download the latest Geyser-Spigot.jar from the official GeyserMC website.
2. Upload the file to your server's /plugins folder using an SFTP client like FileZilla or the web-based File Manager.
3. Restart your server to generate the configuration files.
4. Edit the config.yml file within the plugins/Geyser-Spigot folder to define your Bedrock port (default is 19132).

Configuring for Bedrock Players

Once installed, you must ensure your server is accessible to Bedrock clients.

• Port Forwarding: If you are hosting externally, ensure your UDP port (default 19132) is open on your firewall.

On AwakeNode, make sure to create a new allocation in the networking tab for your bedrock users to use.

• Floodgate: If you want Bedrock players to join without needing to authenticate with a Java account, you should also install the Floodgate plugin. This allows for seamless "link-free" joining.

Performance Considerations

GeyserMC requires additional processing power to handle the translation between Java and Bedrock protocols. If you notice performance dips or TPS drops after installing, you may need to upgrade your server plan to provide more headroom. On AwakeNode, upgrading your plan automatically scales your allocated RAM and CPU resources, with no manual startup flag adjustments required.

If you believe your server requires specific JVM startup flags to optimise Geyser performance, please open a ticket with our Support team, as clients cannot modify these flags directly.