Minecraft
Geyser lets Minecraft Bedrock Edition players (phones, tablets, Xbox, PlayStation, Switch, Windows Bedrock) join your Java server. Floodgate lets them join without owning a Java account.
The one rule: one Geyser per address
Geyser listens on its own UDP port. Bedrock players connect to that port, and Geyser translates their game into Java.
| Your setup | Install Geyser on | Install Floodgate on |
|---|---|---|
| One server (no proxy) | That server | That server |
| Velocity network | Velocity only | Velocity and every back-end |
Get a port for Geyser
Geyser needs a port that players can reach over UDP.
- Option A (simplest): use your game port. In Geyser's
config.ymlsetbedrock.clone-remote-port: true, so Geyser uses the same port number as Java. Bedrock players join with the same address and port. On Velocity, that's the Velocity port. - Option B: a separate port. Ask us for an extra allocation on your server. It shows on Network. Set
bedrock.portto that number.
Install
Stop the server (or Velocity).
Install Geyser for your platform (Paper/Spigot, Fabric or Velocity) and Floodgate from Minecraft Plugins, or from geysermc.org/download.
Start once, then Stop. Geyser creates its config:
- Paper:
plugins/Geyser-Spigot/config.yml - Fabric:
config/Geyser-Fabric/config.yml - Velocity:
plugins/Geyser-Velocity/config.yml
- Paper:
Edit the config:
bedrock: port: 19132 # or your extra port (Option B) clone-remote-port: true # Option A: use the Java port remote: auth-type: floodgate # Bedrock players don't need a Java accountVelocity networks only: copy
key.pemfromplugins/floodgate/on Velocity into thefloodgatefolder of every back-end (plugins/floodgate/on Paper,config/floodgate/on Fabric). Every server must have the same key.Start everything. The console should say Geyser started on your port.
Join from Bedrock
- In Bedrock, go to Play → Servers → Add Server.
- Server Address:
gameprod1.crashcrafts.com(or your SRV domain). Port: your Geyser port. - Save and join.
Consoles can't add custom servers directly. Players use an app such as BedrockTogether (mobile) or change their console's DNS. See Geyser's guide.
Things to know
- Bedrock usernames get a prefix (default
.), so whitelist them as.PlayerName. - Every server behind Geyser must accept the Java version Geyser imitates. Usually that's the newest; ViaVersion on the server or proxy helps.
- Some Java-only features (custom items, some resource packs, a few mods) don't show for Bedrock players.
