ВЕРСИИ (25)

# MeowEco Economy 26.10.7.1-mc1.21.11 This LTS compatibility release brings the current MeowEco transaction ledger, audit commands, and policy analytics to Paper 1.21.11 without changing the Java 25 baseline of the modern main line. ## Added - Added `/meco audit` transaction history and export support for Paper 1.21.11. - Added `/meco policy report` supply and concentration analytics for Paper 1.21.11. - Included the shared-MySQL multi-instance consistency fixes from MeowEco 26.10.7. ## Changed - Targets Paper API 1.21.11 and Java 21. - Uses `api-version: 1.21.11` so the server validates the intended compatibility baseline. - Published as a separate LTS artifact while the modern main line remains on Paper 26.x and Java 25. - Checks for updates only within the Paper 1.21.11 Modrinth release channel. ## Fixed - Replaced Java 25-only unnamed resource variables with Java 21-compatible code without changing audit behavior. ## Verification - Compiled the complete plugin against Paper API 1.21.11 using Java 21 bytecode. - Passed the core economy, SQLite, migration, Classic Vault, and VaultUnlocked v2 regression suites. - Verified the shaded plugin JAR on a real Paper 1.21.11 server. ## Compatibility - Paper 1.21.11 - Java 21 - Classic Vault remains supported. - VaultUnlocked v2 remains available as an optional integration. ## Maintenance Policy - This branch receives critical bug, security, database correctness, and compatibility fixes. - New Paper 26.x-only features remain on the modern main branch unless explicitly selected for backporting.

# MeowEco Economy 26.10.7 This release adds reliable balance consistency for networks running multiple Paper servers against one shared MySQL database. ## Added - Added atomic balance snapshots so balance and frozen funds are read together from the shared database. - Added real MySQL regression coverage using two independent plugin database instances. ## Changed - Classic Vault balance reads now use MySQL as the source of truth instead of a process-local read cache. - Multi-instance shared-MySQL deployments are now explicitly supported and documented. ## Fixed - Fixed stale Vault balances when one Paper server changed an account that another server had recently read. - Fixed a MySQL concurrency edge case that could roll back one of two valid simultaneous deposits. - Added deterministic account lock ordering to prevent deadlocks during opposing transfers while preserving total balances. ## Verification - Passed 25 rounds each of concurrent withdrawals, concurrent deposits, and opposing transfers through two independent connection pools on MySQL 8.4. - Verified that committed balance and frozen-fund changes are immediately visible to the other instance. - Passed the complete Gradle check suite, including SQLite, migration, Classic Vault, VaultUnlocked v2, and Paper compatibility checks. ## Compatibility - Paper 26.1.x / 26.2 / 26.3 - Java 25 - Classic Vault remains supported. - VaultUnlocked v2 remains available as an optional integration. ## Download - Download the compiled plugin JAR from [Modrinth versions](https://modrinth.com/plugin/meoweco/versions). - GitHub hosts the source code and issue tracker.

# MeowEco Economy 26.10.6 This release adds verified Paper 26.3 support while retaining compatibility with the existing Paper 26.1.x and 26.2 server lines. ## Added - Added Paper 26.3 build 38 as the primary compile target. - Added a dedicated Paper 26.2 stable compatibility check alongside the existing Paper 26.1.x checks. ## Changed - Updated the supported server range to Paper 26.1.x, 26.2, and 26.3 on Java 25. - Updated the README, Modrinth project description, and release metadata for Paper 26.3. ## Fixed - Prevented future Paper 26.3 API changes from silently breaking Paper 26.2 compatibility by compiling the complete plugin source against both API lines during every release check. ## Verification - Compiled successfully against Paper 26.1.1, 26.1.2, 26.2, and 26.3 APIs. - Passed all database, migration, and VaultUnlocked v2 regression tests. - Started and stopped successfully on a real Paper 26.3 build 38 server with SQLite initialization and clean database shutdown. ## Compatibility - Paper 26.1.x / 26.2 / 26.3 - Java 25 - Classic Vault remains supported. - VaultUnlocked v2 remains available as an optional integration. ## Download - Download the compiled plugin JAR from [Modrinth versions](https://modrinth.com/plugin/meoweco/versions). - GitHub Release contains release notes only and intentionally has no build-file attachments.

# MeowEco Economy 26.10.5 This release adds optional VaultUnlocked v2 support while preserving the existing Classic Vault integration. ## Added - Added a VaultUnlocked v2 economy provider with UUID accounts, multiple currencies, transfers, exact amount validation, and asynchronous operations. - Added regression coverage for Classic Vault and VaultUnlocked v2 interoperability, precision boundaries, progressive transfer tax, rollback, concurrency, and async shutdown. - Added a direct GitHub Issue button to the project header. ## Changed - Classic Vault and VaultUnlocked v2 balance mutations now share the same economy service, database transaction path, and audit metadata. - Updated the README, Modrinth project description, and plugin metadata to document the new compatibility. - Kept VaultUnlocked v2 optional; servers without its API continue using Classic Vault as before. ## Fixed - Rejected v2 amounts that cannot be represented at the configured currency precision or by the existing double-backed storage. - Coordinated asynchronous v2 operations with plugin shutdown and deferred database close when a running operation needs more time to finish. - Scoped intentional Classic Vault deprecation handling to compatibility code, explicitly marked legacy VaultUnlocked overrides as deprecated, and removed unused audit-scope resource warnings. ## Compatibility - Paper 26.1.x / 26.2 - Java 25 - Classic Vault remains supported. - VaultUnlocked v2 is supported as an optional integration. ## Download - Download the compiled plugin JAR from [Modrinth versions](https://modrinth.com/plugin/meoweco/versions). - GitHub Release contains release notes only and intentionally has no build-file attachments.

# MeowEco Economy 26.10.4 Progressive tax tiers and the anti-inflation policy workflow are now available for Paper 26.1.x / 26.2 servers running Java 25. ## Added - Added marginal progressive tiers for rich tax and per-currency transfer tax. - Preserved compatibility with the legacy single-threshold `threshold` + `rate` configuration. - Added regression coverage for marginal tier calculations. ## Changed - Updated the Chinese and English Wiki with tier configuration and calculation examples. - Updated the project description to explain the measure → adjust → verify anti-inflation policy loop. - GitHub remains the source and documentation hub; compiled plugin downloads are distributed through Modrinth. ## Fixed - Removed the redundant deprecation suppression reported by IDE diagnostics. - Cleared compatibility-build deprecation diagnostics for the intentionally implemented legacy Vault methods. Download the compiled plugin JAR from Modrinth versions: https://modrinth.com/plugin/meoweco/versions

# MeowEco Economy 26.10.3 This maintenance release fixes four reported economy issues and strengthens monetary integrity for Paper 26.1.x / 26.2 servers running Java 25. ## Fixed - Fixed `/meco set` SQL parameter ordering and verified that successful `SET_BALANCE` operations write the matching audit record. - Prevented deposits, transfers, exchanges, and frozen-balance mutations from exceeding the exact `double` safe range (`2^53 - 1`). Mutations that cannot represent the requested delta now fail and roll back instead of reporting success or destroying money. - Preserved leaderboard and monetary-policy entries for accounts that share a display name such as `Unknown`; duplicate names receive a short UUID suffix. - Added the missing `invalid-subcommand` message to the English and Simplified Chinese language bundles when exchange rates are disabled. ## Verification - Added SQLite regression coverage for all four reported cases. - Passed `./gradlew.bat clean build` and GitHub Actions CI. ## Upgrade Notes - Replace the plugin JAR and restart the server. - Back up the database before upgrading, especially for production economy servers.

# MeowEco Economy 26.10.2 This patch hardens currency normalization, frozen-balance invariants, rich-tax filtering, and payment account initialization. ## Added - Added regression coverage for canonical currency IDs, frozen balances, and rich-tax account filtering. ## Changed - Payment account initialization now closes the join-time race for online participants. ## Fixed - Fixed mixed-case API currency operations. - Fixed balance resets that could drop below frozen funds. - Excluded hidden and tax accounts from rich-tax collection. - Prevented self-tax transfers and negative available balances.

# MeowEco Economy 26.10.1 This patch makes the monetary policy report fully localizable and publishes the report implementation that was documented in 26.10.0 planning materials. ## Added - Added customizable English and Simplified Chinese templates for `/meco policy report`. - Added localized labels for rich-tax status and destinations. ## Changed - The report follows `messages.language` and reloads custom text from `plugins/MeowEco/lang/` after `/meco reload`. - Bumped the release version to `26.10.1`. ## Fixed - Removed hard-coded English labels from the monetary policy report output.

# MeowEco Economy 26.10.0 This release adds guarded balance migration and a persistent audit trail for Paper 26.1.x / 26.2 servers running Java 25. ## Added - Dry-run migration from any live Vault economy provider, including common EssentialsX, CMI, XConomy, and The New Economy setups. - Offline EssentialsX userdata migration and standard CSV migration. - Automatic CSV backup before every applied migration and a single database transaction for the complete import. - Persistent transaction audit records with source, actor, transaction ID, amount, before/after balance, and frozen-balance state. - `/meco audit <player> [currency] [limit]` and `/meco audit export [limit]`. - Optional bStats integration with storage, currency-count, and language charts after a project id is configured. - GitHub Actions verification for tests, compatibility compiles, and the release jar. ## Changed - English is now the default message language. Chinese servers can set `messages.language: "zh_CN"` and run `/meco reload`. - The marketplace name is now **MeowEco Economy** for clearer search discovery; the plugin id, data directory, commands, API, and placeholders remain `MeowEco` compatible. - The Modrinth page now starts with positioning, five product benefits, a compatibility table, and a three-minute install path. ## Fixed - Failed balance mutations and failed migrations do not create audit records. - Transfer and exchange audit rows share one transaction id across both affected accounts or currencies. - Modrinth loader metadata no longer claims direct Bukkit or Spigot compatibility for the Paper-only build.

# MeowEco 26.9.1 Changelog Release date: 2026-06-29 ## 🚀 Highlights MeowEco `26.9.1` is a performance maintenance release for **Paper 26.1.x / 26.2** servers. It focuses on reducing Vault default-currency balance read pressure. Many shop, menu, permission, quest, and display plugins query balances through Vault very frequently. This release adds a very short read cache for Vault default-currency balance lookups, reducing repeated database reads while keeping all money-changing operations database-authoritative. ## ✨ Added - ⚡ Added a short Vault default-currency balance read cache for frequent `getBalance` / `has` calls from external Vault consumers. - 🧾 Added 26.9.1 release notes explaining the cache strategy, intended use, and safety boundaries. - 🧹 Player quit now clears that player's Vault cache entries to avoid stale cache growth on long-running servers. - 🧪 Added a Paper 26.1.2 stable API compatibility compile gate alongside the existing earliest 26.1.x guard and Paper 26.2 main compile target. ## 🔄 Changed - ☕ Bumped the plugin version to `26.9.1`. - 🔁 Successful Vault, MeowEco API, admin command, pay/exchange, join-time account creation, and rich-tax write paths now invalidate the related Vault balance cache. - 🧠 Player-level cache invalidation now removes every Vault cache key for that player instead of relying on the current default-currency setting. - 📦 Release verification now covers the earliest Paper 26.1.x API, Paper 26.1.2 stable API, and the Paper 26.2 main target API. ## 🛠️ Fixes And Improvements - 🛡️ The cache is read-only and only applies to Vault default-currency reads; deposits, withdrawals, and account creation still go directly to the database. - 🔒 Vault withdrawals remain database-authoritative, so insufficient funds are rejected by the atomic database update instead of by cached reads. - 🧽 Cleaned README trailing whitespace while preserving the emoji-led marketplace introduction layout. ## 🌟 Why Upgrade - 🏪 Lower database pressure when shop, menu, VIP, and reward plugins repeatedly check balances. - 📊 Lighter balance displays, requirement checks, and menu refreshes. - 🔌 Better Vault behavior for high-interaction servers. - 🛡️ Performance gains without weakening economy safety. ## ⚠️ Upgrade Notes - Your server must run on **Java 25**. - This release targets **Paper 26.1.x / 26.2**. - Back up your database and configuration files before upgrading, especially on production economy servers. - No extra configuration migration is required when upgrading from 26.9.0.

# MeowEco 26.9.0 Changelog Release date: 2026-06-29 ## 🚀 Highlights MeowEco `26.9.0` targets **Paper 26.1.x / 26.2** servers running **Java 25**. This release moves the primary build target to Paper 26.2 while keeping the Paper 26.1.x compatibility compile gate, so server owners can adopt the newer Paper line with a clearer safety net. This is also a stability-focused economy release: money precision, database regression coverage, SQLite behavior, public documentation, and release metadata were all tightened for multi-currency servers, shop menus, leaderboards, rich-tax setups, and integrated server workflows. ## ✨ Added - 🛡️ Added primary Paper 26.2 API support with `paper-api:26.2.build.40-alpha`. - 🧪 Added broader economy regression coverage for transfers, exchange, frozen funds, rich tax, and amount precision policy. - 🗄️ Added SQLite regression coverage for account creation, transfers, exchange rollback, frozen funds, and leaderboard exclusions. - 🔍 Added read-only precision reporting for legacy balances, helping server owners find over-precise stored amounts without modifying player money. ## 🔄 Changed - ☕ Bumped the plugin version to `26.9.0`. - 🧱 Updated the supported runtime range to **Paper 26.1.x / 26.2** with **Java 25**. - 📦 Kept the Paper 26.1.x compatibility compile check while compiling primarily against Paper 26.2. - 🔌 Adjusted Maven resolution so Paper 26.2's Adventure 5.x dependencies resolve from Maven Central. - 📚 Improved README and Wiki copy so server owners can quickly understand where MeowEco fits and why it is useful. ## 🛠️ Fixes And Improvements - 💰 Unified amount precision handling across commands, API calls, and Vault boundaries. - 🧾 Rounded tax, exchange, and scheduled economy results before storage for cleaner database values. - 🧹 Removed stale non-Paper project messaging and kept the project direction focused on the Paper plugin. - ⚙️ Cleaned up generated-file and local-runtime ignores to keep the repository easier to maintain. ## 🌟 Best For - 🪙 Servers running coins, points, gems, tokens, or other multi-currency economies. - 🏪 Shop, VIP, reward, and exchange menus built around Vault, PlaceholderAPI, and TrMenu. - 📊 Servers that care about leaderboards, formatted balances, and total-economy displays. - 🧊 RPG and survival servers that need frozen funds, rich tax, and economy-control tools. - 🛡️ Server owners preparing for Paper 26.2 while keeping Paper 26.1.x compatibility checks in place. ## ⚠️ Upgrade Notes - Your server must run on **Java 25**. - This release targets **Paper 26.1.x / 26.2**. If your server is still on Paper / Minecraft `1.21.11` or older, do not assume this version is compatible. - Back up your database and configuration files before upgrading, especially on production economy servers. - If you use MySQL, validate connection settings, charset, and permissions on a test server first.

# MeowEco 26.8.1 MeowEco `26.8.1` targets **Paper 26.1 / 26.1.1 / 26.1.2** servers running **Java 25**. This release focuses on smoother use on newer Paper environments and a better out-of-the-box MySQL storage experience. ## Added - MySQL storage now ships with the Paper plugin, so server owners no longer need to install the MySQL driver separately. - Added MySQL pool settings for tuning connection count, timeouts, and connection lifetime. ## Changed - Clarified support for `Paper 26.1`, `Paper 26.1.1`, and `Paper 26.1.2`, all running on Java 25. - Updated MySQL defaults to use `utf8mb4` and improved compatibility with common MySQL 8 authentication and timeout scenarios. - Updated documentation for the current version, supported Paper range, and Java runtime requirement. ## Fixed - Improved MySQL connection stability for charset, authentication, and slow-network situations. ## Runtime Notes - Your server must run on **Java 25**. - This release targets **Paper 26.1 / 26.1.1 / 26.1.2**. If your server is still on Paper / Minecraft `1.21.11` or older, do not assume this version is compatible.

## 📝 Changelog Update - v26.7.4 Here are the summary of changes for the upcoming release: ### ✅ Code Changes * **🔍 Player Lookup:** * Removed the name fallback to `Bukkit#getOfflinePlayer(String)` in `PlayerLookup.resolveOfflinePlayer(...)`. This prevents non-existent player names from being resolved as forged offline accounts. * **🛡️ Permission Handling:** * Adjusted `EcoCommand` permission checks: * `give`, `take`, `set`, `freeze`, `unfreeze`, and `deductfrozen` now require their own independent permission nodes. * `setrate`, `refresh`, `hide`, and `unhide` continue to require `meoweco.admin`. ### ⬆️ Dependency Updates * **📦 Versioning:** * Updated project version and Paper plugin version to `26.7.4`.

* Tested exclusively on the Paper server-side. * Since Paper has not released version 26.1, compatibility is only supported and tested for version 26.1.1. 

## 🛠️ Changelog ### ✨ Added * **Offline-Player Lookup Support**: Added shared support for admin commands and `rich-tax` player destinations. Offline accounts can now be resolved via **UUID**, **cached profile**, **database name mapping**, or **final server lookup**. * **Permission Declarations**: Added explicit declarations to `plugin.yml` for: * `meoweco.eco.freeze` * `meoweco.eco.unfreeze` * `meoweco.eco.deductfrozen` ### 🔄 Changed * **Alias Handling Optimization**: Optimized `/eco bal` and `/eco top` to delegate to the main `meoweco` command handlers, ensuring consistent behavior and cache management. * **Rich-Tax Improvements**: Updated configuration to support **per-currency rules** and provided clearer scheduling log output. * **Documentation**: Updated the project documentation and wiki content to align with the current feature set. ### 🐞 Fixed * **Offline `/eco give`**: Fixed failures occurring when the target player was not already present in the immediate Bukkit offline-player cache. * **Resolution Consistency**: Fixed `rich-tax` destination-player resolution to reuse the same lookup path as admin commands. * **Code Cleanup**: Removed the stale `org.bukkit.Bukkit` import warning in `RichTaxService`.

# MeowEco 26.7.1 ## Added - Added a configurable **Wealth Tax system**, supporting: - Tax threshold amount - Tax rate - Execution start time - Execution interval - The wealth tax now supports **two destinations**: - Confiscated by the system - Transferred to a specified player's account ## Improved - Updated `config.yml` comments to **bilingual Chinese–English**, making it easier for server owners to configure directly. - Improved **API parameter validation**, rejecting invalid or illegal amount inputs. - Optimized **Placeholder and leaderboard cache refresh logic**, reducing main-thread blocking and improving overall stability. ## Build - Updated build configuration and **fixed `shadowJar` packaging compatibility issues** under the current Gradle environment.

# Changelog - Fixed an issue where players received an incorrect amount of points. - Fixed an issue where commands using the `/eco` prefix were not working properly.

# Changelog ## Features ### 1. Restored Classic Top-Level Commands & Enhanced `/eco` Admin Tools - Restored and registered the following top-level commands in `plugin.yml`: - `/bal` (aliases: `/money`, `/balance`) - `/pay` - `/baltop` - `/eco` (alias: `/economy`) - These commands can now be used directly without the `/meco` prefix, greatly improving compatibility with existing habits of veteran players and administrators. - Enhanced `/eco` admin commands and aligned behavior: - Added quick lookup shortcuts: - `/eco bal [player] [currency]` - `/eco top [currency]` - All admin subcommands under `/eco` (`give`, `take`, `set`, `hide`, `refresh`, etc.) now work correctly and are consistent with previous behavior. ### 2. Tab Completion & Permission Control - Added / synchronized intelligent tab-completion for all restored commands, improving usability and input efficiency. - Strictly preserved the existing permission model: - For example, only players with `meoweco.admin` can use `/eco` admin features and related subcommands. ### 3. Baltop UI Cleanup - Updated `BaltopCommand.java` to remove duplicated currency names from the baltop header. - The baltop header now uses only the colored display name defined in the config, resulting in a cleaner, more professional, and visually consistent UI. ### 4. Fully Localized Help Menu - Refactored the `sendHelp` method in `MeowEcoCommand.java`: - All help messages (including player commands and admin commands) are now dynamically loaded from language files. - Language & permission support: - All help content is now read from `zh_CN.yml` and `en_US.yml`, fully respecting the server’s selected language. - The help menu is permission-aware and only shows admin entries to users who actually have the corresponding permissions. ### 5. New Developer API (MeowEcoAPI) - Introduced the `MeowEcoAPI.java` interface providing two core methods: - `getRegisteredCurrencies()`: returns a collection of all registered currency objects. - `getCurrency(String id)`: retrieves a currency object by its ID. - The implementation of `MeowEcoAPI` is registered via Bukkit `ServicesManager` on plugin startup: - Other plugins can obtain the API instance via `Bukkit.getServicesManager()` and integrate with the economy system in a standardized way. ## Docs & Config - Updated `WIKI_CN.md` and `WIKI_EN.md`: - Documented `/bal`, `/pay`, `/baltop`, `/eco`, etc. as “shortcut commands”, while keeping `/meco` as the unified entry point for users who prefer a single root command. - Added a “Developer API” section with code samples showing how other plugins can obtain and use `MeowEcoAPI` via `Bukkit.getServicesManager()`. - Synchronized plugin version and related metadata in `build.gradle.kts` and `plugin.yml` to reflect the current feature set.

# MeowEco Changelog (v26.6.4) ## 1. Exchange Rates Feature Toggle - New config option: Added `exchange-rates.enabled` toggle in `config.yml`. - Dynamic command hiding: - When this toggle is disabled, players will not be able to use the `/meco exchange` command. - The command help page (`/meco help`) will automatically hide exchange-related entries. - Tab-completion will no longer suggest the `exchange` subcommand, keeping the command environment clean. ## 2. Config Auto-Update Improvements - Smart completion: Improved the auto-sync logic when upgrading `config-version`. The plugin now prioritizes preserving existing custom settings (such as database passwords, custom currencies, etc.) and only auto-fills newly added config entries that are missing. - Message sync: Only usage hints (entries ending with `-usage`) and header/footer template messages are forcibly synchronized during version upgrades, ensuring administrators always have up-to-date command usage guidance. - Language file merging: Enhanced multi-language file loading. Newly added translation entries are now automatically merged into the existing locale files, so you no longer need to manually delete old files to regenerate them. ## 3. Versioning and Documentation - Version bump: Plugin version and config version have been updated to `26.6.4` and `v6` respectively. - Wiki updates: Updated both Chinese and English Wiki pages to document the new exchange-rate toggle configuration, as well as the latest PAPI placeholder output behavior. --- ## ⚠️ Update Recommendations - Seamless upgrade: Thanks to the improved config auto-update logic, you can simply replace the JAR file and restart. The plugin will automatically append `enabled: true` under the exchange-rate config section in your `config.yml` without altering your existing exchange settings. - Backup advice: Although the config update logic has been optimized, it is still a best practice to back up `config.yml` before performing any updates in a production environment.

# MeowEco Changelog ## 1. Core Architecture Refactor - **Unified Command System** Completely removed scattered top-level commands (such as `/money`, `/pay`, `/baltop`, etc.). All features are now centralized under the main command `/meco` (or `/meoweco`). - **Enhanced Multi-Currency System** Fully supports unlimited custom currencies (e.g., Coins, Tokens, Gems). Each currency now supports: - Independent decimal precision - Transfer tax rate - Initial balance configuration - **Database Architecture Upgrade** Introduced a **composite primary key (`uuid`, `currency`)** mechanism. The plugin will automatically detect and upgrade legacy database structures, ensuring that the same player can have separate accounts for different currencies without conflicts. --- ## 2. PlaceholderAPI System Deep Optimization - **Dynamic Currency Support** All PAPI placeholders now support specifying a currency ID via suffix (e.g., `%meoweco_balance_gems%`). - **Multiple Output Modes** - **Standard Mode** `%meoweco_balance_<ID>%` (Formatted number with thousands separator) - **Short Format** `%meoweco_balance_short_<ID>%` (Auto-converts to formats like `1.2K`, `3.4M`, etc.) - **Full Format** `%meoweco_balance_formatted_<ID>%` (Includes number and currency name) - **Fixed Numeric** `%meoweco_balance_fixed_<ID>%` (Raw number without thousands separator; suitable for scoreboards or calculations) --- ## 3. Administration & Maintenance Improvements - **Asynchronous Update Checker** Integrated with the Modrinth API for asynchronous update checking. When a new version is detected, a notification with a download link will automatically be sent to the console and players with the `meoweco.admin` permission. - **Leaderboard Accuracy Improvements** - Automatically excludes the system account `tax` from leaderboards and total server wealth statistics. - Fixed `/meco hide` logic to ensure hidden players are immediately and completely removed from rankings. - **Instant Refresh Mechanism** Optimized the `/meco refresh` logic. Executing this command will immediately clear: - PAPI cache - Leaderboard cache - In-memory data Forcing the next query to fetch the latest data directly from the database. --- ## 4. Compatibility & Code Quality - **Color Code Fix** Fully supports `&` color parsing, resolving previous issues where raw color codes appeared in messages and placeholders. - **Performance Optimization** - Removed all unused imports and variables - Replaced deprecated Java 20+ API usage (such as outdated `URL` constructors) --- # ⚠️ Important Update Warnings Before updating to **v26.6.2**, please carefully read the following: ## 1. Database Backup (Highly Recommended) Since the plugin will automatically perform SQLite/MySQL table structure reconstruction to support composite primary keys, and although built-in migration logic is included, **it is strongly recommended that you back up your `meoweco.db` file or MySQL database before updating**, just in case. --- ## 2. Command Changes Notice Because legacy commands such as `/money` and `/pay` have been unregistered in `plugin.yml`, although the plugin includes silent redirection logic, if you have other plugins (such as scripts, menus, or NPCs) directly calling these old command names, it is recommended to update them to the new `/meco <subcommand>` format as soon as possible for better compatibility. --- ## 3. Configuration Synchronization The new version introduces an `update-checker` configuration section in `config.yml`. If you are using an older configuration file, it is recommended to: - Delete it and regenerate a fresh one, **or** - Manually synchronize it with the latest configuration structure described in `WIKI_CN.md`. --- ## 4. Placeholder Changes If you previously used formatted placeholders in scoreboards, please verify their output behavior. It is recommended to switch to the new: - `_short` (compact format), or - `_formatted` (full format) placeholders for the best visual presentation.

### Updates #### 1. Language File Renaming - Renamed `src/main/resources/lang/messages_en_US.yml` to `en_US.yml`. - Renamed `src/main/resources/lang/messages_zh_CN.yml` to `zh_CN.yml`. - Code update: Updated the `resolveMessagesResourceName` method in `ConfigManager.java` to remove the `messages_` prefix. Language files are now loaded directly using the `en_US.yml` format. - Please delete the old language files in the `lang` folder before updating. --- #### 2. Added Transfer Tax Mechanism - Configuration: Added a new `currency.transfer-tax` option in `config.yml` (default: `0.0`). Supports tax rates between `0.0` and `1.0` (e.g., `0.05` = 5% tax). - Core logic: Implemented transfer transactions with tax support in `DatabaseManager.java` and `AbstractSQLDatabase.java`, ensuring that the deduction (including tax) and the credited amount (after tax) are completed within the same transaction. - Command update: Updated `PayCommand.java`. Transfer commands now automatically calculate and deduct the tax. - Multilingual support: Added a new `pay-success-sender-tax` message in both `messages_en_US.yml` and `messages_zh_CN.yml`. When tax is applied, the sender will see a message including the tax amount. --- #### 3. Fixed Baltop Command Issue - Fixed an issue where the `/baltop` command would not work properly under certain conditions.

### Update Details 1. Leaderboard Display Optimization (BaltopCommand): - Added a display of the **total server balance** at the top of the `/baltop` leaderboard. - Data is retrieved asynchronously with a 5-minute caching mechanism to ensure no performance impact. - Added a new `baltop-total` configuration option in the language file to support custom display formatting. 2. New PlaceholderAPI Variables: - `%meoweco_server_total%` — Total server balance (respects configured decimal places). - `%meoweco_server_total_raw%` — Total server balance (raw numeric value). - `%meoweco_server_total_formatted%` — Total server balance (formatted with unit abbreviations, e.g., 1.5M). - These placeholders use an independent 30-second cache to prevent excessive database load from high-frequency refreshes. 3. Database Layer Upgrade: - Added a new `getTotalBalance()` method in `DatabaseManager`. - Implemented an efficient SQL `SUM(balance)` query in `AbstractSQLDatabase`. 4. Documentation Updates: - Updated `WIKI_CN.md` and `WIKI_EN.md` to include explanations of the new placeholders.

## Plugin Compatibility & Optimization - Fully supports **all Minecraft versions 1.18 and above** - Codebase has been **comprehensively optimized** to improve performance and efficiency

## 🆕 Changelog | v26.1.0 ### ✨ New Features #### Admin Commands - `/eco hide <player>` Hide a player from the leaderboard - `/eco unhide <player>` Restore a player’s visibility on the leaderboard - `/eco refresh` Refresh the leaderboard cache and fix unknown or invalid player names --- ### 🛠️ Improvements & Refactors - **EcoCommand.java** - Refactored command structure for better maintainability - All messages are now retrieved via `ConfigManager` - Full support for **Adventure API** text formatting and colors --- ### 📦 Version Update - Plugin version updated to **`26.1.0`** - Version number synchronized in both `plugin.yml` and `build.gradle.kts` - Versioning scheme aligned with **Minecraft-style versioning** --- ### ✅ Compatibility - Compatible with all currently supported Minecraft server versions - Updating is recommended for improved leaderboard stability and admin control