Your Java Minecraft server can accept players from Bedrock Edition on phones, tablets, consoles and Windows. GeyserMC translates between the two protocols in real time, so everyone plays on the same server.
This guide is about getting phone players in. For consoles, proxies and every config option, see our complete Geyser and Floodgate guide.
What you need
- A Java Edition server (Paper, Purpur or Spigot recommended). Geyser follows the newest Java version, 26.3 since Geyser 2.12.0 on 14 October 2026. Older servers need ViaVersion as well.
- GeyserMC plugin (the translator)
- Floodgate plugin (optional, but most phone players have no Java account, so in practice you want it)
- A port for Bedrock players, open for TCP and UDP
Installing GeyserMC
Download the GeyserMC plugin for your server type from geysermc.org. Drop it into your /plugins/ folder and restart the server.
Your server will generate a Geyser-Spigot/config.yml file. The important settings:
bedrock:
port: 19132
clone-remote-port: false
transport: nethernet
java:
auth-type: floodgate
motd:
primary-motd: "Your Server Name"
secondary-motd: "Java + Bedrock"
Keep transport: nethernet in there: GeyserMC says Bedrock 26.60, released on 27 October 2026, stops connecting over RakNet. Players on 26.60 need Geyser build 1273 or newer. Build 1280 (31 October) moves an existing raknet line to nethernet by itself; on builds 1273 to 1279 it stays until you change it. Our NetherNet guide explains the switch. Set auth-type to floodgate if you use the Floodgate plugin (recommended). That lets Bedrock players join without a Java account. On older Geyser versions the java section is called remote, and the MOTD lines sit under bedrock as motd1 and motd2.
Installing Floodgate
Without Floodgate, Bedrock players must own a Java Edition account and sign in with it. Most people who play on a phone do not have one. Floodgate lets them join with the Microsoft account they already use on Bedrock.
Download Floodgate from the same GeyserMC website and place it in your plugins folder. Restart the server. Bedrock players now join with a . prefix before their name (like .Steve).
Port configuration
This is where most people get stuck. Java Minecraft uses TCP, port 25565 by default. Bedrock through Geyser uses port 19132 by default, and with NetherNet that port needs TCP for signaling and UDP for gameplay.
| Port | Protocol | Purpose |
|---|---|---|
| Java port (25565 by default) | TCP | Java Edition connections |
| Bedrock port (19132 by default) | TCP and UDP | Bedrock Edition connections (signaling over TCP, gameplay over UDP) |
On a Space-Node server you set up the Bedrock port yourself, for free. Open the panel's Network tab, click Create Allocation, and put the new port in port under bedrock, with clone-remote-port: false. Your plan includes three allocations, and we can raise that to five on request. The panel opens each allocation for TCP and UDP, so this works for current Bedrock clients, 26.60 included.
Do not put Bedrock on the Java port with clone-remote-port: true. The Geyser setup guide says the Geyser port "cannot be the port of the Paper / Spigot server", and GeyserMC's NetherNet post says that option "only works with external signaling". Phone players would then join with an address and port that Geyser prints in the console, not with yours.
Voice chat plugins and the server query cannot share Geyser's port, so give them their own. If you also set transport: both, which GeyserMC's setup guide offers because versions such as 26.40 fetch the MOTD and player count over RakNet, NetherNet needs one more UDP port as webrtc-port. Next to Java, Geyser and voice chat that is a fourth port, so ask us to raise your limit. Our NetherNet guide has the details.
For VPS users, open the port in your firewall:
ufw allow 19132/tcp
ufw allow 19132/udp
Adding the server on a phone
- Open Minecraft on the phone or tablet
- Tap Play, then the Servers tab
- Scroll down and tap Add Server
- Enter your server address and the Bedrock port
- Save and join
Before you hand the address to your friends, run geyser connectiontest <address> <port> in the server console. It checks whether Bedrock players can reach Geyser from outside.
Common issues and fixes
"Unable to connect to world" on Bedrock
This usually means the Bedrock port is not reachable. Check that:
- The port is one of your server's allocations, open for TCP and UDP, and
clone-remote-portis off transportisnethernet, notraknet, and Geyser is on build 1273 or newer for Bedrock 26.60- GeyserMC started without errors (check the server log)
- Nothing else, such as voice chat or the query, uses the same port
- Players type the correct address and port
Bedrock players see ghost blocks
Some Java blocks have no Bedrock equivalent. GeyserMC substitutes the closest match, which can cause visual glitches. Updating to the latest GeyserMC build fixes many of these.
Skin issues
Bedrock skins come from Microsoft accounts, not from Java's skin system. With Floodgate installed they normally show up for Java players. If they still appear as Steve or Alex, see our Bedrock skins fix.
Inventory differences
Some items exist in Java but not in Bedrock, and the other way round. GeyserMC handles most conversions. Modded items are a different story: the Geyser docs say Geyser only works with server-side mods, and mods that need a client-side install will not work for Bedrock players.
Phone players lag more than PC players
Phones on mobile data or weak Wi-Fi have less stable connections than a PC on a cable. Ask the player to test on good Wi-Fi first. If everyone lags, look at the server itself.
Performance impact
GeyserMC adds some work on the server for each Bedrock player, because every packet is translated. How much depends on your plugins, your world and how many Bedrock players are online, so we do not quote a fixed number. Measure it on your own server with spark while Bedrock players are online.
Recommended server configuration
For a mixed Java and Bedrock community:
- Paper or Purpur as the server software
- A bit of RAM headroom on top of what the server needs for Java players alone
- GeyserMC, Floodgate, and ViaVersion if your server is not on the newest version
- A test with a real phone before you announce cross-play
Cross-platform play is a good way to grow your community. Plenty of players only have Minecraft on a phone or console, and Geyser lets them join your Java server.
More Geyser guides: the complete Geyser and Floodgate guide, GeyserMC on a Paper server, step by step, GeyserMC cross-play tutorial, what to check in a host before you run Geyser.