Comprehensive Guide to Setting Up GeyserMC on FreeMinecraftHost.com
GeyserMC is a proxy that enables Minecraft Bedrock Edition players to join Java Edition servers, facilitating cross-play between the two versions. By integrating GeyserMC with Floodgate on your FreeMinecraftHost.com server, you allow Bedrock players to connect seamlessly—even without a linked Java account. Note that Java and Bedrock players can use the same port since they operate on separate protocols (TCP for Java and UDP for Bedrock).
Prerequisites
- Java Edition Server: Ensure your server is running a Java Edition-compatible server type, such as Spigot, Paper, or another supported platform.
- Access to Server Files: You should have the ability to upload plugins and modify configurations via the FreeMinecraftHost.com control panel.
Step 1: Download GeyserMC and Floodgate
GeyserMC:
Navigate to the GeyserMC Downloads page.
Download the appropriate version for your server platform (e.g., Geyser-Spigot.jar
for Spigot or Paper).

Floodgate:
Step 2: Install the Plugins on Your Server
Access the Control Panel:
Upload the Plugins:
Navigate to the "Files" section.
Open the "plugins" folder.
Click the "Upload" button and select both the Geyser-Spigot.jar
and the Floodgate .jar
files you downloaded.
Confirm that both files upload successfully into the plugins directory.

Restart the Server:
Go to the "Terminal" tab in the control panel.
Click the yellow "Restart" button.
Wait for the server to reboot and load both the GeyserMC and Floodgate plugins.

Step 3: Configure GeyserMC and Floodgate
Generate Configuration Files:
Find Your Server Port:
- You can locate your server's port displayed behind the IP address on the Terminal page (e.g.,
:61828
).
- There is no need to create a separate port for Bedrock; Java (TCP) and Bedrock (UDP) protocols operate on the same port.
Edit the GeyserMC Configuration:
- Open the
config.yml
file inside the Geyser-Spigot
folder.
- In the
bedrock
section, update the port
field with your server’s port number (e.g., 61828
) and ensure the address
field is set to 0.0.0.0
to allow connections from any IP.
- Set the
auth-type
to floodgate
to enforce Floodgate authentication.
Copy the key.pem File:
- Locate the
key.pem
file included with Floodgate (either provided in the plugin package or generated on first run).
- Copy the
key.pem
file into the appropriate configuration directory (usually within the Floodgate folder) to enable secure key authentication.
Review Floodgate Configuration:
- Open Floodgate’s configuration file (typically found in the Floodgate folder or within the Geyser folder, depending on your server setup).
- Verify that the settings meet your server requirements and adjust as necessary.
- Save any changes you make.
Restart the Server Again:
- To apply your configuration changes, restart your server via the control panel.
Step 4: Connect to Your Server from Bedrock Edition
On Your Bedrock Device:
- Launch Minecraft Bedrock Edition.
- Navigate to the "Play" menu, then select the "Servers" tab.
- Scroll down and click "Add Server".
Enter Server Details:
- Server Name: Choose a preferred name for your server.
- Server Address: Enter your server's IP address.
- Port: Input the same port number as your Java server. You can find the port by looking after the colon on the ip.

Save and Connect:
- Save the server details.
- Select your server from the list and click "Join Server" to start playing.
By following these steps, you’ve successfully set up GeyserMC with Floodgate on your FreeMinecraftHost.com server. This configuration allows both Minecraft Java and Bedrock players to connect on the same port (leveraging separate TCP and UDP protocols) and ensures secure authentication through Floodgate with the proper key.pem
setup. Enjoy your enhanced cross-play gaming experience!
Additional Resources
For a visual walkthrough, consider watching this tutorial: How To Add Crossplay to Your Minecraft Server