Added

• Performance and reliability improvements to balance fast-path caching and background persistence.

Changed

• Reduced DB contention and improved fast-path caching semantics for balances to provide more consistent immediate responses under load.
• Withdraw fast-path: added per-key striped locking to prevent concurrent over-reservations.
• Shutdown ordering: background persistence flush now runs before closing JDBC pools to guarantee pending deltas are persisted.

!EzEconomy benchmark

• Configuration: moved MySQL tuning keys into performance.mysql in the main config.yml. The plugin now prefers performance.mysql.* with fallbacks to mysql.* in config-mysql.yml; documentation and default configs were updated.

• Added MySQL tuning options and safer defaults: background persistence batching/queueing settings and additional Hikari pool tuning keys (leak-detection-threshold-ms, validation-timeout-ms, initialization-fail-timeout-ms, auto-commit). JDBC params now include UTF-8 encoding by default.

• Security: /eco command permissions tightened. New granular permission nodes added: ezeconomy.eco.give, ezeconomy.eco.take, ezeconomy.eco.set, ezeconomy.eco.gui (GUI opens require ezeconomy.eco.gui), and ezeconomy.eco remains the umbrella admin node. Console execution still allowed.

Fixed

• Race conditions where multiple concurrent withdraws could exceed the persisted balance.
• Background flush failures during shutdown caused by closed connections.

---

Added

• Global debug flag: new top-level debug: false option in config.yml controls all verbose/diagnostic logging in one place. When enabled, Jaloquent's internal SQL logging and plugin-level debug messages (cross-server messaging, daily-reward diagnostics) are written to the server console.

Changed

• DailyRewardManager and MessagingService now respect the unified debug flag instead of the previous per-feature toggles (daily-reward.debug and cross-server.verbose-logging).

Removed

• Per-feature debug flags daily-reward.debug and cross-server.verbose-logging from config.yml - superseded by the new top-level debug option.

---

!Bungeecord and Velocity support

Added

• Velocity proxy support - New ezeconomy-velocity module provides a Velocity proxy plugin for cross-server payment notifications and global player list broadcasting. Deploy ezeconomy-velocity.jar on your Velocity proxy alongside the main plugin on backend servers.
• Cross-server messaging layer - New MessagingService, MessagingTransport, and MessageType abstractions in core. Supports three transports: Velocity plugin messaging, BungeeCord plugin messaging, and Redis pub/sub.
• Redis pub/sub messaging - New RedisMessagingTransport in the ezeconomy-redis module enables proxy-independent cross-server messaging via Redis pub/sub. Ideal for multi-proxy setups or networks already running Redis.
• Pending notifications - Payment notifications for offline players are now stored in the database and delivered on next join. Implemented in all four storage backends (YML, MySQL, SQLite, MongoDB).
• Player info persistence - StorageProvider.persistPlayerInfo() stores UUID/name/display name on join, enabling resolvePlayerByName() for cross-server name lookups.
• Configurable lock timing - New locking section in config.yml with ttl-ms, retry-ms, and max-attempts settings, replacing hardcoded values.
• VaultEconomyImpl distributed locking - Withdraw and bank withdraw operations now acquire distributed locks (with local fallback) to prevent race conditions in multi-server environments.
• Cross-server documentation - New docs/feature/cross-server.md and docs/integration/velocity.md covering all three messaging transports, configuration, and deployment.
• Velocity CI workflow - GitHub Actions workflow for the ezeconomy-velocity module.
• MessagingComponent - Bootstrap component that initialises cross-server messaging during plugin startup.
• New message keys: eco_give, baltop_footer, payment_cancelled, recipient_offline_queued.
• /pay alias: ezpay.
• MySQLStorageProvider.persistPlayerInfo() implementation for explicit player data upserts.

Changed

• BungeeCord proxy overhaul - EzBungeeProxyPlugin now implements Listener, registers both ezeconomy:locks and ezeconomy:notify channels, handles payment notification forwarding, sends RECIPIENT_OFFLINE responses, and broadcasts the global player list every 3 seconds.
• BungeeCord proxy plugin.yml - Fixed main class reference, added description, enabled resource filtering for ${project.version}.
• All sub-module POM versions now inherit from the parent (removed explicit <version> tags).
• Updated README with cross-server messaging, Velocity integration, and distributed locking documentation links.
• Updated docs/feature/proxy-network.md and docs/integration/bungeecord.md to reflect Velocity support and cross-server messaging.
• StorageProvider.transfer() now uses configurable lock timing via EzEconomyPlugin.getLockTtlMs/RetryMs/MaxAttempts().

Fixed

• BungeeCord proxy plugin.yml - Main class was pointing to the wrong class (EzBungeeProxy instead of EzBungeeProxyPlugin).
• BungeeCord channel mismatches - Unified lock and notification channels across server and proxy modules.
• PaymentExecutor cross-server notifications - Offline recipients now receive payment notifications via cross-server messaging instead of silently dropping the message.
• Cross-server /pay failing silently - Payments to players on other backend servers failed because the recipient was looked up only in Bukkit's local player cache. PayCommand now checks MessagingService.isNetworkPlayer() and StorageProvider.resolvePlayerByName() when local lookups fail.
• Incorrect UUID for cross-server recipients - PaymentExecutor was using Bukkit.getOfflinePlayer(name) which generates an offline-mode UUID for players who have never joined the local server. It now resolves the correct UUID from the messaging service or shared database.
• MySQLStorageProvider.resolvePlayerByName() not implemented - The default no-op from the StorageProvider interface was being used. Now queries the players table by name to return the correct UUID.

---

Fixed

• Folia compatibility — plugin.yml now declares folia-supported: true so EzEconomy loads on Folia servers without being rejected as an unsupported plugin.
• API version format — api-version changed from 26.1.2 to 1.21 in both the main and PAPI module plugin.yml files. Paper build 69 introduced strict Minecraft-version format validation that rejected the old dotted build-number form.
• Java 21 runtime compatibility — The jdk25 Maven profile was setting maven.compiler.release=25, producing class file version 69 that Java 21 JVMs cannot load (UnsupportedClassVersionError). Lowered the release target to 21 (class file version 65) in both the default properties and the profile; the build JDK requirement ([25,)) is unchanged.

---

Added

Changed

Fixed

Removed

---