
BalSync
BalSync – Vault Economy Synchronization for Minecraft Server Networks with MySQL Database
BalSync 1.3.1
release8 марта 2026 г.BalSync 1.3.1
Permission System and Hotfix Update
Updated config.yml
I have used AI for one of the first Updates and the AI deleted the Database Settings from the config.yml. I recovered it because I discovered this issue myself.
The new Part:
# Database Configuration
database:
host: "localhost"
port: 3306
database: "minecraft"
username: "root"
password: "password"
use-ssl: false
connection-pool:
maximum-pool-size: 10
minimum-idle: 5
connection-timeout: 30000
idle-timeout: 600000
New Feature: Per-Player Sync Control
We've added a new permission node balsync.sync (default: true) that lets you control which players are automatically synchronized with the database.
- Players with
balsync.sync: true(default) will have their balance loaded on join and receive external balance updates as usual. - Players with
balsync.sync: falsewill not be synchronized – their balance will not be loaded when they join, and external database changes will be ignored for them.
This allows server admins to exclude specific players (e.g., bots, restricted accounts) from the synchronization process without affecting the core functionality.
All admin commands (/balsync reload, save, load, status) remain protected by the balsync.admin permission (default: op). Regular players still cannot execute these commands.
No configuration changes are required – simply assign the permission via your permissions plugin (e.g., LuckPerms) to opt players out.
v1.3
release7 марта 2026 г.BalSync v1.3
New Feature: Action Bar Messages
You can now choose whether BalSync messages appear in chat or the action bar!
Simply set message-display: "actionbar" in your config.yml (under settings).
Keep it as "chat" (default) for the classic experience.
This works for all player notifications, including:
- Balance sync on join
- External balance changes
- Command responses (
/balsync reload, etc.)
Enjoy a cleaner chat experience!
Added
- New config option
settings.log-save-all-messages(default:true) to control whether the console messages "Saving all player balances to database..." and "Saved X player balances to database." are printed. Set tofalseto silence them.
1.2.0
release1 марта 2026 г.BalSync v1.2.0
This release fixes a critical SQL syntax error and adds two new configuration options to give you more control over logging and player notifications.
🐛 Bug Fixes
- Fixed table creation error on MariaDB/MySQL caused by a
DEFAULTvalue with decimals in thebalancecolumn.
The table is now created without a default value – the starting balance is set via the plugin logic as before.
(Error message: "You have an error in your SQL syntax; check the manual … near '00,")
✨ New Features
1. Toggle console logs
Added log-balance-actions (default: true) to config.yml.
When set to false, the following messages will no longer appear in the console:
Reset balance to 0 for <player>Balance loaded for <player>: <amount> (from DB)Applied external DB change for <player>: <amount>Detected offline change for <player> ...
2. Toggle player sync message
Added notify-player-on-sync (default: true) to config.yml.
If you don’t want players to see the message "Your balance has been synchronized with the database." on every join, set this to false.
🔧 Configuration Example
settings:
# ... other settings ...
log-balance-actions: false
notify-player-on-sync: false
📦 Installation
- Replace the jar file with the new version.
- The new options will be added to your
config.ymlautomatically when you restart the server (if you already have a config file, you may want to add them manually).
Enjoy a quieter console and less intrusive player messages!
If you encounter any issues, please report them on the issue tracker.
1.1
release12 декабря 2025 г.BalSync 1.1
What changed
- Bugfix: Fixed a bug, which caused that players could easily duplicate their Money with offline Changes
1.0
release2 декабря 2025 г.BalSync v1.0
This is the initial release which is tested and works.