BalSync v1.3

Welcome to the first CurseForge 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 CurseForge

• 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 CurseForge 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.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.