Geyser Hosting Provider Modded Setup

caution

Geyser-Fabric and Geyser-NeoForge run only on a 1.21.9-1.21.10 server. See this page for more details.

info

Geyser only works with server-side mods. Mods that require a client-side install will not work!

Select your server hosting provider in the dropdown above.
Download the mod from the download page.
Place the Geyser mod jar in the mods folder, and restart the server. For Fabric, you will also need FabricAPI.

Open your Geyser config, located in /config/Geyser-Fabric/config.yml (or /config/Geyser-NeoForge/config.yml), and find the following:

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

  # The port that will Geyser will listen on for incoming Bedrock connections.
  # Since Minecraft: Bedrock Edition uses UDP, this port must allow UDP traffic.
  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.
  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/mods that rely on ports with UDP, such as Voice Chats or Query, cannot share the port with Geyser.

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.