MeowEco

## Support and Feedback - (https://github.com/xiaoyiluck666/MeowEco/issues) # MeowEco Documentation Guide 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. ## 🌟 Highlights - 🪙 `Multi-Currency and Custom Currencies`: 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`: `raw`, `formatted`, `fixed`, and `short` output styles make balances, leaderboards, and total-economy views easier to show. - ⚖️ `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. - ⚡ `Efficient Runtime`: async-heavy database work, cached balance/top lookups, and DB-level hidden-account filtering for high-frequency servers. - 🛡️ `Clear Version Baseline`: compiled against the Paper `26.2` API line, guarded by a 26.1.x compatibility compile check, and emitted as Java 25 bytecode for Paper 26.1.x / 26.2 servers. ## 🚀 Server Owner Setup - Plugin version: `26.9.1` - Recommended server software: `Paper` - Economy bridge: works with `Vault` using the default currency - Placeholder support: works with `PlaceholderAPI` for menus, scoreboards, chat, and HUD-style displays - Menu integration: works well with `TrMenu` for shops, VIP pages, exchange buttons, and reward flows - Current primary build target API: `io.papermc.paper:paper-api:26.2.build.40-alpha` - Compatibility compile-check API: `io.papermc.paper:paper-api:26.1.1.build.8-alpha` - `meoweco-paper` is compiled with a JDK 25 toolchain - The plugin artifact targets 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 ## ✨ Best-Fit Scenarios - 🪙 `Multi-currency servers`: coins, points, gems, tokens, and similar parallel economies without forcing every gameplay loop into one balance. - 🏪 `Shop and menu flows`: TrMenu-driven purchases, exchanges, permission rewards, and claim buttons with simple commands and placeholders. - 🧱 `RPG and survival economy`: frozen funds, rankings, rich tax, transfer tax, and exchange rates can combine into a more durable economy loop. - 📊 `Display-heavy gameplay`: formatted balances, top lists, and server-wide totals are ready for menus, scoreboards, and chat displays. - 🔧 `Integrated server setups`: easy to drop into servers already using Vault, PlaceholderAPI, and TrMenu without writing extra glue logic. ## ⚙️ Configuration Overview Main file: `plugins/MeowEco/config.yml` ### 🧩 Core Config Example ```yaml messages: language: "zh_CN" storage: type: sqlite mysql: host: localhost port: 3306 database: meoweco username: root password: password use-ssl: false update-checker: enabled: true interval: 24 slug: "meoweco" default-currency: "coins" exchange-rates: enabled: true coins: points: 0.1 gems: 0.01 rich-tax: enabled: false threshold: 100000.0 rate: 0.05 start-time: "03:00" interval: "24h" destination: type: "system" player: "Admin" currencies: coins: display-name: "&eCoins" singular: "Coin" plural: "Coins" initial-balance: 100.0 decimal-places: 2 transfer-tax: 0.0 ``` ### 💸 Rich Tax Focus - `threshold`: only the balance above this point is taxed - `rate`: clamped between `0.0` and `1.0` - `start-time`: server local time in `HH:mm` - `interval`: supports raw minutes and values like `30m`, `6h`, `1d` - `destination.type = system`: taxed funds are removed - `destination.type = player`: taxed funds are redirected into a player account Why rich tax matters: - 🏦 helps drain excess money when the server economy starts inflating - ⚖️ works as a soft “redistribution” tool so a few ultra-rich accounts do not dominate the whole economy - 🧭 turns economy balancing from manual intervention into scheduled rule-based control - 🛒 when tax goes to a player account, you can measure exactly how much tax was collected and reuse that pool for system buy-shops, public rewards, or other balancing loops ### 🔄 Exchange Focus - Supports direct `A -> B` rates - Supports inverse lookups - S