SyncMaster Player Data Bridge MySQL - Universal NBT Support Cross-Server

SyncMaster-PlayerDataBridge is a modern cross-server synchronization system that keeps vanilla player data (inventory, health, experience, potion effects) perfectly synchronized across your entire Minecraft network with full NBT support. Players maintain all their items and progress when switching between servers without any risk of duplication exploits — our exclusive SyncMaster-BungeeProxy ensures complete data integrity during transfers. Powered by MySQL and SyncMaster Core for maximum reliability and performance.

⚠️ Requires SyncMaster-Core 1.0.0+ as dependency - This extension leverages the powerful SSL/TLS database connections, UUID validation system, and HikariCP connection pooling from SyncMaster Core.
⚠️ Requires SyncMaster-BungeeProxy for item duplication prevention - This extension works with SyncMaster-BungeeProxy to ensure safe server transfers without item duplication during cross-server synchronization.


Compatibility & Requirements
⭐ Minecraft: 1.19.4 – 1.21.8+ (Paper recommended, Spigot supported)
⭐ Java: 17 or 21 (validated on Temurin 21)
⭐ Required Dependency: SyncMaster-Core 1.0.0+
⭐ Databases: MySQL 5.7+, MariaDB 10.3+ (inherits from Core)


SyncMaster Extension Status
✅ SyncMaster-Essentials – Cross-server essentialsX chat, warps, homes, etc.
✅ SyncMaster-Watchdog – Free supervisor for safe shutdowns on hosting panels
✅ SyncMaster Plugin Data Bridge – Inventory, health, experience, effects synchronization
✅ SyncMaster BungeeProxy – prevents item duplication during server transfers

️ Pending Releases
⌛ SyncMaster Essentials MySQL – EssentialsX economy sync, validated and live in production
⌛ SyncMaster Backup MySQL – Automatic backups and pruning of old records/player data
⌛ SyncMaster Economy MySQL – Advanced synchronization for third-party currency systems


What Gets Synchronized vs What Doesn't
✅ YES - Physical Items & Native Minecraft Data

Complete Inventory System (Universal NBT Support)
✅ ALL items in inventory slots - Every item a player carries, including custom items from ANY plugin
✅ Custom items with NBT - ItemsAdder swords, Oraxen tools, MMOItems armor, EcoItems weapons
✅ Ender Chest contents - Everything stored in ender chest, preserving all NBT data
✅ Armor & Equipment - Helmets, chestplates, leggings, boots, offhand items
✅ Item metadata - Enchantments, lore, custom names, attributes, durability, custom model data

Example: A player has a custom ItemsAdder sword with special NBT? ✅ It syncs perfectly across servers!

❤️ Native Player Attributes (Bukkit/Spigot Data)
✅ Health & Food - Current health, max health, hunger, saturation, exhaustion
✅ Experience - XP levels, XP points, total experience
✅ Active Potion Effects - Speed, strength, regeneration (with configurable duration limits)
✅ Game Mode - Survival, creative, adventure, spectator (with anti-exploit protection)
✅ Location - Current world and coordinates (optional)
✅ Statistics - Play time and basic Minecraft stats (optional)

❌ NO - Plugin Data Stored in External Databases

What PlayerDataBridge CANNOT Sync (Support will be provided soon.)
❌ Skills & Levels (stored in plugin databases, not in player inventory)

• McMMO mining level 100? ❌ NOT synced - requires SyncMaster-McMMO extension
• AureliumSkills farming level 50? ❌ NOT synced - requires dedicated extension
• Custom RPG plugin skills? ❌ NOT synced - requires custom extension

️ Built on SyncMaster Core Foundation
Inherits Core Features:

• SSL/TLS encryption for secure database connections
• Professional UUID validator with cross-server analysis
• ⚡ HikariCP connection pooling (tuned for performance)
• Server groups system for network organization
• ️ Health monitoring with emergency shutdown protection
• Advanced logging and performance metrics
• BungeeCord/Velocity full compatibility

PlayerDataBridge Specific Features:

• Auto-table creation - Creates required database tables automatically
• Intelligent caching - Smart cache with automatic expiration
• Diff-based sync - Only synchronizes changed data for performance
• Detailed sync logs - Complete audit trail of all operations
• ️ Flexible configuration - Module-based sync control
• Developer API - Events and hooks for custom integrations

✨ Key Highlights in v1.0.1

• Complete command system with administrative controls
• Real-time sync monitoring with detailed statistics
• ️ Data validation and integrity checking
• ️ Automatic database management with optimized schema
• Smart group inheritance from SyncMaster Core
• Security restrictions for gamemode synchronization
• ⚡ Performance optimizations with parallel operations
• Comprehensive logging for troubleshooting

️ Database Architecture
Auto-Created Tables:

• syncmaster_player_data - Complete player data storage
• syncmaster_sync_log - Audit trail of all sync operations
• syncmaster_player_cache - Performance caching system

Advanced Features:

• ✅ Automatic table creation with proper indexes
• ✅ Data compression for large inventories
• ✅ Batch operations for performance
• ✅ Connection validation and auto-recovery
• ✅ Cache cleanup with intelligent expiration

⚡ Quick Setup

1. Install SyncMaster-Core first and configure database
2. Download SyncMaster-PlayerDataBridge-1.0.1.jar
3. Drop into plugins folder
4. Restart server (tables auto-created)
5. ⚙️ Configure config.yml
6. Recommended: Set inherit-from-core: true for database config

Commands & Permissions
Command Permission Description
/playerdata playerdata.admin Main command help
/playerdata sync <player> playerdata.admin Force sync specific player
/playerdata status playerdata.admin View system status
/playerdata stats playerdata.admin Performance statistics
/playerdata cache clear playerdata.admin Clear performance cache
/playerdata reload playerdata.admin Reload configuration
️ Security & Performance
Security Features:

• SSL/TLS support inherited from SyncMaster Core
• ️ Data validation and sanitization
• Gamemode restrictions (prevent creative→survival exploits)
• Size limits (max 1MB per player data)
• ⏱️ Effect duration limits (configurable max durations)

Performance Optimizations:

• ⚡ Diff-based synchronization - Only sync changes
• Intelligent caching - Reduce database queries
• Parallel operations - Multiple sync operations simultaneously
• Data compression - Reduce storage and bandwidth
• Connection pooling - Shared HikariCP from Core

Monitoring & Diagnostics

• Real-time statistics - Sync operations, performance metrics
• Detailed logging - Complete audit trail
• Diagnostic commands - System status and troubleshooting
• Performance monitoring - Query times, cache hit rates
• Error reporting - Detailed error messages for support

Network Integration

• Server groups - Inherited from SyncMaster Core configuration
• Multi-network support - Different sync rules per server group
• BungeeCord/Velocity - Full proxy compatibility
• Cross-server events - Real-time sync notifications
• Selective sync - Configure what syncs per server group

⚠️ Important Notes

• Requires SyncMaster-Core - This is an extension, not standalone
• ️ Database sharing - Uses same database as SyncMaster-Core
• SSL inheritance - Automatically uses Core's SSL/TLS settings
• Group compatibility - Works with Core's server group system
• ️ Security aligned - Follows Core's security and validation rules