BalSync 1.4 (Preview)

New Feature: Update Checker

Update Checker: BalSync now automatically checks for new versions on Modrinth. When an update is available and compatible with your server, players with the balsync.update.notify permission (OP by default) will receive a clickable notification upon joining. You can disable this feature in config.yml (settings.check-for-updates: false).

New Feature: Tab Completion for /balsync

The main command now supports tab completion!

• Type /balsync and press Tab to see all available subcommands: reload, save, load, status, backup, backups, rollback.
• For the rollback subcommand, it will suggest existing backup filenames and online player names, making balance restoration faster and easier.
• Only players with the balsync.admin permission will see the suggestions.

New Feature: Rollback from Backups

BalSync now allows you to restore player balances from previously created backup files!

• List available backups:
  /balsync backups – shows all backup files with timestamps.

• Rollback all players or a single player:
  /balsync rollback <filename> [player]

  • If you specify a player name, only that player's balance is restored.
  • If you omit the player, all players in the backup are restored.

The rollback runs asynchronously and updates both the database and online players' balances instantly. The plugin’s internal tracking is kept consistent to avoid any conflicts with auto-save or polling.

Example:
/balsync rollback backup-2025-03-13-12-30-00.json – restores all balances from that backup.
/balsync rollback backup-2025-03-13-12-30-00.json Steve – restores only Steve's balance.

Make sure to enable backups in your config.yml (backup.enabled: true) and set the interval to your preference. Backups are stored in the backups/ folder inside the plugin directory.

Note: Rollback requires the balsync.admin permission (default OP).

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: false will 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.

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 to false to silence them.

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 DEFAULT value with decimals in the balance column.
  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.yml automatically 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.

BalSync 1.1

What changed

• Bugfix: Fixed a bug, which caused that players could easily duplicate their Money with offline Changes