issues

MeowEco Documentation

Version: 26.9.1

MeowEco is a modern multi-currency economy plugin for Paper servers. It is not just a balance table; it helps server owners connect coins, points, gems, shops, menus, leaderboards, taxes, and database-backed economy control into one practical system.

🐾 Built for point shops, RPG currency systems, VIP menus, recharge flows, leaderboards, rich-tax balancing, and servers that want smooth Vault / PlaceholderAPI / TrMenu integration.

Why Server Owners Pick MeowEco

• 🪙 Real multi-currency support: run coins, points, gems, tokens, or any custom economy with independent names, symbols, precision, starting balances, and transfer tax.
• 🏪 Shop, VIP, and menu ready: bridge the default currency through Vault, expose balances through PlaceholderAPI, and use clean commands for TrMenu shops, exchanges, and reward buttons.
• 📊 Display-ready economy data: show formatted balances, frozen funds, leaderboards, and server-wide totals in menus, scoreboards, chat, and HUD-style displays.
• ⚖️ Rich tax and economy control: schedule taxation per currency with custom thresholds and rates to slow inflation and support long-running servers.
• 🧊 Frozen funds: freeze, unfreeze, and deduct frozen money for deposits, penalties, locked trades, quest guarantees, and custom server rules.
• ⚡ Built for busy servers: async-heavy database work, cached balance/top lookups, and DB-level hidden-account filtering keep common economy flows responsive.

Platform

• Plugin version: 26.9.1
• Current build target API: io.papermc.paper:paper-api:26.2.build.40-alpha
• Additional compatibility guard: compiled against the earliest supported 26.1.x API line to protect Paper 26.1.x / 26.2
• meoweco-paper is compiled with a JDK 25 toolchain and emitted as Java 25 bytecode
• If you run Paper 26.1.x / 26.2, the server itself still needs Java 25 because that requirement comes from upstream Paper

Implemented Features

• Multiple currencies loaded from config.yml
• Per-currency display name, singular or plural name, initial balance, decimal precision, and transfer tax
• Configurable default currency used by Vault and command fallbacks
• Currency exchange with direct, inverse, and default-currency-derived rates
• Player balance lookup, payments, and leaderboard
• Admin balance management: give, take, set
• Frozen funds operations: freeze, unfreeze, deductfrozen
• Leaderboard visibility control: hide, unhide
• Leaderboard and placeholder cache refresh: refresh
• Scheduled rich tax with system sink or player collector
• Vault economy provider for the default currency
• PlaceholderAPI expansion with cached balance, top, and server-total placeholders
• Update checker against Modrinth
• Automatic account creation for every configured currency on player join
• Built-in MySQL storage support with bundled driver and pool tuning options
• Command override listener for legacy labels such as /bal, /money, /pay, /baltop, /moneytop, and /ecotop
• Read-only precision reporting for legacy balances with over-precise stored amounts

PlaceholderAPI

Identifier: meoweco

• Currency metadata placeholders for singular, plural, display, and id forms
• Balance placeholders for balance, frozen, and available
• Top placeholders and server-total placeholders with cached output for menu and HUD use
• Works well with PlaceholderAPI-powered scoreboards, chat formats, and TrMenu displays

Developer API

MeowEcoAPI api = MeowEcoAPI.get();

Operational Notes

• Leaderboard cache lifetime: 5 minutes
• Vault default-currency read cache lifetime: 0.5 seconds
• Placeholder balance cache lifetime: 1 second
• Placeholder top and server-total cache lifetime: 30 seconds
• Most database operations are dispatched asynchronously
• Hidden accounts are excluded from leaderboard output at the database layer