issues

MeowEco Documentation

Version: 26.8.1

MeowEco is a Paper economy plugin with multi-currency support, Vault integration, PlaceholderAPI support, exchange rates, frozen funds, scheduled rich tax, and built-in MySQL storage support for modern server setups.

Great for point shops, RPG currency systems, VIP menus, recharge flows, and servers that want smooth Vault / PlaceholderAPI / TrMenu integration.

Platform

• Plugin version: 26.8.1
• Current build target API: io.papermc.paper:paper-api:26.1.2.build.64-stable
• Additional compatibility guard: compiled against the earliest supported 26.1.x API line to protect Paper 26.1 / 26.1.1 / 26.1.2
• meoweco-paper is compiled with a JDK 25 toolchain and emitted as Java 25 bytecode
• If you run Paper 26.1 / 26.1.1 / 26.1.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

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
• 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