MC-Data-Bridge

插件

· 作者 XvGwest

在您的 BungeeCord/Velocity 网络中同步玩家数据、物品栏、生命值、经验值、效果等。

0 本站下载 0 关注 更新于 1 个月前

最新 2.2.3 · 26.3 · Bukkit / BungeeCord

一键开服(送7天)

MC Data Bridge

MC Data Bridge 是一款高性能混合插件,适用于 PaperMC(及其分支如 Purpur)、Folia、Spigot、Bukkit、BungeeCord(及其分支如 Waterfall)和 Velocity。它通过分布式锁、单事务原子持久化和事件驱动消息传递,在关联的 Minecraft 服务器之间同步玩家数据。

兼容性

  • Minecraft 版本: 1.21.x - 26.3.x
  • 服务端平台: PaperMC, Purpur, Spigot, Bukkit, Folia
  • 代理端平台: BungeeCord, Waterfall, Velocity
  • Java 版本: 25+

该插件是一个混合单 JAR 构建包,可在所有支持的服务端和代理端平台上运行。


快速开始

  1. 部署插件:将单个 mc-data-bridge-*.jar 文件放入每个 Minecraft 服务器(Paper/Folia/Spigot)的 plugins/ 文件夹以及你的代理端(Velocity/Bungee)中。

  2. 配置后端:编辑每个后端服务器上的 plugins/mc-data-bridge/config.yml:

    • 设置唯一的 server-id(例如 server-id: "survival-1")。
    • 配置 MySQL 或 MariaDB 凭据(多服务器网络必需。需要帮助设置数据库?请参阅 DATABASE_SETUP.md)。
    • 设置 security.seed 为一个秘密随机字符串。
  3. 重启服务器:重启你的代理端和后端服务器。数据同步将自动运行。


功能

  • 全面的跨服务器数据同步:同步生命值、饥饿值、饱和度、消耗值、经验值、物品栏、护甲、药水效果、末影箱、进度、配方、原版统计信息、持久化数据容器 (PDC) 元数据、飞行和游戏模式状态、伙伴宠物、跨服务器地图以及独立的游戏模式物品栏配置文件。
  • 物品复制漏洞防护:在服务器传输期间自动关闭打开的物品栏视图,并在持有传输锁时取消容器点击、拖拽、物品掉落、拾取和交互操作。
  • 交互式物品栏与末影箱检查器 (invsee / endersee):实时检查离线或跨服务器的玩家物品栏和末影箱。默认提供安全的只读模式,并为拥有权限的管理员提供交互式编辑模式(使用 --edit 标志或右键单击),在 GUI 关闭时自动持久化到数据库。
  • 混合单 JAR 架构:单个 JAR 文件即可在您的 PaperMC、Folia、Spigot、BungeeCord 和 Velocity 服务器上运行,并自动执行相应的平台处理器。
  • 身份模式与认证自动迁移:在严格的 PREMIUM UUID 强制模式或灵活的 HYBRID 身份切换之间进行切换。当 FastLogin (PreLogin) 或 AuthMe (Login,包括 AuthMe 原生 TOTP/2FA) 验证后,自动将玩家数据从离线 UUID 迁移至正版 UUID。
  • 身份历史与安全追踪:追踪 last_known_name 和安全 identity_hash(Keyed HMAC-SHA256),以检测身份劫持、UUID 冲突和手动数据库篡改。
  • 分布式锁围栏令牌 (lock_version):采用单调递增的生成计数器来隔离过期的服务器写入,确保延迟的服务器(例如 GC 暂停后或网络抖动)永远无法覆盖活跃的玩家会话。
  • 事件驱动锁释放消息:源服务器在保存玩家状态后立即发送 LockReleased 信号,唤醒目标端的预登录线程,并将服务器切换时的锁等待延迟降低至约 50ms(具有自动回退到数据库轮询的功能)。
  • 单事务原子持久化:将规范化组件更新(inventories, statistics, metadata, companions, maps)和锁释放合并到单个数据库连接和事务中(setAutoCommit(false) ... commit())。
  • 规范化数据完整性校验和:计算经过 security.seed 加盐的规范化玩家状态组件的标准 SHA-256 完整性哈希值,以便在加载前验证数据完整性。
  • Folia 多线程兼容:使用区域化调度程序(GlobalRegionScheduler, EntityScheduler)以确保在 Folia 的区域化线程模型中的线程安全。
  • Prometheus 指标导出器:内置 HTTP 服务器,暴露实时同步性能指标(同步延迟、缓存命中率、HikariCP 池状态),用于 Grafana 仪表板。
  • 细粒度同步与黑名单控制:通过 config.yml 启用或禁用任何特定数据类型的同步,或通过排除特定的服务器和世界来控制同步范围。

命令与权限

命令 描述 所需权限
/databridge inspect <player> [inv|ender] [--edit] 打开图形界面以查看或编辑已保存的玩家数据 databridge.inspect(使用 --edit 时需 .edit)
/databridge invsee <player> [--edit] 直接打开玩家物品栏查看或编辑的图形界面 databridge.inspect(使用 --edit 时需 .edit)
/databridge endersee <player> [--edit] 直接打开玩家末影箱查看或编辑的图形界面 databridge.inspect(使用 --edit 时需 .edit)
/databridge unlock <player> 解除卡住的数据锁定(适用于 Spigot、Folia、Bungee、Velocity) databridge.admin
/databridge forceunlock <player> 代理命令:强制立即发送解锁信号 databridge.admin
/databridge migrate <source> <target> 在 UUID 或名称之间迁移玩家数据 databridge.admin
/databridge reload 重新加载配置并重新连接数据库池 databridge.admin

权限节点:

  • databridge.inspect: 允许以安全只读模式查看玩家数据、物品栏和末影箱。
  • databridge.inspect.edit: 通过 --edit 参数或右键点击交互式编辑物品栏和末影箱所需的高级权限。
  • databridge.admin: 对所有命令和功能拥有完全的管理员访问权限。

文档参考

如需完整的技术图表、关系型数据库架构以及 SpigotMC wiki 页面:

  • DATABASE_SETUP.md — MySQL 与 MariaDB 安装指南(Docker、Linux 主机、防火墙与安全最佳实践)。
  • ARCHITECTURE.md — 架构深度解析、完整序列图及数据库结构。
  • GitHub Repository — 源代码、发行版本、问题反馈及其他文档。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源