How to Configure GeyserMC on a Minecraft Server

Tutorials Minecraft
1

geyser
geyser437×215 88 KB

This guide details the procedure for configuring GeyserMC on a BoxToPlay Minecraft server.

GeyserMC is an efficient solution to enable connectivity between players using the Bedrock Edition and Minecraft Java servers. Its modularity, available as a mod, plugin, or via a Bungee proxy, allows flexible adaptation to the specific requirements of your server infrastructure. The instructions below will guide you through configuring each of these variants on your server.

Prerequisites:

  • A working Minecraft Java server.
  • Access to the server file system to install plugins or mods.
  • For the proxy implementation: a server network using BungeeCord, Velocity, or ViaProxy, already configured.

Step 1: Downloading GeyserMC

Please visit the official GeyserMC website and download the version compatible with your server configuration.

Step 2: Installing GeyserMC

  1. Mod Version
    For integration on a modded server using NeoForge or Fabric:
    Upload the downloaded file to the mods directory of your server.
    Restart the server to enable GeyserMC.

  2. Plugin Version
    To install GeyserMC as a plugin (Spigot and Paper):
    Move the downloaded file into the plugins directory.
    Restart the server to load GeyserMC.

  3. Proxy Version
    To use GeyserMC with BungeeCord, Velocity, or ViaProxy, follow the steps below:
    Place the downloaded file into the plugins directory.
    Restart the proxy to generate Geyser’s configuration folder.

Step 3: Configuring GeyserMC

Configuring the port in GeyserMC requires the following steps, starting by creating a port via the BoxToPlay interface.

  1. Creating a port in BoxToPlay
    Log in to your BoxToPlay management panel and access the configuration section of your Minecraft Java server.
    Navigate to the « Port Management » category. Reserve a new port and make sure to keep the assigned number, as it will be essential.

Configuring the port in the config.yml file
Open GeyserMC’s config.yml file. The location depends on the version:
it is found in the config directory at the server root for the mod version, and in plugins/Geyser-Spigot or plugins/Geyser-BungeeCord for the plugin and proxy versions.

Locate the `bedrock` section and replace the port value with the number you created in BoxToPlay:
bedrock:
  # The IP address that will listen for connections.
  # address: 0.0.0.0

  # The port that will listen for connections
  port: YOUR_PORT

Replace `YOUR_PORT` with the port number you previously reserved.

Save the changes and restart your Minecraft server.
The configured port will now be the connection port for Bedrock players (the connection IP address remains your Java server IP, and the port is the one specified here).

Step 4: Floodgate Configuration (optional)

To allow Bedrock players to connect without requiring a Microsoft account, install Floodgate:

  • Download Floodgate from the official GeyserMC website.
  • Place the file in the same directory as Geyser (either mods or plugins, depending on your setup).
  • Restart the server.
  • Configure Floodgate via its dedicated configuration file if necessary (refer to Floodgate documentation for detailed instructions).

Step 5: Connection Verification

Once GeyserMC setup is complete:

  • Ask a Bedrock Edition player to connect using the IP address of your Java server and the Bedrock port configured in GeyserMC’s config.yml.
  • Make sure the connection works properly and that Bedrock players can interact normally in the game environment.

Conclusion

By following this guide, you will be able to adapt GeyserMC to the specifics of your BoxToPlay server, whether via a mod, a plugin, or a Bungee-based proxy. For any questions or additional information related to the BoxToPlay platform, feel free to consult the GeyserMC documentation or contact BoxToPlay technical support.