Geyser (Cross-Play)
Dual TCP+UDP proxy for Geyser cross-play servers.
Protocol: TCP + UDP | DNS: CNAME | Firewall: All condition types
Geyser lets Bedrock players join Java servers. PixelShield supports this by running both protocol parsers on a single domain — Java clients connect over TCP, Bedrock clients connect over UDP, and both get forwarded to your Geyser backend.
How it works
When you create a Geyser domain, we allocate a TCP port for Java traffic and a UDP port for Bedrock traffic on the same edge node. Both parsers run simultaneously:
- TCP listener handles Java clients with the full handshake/login state machine
- UDP listener handles Bedrock clients with the RakNet parser
- Both streams share the same firewall rules and rate limits
All traffic goes to your single backend server running Geyser, which handles the protocol translation.
Backend configuration
When adding a backend for a Geyser domain, you can specify a separate bedrock_port for the UDP side. If you leave it blank, it defaults to 19132. The Java port uses whatever port you set as the main backend port.
Compatibility
Works with Geyser standalone, Geyser as a Spigot/Paper/Velocity/BungeeCord plugin, and Floodgate for seamless Bedrock authentication.
Edition comparison
| Feature | Java | Bedrock | Geyser |
|---|---|---|---|
| Protocol | TCP | UDP (RakNet) | TCP + UDP |
| DNS record | CNAME | CNAME | CNAME |
| CNAME target | *.proxy.pixelshield.net | *.edge.pixelshield.net | *.edge.pixelshield.net |
| IP / CIDR rules | Yes | Yes | Yes |
| Country rules | Yes | Yes | Yes |
| Protocol version rules | Yes | No | Yes (Java side) |
| Username pattern rules | Yes | No | Yes (Java side) |
| MOTD caching | Yes | Yes | Yes |
| Bot detection | Full | Flood-based | Full (Java) + Flood-based (Bedrock) |
| Multi-node failover | Yes | Yes | Yes |
Default ports
| Edition | Protocol | Default Port |
|---|---|---|
| Java | TCP | 25565 |
| Bedrock | UDP | 19132 |
| Geyser (Java side) | TCP | 25565 |
| Geyser (Bedrock side) | UDP | 19132 |
Questions or feature requests?
If you run into compatibility issues or have specific needs, reach out at support@pixelshield.net.