issues<\/p>\n
# MeowEco Documentation<\/p>\n
Version: `26.7.4`<\/p>\n
MeowEco is a Paper economy plugin with multi-currency support, Vault integration, PlaceholderAPI support, exchange rates, frozen funds, and scheduled rich tax.<\/p>\n
## Platform<\/p>\n
– Plugin version: `26.7.4`
\n– Current build target API: `io.papermc.paper:paper-api:26.1.1.build.14-alpha`
\n– `meoweco-paper` is compiled with a JDK 25 toolchain
\n– The plugin artifact still targets Java 17 bytecode for compatibility with older supported Paper servers
\n– If you run `Paper 26.1.x \/ 26.1.1`, the server itself still needs Java 25 because that requirement comes from upstream Paper<\/p>\n
## Implemented Features<\/p>\n
– Multiple currencies loaded from `config.yml`
\n– Per-currency display name, singular or plural name, initial balance, decimal precision, and transfer tax
\n– Configurable default currency used by Vault and command fallbacks
\n– Currency exchange with direct, inverse, and default-currency-derived rates
\n– Player balance lookup, payments, and leaderboard
\n– Admin balance management: give, take, set
\n– Frozen funds operations: `freeze`, `unfreeze`, `deductfrozen`
\n– Leaderboard visibility control: `hide`, `unhide`
\n– Leaderboard and placeholder cache refresh: `refresh`
\n– Scheduled rich tax with system sink or player collector
\n– Vault economy provider for the default currency
\n– PlaceholderAPI expansion with cached balance, top, and server-total placeholders
\n– Update checker against Modrinth
\n– Automatic account creation for every configured currency on player join
\n– Command override listener for legacy labels such as `\/bal`, `\/money`, `\/pay`, `\/baltop`, `\/moneytop`, and `\/ecotop`<\/p>\n
## Configuration<\/p>\n
Main file: `plugins\/MeowEco\/config.yml`<\/p>\n
### Core Keys<\/p>\n
“`yaml
\nmessages:
\n language: “zh_CN”<\/p>\n
storage:
\n type: sqlite
\n mysql:
\n host: localhost
\n port: 3306
\n database: meoweco
\n username: root
\n password: password
\n use-ssl: false<\/p>\n
update-checker:
\n enabled: true
\n interval: 24
\n slug: “meoweco”<\/p>\n
default-currency: “coins”<\/p>\n
exchange-rates:
\n enabled: true
\n coins:
\n points: 0.1
\n gems: 0.01<\/p>\n
rich-tax:
\n enabled: false
\n threshold: 100000.0
\n rate: 0.05
\n start-time: “03:00”
\n interval: “24h”
\n destination:
\n type: “system”
\n player: “Admin”<\/p>\n
currencies:
\n coins:
\n display-name: “&eCoins”
\n singular: “Coin”
\n plural: “Coins”
\n initial-balance: 100.0
\n decimal-places: 2
\n transfer-tax: 0.0
\n“`<\/p>\n
### Rich Tax Behavior<\/p>\n
– `threshold`: only the balance above this value is taxed
\n– `rate`: clamped to `0.0` through `1.0`
\n– `start-time`: server local time in `HH:mm`
\n– `interval`: supports raw minutes or suffixed values like `30m`, `6h`, `1d`
\n– `destination.type`:
\n – `system`: taxed funds are removed
\n – `player`: taxed funds are transferred to the configured player account<\/p>\n
## Commands<\/p>\n
### Registered Root Commands<\/p>\n
– `\/meoweco`
\n– `\/money`
\n– `\/pay`
\n– `\/baltop`
\n– `\/eco`<\/p>\n
Aliases:<\/p>\n
– `\/meoweco`: `meco`, `meow`
\n– `\/money`: `balance`, `bal`
\n– `\/eco`: `economy`<\/p>\n
### Player Commands<\/p>\n
| Command | Description | Shortcut or legacy-compatible commands:<\/p>\n – `\/bal`, `\/balance`, `\/money` ### Admin Commands<\/p>\n | Command | Description | Additional admin economy routes implemented in `EcoCommand`:<\/p>\n | Command | Description | ## TrMenu Compatibility<\/p>\n MeowEco can be used inside TrMenu menus for VIP shops, point purchases, exchange menus, and similar GUI flows.<\/p>\n There are two recommended styles:<\/p>\n ### 1. Short action style<\/p>\n If your TrMenu environment already provides MeowEco short conditions or actions, you can write:<\/p>\n “`yaml To give currency:<\/p>\n “`yaml Meaning:<\/p>\n – `condition: ‘meco points >= 99’`: checks whether the player has at least `99` of the `points` currency ### 2. Universal command style<\/p>\n If you do not use those short actions, or you want the most portable setup, let TrMenu execute MeowEco commands directly:<\/p>\n “`yaml To give currency:<\/p>\n “`yaml Notes:<\/p>\n – `console:` is recommended for `meco give` and `meco take`, so player permissions do not block the action ## Permissions<\/p>\n Declared in `plugin.yml`:<\/p>\n – `meoweco.admin` Notes:<\/p>\n – `give`, `take`, `set`, `freeze`, `unfreeze`, and `deductfrozen` can now be granted through their dedicated permission nodes ## PlaceholderAPI<\/p>\n Identifier: `meoweco`<\/p>\n ### Currency Metadata<\/p>\n – `%meoweco_currency_singular%` ### Balance Placeholders<\/p>\n Supported modes: `balance`, `frozen`, `available`<\/p>\n Supported formats:<\/p>\n – default: formatted numeric balance with separators Examples:<\/p>\n – `%meoweco_balance%` ### Server Total Placeholders<\/p>\n – `%meoweco_server_total_ ### Top Placeholders<\/p>\n – `%meoweco_top_ ## Developer API<\/p>\n Service lookup:<\/p>\n “`java Main methods currently exposed:<\/p>\n “`java ## Operational Notes<\/p>\n – Leaderboard cache lifetime: 5 minutes MeowEco is a High-Efficiency, Lightweight, and Highly Compatible economy plugin designed for modern Minecraft servers.<\/p>\n","protected":false},"featured_media":100550,"template":"","meta":{"_minecraft_slug":"meoweco","_minecraft_project_id":"M9JO0TFv","_minecraft_author":"xiaoyiluck666","_minecraft_license":"MIT","_minecraft_downloads":202,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"meoweco.zip","_minecraft_size_bytes":10393437,"_minecraft_version_count":13,"_minecraft_updated_at":"2026-05-16T12:43:53.673119Z","_minecraft_date_created":"2026-01-25T21:19:44.360372Z","_minecraft_date_modified":"2026-04-08T02:44:41.322868Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/meoweco","_minecraft_icon_attachment_id":100550,"_minecraft_imported_at":"2026-06-05T18:42:33+00:00","_minecraft_import_hash":"983518ea80246e225f1df36042f719af","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,126,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,167],"class_list":["post-100549","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1-1"],"yoast_head":"\n
\n| :— | :— |
\n| `\/meco` | Shows help |
\n| `\/meco bal [player] [currency]` | Check balance |
\n| `\/meco money [player] [currency]` | Same as `bal` |
\n| `\/meco pay
\n| `\/meco top [currency]` | Show leaderboard |
\n| `\/meco baltop [currency]` | Same as `top` |
\n| `\/meco exchange
\n– `\/pay`
\n– `\/baltop`
\n– `\/moneytop`
\n– `\/ecotop`<\/p>\n
\n| :— | :— |
\n| `\/meco give
\n| `\/meco take
\n| `\/meco set
\n| `\/meco setrate
\n| `\/meco hide
\n| `\/meco unhide
\n| `\/meco refresh` | Clear caches and fix unknown stored names |
\n| `\/meco reload` | Reload config and messages |
\n| `\/meco checkupdate` | Run update check immediately |
\n| `\/meco debug` | Toggle debug mode |
\n| `\/meco debug currencies` | Print loaded currencies |<\/p>\n
\n| :— | :— |
\n| `\/eco bal [player] [currency]` | Balance shortcut |
\n| `\/eco top [currency]` | Leaderboard shortcut |
\n| `\/eco freeze
\n| `\/eco unfreeze
\n| `\/eco deductfrozen
\nactions:
\n left:
\n condition: ‘meco points >= 99’
\n actions:
\n – ‘meco-take: points 99’
\n – ‘console: lp user %player_name% permission set vip.level1 true’
\n – ‘tell: &aPurchase successful’
\n“`<\/p>\n
\nactions:
\n left:
\n actions:
\n – ‘meco-give: points 99’
\n – ‘tell: &aGranted 99 points’
\n“`<\/p>\n
\n– `meco-take: points 99`: removes `99` of `points` from the player’s account
\n– `meco-give: points 99`: adds `99` of `points` to the player’s account<\/p>\n
\nactions:
\n left:
\n condition: ‘js: Number(“%meoweco_balance_points%”) >= 99’
\n actions:
\n – ‘console: meco take %player_name% 99 points’
\n – ‘tell: &aPurchase successful’
\n deny:
\n – ‘tell: &cNot enough points’
\n“`<\/p>\n
\nactions:
\n left:
\n actions:
\n – ‘console: meco give %player_name% 99 points’
\n – ‘tell: &aGranted 99 points’
\n“`<\/p>\n
\n– Conditions can use PlaceholderAPI values such as `%meoweco_balance_points%`
\n– `points` is only an example currency id; replace it with `coins`, `gems`, or any other currency id from your config
\n– For frozen-balance operations, you can also call `console: eco freeze …`, `console: eco unfreeze …`, and `console: eco deductfrozen …`<\/p>\n
\n– `meoweco.balance`
\n– `meoweco.balance.other`
\n– `meoweco.pay`
\n– `meoweco.take`
\n– `meoweco.reload`
\n– `meoweco.top`
\n– `meoweco.eco.give`
\n– `meoweco.eco.take`
\n– `meoweco.eco.set`
\n– `meoweco.eco.freeze`
\n– `meoweco.eco.unfreeze`
\n– `meoweco.eco.deductfrozen`
\n– `meoweco.debug`<\/p>\n
\n– `setrate`, `refresh`, `hide`, and `unhide` should still stay on the stricter `meoweco.admin` path<\/p>\n
\n– `%meoweco_currency_plural%`
\n– `%meoweco_currency_display%`
\n– `%meoweco_currency_id%`
\n– `%meoweco_currency_singular_
\n– `%meoweco_currency_plural_
\n– `%meoweco_currency_display_
\n– `%meoweco_currency_id_
\n– `raw`
\n– `formatted`
\n– `fixed`
\n– `short`<\/p>\n
\n– `%meoweco_balance_points%`
\n– `%meoweco_balance_short_gems%`
\n– `%meoweco_frozen%`
\n– `%meoweco_frozen_fixed_coins%`
\n– `%meoweco_available_formatted_points%`<\/p>\n
\n– `%meoweco_server_total_raw_
\n– `%meoweco_server_total_formatted_
\n– `%meoweco_server_total_fixed_
\n– `%meoweco_server_total_short_
\n– `%meoweco_top_
\n– `%meoweco_top_
\n– `%meoweco_top_
\n– `%meoweco_top_
\n– `%meoweco_top_
\nMeowEcoAPI api = MeowEcoAPI.get();
\n“`<\/p>\n
\nCollection
\nCurrency getCurrency(String id);
\ndouble getBalance(UUID uuid, String currencyId);
\nboolean deposit(UUID uuid, String currencyId, double amount);
\nboolean withdraw(UUID uuid, String currencyId, double amount);
\ndouble getFrozenBalance(UUID uuid, String currencyId);
\ndouble getAvailableBalance(UUID uuid, String currencyId);
\nboolean freeze(UUID uuid, String currencyId, double amount);
\nboolean unfreeze(UUID uuid, String currencyId, double amount);
\nboolean deductFrozen(UUID uuid, String currencyId, double amount);
\n“`<\/p>\n
\n– Placeholder balance cache lifetime: 1 second
\n– Placeholder top and server-total cache lifetime: 30 seconds
\n– Most database operations are dispatched asynchronously
\n– Hidden accounts are excluded from leaderboard output at the database layer<\/p>\n","protected":false},"excerpt":{"rendered":"