Enable Bedrock players to join your Java Minecraft server with GeyserMC - the perfect bridge for cross-platform gameplay that expands your player community across all devices.
What is GeyserMC?
GeyserMC is a powerful bridge that allows Minecraft Bedrock Edition players (Windows 10/11, mobile, console) to join Java Edition servers without purchasing the Java version. It translates all necessary data between the two versions in real-time, creating a seamless cross-platform experience.
Installation Options
Plugin Installation (Recommended)
-
Download the appropriate GeyserMC plugin from the official GeyserMC website:
- Geyser-Spigot for Spigot/Paper servers
- Geyser-Bungee for Bungeecord/Waterfall
- Geyser-Velocity for Velocity
- Geyser-NeoForge for SpongeVanilla/SpongeForge
- Stop your server before making any changes
- Upload the GeyserMC JAR file to your plugins folder
- Start your server to generate the configuration files
Standalone Installation
For networks with heavy Bedrock traffic, a standalone setup might be preferable:
- Download the standalone Geyser.jar
- Install it as a Custom JAR on a separate server instance
- Configure the
remote: address
in the config file to point to your Java server
Configuration
Bedrock Port Configuration
- Locate the
config.yml
file in your GeyserMC plugin folder. It's located in plugins/GeyserMC folder. - Find the
port:
setting (default is 19132) - To allocate a port on MintServers, go to dashboard, then game panel
- On the left side click "Network", then click the blue "Create Allocation" button on the right
- A new port will appear in the list - copy this port number
- Update the port in the configuration file with your newly allocated port



Authentication Setup
By default, Bedrock players need a Java account to connect. To allow Bedrock players without Java accounts:
- Install the Floodgate plugin alongside GeyserMC
- Change
auth-type
fromonline
tofloodgate
in the /plugins/GeyserMC/config.yml file
Testing Your Connection
To verify your setup is working correctly:
- Run the command
geyser connectiontest IP:PORT
in your server console - If the test fails, check your port configuration and firewall settings
- Restart your server after making configuration changes
Compatibility Enhancements
For the best cross-platform experience, consider these additional plugins:
- ViaVersion - Ensures version compatibility across different Minecraft releases
- Floodgate - Allows Bedrock players to join without owning Java Edition
- ViaBackwards - Enables backward compatibility for older clients
Troubleshooting Common Issues
Connection Problems
- Port binding errors - Ensure your port isn't already in use by another service
- Unable to connect - Verify that
enforce-secure-profile
is set tofalse
in server.properties - Authentication failures - Check that Floodgate is properly configured if using floodgate authentication
Performance Considerations
GeyserMC requires additional server resources to handle the translation between platforms. For optimal performance:
- Consider using Paper or Purpur server software for better optimization
With GeyserMC properly configured, your Minecraft server will become truly inclusive, allowing friends to play together regardless of which version they own. This cross-platform capability can significantly increase your player base and create a more diverse community on your server.