BalSync

BalSync is a powerful and reliable balance synchronization system for Minecraft servers. It ensures that player balances are securely stored, automatically updated, and consistently synchronized across your server network.

BalSync is open source. The full code is available on GitHub for transparency.

Stability

BalSync has been tested with multiple servers running simultaneously to ensure balances remain synchronized without duplication issues.

If any issues occur, they can be reported via GitHub Issues and will be fixed quickly.

🎯 Features

Automatic Balance Backup

Player balances are automatically saved to a MySQL database at configurable intervals.
No manual intervention required – everything runs seamlessly in the background.

Seamless Login Synchronization

Player balances are automatically loaded from the database when they join the server.
Optional: Reset balances to 0 before loading from the database (ideal for events or test servers).

Multi-Server Synchronization

Supports synchronizing balances across multiple servers with a proxy.
Players retain their balances when moving between servers in your network.

Real-Time Monitoring

The plugin regularly checks the database for external changes (e.g., made by admins or other systems).
Any changes are immediately applied to online players.

Intelligent Offline Detection

Changes to a player's balance are recognized even while they are offline.
Example: If a player earns money in single-player mode, it is updated when they join the server.

Multi-Language Notifications

Players are notified of important balance changes.
Supports 7 languages: German, English, Spanish, French, Polish, Portuguese (Brazil), Russian.

🎮 Player Experience

On server join: "Your balance has been synchronized with the database."
On external updates: "Your balance was updated externally: 100 → 150"
No data loss: Balances are always safely stored.
Server switching supported: Players can move between servers and retain their balances.

👨‍💼 Admin Commands

Command	Description
`/balsync reload`	Reloads plugin configuration
`/balsync save`	Immediately saves all player balances
`/balsync load`	Reload your own balance from the database
`/balsync status`	Displays system status

⚙️ Configuration Options

Set automatic save intervals (e.g., every minute)
Enable or disable notifications
Configure database polling intervals
Set starting balance for new players
Customize the database table name
Proxy support settings for multi-server synchronization

🔒 Security & Performance

All transactions are logged
Database connection supports SSL
Connection pooling for optimal performance
Fault-tolerant architecture ensures reliability

📌 Supported Platforms

Paper
Spigot
Purpur
And other compatible Minecraft server forks

🚀 Getting Started

Place the BalSync-version.jar file into your server's plugins folder.
Start the server once to generate the default configuration file.
Configure your MySQL database credentials and plugin settings in config.yml.
Restart the server to apply changes.
Enjoy secure, automatic balance synchronization for all your players across single or multiple servers!

Links

GitHub Repo with Source Code