Install GeyserMC on PaperMC server

3 min read 21-09-2024
Install GeyserMC on PaperMC server


Setting up a Minecraft server can be a fun and rewarding experience, especially when it involves bridging the gap between different platforms. One such solution is GeyserMC, which allows Bedrock players to join Java servers seamlessly. If you're running a PaperMC server and wish to enable cross-platform play, you're in the right place! In this article, we’ll guide you through the installation process of GeyserMC on your PaperMC server.

Understanding the Scenario

Original Problem Statement: "create me article about: Install GeyserMC on PaperMC server"

GeyserMC is a proxy that allows Bedrock Edition players to connect to Java Edition servers. PaperMC is a popular fork of Spigot that provides optimizations and features for Minecraft servers. By integrating GeyserMC with your PaperMC server, you can allow players from different platforms to enjoy the same game world together.

Installation Steps

Step 1: Download the Required Files

  1. PaperMC Server: If you haven’t already set up a PaperMC server, download the latest version from the official PaperMC website.
  2. GeyserMC: Download the latest version of GeyserMC from its GitHub Releases page.

Step 2: Setting Up GeyserMC

  1. Move GeyserMC to Your Plugins Folder:

    • Once downloaded, extract the GeyserMC ZIP file.
    • Move the extracted folder into the plugins directory of your PaperMC server.
  2. Launch Your Server:

    • Start your PaperMC server. This will create the necessary configuration files for GeyserMC.

Step 3: Configuration

  1. Edit the Geyser Configuration:

    • Navigate to the plugins/Geyser-Spigot folder. Inside, you will find config.yml.
    • Open config.yml with any text editor (like Notepad or VS Code).
    • Here are some key settings to consider:
      bedrock:
        port: 19132 # The default port for Bedrock players
      remote:
        address: 127.0.0.1 # Localhost address, keep this if running locally
        port: 25565 # The port your PaperMC server is running on
      
  2. Save Changes:

    • After editing the configuration, save the config.yml file.

Step 4: Optional: Setting Up a Floodgate

If you want your Bedrock players to join your PaperMC server without needing a Java account, you can install Floodgate. It’s a plugin that works alongside GeyserMC.

  1. Download Floodgate: Get it from the GeyserMC Floodgate page.
  2. Install Floodgate: Move the Floodgate plugin into your plugins folder just like you did with GeyserMC.
  3. Configure Floodgate: Just like GeyserMC, open and adjust the config.yml file for Floodgate.

Step 5: Restart the Server

Once you have everything configured, restart your PaperMC server to apply the changes.

Testing the Setup

To test your setup:

  1. Launch Minecraft Bedrock Edition on your device.
  2. Add a new server using your PaperMC server's IP address and the port specified in Geyser’s configuration (default: 19132).
  3. Try connecting to the server.

Troubleshooting Tips

  • Connection Issues: Ensure that your server's firewall settings allow traffic on the ports used for both Bedrock and Java.
  • Logs: Check the server console for any error messages that may guide you in troubleshooting.
  • Compatibility: Ensure that the versions of GeyserMC and PaperMC you are using are compatible.

Conclusion

Installing GeyserMC on your PaperMC server is a straightforward process that can greatly enhance your Minecraft server experience by allowing Bedrock Edition players to join your game. This setup encourages community engagement and inclusivity across platforms.

Additional Resources

By following the steps above, you're well on your way to creating a cross-platform Minecraft experience. Happy gaming!