BalSync v1.3

Welcome to the first Polymart release of BalSync! This version brings robust MySQL-based balance synchronization for multi-server networks. Below are the key features and improvements.

✨ New Features on Polymart

• Database Synchronization
  Seamlessly sync player balances across multiple servers using a MySQL database. No more inconsistent balances when switching servers!
• Vault Economy Integration
  Works with any economy plugin that supports Vault (EssentialsX, CMI, etc.).
• Auto-Save
  Configurable interval (in seconds) to periodically save all player balances to the database. Disable it if you prefer real-time syncing.
• Database Polling
  When enabled (db-poll-interval), the plugin polls the database for external balance changes and instantly updates online players. Perfect for networks where other plugins or servers modify balances directly.
• Offline Balance Monitoring
  If auto-save is disabled, the plugin can still monitor offline players’ balance changes and save them to the database (via delta updates) – so you never lose a transaction.
• Reset on Join
  Option to reset a player’s balance to zero before loading their database balance. Useful for setups where you want to enforce a clean state on each login.
• Atomic Delta Updates
  Instead of overwriting the whole balance, the plugin applies delta changes to the database. This prevents conflicts when multiple servers modify the same player’s balance concurrently.
• Multi-Language Support
  Built-in translations for:
  • 🇬🇧 English
  • 🇩🇪 German
  • 🇪🇸 Spanish
  • 🇫🇷 French
  • 🇵🇱 Polish
  • 🇧🇷 Portuguese (Brazil)
  • 🇷🇺 Russian
  You can easily add or override messages with your own messages.yml.
• Flexible Notifications
  Choose whether sync notifications appear in chat or the action bar. Customize every message via the language files.
• New Command: /balsync status
  Quickly check current settings (auto-save interval, polling interval, reset-on-join, offline monitoring).
• Connection Pooling
  Uses HikariCP for efficient and reliable database connections. Pool size, timeouts, and SSL are fully configurable.
• Detailed Logging
  Control what gets logged: balance actions, external changes, save-all messages, etc. Helpful for debugging and monitoring.

🔧 Improvements & Fixes

• First Polymart release – all code has been reviewed and optimized for public use.
• Better error handling during database operations.
• Graceful shutdown – saves all balances when the plugin disables.
• Compatibility – tested with Minecraft 1.21 and Vault.

📦 Installation

1. Place the BalSync-1.3-all.jar in your plugins folder.
2. Ensure Vault and a compatible economy plugin are installed.
3. Start the server, then edit the generated config.yml with your MySQL credentials.
4. Restart or reload – BalSync will create the necessary database table.

Thank you for trying BalSync! If you encounter any issues or have suggestions, please open an issue on GitHub.