Skip to main content

Setup

Provider Instructions

Select a provider to see specific installation instructions

info

If your server is not running 1.21/1.21.1, you will need to install ViaVersion. See also this page on supported versions.

  1. Select your server hosting provider in the dropdown above.

  2. Download the plugin from the download page.

  3. Place the Geyser-Spigot.jar in the plugins folder, and restart the server.

  4. Open your Geyser config, located in /plugins/Geyser-Spigot/config.yml, and find the following:

    bedrock: 
    # The IP address that will listen for connections.
    # Generally, you should only uncomment and change this if you want to limit what IPs can connect to your server.
    #address: 0.0.0.0

    # The port that will listen for connections. This is the port that Bedrock players will use to connect to your server.
    port: 19132

    # Some hosting services change your Java port everytime you start the server and require the same port to be used for Bedrock.
    # This option makes the Bedrock port the same as the Java port every time you start the server.
    # This option is for the plugin version only.
    clone-remote-port: false

    The vital part is the port. This is the port that Bedrock players will use to connect to your server. Follow the instructions in the provider selector - change the port, and if necessary, clone-remote-port & address. If clone-remote-port is enabled, the bedrock port will be overwritten with the Java port!
    Important: Other services/plugins that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser.

  5. Verify whether connections are possible by running geyser connectiontest <ip> <port> in the console.

info

To allow Bedrock Edition players to join your server without needing to log in to a paid Java Edition account, you can use Floodgate.