FloodgateRelink
FloodgateRelink 是一款插件,旨在确保通过 Floodgate/Geyser 从基岩版和 Java 版加入服务器的玩家保持 UUID 的一致性。
当玩家使用 Geyser 的绑定系统关联其基岩版和 Java 版账号后,本插件可确保他们无论后续切换至哪个平台,都能保留原有的进度、物品栏、统计数据及权限。该功能通过持久化记录首次登录时的账号 UUID,并在未来登录时重复使用该 UUID 来实现。
特性:
- ⚙️ 根据玩家的首次登录情况,自动解析正确的 UUID(Java 版或基岩版)。
- ? 完全支持 Geyser/Floodgate 账号绑定。
- ? 通过始终应用较早的 UUID,防止玩家数据重复。
- ? 智能处理与绑定顺序和登录序列相关的所有边缘情况。
条件说明:
- 如果玩家首次使用 Java 版登录,随后使用已绑定的基岩版账号登录——将使用 Java UUID。
- 如果玩家首次使用已绑定的 Geyser 账号登录——将使用(来自绑定的)Java UUID。
- 如果玩家首次使用未绑定的 Geyser 账号登录,之后进行绑定,然后从任一平台再次登录——将使用 Geyser UUID。
- 如果玩家首次使用 Java 版登录,随后使用未绑定的 Geyser 账号登录——在绑定后,将使用 Java UUID。
该系统确保玩家最初登录的账号(绑定前)被视为用于数据追踪的“主要”身份。
为何使用 FloodgateRelink?
若无适当的 UUID 保留机制,玩家在绑定后切换平台可能会导致进度丢失。FloodgateRelink 通过维持稳定且可靠的 UUID 解析策略来避免此问题,该策略尊重玩家进入服务器网络的初次登录行为——从而提升跨平台玩家体验并减少管理开销。
兼容性:
- 本插件仅支持 Velocity 环境,专为 Velocity 设计。
- 兼容依赖基于 UUID 的玩家追踪功能的权限、经济、统计等插件。
依赖项:
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:
评论 0
登录后参与评分
还没有评论,来抢沙发吧