> ## Documentation Index
> Fetch the complete documentation index at: https://help.freakhosting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Install & Configure GeyserMC in Minecraft

> Bridge the gap between Java and Bedrock Edition. Learn how to install GeyserMC and Floodgate to allow Console and Mobile players to join your server.

## Technical Cross-Platform Unity

Historically, the architectural differences between Minecraft Java Edition and Bedrock Edition prevented any form of synchronized multiplayer. **GeyserMC** solves this by acting as a high-performance, real-time packet translator. By implementing Geyser, you enable players on mobile devices, consoles (Xbox, PlayStation, Switch), and Windows 10/11 Edition to smoothly join your Java-based community. This technical bridge ensures your server remains inclusive and accessible to the widest possible audience.

<CardGroup cols={2}>
  <Card title="Difficulty" icon="gauge-low">
    Intermediate
  </Card>

  <Card title="Time" icon="clock">
    8 Minutes
  </Card>
</CardGroup>

***

## Technical Infrastructure Components

To enable a successful crossplay experience, you must deploy two specialized technical modules.

1. **Geyser:** The core translation engine that handles the network protocol handshake between Bedrock and Java.
2. **Floodgate:** An authentication bridge that allows Bedrock players to join without requiring a Java account, using their Microsoft/Xbox identity instead.

***

## Installation & Deployment Workflow

Follow these steps to initialize the crossplay bridge on your Paper, Spigot, or Purpur server.

<Steps>
  <Step title="Acquire Latest Build">
    Download the appropriate JAR files from the official [GeyserMC Portal](https://geysermc.org/download). You will require both the `Geyser-Spigot` and `Floodgate-Spigot` builds.
  </Step>

  <Step title="Deploy to Plugins">
    Using the [Game Panel](https://games.freakhosting.com) File Manager, upload both JAR files into your server's `/plugins/` directory.
  </Step>

  <Step title="Initialize the Logic">
    **Restart** your server to generate the configuration folders and default variables.
  </Step>

  <Step title="Network Configuration">
    Open `/plugins/Geyser-Spigot/config.yml` and verify:

    * **`bedrock.port`:** Set this to your assigned Bedrock port (Default is `19132`).
    * **`auth-type`:** Ensure this is set to **`floodgate`** for the best user experience.
  </Step>
</Steps>

***

## Technical Networking: The UDP Protocol

Unlike Java Edition which uses TCP, Bedrock Edition communication relies exclusively on **UDP**.

<Important>
  ### Firewall Synchronization

  On the FREAKHOSTING network, ensure that your assigned Bedrock port is authorized for both TCP and UDP traffic. If you encounter "Unable to connect" errors for mobile players, [Open a Support Ticket](https://freakhosting.com/clientarea/submitticket.php) to verify your node's UDP allocation status.
</Important>

***

## Management & Accessibility

<AccordionGroup>
  <Accordion title="Console Platform Restrictions">
    Directly adding third-party servers to the Xbox, PlayStation, or Switch "Server List" is restricted by the manufacturers. Players on these platforms must use specialized workarounds such as the **BedrockTogether** mobile application or custom DNS redirects to join your community.
  </Accordion>

  <Accordion title="Visual & Mechanical Parity">
    Geyser performs sophisticated packet translation, but Bedrock players may observe minor visual discrepancies in entity animations or stylized UI elements. These are purely client-side rendering differences and do not impact the underlying gameplay logic or world persistence.
  </Accordion>
</AccordionGroup>

***

<Note>
  ### Need Extra Help?

  If you encounter any issues, our support team is ready to assist:

  * **Live Chat:** Quick assistance via our website.
  * **Support Ticket:** [Open a Ticket](https://freakhosting.com/clientarea/submitticket.php)
  * **Discord:** [Join our Community](https://discord.gg/freakhosting)
  * **Email:** [support@freakhosting.com](mailto:support@freakhosting.com)
</Note>

<Tip>
  ### Save on Your Hosting

  Ready to get a new server? Use code **KB20** at checkout for **20% off** your first month!
</Tip>

***

<div align="center">
  **Last Updated:** January 2026 | **Minecraft:** Cross-platform unity.
</div>