Minecraft plugin floodgate

🔌 About Floodgate

Floodgate is a companion Minecraft plugin for Geyser that enables Bedrock Edition players to join Java Edition servers without requiring a Java account. It provides the authentication and account-linking functionality Floodgate needs to allow Bedrock clients to appear as valid players on online-mode Java servers.

🎯 Purpose

Floodgate's core purpose is to bridge authentication differences between Bedrock and Java editions: it verifies Bedrock (Xbox/Microsoft) identities, maps them to Java-compatible player entries, and supports local and global account linking so a Bedrock player's identity can be recognized consistently across servers using Floodgate. ()

⚙️ Features

• Bedrock account authentication and mapping to Java player accounts. ()
• Local account linking and unlinking commands for players. ()
• A whitelist command for managing Floodgate (Bedrock) players separately from Java whitelists. ()
• A plugin API that other plugins can use to detect and interact with Floodgate-managed Bedrock players. ()

🧩 Who It Is For

Floodgate is intended for server owners and network administrators who run Geyser to allow Bedrock players to join their Java servers, and who need a robust authentication/linking solution for Bedrock identities.

🏗️ Example Use Cases

• Allowing mobile and console Bedrock players to join an existing Java SMP or Survival server while keeping player accounts distinct and trackable.
• Linking a player's Bedrock identity to a Java account so plugins and permissions continue to work consistently for that user.

⌨️ Commands

(Commands and permission nodes are taken from Floodgate's official documentation.) ()

🔐 Permissions

⚙️ Installation

📥 Setup

• Download the appropriate Floodgate build for your server type and place the .jar into your server's plugins/ directory (or install the mod for Fabric/NeoForge where applicable).
• Restart the server and check your console to confirm Floodgate loaded.
• If using Geyser, update Geyser's configuration to use auth-type: floodgate so Geyser delegates Bedrock authentication to Floodgate. ()

📦 Dependencies

• Floodgate is designed to be used with Geyser for Bedrock-to-Java bridging; installation notes and recommended setup are documented in the official Floodgate/Geyser documentation. ()

🧠 Technical Notes

• Floodgate is distributed both as plugins for server software and as mods for Fabric/NeoForge; supported server types include Spigot (and forks such as Paper), BungeeCord, Velocity, and Fabric/NeoForge builds. ()
• Floodgate exposes an API that other plugins can use to query Floodgate player information and respond to Bedrock-specific events. ()

🤝 When This Plugin Is Useful

If you run Geyser to let Bedrock players join your Java servers, Floodgate is the component that handles Bedrock identity and account linking so those players are recognized and usable by Java-side plugins and server systems.