October DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run ScanOctober DealsAmazon USDeal season is back - check today's better picksAmazon US: current deals, useful picks and tech finds.See Picks×
Skip to content
VGSources
Blog

How to Install GeyserMC and Floodgate for Minecraft Crossplay

GeyserMC translates Bedrock traffic for Java servers, while Floodgate lets Xbox Live-authenticated Bedrock players join without Java Edition. Follow platform-specific installation, UDP port, proxy, key-security, whitelist, and troubleshooting steps.
Length10 min Posted Quest giverVGSources Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

To let Minecraft Bedrock players join a Java server, install GeyserMC as a plugin, mod, proxy component, or standalone bridge, then expose Geyser’s Bedrock UDP listener. Add Floodgate when Bedrock players should authenticate through Xbox Live without owning Minecraft: Java Edition. Geyser translates Bedrock network traffic into the Java protocol; Floodgate supplies the optional Bedrock authentication layer.

This guide covers Paper and Spigot servers, Fabric, BungeeCord, Waterfall, Velocity, standalone Geyser, port forwarding, identity settings, whitelists, and the failures most often reported as “Unable to connect to world.”

As an Amazon Associate I earn from qualifying purchases.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What GeyserMC and Floodgate each do

GeyserMC is the protocol bridge

Java and Bedrock use different network protocols. Geyser sits between them and translates Bedrock client traffic into the Java protocol understood by your server. It can run directly on a supported Java server platform, on a proxy, or as a separate standalone process that forwards traffic to a Java server.

Geyser does not turn a Bedrock client into a Java account. It provides the compatibility layer and a Bedrock-facing listener. Without Floodgate, a Bedrock player generally still needs a Java Edition account for the server’s normal authentication flow.

#1 Best Overall
Sale
Gaoye Blue Light Blocking Glasses
  • BLUE LIGHT BLOCKING GLASSES: Our blue light glasses for women boast UV400 protection, blocking harmful blue rays from computer screens. With these bluelight glasses women, you can enjoy gaming, reading, or watching TV with no worries of eye strain.
  • EYE RELIEF: Our blue light glasses are engineered to reduce blurry vision or strain caused by prolonged screen time. These womens blue light glasses aid in better sleep by preventing blue light from disrupting your natural sleep cycle, helping you fall asleep faster and enjoy a more restful night's sleep, making them the perfect christmas present.
  • COMFORTABLE: Crafted from durable material, our trendy blue light glasses for woman or blue light glasses men ensure long-lasting comfort. The high-transmittance lenses accessories, gamer gifts for men, help keep your eyes relaxed. Perfect stocking stuffers, gifts for gamers men, christmas gifts for men, halloween costumes.
  • LIGHTWEIGHT: These clear blue light glasses feature a lightweight frame, meaning they’ll stay comfy for long-term wear. Perfect as blue blockers glasses for women or mens blue light glasses, these non-prescription fake glasses for men can be worn throughout the day. The blue light blocking glasses women feature polycarbonate HD lenses, which are anti-reflective and restore true color.
  • WORRY-FREE PURCHASE: If you experience any issues, our support team is ready to assist you quickly. These are the perfect costume glasses for cosplay dressing up.

Floodgate is optional Bedrock authentication

Floodgate lets an Xbox Live-authenticated Bedrock player join without having a Java Edition account. Install the Floodgate build matching your platform and configure Geyser to use Floodgate authentication. If every Bedrock player already has a Java account and you want the server’s ordinary Java authentication, Floodgate is not required.

Floodgate creates an authentication key named key.pem. Treat that file like a server credential. The official documentation warns: “DO NOT DISTRIBUTE THIS KEY TO ANYBODY!” A leaked key can allow an attacker to bypass Java authentication and compromise the server.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Choose the right installation layout

Layout Where Geyser runs Best fit Important networking detail Operational complexity
Plugin Inside Paper, Spigot, or another supported Bukkit-derived server A single Java server Expose Geyser’s Bedrock UDP listener, commonly port 19132 Lowest; one server and one configuration
Mod Inside a supported Fabric server A Fabric-based Java server Expose the configured Bedrock UDP listener Low, but the Geyser build must match the platform
Proxy On BungeeCord, Waterfall, or Velocity Several Java back ends behind one entry point Bedrock connects to the proxy; back ends can remain private Higher; proxy routing and shared Floodgate keys must be correct
Standalone As a separate Geyser process Geyser on another machine or an independently managed service Expose the standalone Bedrock listener and configure its remote Java target Moderate; two processes and two network paths

Download the build intended for your platform. A Spigot-derived server needs the plugin build; Fabric needs the Fabric build; a proxy needs the corresponding BungeeCord, Waterfall, or Velocity build; and a separate machine needs the standalone build. Using the wrong build is a common cause of missing files or a component that never loads.

Install Geyser on Paper, Spigot, or another plugin server

1. Put the platform-specific jar in the plugins folder

  1. Stop the Java server cleanly.
  2. Download the Geyser jar for your server platform.
  3. Place that jar in the server’s plugins directory. Do not put a standalone jar in this directory.
  4. Start the server once. Geyser creates its configuration and data files during startup.
  5. Stop the server again before editing the generated configuration.

Check the startup log after the first launch. The purpose of this pass is to confirm that the plugin was discovered and to let it create its files; do not try to configure a file that has not yet been generated.

2. Set the Java target and Bedrock listener

Open Geyser’s generated configuration. Set the Java server target to the address and port that Geyser should use for the local Java server. In a normal plugin installation this is the Java server on which the plugin is running; in a more unusual arrangement it may be another reachable Java endpoint.

Rank #2
Windex Gaming Cleaning Wipes, Pre-Moistened Wipes to Instantly Clean all Gaming Gear and Electronics, Resealable Packaging for a Freshness Lock, 25 count (Pack of 1)
  • WINDEX GAMING WIPES: effortlessly clean all your gaming gear and gaming electronics in one easy step with our new Windex Gaming Wipes
  • AMMONIA FREE: our ammonia-free formula is safe to use on all of your favorite gaming equipment like consoles, headsets, controllers, screens, keyboards, and more
  • PRE-MOISTENED WIPES: each wipe instantly removes dust, dirt, and stubborn smudges and fingerprints leaving a streak-free shine
  • ANTI-STATIC: great for cleaning and wiping down your gaming gear and electronics leaving behind no visible residue
  • COMPACT RESEALABLE PACKAGE: store your pack of Windex Gaming Wipes anywhere in your home for whenever a quick and easy wipedown is needed

Set the Bedrock listener’s address and port to values your host permits. Geyser commonly uses UDP port 19132, but that is not guaranteed. Some hosting companies allocate a different Bedrock port, and the value in the host’s control panel must match the value in Geyser’s configuration.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

3. Expose UDP to players outside your LAN

  1. Forward the configured Bedrock port on your router to the Java server’s local address.
  2. Forward it as UDP. Forwarding only TCP does not provide the Bedrock transport Geyser needs.
  3. Allow the same UDP port through the operating system firewall and any provider-level firewall.
  4. If your host gives you a custom port, use that port in the forwarding rule and tell Bedrock players to use it.

Players on the same LAN may see the server in Bedrock’s Friends tab, but that discovery does not prove that internet clients can reach it. Test from a separate network, such as a mobile connection, after the UDP rule is active.

4. Restart and connect from Bedrock

Restart the server after configuration edits. In Bedrock, add a server using the public address and the configured Bedrock port. Bedrock clients must use the Bedrock listener’s port, not automatically the Java server port. A Java player can continue using the normal Java address and port.

Install Geyser on Fabric

Use the Fabric build rather than a Bukkit plugin. Place the Geyser Fabric mod and its required dependencies in the Fabric server’s mods directory, then start the server so Geyser generates its files. Configure the Java target and Bedrock UDP listener in the generated configuration, open the selected UDP port in the host firewall, and restart after editing.

The network decisions are the same as on Paper or Spigot: Bedrock players connect to Geyser’s UDP address and port, while Java players use the Java server endpoint. Keep the Geyser build aligned with the Fabric environment and the server version you operate.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Sale
LISEN Cell Phone Stand Phone Holder for Desk, Office Decor Gadgets for Men
  • Ergonomic & Adjustable Design: Fight "text neck" and improve your posture. Designed for comfort, it offers an adjustable height (7.1in-8.5in) (1.4in adjustable range) and angle (5°-85°) Please note: cell phone stand is only 9 inches tall—the length of a standard pencil
  • Without blocking subtitles Perfect for office desk Tiktok Face Time Zoom video—this is the ultimate kitchen desk essential for phones! Perfect viewing experience while reducing neck back strain, A must-have for gamers streamers desk, and anyone who values both style and support!
  • Sleek & Stable Design fits Otterbox Case: Say goodbye to bent cables, tangles, and tip-overs! LISEN’s stylish adjustable desk phone holder features a built-in charging hole and smart cable management, keeping your phone secure and your workspace clutter-free cool gadgets for men
  • ANTI-SLIP DESIGN free hands: The under 10.00 items easy gadgets back and the bottom of this kitchen essentials for women are fully covered by anti-skid silicone, which LISEN stand up desk decor can provide maximum protection device from any scratches and slides
  • Your Perfect Viewing Companion:If your product arrives damaged or breaks within 365 days, reach out to LISEN for a quick and hassle-free solution. Struggling with assembly, like tightening the screw? We’ve got your back! Your experience matters to us. (Product including: phone Holder stand*1, screw*1, hexagon screwdriver*1, specification*1)

Use Geyser with BungeeCord, Waterfall, or Velocity

Install Geyser at the proxy entry point

For a proxy network, install Geyser on the proxy rather than expecting each back end to accept Bedrock traffic. Bedrock clients connect to the proxy’s Bedrock listener, and the proxy routes them to a Java back end. This gives the network one Bedrock-facing entry point.

Install the proxy-specific Geyser build and, when passwordless Bedrock authentication is required, the matching Floodgate component for the proxy topology. Configure the proxy’s Java routing and Bedrock listener, then expose the listener’s UDP port at the proxy’s public address.

Share one Floodgate key across the network

If Floodgate is also installed on Java back ends, every relevant instance must use the same key.pem. Copy the key securely to the required proxy and back-end locations; never send it through public chat, commit it to a repository, or include it in a downloadable server pack.

Route Bedrock clients to the proxy address, not directly to a back end. A direct back-end connection bypasses the proxy’s Geyser and authentication path and commonly results in a rejected login or an unreachable server.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Proxy-specific failure pattern

If Java players can move between servers but Bedrock players are rejected, check the proxy first: Geyser must be loaded there, the Bedrock port must reach the proxy, and all Floodgate instances must use the same key. Only after those checks should you investigate an individual back end.

Rank #4
Ledagic IC+RGBW USB Powered Led Light Bar with App & Remote Control, 2 Pack
  • Easy Installation: Our gaming lights have been designed to enhance your entertainment experience. Simply position the led light bar next to your TV or game console to create a game room environment with ease. They come with USB power and a 60 inch cord for direct mounting and mobility
  • Audio Syncing & Extensive Mode: The built-in high-sensitivity music sensor allows you to sync the TV led lights to your favorite music. Lights react and move to the beat of music, film and game audio, creating an incredible immersive sound and light experience – and all without the need for an additional hub. You can choose from 64+ patterns, including strobe, illusion, jump, energy, gradient, running, chasing, fluttering mode etc. Each mode can be applied to different scenes
  • 64+ Chasing IC+RGB & W Effect: The independent control design of IC+RGB and white all-in-one multifunctional rgbw led bar lights monitor backlight allows you to easily switch the led lights for desk between IC+RGB and white to enjoy a variety of lighting effects, you can choose white lighting mode with high brightness for better illumination when working, etc. Choose IC+RGB lighting mode when you need to create an entertaining atmosphere for the light show, 16 million colours of Color changing rgb light bar let you dance to the beat and create a dynamic party atmosphere
  • Dynamic and Dimmable Lights: 1%-full brightness free brightness adjustment gives you the flexibility to adjust dimmable led light bar for room decorations or a variety of occasions
  • USB Powered: USB light bars for room can be powered by powernank, usb charger, TV, Monitor, laptop PC mainframe, making behind TV led lighting bar easy to install in any location.TV led lights are powered by the TV usb interface / PC mainframe, can be turned on/off synchronously with TV / PC

Run Geyser as a standalone process

Standalone is useful when the bridge should run on another machine, in a separate container, or independently from the Java server process.

  1. Create a dedicated directory for Geyser.
  2. Place the Geyser standalone jar in that directory.
  3. Launch it once. The first run creates the configuration and required data files.
  4. Stop Geyser and edit the generated configuration.
  5. Set the remote Java server address and port. This must be reachable from the machine running Geyser.
  6. Set the Bedrock listener address and UDP port that your network can expose.
  7. Launch Geyser again and watch its log for a successful startup.

Open the standalone listener’s UDP port in the machine firewall and any upstream firewall. The Java server’s own port may remain private if only the standalone machine needs to reach it.

Add Floodgate for Bedrock accounts without Java Edition

Plugin, mod, and proxy installations

Install the Floodgate jar or component built for the same platform as Geyser: the Java server platform for a direct installation, or the documented proxy topology for a proxy network. Start the platform once if necessary so Floodgate creates its data and key files. Configure the installation according to that platform’s generated files, then restart both components after changes.

Standalone sequence

For standalone Geyser, the documented order is:

  1. Install the platform-specific Floodgate jar on the Java server.
  2. Set Geyser Standalone’s auth-type to floodgate.
  3. Copy Floodgate’s key.pem into the same directory as Geyser Standalone.
  4. Restart Geyser Standalone.

The key must be readable by the Geyser process, but its permissions should prevent ordinary users and unrelated services from reading it. If you rotate or replace the key, update every proxy and back end that participates in the Floodgate path.

What the player experiences

A Bedrock player signs in through Xbox Live on the Bedrock device and then connects to the server’s Bedrock address and port. Floodgate handles the Bedrock identity so a separate Java Edition account is not required. Java players continue to authenticate through the Java route.

Best Value
Sale
HUANUO FlowLift™ Dual Monitor Stand, Fully Adjustable Gaming Monitor Desk Mount for 13–32″ Computer Screens, Full Motion VESA 75x75/100x100 with C-Clamp & Grommet Base, Each Arm Holds 4.4 to 19.8 lbs
  • Compatible with Wide Screens - To ensure compatibility with the dual monitor mount, your each monitor must meet three conditions at the same time: First, computer screens size range: 13 to 32 inches. Second, screen weight range: 4.4 to 19.8 lbs. Third, the back of the monitor screen must have VESA mounting holes with a pitch of 75x75mm or 100x100mm.
  • Regarding the compatibility with desks - Your desk must meet three conditions at the same time: First, desk material: Only wooden desks are recommended, plastic or glass desks cannot be used. Second, desk thickness range: 0.59" - 3.54". Third, the bottom of the desk should not have any cross beams or panels, as this will interfere with installation. We recommend carefully checking that your desk and monitors meets all above conditions before purchasing.
  • Dual C-Clamp Hold - Worried your dual monitors might wobble or slip? Our upgraded base uses a larger platform plus a dual C-clamp structure to lock the dual monitor arm firmly to your desk. Each arm safely keeps your screens steady while you type, click and game—no shaking, no sliding, just a clean and secure setup you can trust every day. It also provides Grommet Mounting installation choice, both options ensure stable and secure fixation for your 0.59" - 3.54" desk.
  • Full-Motion Adjustment For Comfortable View - Pull the screen closer when you’re deep in a spreadsheet, push it back to watch videos, or rotate to portrait for coding — moving everything smoothly with just one hand. The monitor stand offers +85°/-50° tilt, ±90° swivel and 360° rotation. Raise your monitor up to 15.75″ to support a healthy sitting posture. Whether you’re working from home, gaming through the night, or switching between video calls and documents, getting the screens to your natural line of sight helps relieve neck, shoulder and back strain so you can stay focused longer with less fatigue.
  • Keep Your Desk Organized: By lifting both screens off the desktop, this dual monitor stand opens up valuable space for your keyboard, notebook, docking station or a simple, clutter-free work area. Built-in cable management guides wires along the arms, keeping cords out of sight and out of the way. Enjoy a tidy, modern workstation that looks as good as it feels to use.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Username prefixes, collisions, skins, and whitelists

Keep the username prefix unless collisions are controlled

Floodgate normally distinguishes Bedrock names from Java names with a username prefix. Removing that prefix can make names look cleaner, but it is not recommended unless you are certain that Java and Bedrock names cannot overlap. A collision can make commands ambiguous and can produce problems such as being unable to teleport to one of two players.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Change username-prefix only after checking your existing player names, plugins, permissions, command selectors, and future account policy. If a collision appears, restore a distinguishing prefix rather than trying to resolve every command and identity conflict separately.

Whitelist Bedrock players with Floodgate commands

Floodgate 2.0 provides these commands:

  • fwhitelist add <name>
  • fwhitelist remove <name>

Enter the Bedrock player’s name without the Floodgate username prefix. The command handles the Floodgate identity format; adding the prefix yourself can cause the whitelist entry not to match.

Bedrock skins

Floodgate 2.0 is intended to make Bedrock skins visible to Java players. A skin may not appear immediately because uploads can wait in a processing queue. Treat a short delay as a presentation issue rather than evidence that authentication failed.

Port, firewall, and address checklist

  • Use UDP: the Bedrock listener requires UDP, commonly 19132.
  • Match every layer: Geyser’s configured port, router forwarding rule, host firewall rule, provider allocation, and the port entered in Bedrock must agree.
  • Use the correct destination: with a proxy, forward to the proxy; with standalone, expose the standalone machine; with a plugin, expose the Java server host.
  • Do not assume the Java port: Bedrock clients use Geyser’s Bedrock port, which may differ from the Java listener.
  • Check provider restrictions: some hosts do not permit arbitrary UDP ports or require you to request a separate Bedrock allocation.

Troubleshoot common connection and authentication failures

“Unable to connect to world”

  1. Confirm the Bedrock address is the public address of the Geyser listener, not an internal address.
  2. Confirm the port is the configured Bedrock UDP port and is entered correctly in Bedrock.
  3. Verify that the host exposes that UDP port and that the operating-system and provider firewalls allow it.
  4. For standalone Geyser, verify that its configured remote Java address and port are reachable from the standalone machine.
  5. For a proxy, verify that the Bedrock packet reaches the proxy rather than a private back end.

Bedrock reaches the server but authentication fails

  • Confirm Floodgate is installed for the platform actually handling the connection.
  • Confirm Geyser’s auth-type is set to floodgate when using standalone Floodgate authentication.
  • Confirm the matching key.pem is present and readable by Geyser.
  • On a proxy network, confirm every Floodgate instance uses the same key.
  • Restart after changing authentication settings.

Proxy network rejects Bedrock players

Install Geyser on the proxy, route Bedrock clients to that proxy, expose the proxy’s UDP listener, and use one shared Floodgate key wherever Floodgate is installed. Installing Geyser only on a back end does not provide a Bedrock path to the proxy’s public address.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Commands target the wrong player or names cannot coexist

Restore or change the username prefix and review duplicate Java and Bedrock names. Do not remove the prefix merely to improve appearance when the server cannot guarantee unique names.

Whitelist entries do not work

Use fwhitelist add <name> or fwhitelist remove <name> and enter the Bedrock name without its prefix. Confirm that the command is being run on the instance that controls the relevant player list.

Pre-launch verification

  1. Confirm the Geyser build matches the server, proxy, or standalone layout.
  2. Start once to generate files, then edit the Java target and Bedrock listener.
  3. Confirm the listener uses UDP and record the exact externally reachable port.
  4. Open that port in the router and every applicable firewall.
  5. If using Floodgate, install the matching component, set the required authentication mode, and protect key.pem.
  6. If using a proxy, install Geyser at the proxy, route Bedrock there, and synchronize the Floodgate key with back ends.
  7. Test from outside the LAN with a Bedrock client.
  8. Test both a Floodgate Bedrock account and an ordinary Java account when both account types are part of your community.
  9. Test a whitelist entry and a command involving both a Java and Bedrock player before opening the server publicly.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More quests from Patch Notes

  1. How to Set Up a RedM (RDR2) Server in 2026: License Key, txAdmin and server.cfg, Step by StepBlog11min
  2. Best RedM (RDR2) Server Hosting in 2026: Comparing Four Hosts on Slots, Memory and PriceBlog10min
  3. How to Host a Mindustry Server in 2026: server-release.jar, Port 6567 and the Commands That MatterBlog7min
Recommended PC Tool
Recommended PC Tool
PC Slower Than It Used to Be?Free scan - under a minute
Crashes, No Sound, or Screen Glitches?Free driver scan

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.