SyncMaster-PlayerDataBridge is the professional extension that transforms SyncMaster Core into a complete cross-server player data synchronization solution. Built on the robust SyncMaster Core API, it provides seamless inventory, health, experience, and potion effect synchronization across your entire network.

⚠️ 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.


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-Watchdog – Free supervisor for safe shutdowns on hosting panels

️ 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
⌛ SyncMaster InventoryBridge MySQL – Support for custom items from plugins like ItemsAdder, EcoItems, etc.

What Gets Synchronized
✅ Complete Inventory - Items, armor, offhand, hotbar
✅ Ender Chest - Full ender chest contents
✅ Health & Food - Health, max health, food level, saturation, exhaustion
✅ Experience System - Levels, points, total experience
✅ Potion Effects - Active effects with duration (configurable limits)
✅ Player Statistics - Custom stats (optional)
✅ Player Location - Coordinates and world (optional)
✅ Game Mode - With security restrictions (creative→survival prevention)
✅ Auto-Save System - Configurable intervals with smart caching

️ 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