SyncMaster Core MySQL

SyncMaster Core is a powerful player data synchronization system for multiple Minecraft servers. Designed for BungeeCord networks and individual servers, it provides a robust and extensible API to keep player data synchronized in real-time.

SyncMaster-Core is the free nucleus of the SyncMaster ecosystem. It delivers a professional framework to synchronize player data over MySQL/MariaDB, exposes a stable API for commercial extensions, and protects your Paper/Spigot servers with active monitoring, UUID validation, and safe shutdowns.


Compatibility
⭐ Minecraft: 1.19.4 – 1.21.8+ (Paper recommended, Spigot supported)
⭐ Java: 17 or 21 (validated on Temurin 21)
⭐ Databases: MySQL 5.7+, MariaDB 10.3+ (InnoDB UTF-8 mode)

SyncMaster Extension Status
✅ SyncMaster-PlayerDataBridge – cross-server inventories, EnderChest, experience, potion effects and FULL NBT SUPPORT
✅ SyncMaster-Watchdog – Free supervisor for safe shutdowns on hosting panels
✅ SyncMaster-Essentials – Cross-server essentialsX chat, warps, homes, etc.

⌛ SyncMaster-MySQL-Backup – Automatic backups and pruning of old records/player data
⌛ SyncMaster-Economy – Advanced synchronization for third-party currency systems

✨ Key Highlights in v1.0.2

• Complete command system with 9 administrative subcommands
• Real extension detection (not hardcoded)
• ️ Health monitor and emergency shutdown if database or core fails
• Optional Watchdog integration that reinforces shutdowns and notifies your panel
• Smart BungeeCord detector with auto-fixes and detailed reports
• COMPLETE premium/offline UUID validator with per-server and per-player reports
• Improved extension loader with metadata and wrapper support
• ⚙️ Simple mode with guided migration to advanced mode

Main Features
️ Data Platform

• Tuned HikariCP 5.x connection pool
• Automatic creation and verification of tables
• Asynchronous operations and configurable caches
• Extension registry stored in syncmaster_extensions

️ Stability and Security

• Asynchronous health check every 30 seconds
• Critical failure messages designed for ticket workflows
• Integration with external Watchdog to block "zombie" restarts
• Protection against incorrect Bungee/Velocity configurations

Network Tools

• Server-group system to determine which servers share data
• Automatic server-name detection
• Advanced UUID validator with professional capabilities

Professional UUID Validator

• ✅ Automatic detection Premium (v4) vs Offline (v3) UUID
• ✅ Cross-server analysis with per-server reports
• ✅ Per-player validation with complete details
• ✅ Auto-fix for UUID inconsistency issues
• ✅ Detailed reports with warnings and recommendations
• ✅ Full BungeeCord/Offline compatibility
• ✅ Asynchronous operations without server lag

SSL/TLS & Advanced Security

• ✅ SSL/TLS encryption for database connections
• ✅ Certificate validation options (configurable)
• ✅ Connection security with useSSL and verifyServerCertificate
• ✅ Data validation and input sanitization
• ✅ Rate limiting and anti-abuse protection
• ✅ Secure connection pooling with leak detection
• ✅ Auto-reconnect with secure parameters
• ✅ Maximum data size limits (1MB per player)

⚡ Quick Installation

1. Download SyncMaster-Core-1.0.2.jar
2. Drop into plugins folder
3. Start server once
4. ⚙️ Edit config.yml with your MySQL/MariaDB credentials
5. Configure SSL if needed: Set ssl: true and verify-server-certificate: true
6. Restart and run /syncmaster status

Note: Install SyncMaster-Watchdog to reinforce safe shutdowns on Multicraft or Pterodactyl panels

⚠️ Important Warnings

• Avoid kicking players with other plugins before /stop. Bukkit cancels async tasks during shutdown
• Network configuration: All servers sharing data must have bungeecord: true with same online-mode
• SSL Configuration: Enable SSL for production environments with sensitive data

Commands and Permissions
Command Permission Description
/syncmaster help syncmaster.admin Complete help
/syncmaster info syncmaster.admin Plugin information
/syncmaster status syncmaster.admin Database connection status
/syncmaster debug <on/off> syncmaster.admin Debug mode
/syncmaster reload syncmaster.admin Reload configuration
/syncmaster uuid <player> syncmaster.admin Complete UUID validator
/syncmaster bungeecord <status/sync> syncmaster.admin BungeeCord management
/syncmaster extensions syncmaster.admin View loaded extensions
/syncmaster test syncmaster.admin Test connections
Diagnostic Commands

• /syncmaster status - Connection, mode, extensions, and Hikari pool usage
• /syncmaster debug - Host, database, user, SSL state, and active connections
• /syncmaster bungeecord - Safety report with recommended actions
• /syncmaster uuid - Mass validation, per-player analysis, auto-fix, and detailed reports

Reports are also written to the log for ticket usage.

Monitoring and Protection

• Health Monitor verifies Hikari pool status every 30s
• Emergency shutdown with detailed message and Bukkit.shutdown()
• Optional SyncMaster-Watchdog listens for core events and enforces shutdown
• BungeeCord detector reviews spigot.yml, server.properties, and network plugins
• UUID Validator audits UUID consistency across network and per player with complete professional capabilities

Transform your network into a perfectly synchronized ecosystem!