FloodgateRelink

FloodgateRelink

FloodgateRelink is a plugin designed to ensure seamless UUID consistency for players using Floodgate/Geyser to join your server from both Bedrock and Java editions.

When players link their Bedrock and Java accounts using Geyser's linking system, this plugin ensures that they will retain their original progress, inventory, stats, and permissions — regardless of which platform they switch to later. It achieves this by persisting the UUID of the account that was seen first and reusing it during future joins.

Features:

• ⚙️ Automatically resolves the correct UUID (Java or Bedrock) based on the player's first join.
• 🔗 Fully supports Geyser/Floodgate account linking.
• 💾 Prevents duplicate player data by consistently applying the older UUID.
• 🧠 Intelligent handling for all edge cases related to linking order and join sequence.

Conditions:

• If a player joins first with Java, and later with their linked Bedrock account — the Java UUID will be used.
• If a player joins first with a linked Geyser account — the Java UUID will be used (from the link).
• If a player joins first with an unlinked Geyser account, then links it, and joins again from either platform — the Geyser UUID will be used.
• If a player joins first with Java, and then later with an unlinked Geyser account — after linking, the Java UUID will be used.

This system ensures that the original account the player joined with (before linking) is considered the "primary" identity for data tracking purposes.

Why use FloodgateRelink?

Without proper UUID preservation, switching platforms after linking can cause players to lose their progress. FloodgateRelink prevents this by maintaining a stable and reliable UUID resolution strategy that respects the player’s first entry into your server network — enhancing cross-platform player experience and reducing administrative overhead.

Compatibility:

• This plugin supports only Velocity setup, and is meant for Velocity.
• Compatible with permission, economy, stats, and other plugins that rely on UUID-based player tracking

Dependancy:

• Floodgate (https://geysermc.org/download/?project=floodgate)