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
