
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.xAPI line to protectPaper 26.1.x / 26.2 meoweco-paperis 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, andavailable - 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
Ченджлог
26.9.1Релиз26.1.1, 26.1.2, 26.2 · 29 июня 2026 г.
MeowEco 26.9.1 Changelog
Release date: 2026-06-29
🚀 Highlights
MeowEco 26.9.1 is a performance maintenance release for Paper 26.1.x / 26.2 servers. It focuses on reducing Vault default-currency balance read pressure.
Many shop, menu, permission, quest, and display plugins query balances through Vault very frequently. This release adds a very short read cache for Vault default-currency balance lookups, reducing repeated database reads while keeping all money-changing operations database-authoritative.
✨ Added
- ⚡ Added a short Vault default-currency balance read cache for frequent
getBalance/hascalls from external Vault consumers. - 🧾 Added 26.9.1 release notes explaining the cache strategy, intended use, and safety boundaries.
- 🧹 Player quit now clears that player's Vault cache entries to avoid stale cache growth on long-running servers.
- 🧪 Added a Paper 26.1.2 stable API compatibility compile gate alongside the existing earliest 26.1.x guard and Paper 26.2 main compile target.
🔄 Changed
- ☕ Bumped the plugin version to
26.9.1. - 🔁 Successful Vault, MeowEco API, admin command, pay/exchange, join-time account creation, and rich-tax write paths now invalidate the related Vault balance cache.
- 🧠 Player-level cache invalidation now removes every Vault cache key for that player instead of relying on the current default-currency setting.
- 📦 Release verification now covers the earliest Paper 26.1.x API, Paper 26.1.2 stable API, and the Paper 26.2 main target API.
🛠️ Fixes And Improvements
- 🛡️ The cache is read-only and only applies to Vault default-currency reads; deposits, withdrawals, and account creation still go directly to the database.
- 🔒 Vault withdrawals remain database-authoritative, so insufficient funds are rejected by the atomic database update instead of by cached reads.
- 🧽 Cleaned README trailing whitespace while preserving the emoji-led marketplace introduction layout.
🌟 Why Upgrade
- 🏪 Lower database pressure when shop, menu, VIP, and reward plugins repeatedly check balances.
- 📊 Lighter balance displays, requirement checks, and menu refreshes.
- 🔌 Better Vault behavior for high-interaction servers.
- 🛡️ Performance gains without weakening economy safety.
⚠️ Upgrade Notes
- Your server must run on Java 25.
- This release targets Paper 26.1.x / 26.2.
- Back up your database and configuration files before upgrading, especially on production economy servers.
- No extra configuration migration is required when upgrading from 26.9.0.
26.9.0Релиз26.1.1, 26.1.2, 26.2 · 29 июня 2026 г.
MeowEco 26.9.0 Changelog
Release date: 2026-06-29
🚀 Highlights
MeowEco 26.9.0 targets Paper 26.1.x / 26.2 servers running Java 25. This release moves the primary build target to Paper 26.2 while keeping the Paper 26.1.x compatibility compile gate, so server owners can adopt the newer Paper line with a clearer safety net.
This is also a stability-focused economy release: money precision, database regression coverage, SQLite behavior, public documentation, and release metadata were all tightened for multi-currency servers, shop menus, leaderboards, rich-tax setups, and integrated server workflows.
✨ Added
- 🛡️ Added primary Paper 26.2 API support with
paper-api:26.2.build.40-alpha. - 🧪 Added broader economy regression coverage for transfers, exchange, frozen funds, rich tax, and amount precision policy.
- 🗄️ Added SQLite regression coverage for account creation, transfers, exchange rollback, frozen funds, and leaderboard exclusions.
- 🔍 Added read-only precision reporting for legacy balances, helping server owners find over-precise stored amounts without modifying player money.
🔄 Changed
- ☕ Bumped the plugin version to
26.9.0. - 🧱 Updated the supported runtime range to Paper 26.1.x / 26.2 with Java 25.
- 📦 Kept the Paper 26.1.x compatibility compile check while compiling primarily against Paper 26.2.
- 🔌 Adjusted Maven resolution so Paper 26.2's Adventure 5.x dependencies resolve from Maven Central.
- 📚 Improved README and Wiki copy so server owners can quickly understand where MeowEco fits and why it is useful.
🛠️ Fixes And Improvements
- 💰 Unified amount precision handling across commands, API calls, and Vault boundaries.
- 🧾 Rounded tax, exchange, and scheduled economy results before storage for cleaner database values.
- 🧹 Removed stale non-Paper project messaging and kept the project direction focused on the Paper plugin.
- ⚙️ Cleaned up generated-file and local-runtime ignores to keep the repository easier to maintain.
🌟 Best For
- 🪙 Servers running coins, points, gems, tokens, or other multi-currency economies.
- 🏪 Shop, VIP, reward, and exchange menus built around Vault, PlaceholderAPI, and TrMenu.
- 📊 Servers that care about leaderboards, formatted balances, and total-economy displays.
- 🧊 RPG and survival servers that need frozen funds, rich tax, and economy-control tools.
- 🛡️ Server owners preparing for Paper 26.2 while keeping Paper 26.1.x compatibility checks in place.
⚠️ Upgrade Notes
- Your server must run on Java 25.
- This release targets Paper 26.1.x / 26.2. If your server is still on Paper / Minecraft
1.21.11or older, do not assume this version is compatible. - Back up your database and configuration files before upgrading, especially on production economy servers.
- If you use MySQL, validate connection settings, charset, and permissions on a test server first.
26.8.1Релиз26.1, 26.1.1, 26.1.2 · 30 мая 2026 г.
MeowEco 26.8.1
MeowEco 26.8.1 targets Paper 26.1 / 26.1.1 / 26.1.2 servers running Java 25. This release focuses on smoother use on newer Paper environments and a better out-of-the-box MySQL storage experience.
Added
- MySQL storage now ships with the Paper plugin, so server owners no longer need to install the MySQL driver separately.
- Added MySQL pool settings for tuning connection count, timeouts, and connection lifetime.
Changed
- Clarified support for
Paper 26.1,Paper 26.1.1, andPaper 26.1.2, all running on Java 25. - Updated MySQL defaults to use
utf8mb4and improved compatibility with common MySQL 8 authentication and timeout scenarios. - Updated documentation for the current version, supported Paper range, and Java runtime requirement.
Fixed
- Improved MySQL connection stability for charset, authentication, and slow-network situations.
Runtime Notes
- Your server must run on Java 25.
- This release targets Paper 26.1 / 26.1.1 / 26.1.2. If your server is still on Paper / Minecraft
1.21.11or older, do not assume this version is compatible.
26.7.4Релиз1.21.10, 1.21.11, 26.1.1 · 8 апреля 2026 г.
📝 Changelog Update - v26.7.4
Here are the summary of changes for the upcoming release:
✅ Code Changes
🔍 Player Lookup:
- Removed the name fallback to
Bukkit#getOfflinePlayer(String)inPlayerLookup.resolveOfflinePlayer(...). This prevents non-existent player names from being resolved as forged offline accounts.
- Removed the name fallback to
🛡️ Permission Handling:
- Adjusted
EcoCommandpermission checks:give,take,set,freeze,unfreeze, anddeductfrozennow require their own independent permission nodes.setrate,refresh,hide, andunhidecontinue to requiremeoweco.admin.
- Adjusted
⬆️ Dependency Updates
- 📦 Versioning:
- Updated project version and Paper plugin version to
26.7.4.
- Updated project version and Paper plugin version to
26.7.3Релиз1.21.10, 1.21.11, 26.1.1 · 4 апреля 2026 г.
- Tested exclusively on the Paper server-side.
- Since Paper has not released version 26.1, compatibility is only supported and tested for version 26.1.1.

26.7.2Релиз1.21.9, 1.21.10, 1.21.11 · 21 марта 2026 г.
🛠️ Changelog
✨ Added
- Offline-Player Lookup Support: Added shared support for admin commands and
rich-taxplayer destinations. Offline accounts can now be resolved via UUID, cached profile, database name mapping, or final server lookup. - Permission Declarations: Added explicit declarations to
plugin.ymlfor:meoweco.eco.freezemeoweco.eco.unfreezemeoweco.eco.deductfrozen
🔄 Changed
- Alias Handling Optimization: Optimized
/eco baland/eco topto delegate to the mainmeowecocommand handlers, ensuring consistent behavior and cache management. - Rich-Tax Improvements: Updated configuration to support per-currency rules and provided clearer scheduling log output.
- Documentation: Updated the project documentation and wiki content to align with the current feature set.
🐞 Fixed
- Offline
/eco give: Fixed failures occurring when the target player was not already present in the immediate Bukkit offline-player cache. - Resolution Consistency: Fixed
rich-taxdestination-player resolution to reuse the same lookup path as admin commands. - Code Cleanup: Removed the stale
org.bukkit.Bukkitimport warning inRichTaxService.
26.7.1Релиз1.21.9, 1.21.10, 1.21.11 · 11 марта 2026 г.
MeowEco 26.7.1
Added
- Added a configurable Wealth Tax system, supporting:
- Tax threshold amount
- Tax rate
- Execution start time
- Execution interval
- The wealth tax now supports two destinations:
- Confiscated by the system
- Transferred to a specified player's account
Improved
- Updated
config.ymlcomments to bilingual Chinese–English, making it easier for server owners to configure directly. - Improved API parameter validation, rejecting invalid or illegal amount inputs.
- Optimized Placeholder and leaderboard cache refresh logic, reducing main-thread blocking and improving overall stability.
Build
- Updated build configuration and fixed
shadowJarpackaging compatibility issues under the current Gradle environment.
26.6.9Релиз1.21.9, 1.21.10, 1.21.11 · 4 марта 2026 г.
Changelog
- Fixed an issue where players received an incorrect amount of points.
- Fixed an issue where commands using the
/ecoprefix were not working properly.
Комментарии
Загружаем…