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.