# MC Data Bridge<\/p>\n
MC Data Bridge is a robust, high-performance hybrid plugin for PaperMC (Spigot), **Folia**, BungeeCord, and Velocity. It is designed to seamlessly synchronize player data across multiple Minecraft servers, ensuring that players have a consistent experience by retaining their health, hunger, experience, inventory, **Ender Chests, Advancements, Statistics, and Persistent Data** as they move between linked servers.<\/p>\n
## Compatibility<\/p>\n
* **Minecraft Version:** `1.21.x` and `26.1.x`
\n* **Server Platforms:** PaperMC (Purpur), **Folia**, Spigot
\n* **Proxy Platforms:** BungeeCord, Waterfall, Velocity
\n* **Java Version:** 25+<\/p>\n
This plugin is a hybrid build and the same JAR file works on all supported platforms, automatically activating the correct functionality for each platform.<\/p>\n
## Features<\/p>\n
* **Hybrid Plugin:** A single JAR file works on your PaperMC\/Spigot\/Folia servers and your BungeeCord\/Velocity proxy.
\n* **SHA-256 Data Integrity:** Implements cryptographic checksums with server-side salting to detect and prevent manual database tampering or corruption.
\n* **Industrial Identity Protection:** Tracks `last_known_name` and secure identity hashes to prevent identity hijacking and manage UUID transitions in hybrid (Cracked\/Premium) environments.
\n* **Zero-Tick Identity Verification:** Database locks and identity checks are performed during the `AsyncPlayerPreLoginEvent`, ensuring that player state is verified and ready before they even reach the server’s “Join” state.
\n* **Regionalized Folia Support:** Built with `SchedulerUtils` to handle regionalized threading, ensuring safe execution on Folia’s multi-threaded clusters.
\n* **Administrative Inspector GUI (NEW):** A visual interface for administrators to inspect saved player data (inventories, stats, PDC) even when the player is offline.
\n* **Proxy-Initiated Saves:** The proxy (BungeeCord\/Velocity) orchestrates the data saving process, ensuring that a player’s data is saved from their source server *before* they connect to the destination server. This eliminates race conditions.
\n* **Fully Asynchronous:** All database and serialization operations are performed on a separate thread, ensuring that your server’s main thread is never blocked.
\n* **Robust Locking Mechanism:** A database-level locking mechanism with an automatic timeout and heartbeats prevents data corruption.
\n* **Version-Independent Item Serialization:** Player inventories are serialized using native binary methods (Paper\/Folia) or NBT-API fallback (Spigot), ensuring 100% integrity across updates.
\n* **Cross-Server Player Data Sync (Granular Control):**
\n * Health (Attribute-aware)
\n * Food Level, Saturation, & **Exhaustion**
\n * Experience (Total XP, current XP, and Level)
\n * Inventory & Armor Contents
\n * Active Potion Effects
\n * **Ender Chest Contents**
\n * **Advancements & Recipes**
\n * **Player Statistics** (Vanilla stats)
\n * **Persistent Data Container (PDC)** (Custom metadata)
\n * **Flight & GameMode** status
\n* **Resilient Connection Pooling:** Uses HikariCP with optimized settings for resilience against network jitter.
\n* **Flexible Storage:** Support for **MySQL\/MariaDB** or local **SQLite** databases.
\n* **Granular Sync Control**: Enable or disable synchronization for any specific data type via `config.yml`.
\n* **Server\/World Blacklist**: Prevent synchronization on specific servers or worlds.<\/p>\n
## Installation<\/p>\n
1. **Download the Plugin JAR:**
\n * Download the latest release JAR (`mc-data-bridge-*.jar`) from this page (Modrinth) or the official GitHub Releases.
\n2. **Deploy to Servers:**
\n * Copy the single `mc-data-bridge-*.jar` file into the `plugins\/` folder of **each PaperMC\/Folia server** you wish to synchronize.
\n * Copy the **same JAR file** into the `plugins\/` folder of your **BungeeCord or Velocity proxy server**.
\n3. **Optional: Manual Build (For Developers)**
\n * To build from source, clone the repository and run `mvn clean package`.<\/p>\n
## Commands & Permissions<\/p>\n
| Command | Description | Permission | **Proxy Commands:** ## Configuration<\/p>\n A `config.yml` file will be generated in the `plugins\/mc-data-bridge\/` folder after the first run. **Existing configs will be safely auto-updated.**<\/p>\n “`yaml # A list of JDBC properties to apply. # HikariCP Connection Pool Settings # A unique name for this server. This is CRITICAL for data locking. # Toggle specific data to sync # Security & Identity identity: ### Detailed Configuration Breakdown<\/p>\n * **`database.type`**: Choose between `mysql` (external) or `sqlite` (local file). ## \ud83d\udcca Technical: Database Schema<\/p>\n | Column | Type | Description | — Seamlessly sync player inventory, health, XP, and effects across your BungeeCord\/Velocity network.<\/p>\n","protected":false},"featured_media":99020,"template":"","meta":{"_minecraft_slug":"mc-data-bridge","_minecraft_project_id":"oYE8njDp","_minecraft_author":"XvGwest","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":387,"_minecraft_follows":4,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"mc-data-bridge.zip","_minecraft_size_bytes":30321336,"_minecraft_version_count":11,"_minecraft_updated_at":"2026-05-16T11:02:28.391198Z","_minecraft_date_created":"2025-09-08T07:53:45.029776Z","_minecraft_date_modified":"2026-04-29T16:56:16.504159Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/mc-data-bridge","_minecraft_icon_attachment_id":99020,"_minecraft_imported_at":"2026-06-05T16:33:19+00:00","_minecraft_import_hash":"1f5634032c5c9ad57f2d839784299d60","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,894,125,873,126,127,128,129,91,92,985,992],"mod_loader":[130,895,131,132,133,134,986,993],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-99019","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-bungeecord","mod_category-folia","mod_category-library","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-utility","mod_category-velocity","mod_category-waterfall","mod_loader-bukkit","mod_loader-bungeecord","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","mod_loader-velocity","mod_loader-waterfall","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n| :— | :— | :— |
\n| `\/databridge inspect
\n| `\/databridge migrate
\n| `\/databridge unlock
\n| `\/databridge reload` | Reloads the configuration and DB pool. | `databridge.admin.reload` |<\/p>\n
\n– `\/databridge unlock
\n– `\/databridge forceunlock
\n# Database Configuration
\ndatabase:
\n type: mysql # “mysql” or “sqlite”
\n host: localhost
\n port: 3306
\n database: minecraft
\n username: user
\n password: password
\n sqlite-file: “player_data.db”<\/p>\n
\n properties:
\n useSSL: false
\n allowPublicKeyRetrieval: true<\/p>\n
\n pool-settings:
\n maximum-pool-size: 10
\n minimum-idle: 10
\n max-lifetime: 1800000 # 30 minutes
\n connection-timeout: 5000 # 5 seconds
\n idle-timeout: 600000 # 10 minutes<\/p>\n
\nserver-id: “default-server”<\/p>\n
\nsync-data:
\n health: true
\n food-level: true
\n experience: true
\n inventory: true
\n armor: true
\n potion-effects: true
\n ender-chest: true
\n advancements: true
\n statistics: true
\n pdc: true
\n flight-gamemode: true<\/p>\n
\nsecurity:
\n verify-data-integrity: true
\n seed: “change-me-to-a-long-random-string” # SALT FOR CHECKSUMS<\/p>\n
\n mode: PREMIUM # PREMIUM or HYBRID
\n auto-migrate-fastlogin: false
\n auto-migrate-authme: false
\n“`<\/p>\n
\n* **`server-id` (Required):** You **must** set a unique name for each backend server.
\n* **`security.seed`**: A secret string used to salt all SHA-256 hashes. Change this immediately!
\n* **`identity.mode`**: Choose between `PREMIUM` (strictly enforces UUID consistency) or `HYBRID` (allows flexible identity shifts). Note: **`HYBRID` mode is required** to enable auto-migration features like `auto-migrate-fastlogin`.
\n* **`sync-data`**: Individual toggles for every data type.
\n* **`sync-blacklist`**: Define servers or worlds where synchronization should be skipped.<\/p>\n
\n| :— | :— | :— |
\n| `uuid` | VARCHAR(36) | The player’s Unique ID (Primary Key). |
\n| `data` | LONGBLOB | The serialized binary data snapshot. |
\n| `data_checksum` | VARCHAR(64) | SHA-256 integrity hash of the data packet. |
\n| `is_locked` | BOOLEAN | Prevents concurrent writes from multiple servers. |
\n| `locking_server` | VARCHAR(255) | The ID of the server holding the lock. |
\n| `lock_timestamp` | BIGINT | Heartbeat to detect and recover from crashes. |
\n| `last_known_name` | VARCHAR(16) | Used for identity tracking and migration. |
\n| `identity_hash` | VARCHAR(64) | Salted hash of Name+UUID+Seed for verification. |<\/p>\n
\n_For more detailed information, please refer to the official documentation._<\/p>\n","protected":false},"excerpt":{"rendered":"