ВЕРСИИ (35)

### 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.  - 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. ---

 ### 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 ---

### Added ### Changed ### Fixed ### Removed ---

### Added ### Changed ### Fixed ### Removed ---

### Added ### Changed ### Fixed ### Removed ---

### Added ### Changed ### Fixed ### Removed ---

### Added - **Auto-create bank on join** - Players now automatically get a personal bank named after themselves on first join. Controlled by `banking.auto-create-on-join` (default `true`); respects the existing `banking.enabled` gate. Idempotent: no duplicate bank is created if one already exists. - **`bank_not_found` message key** - "Bank does not exist" errors now route through a localised `bank_not_found` message key (`&c` prefix) instead of a raw white string. Added to both `en` and `nl` locales. - **`/bank deposit` / `/bank withdraw` optional name** - Both commands now accept `[name] <amount> [currency]` so players can run `/bank deposit 100` to deposit into their own bank without having to type their name. - **`usage_bank_deposit` / `usage_bank_withdraw` message keys** - Matching usage hint messages added to `en` and `nl` locales. ### Fixed - **Server deadlock** - `callSyncMethod(...).get()` was called unconditionally from the main thread during bank commands, causing the server to hang indefinitely. An `isPrimaryThread()` guard now ensures events fired from the main thread are dispatched directly, while background-thread calls still schedule and await a sync task. - **`autoCreateBank` early-return bug** - `autoCreateBank()` was placed after the `store-on-join` gate in `PlayerJoinListener`, meaning it was never called when `store-on-join.enabled` is false (the default). It now runs independently of that gate. ### Refactored - Introduced `util/EventDispatcher` - a single, reusable utility class that encapsulates the thread-safe Bukkit event dispatch pattern (`fireSync` / `fireSyncAndAllow`). All storage providers and `PaymentExecutor` now delegate to this class instead of duplicating the guard inline. ### Tests - Added `PlayerJoinListenerAutoCreateBankTest` (4 tests) covering: bank created on join, creation skipped when `auto-create-on-join: false`, creation skipped when `banking.enabled: false`, and no duplicate creation for a pre-existing bank. ---

## What's Changed * cd: added Modrinth release in https://github.com/ez-plugins/EzEconomy/pull/139 * fixed: issue #138 (3.0.1 not released to Github Packages) **Full Changelog**: https://github.com/ez-plugins/EzEconomy/compare/3.0.1...3.0.2

- Updated to Minecraft 26.1 - Updated to Java 25 - Refactored back-end to [Jaloquent](https://github.com/EzFramework/Jaloquent) - Added Github Pages documentation: https://ez-plugins.github.io/EzEconomy

> Make sure with upgrading to this version you renew the main configuration file and your messages file. > For a [more stable version](https://modrinth.com/plugin/ezeconomy/version/2.4.3) recommended for now to use `2.4.3`. **The `2.5.0` is still in testing phase** * Banking toggle by @ez-plugins in https://github.com/ez-plugins/EzEconomy/pull/65 * Added redis lock support for proxy networks by @ez-plugins in https://github.com/ez-plugins/EzEconomy/pull/62 * Bungeecord locking strategy by @ez-plugins in https://github.com/ez-plugins/EzEconomy/pull/67 * Added `locking-strategy` configuration option to `config.yml` * Added `caching-strategy` configuration option to `config.yml` * Up version to 2.5.0 by @ez-plugins in https://github.com/ez-plugins/EzEconomy/pull/66 **Full Changelog**: https://github.com/ez-plugins/EzEconomy/compare/2.4.3...2.5.0

- Fix BigDecimal for currency conversion by @ez-plugins in https://github.com/ez-plugins/EzEconomy/pull/63

- Added prevention zero-rounded currency conversions ([#59](https://github.com/ez-plugins/EzEconomy/pull/59))

## What's Changed * docs: add /currency convert usage to commands.md by @ez-plugins in https://github.com/ez-plugins/EzEconomy/pull/49 * Fix BalanceCommand: prefer currency arg and avoid Mojang lookups; add… by @ez-plugins in https://github.com/ez-plugins/EzEconomy/pull/52 * Create user account through provider on join by @ez-plugins in https://github.com/ez-plugins/EzEconomy/pull/53 * Improve Spigot update check by @ez-plugins in https://github.com/ez-plugins/EzEconomy/pull/54 * Store player display names for easier cached display by @ez-plugins in https://github.com/ez-plugins/EzEconomy/pull/55 * fix: check if balance is available before convertion by @ez-plugins in https://github.com/ez-plugins/EzEconomy/pull/57 **Full Changelog**: https://github.com/ez-plugins/EzEconomy/compare/2.4.0...2.4.1

> Recommended to reset your configuration files and check differences when using custom configurations and doing a bigger update from earlier versions. - Separated PlaceholderAPI to it's own .jar file

- Fixed issue storage type loading the wrong path resulting in `yml` being chosen by default

## What's Changed * feat: added player eco GUIs by @ez-plugins in https://github.com/ez-plugins/EzEconomy/pull/35 * Refactor: moved bootstrap logic by @ez-plugins in https://github.com/ez-plugins/EzEconomy/pull/42 * Add configurable price_message_format for message templates by @ez-plugins in https://github.com/ez-plugins/EzEconomy/pull/45 **Full Changelog**: https://github.com/ez-plugins/EzEconomy/compare/2.2.4...2.3.0

**Feature changes** - Added `<currency>` argument to `/balance <player> [<currency>]` - Added `<currency>` argument to `/pay <player> [<currency>]` - Added new conversion calculation subcommand `/currency convert <fromCurrency> <toCurrency> <amount>` - Added new messages and placeholders to give better support for multi-currency usage **Code changes** - Improved feature tests - Added `CurrencyUtil` for easier reusage

- Split the `messages.yml` into `.yml` file per language - Implemented the new message construction in the plugin

- Fixed issue in async handling / sync availability - Added feature tests for YML / MySQL / MongoDB storage providers

- Fixed issue in finding offline player in `/pay` command

**Summary** - Expose cancellable transaction events via the API so external plugins can intercept/abort economy operations. **Added** - `TransactionType.java` - `PreTransactionEvent.java` (cancellable) - `PostTransactionEvent.java` - `PlayerPayPlayerEvent.java` (cancellable) - `docs/api/event/*.md` (documentation for each event)

- Added `/bal` alias for the `/balance` command

- Fixed player check on `/pay` command

- Added new database documentation in `docs/database.md`: https://github.com/ez-plugins/EzEconomy/blob/main/docs/database.md - Added new improved subcommand structure - Refactored existing subcommands into the new subcommand structure - Cleaned up main plugin class - Cleaned up Vault implementation class - Added new `/ezeconomy reload` subcommand to reload all configuration files - Added new `/ezeconomy database` subcommand to check the information of the database - Added new `/ezeconomy database test` subcommand to test every feature quickly on your database - Added new `/ezeconomy database reset` subcommand to reset the database more easily - Improved autocomplete of the `/ezeconomy` command - Implemented `init()` and `load()` functions of the StorageProvider's over connection building in constructor - Added new overridable `isConnected()` function to `StorageProvider` class to make connection status available per storage provider

- Added missing translations to `messages.yml` - Added `/ezeconomy reload` --- **Needs `messages.yml` reset for new messages to be added automaticly**

- Added PlaceholderAPI in softdepend list to make sure it loads first

- Added storage provider unavailable to configurable messages - Added multi currency disabled to configurable messages - Added cleanup messages to configurable messages - Fixed code styling

- Added default messages to `messages.yml` for French support

- Fixed issue in `/baltop` retrieving offline player names - Added cleanup process to clean up non-existing accounts with `/ezeconomy cleanup`

- Added baltop placeholders, by example `%ezeconomy_top_1%`

* Updated source code to 1.4.0 (missing since Github was suspended) * Added EzEconomyAPI class * Improved markdown documentation in the Github project * Added multiple DTOs for better API responses

# ★ EzEconomy Changelog ~ Tax System Update - **Configurable Tax System**: Server admins can now enable and configure taxes on player transactions, bank interest payouts, and currency exchanges. - **Tax Exemption Permissions**: Grant specific players or groups exemption from all economy taxes via permissions. - **Multi-Currency Support**: Taxes and interest are now calculated and displayed per currency, supporting complex server economies. - **Admin Tax Ledger**: Track total tax collected from transactions, interest, and exchanges. View and reset totals with the /tax admin command. - **PlaceholderAPI Integration**: New placeholders for player and bank balances, including multi-currency support, for use in chat, GUIs, and other plugins. - **Configurable Messages**: All tax-related messages are now fully customizable in messages.yml. - **Configurable Interest Interval**: The bank interest payout interval is now settable in config.yml.