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 构建包,可在所有支持的服务端和代理端平台上运行。
快速开始
-
部署插件:将单个
mc-data-bridge-*.jar文件放入每个 Minecraft 服务器(Paper/Folia/Spigot)的plugins/文件夹以及你的代理端(Velocity/Bungee)中。 -
配置后端:编辑每个后端服务器上的
plugins/mc-data-bridge/config.yml:- 设置唯一的
server-id(例如server-id: "survival-1")。 - 配置 MySQL 或 MariaDB 凭据(多服务器网络必需。需要帮助设置数据库?请参阅 DATABASE_SETUP.md)。
- 设置
security.seed为一个秘密随机字符串。
- 设置唯一的
-
重启服务器:重启你的代理端和后端服务器。数据同步将自动运行。
功能
- 全面的跨服务器数据同步:同步生命值、饥饿值、饱和度、消耗值、经验值、物品栏、护甲、药水效果、末影箱、进度、配方、原版统计信息、持久化数据容器 (PDC) 元数据、飞行和游戏模式状态、伙伴宠物、跨服务器地图以及独立的游戏模式物品栏配置文件。
- 物品复制漏洞防护:在服务器传输期间自动关闭打开的物品栏视图,并在持有传输锁时取消容器点击、拖拽、物品掉落、拾取和交互操作。
- 交互式物品栏与末影箱检查器 (
invsee/endersee):实时检查离线或跨服务器的玩家物品栏和末影箱。默认提供安全的只读模式,并为拥有权限的管理员提供交互式编辑模式(使用--edit标志或右键单击),在 GUI 关闭时自动持久化到数据库。 - 混合单 JAR 架构:单个 JAR 文件即可在您的 PaperMC、Folia、Spigot、BungeeCord 和 Velocity 服务器上运行,并自动执行相应的平台处理器。
- 身份模式与认证自动迁移:在严格的
PREMIUMUUID 强制模式或灵活的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 — 源代码、发行版本、问题反馈及其他文档。
MC Data Bridge
MC Data Bridge is a high-performance hybrid plugin for PaperMC (and forks like Purpur), Folia, Spigot, Bukkit, BungeeCord (and forks like Waterfall), and Velocity. It synchronizes player data across linked Minecraft servers with distributed locks, single-transaction atomic persistence, and event-driven messaging.
Compatibility
- Minecraft Version:
1.21.x-26.3.x - Server Platforms: PaperMC, Purpur, Spigot, Bukkit, Folia
- Proxy Platforms: BungeeCord, Waterfall, Velocity
- Java Version: 25+
This plugin is a hybrid single-JAR build that operates across all supported server and proxy platforms.
Quick Start
-
Deploy Plugin: Place the single
mc-data-bridge-*.jarfile into theplugins/folder of each Minecraft server (Paper/Folia/Spigot) and your proxy (Velocity/Bungee). -
Configure Backend: Edit
plugins/mc-data-bridge/config.ymlon each backend server:- Set a unique
server-id(e.g.server-id: "survival-1"). - Configure MySQL or MariaDB credentials (Required for multi-server networks. Need help setting up a database? See DATABASE_SETUP.md).
- Set
security.seedto a secret random string.
- Set a unique
-
Restart Servers: Restart your proxy and backend servers. Data synchronization runs automatically.
Features
- Comprehensive Cross-Server Data Synchronization: Synchronizes health, food level, saturation, exhaustion, experience, inventory, armor, potion effects, ender chests, advancements, recipes, vanilla statistics, persistent data container (PDC) metadata, flight and gamemode status, companion pets, cross-server maps, and separate gamemode inventory profiles.
- Item Duplication Exploit Protection: Automatically closes open inventory views during server transfers and cancels container clicks, drags, item drops, pickups, and interactions while transfer locks are held.
- Interactive Inventory & Ender Chest Inspector (
invsee/endersee): Inspect offline or cross-server player inventories and ender chests in real time. Features safe view-only mode by default and interactive edit mode (--editflag or Right-Click) for admins with automatic database persistence upon GUI close. - Hybrid Single-JAR Architecture: A single JAR file operates on your PaperMC, Folia, Spigot, BungeeCord, and Velocity servers, automatically executing the appropriate platform handlers.
- Identity Modes & Authentication Auto-Migration: Toggle between strict
PREMIUMUUID enforcement or flexibleHYBRIDidentity shifts. Automatically migrates player data from offline to premium UUIDs upon verification by FastLogin (PreLogin) or AuthMe (Login, including AuthMe native TOTP/2FA). - Identity History & Security Tracking: Tracks
last_known_nameand a secureidentity_hash(Keyed HMAC-SHA256) to detect identity hijacking, UUID collisions, and manual database tampering. - Distributed Lock Fencing Tokens (
lock_version): Employs monotonic generation counters to fence off stale server writes, ensuring delayed servers (e.g., post-GC pauses or network hiccups) can never overwrite active player sessions. - Event-Driven Lock Release Messaging: Source servers dispatch an instant
LockReleasedsignal upon saving player state, waking destination pre-login threads immediately and reducing server-switch lock wait latency to ~50ms (with automatic fallback to database polling). - Single-Transaction Atomic Persistence: Combines normalized component updates (
inventories,statistics,metadata,companions,maps) and lock releases into a single database connection and transaction (setAutoCommit(false)...commit()). - Normalized Data Integrity Checksums: Computes canonical SHA-256 integrity hashes across normalized player state components salted with
security.seedto verify data integrity before loading. - Folia Multi-Threading Compatibility: Uses regionalized schedulers (
GlobalRegionScheduler,EntityScheduler) to guarantee thread safety across Folia's regionalized threading model. - Prometheus Metrics Exporter: Built-in HTTP server exposing real-time synchronization performance metrics (sync latency, cache hit ratios, HikariCP pool status) for Grafana dashboards.
- Granular Sync & Blacklist Control: Enable or disable synchronization for any specific data type or exclude specific servers and worlds via
config.yml.
Commands & Permissions
| Command | Description | Required Permission |
|---|---|---|
/databridge inspect <player> [inv|ender] [--edit] |
Open GUI to view or edit saved player data | databridge.inspect (.edit for --edit) |
/databridge invsee <player> [--edit] |
Directly open player inventory view or edit GUI | databridge.inspect (.edit for --edit) |
/databridge endersee <player> [--edit] |
Directly open player ender chest view or edit GUI | databridge.inspect (.edit for --edit) |
/databridge unlock <player> |
Release a stuck data lock (Works on Spigot, Folia, Bungee, Velocity) | databridge.admin |
/databridge forceunlock <player> |
Proxy command: force immediate lock drop signal | databridge.admin |
/databridge migrate <source> <target> |
Move player data between UUIDs or names | databridge.admin |
/databridge reload |
Reload configuration and reconnect DB pool | databridge.admin |
Permission Nodes:
databridge.inspect: Permission to view player data, inventories, and ender chests in safe read-only mode.databridge.inspect.edit: Elevated permission required to interactively edit inventories and ender chests via--editor Right-Click.databridge.admin: Full administrative access for all commands and functions.
Documentation References
For full technical diagrams, relational database schemas, and SpigotMC wiki pages:
- DATABASE_SETUP.md — MySQL & MariaDB Installation Guide (Docker, Linux Host, Firewall & Security Best Practices).
- ARCHITECTURE.md — Architectural Deep Dive, Complete Sequence Diagrams, and Database Schemas.
- GitHub Repository — Source code, releases, issues, and additional documentation.
下载 MC-Data-Bridge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MC-Data-Bridge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MC-Data-Bridge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MC-Data-Bridge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MC-Data-Bridge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MC-Data-Bridge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MC-Data-Bridge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MC-Data-Bridge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MC-Data-Bridge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MC-Data-Bridge
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
MC Data Bridge - 更新日志 (v2.2.3)
概述
版本 2.2.3 增加了对 Minecraft 26.3 的兼容性,更新了核心依赖项和 Paper API 目标版本,以支持在 Minecraft 26.3+ 服务器上实现跨服务器的物品栈同步。
主要变更
Minecraft 26.3 兼容性
- 依赖升级: 将
de.tr7zw:item-nbt-api升级至2.16.1(包括 PR #360 中的物品栈镜像解析功能),将io.papermc.paper:paper-api升级至26.3-pre-2.build.0-alpha,并将net.kyoriAdventure 库升级至5.2.0。 - 完整的 26.3 物品与组件支持: 已测试并验证了针对 Minecraft 26.3 的全跨服务器物品同步功能(包括新的白杨木物品、软垫、床以及羊毛/混凝土楼梯和台阶)。
有关安装说明和配置详情,请参阅 README.md、ARCHITECTURE.md 和 DATABASE_SETUP.md。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧