MeowEco Economy
🧊 衡量通胀。调整政策。确保每笔余额变动均可解释。
MeowEco 是一款优先适配 Paper 的多币种经济系统,专为希望“运营”而非仅“展示”经济数据的服务器设计。它为工作人员提供了一套实用的循环机制,以保持游戏进度健康有序。
为新手玩家提供具有实际价值的初始余额,同时将其与赚取的资金分开管理。配置初始赠予是否可进入玩家交易,通过货币兑换保留其来源属性,并让集成商店在退款时一次性返还支付金额,且保持原始来源不变。
📊 衡量 → ⚙️ 调整 → 🧾 验证
- 📊 衡量供应与集中度:使用
/meco policy report命令查看总供应量、流通余额、账户数量、最富有账户占比以及前 10 名集中度。 - ⚙️ 调整货币政策:针对每种货币设置富人税、转账税、汇率,并为资金回收池、锁定存款、惩罚机制和进度门槛配置冻结资金。
- 🧾 验证每一项结果:通过交易级审计历史记录、变动前后的余额、操作者、资金来源以及共享交易 ID 进行核查。
你依然可以获得现代服务器经济所需的一切功能:💰 硬币、点数、宝石、代币及自定义货币;🏪 经典 Vault 和 VaultUnlocked v2 兼容性;菜单集成;📈 排行榜;🔄 安全迁移;以及 🛡️ SQLite/MySQL 存储支持。
本项目专注于 Paper 插件开发,当前运行时目标版本为 Java 25 下的 Paper 26.1.x / 26.2 / 26.3。
中文服务器:在 plugins/MeowEco/config.yml 中设置 messages.language: "zh_CN",然后运行 /meco reload。
运行时环境
- 服务器:Paper 26.1.x / 26.2 / 26.3
- Java:25
- 可选集成:Classic Vault, VaultUnlocked v2, PlaceholderAPI, 通过命令/占位符集成的 TrMenu
- 可选身份认证赠予:需配合服务器的 MeowIdentity 桥接插件及 PlaceholderAPI;两者均未随本插件捆绑
- 存储:默认使用 SQLite;MySQL 支持多个 Paper 实例共享同一数据库
构建
.\gradlew.bat :meoweco-paper:check
.\gradlew.bat :meoweco-paper:shadowJar
这些命令适用于贡献者和 CI 验证。服务器用户请仅从 Modrinth 下载已构建好的插件 JAR:
主要功能
- 🎁 追踪初始资金:在总余额旁维护独立的剩余赠予账本;允许个人消费,但控制直接的玩家间转账。
- 🛒 交易与退款 API:原子性地检查可用资金,使用持久化引用进行扣款,并一次性向原始钱包退款,保留原有的赠予标签。
- 🪪 可选的身份认证赠予:新创建的钱包会获得离线基础金额,随后经过验证的付费会话将单独获得补充金额。现有钱包不会被重置或追溯发放资金。
- 🔔 兼容更新通知:仅考虑与当前 Minecraft 版本和 Paper 版本匹配的发布版本,包括正确处理本地构建元数据。
- 🧊 反通胀政策循环:衡量供应量和财富集中度,应用针对性的税收或资金控制,然后对比下一次报告和审计轨迹。
- 📉 受控的资金回收池与冻结资金:富人税可以移除或重定向超过阈值的余额,而转账税和冻结资金则塑造了资金如何进入、流转和退出经济体系。
- 🧾 默认问责制:存款、取款、支付、兑换、管理员编辑、API/Vault 写入、税收和迁移都会记录谁修改了什么以及原因。
- 🪙 支持多币种账户,包含自定义名称、符号、精度、初始余额和转账税。
- 🔌 默认货币的经典 Vault 桥接,以及可选的 VaultUnlocked v2 提供者,支持 UUID 账户、多币种、转账和异步操作。
- 🧩 PlaceholderAPI 占位符,用于显示余额、冻结余额、总余额及类排行榜样式的数据。
- 🏪 面向菜单的命令流,适用于商店、VIP 页面、兑换系统和奖励系统。
- 🧊 管理员工具,包括给予、扣除、设置、冻结、解冻、扣除冻结资金、隐藏/显示、重载和调试功能。
- 📊 SQLite 和 MySQL 存储,带有索引化的余额查询以支持排行榜和税收工作流,包括在多个共享 MySQL 的 Paper 实例之间保持一致的余额。
- ⚖️ 按货币划分的渐进式富人税和转账税层级,应用边际税率以减缓失控的通胀,无需手动进行电子表格计算。
- 🔄 支持从在线 Vault 提供者、EssentialsX userdata 或 CSV 进行试运行迁移,并自动创建导入前的备份。
- 🧾 交易审计历史记录,涵盖命令执行、转账、兑换、Vault/API 写入、税收周期和迁移过程。
政策循环:衡量 → 调整 → 验证
📊 衡量
运行 /meco policy report 检查每种货币的总供应量、流通余额、账户数量、最富有账户占比、前 10 名集中度以及活跃的富人税设置。
⚙️ 调整
- 渐进式富人税:通过可配置的边际财富区间移除或重定向余额。
- 渐进式转账税:将高频转账转化为受控的资金回收池,采用相同的区间模型。
- 冻结资金:预留存款,支持惩罚机制,并作为进度门槛。
- 汇率:保持货币独立性,同时定义明确的转换路径。
- 多币种:分离奖励、高级代币和活动经济体系。
🧾 验证
使用 /meco audit <player> [currency] [limit] 或 /meco audit export [limit] 查看结果。审计条目包含操作、来源、执行者、金额、变动前后余额、时间戳和交易 ID;支付或交换的相关方共享同一个交易 ID。
MeowEco 不承诺固定价格,也不保证能自动抵御所有通胀来源。它赋予管理员测量工具和策略杠杆,以便进行有意识的调整并验证其效果。
26.11.0 新增:初始资金与安全退款
此功能版本增加了赠款来源追踪、可选的签名身份初始余额、持久化支付收据,以及修复了 26.x 服务器被提供 Minecraft 1.21.11 移植版的问题。
配置初始资金的使用方式
initial-funds:
allow-player-transfer: false
spending-order: GIFT_FIRST
- 默认设置阻止受追踪的赠款直接用于玩家支付,但允许普通的个人消费。设置
allow-player-transfer: true以允许赠款转账。 GIFT_FIRST优先花费赠款而非赚取的资金;EARNED_FIRST则反转该顺序。更改将在执行/meco reload后生效。- 新配置的初始余额和未来的签名身份补充金将被追踪。来源未知的现有余额不会被重新标记。
- 兑换和允许的直转会保留赠款标签。冻结的资金也会减少可转移的赚取金额。
- 被拒绝的
/pay命令会解释可用资金何时受到初始资金的限制。
可选的签名身份初始余额
identity-initial-balance:
enabled: false
balances:
coins:
offline: 100.0
premium: 1000.0
仅在服务器提供 MeowIdentity 签名会话桥接和 PlaceholderAPI 时启用此功能。这些集成不包含在 MeowEco 中。金额必须符合货币精度要求,且满足 premium >= offline >= 0。
新符合条件的钱包首先接收离线金额。当签名会话确认高级(premium)状态时,MeowEco 会一次性添加差额,而不会替换后续的收益、支出或冻结资金。缺失或未解决的身份信息将保持待定状态。现有钱包不会进行回溯填充,待处理的赠款保留钱包创建时记录的金额。
整合玩家商店与退款
MeowEcoAPI 提供了 getInitialGiftBalance、getTransferableBalance 以及原子性的 withdrawForPlayerTrade。对于可能需要退款的支付,请使用 debitWithReceipt(uuid, currency, amount, reference, playerTrade)、getReceiptState 和 refundReceipt。
为每次支付使用唯一的持久化引用。重试相同的扣款不会重复收费;退款会恢复原始钱包和来源标签一次。保留收据以确保防重复保护。
通用的 Vault 提款无法识别交易对手或交易目的。 现有的 Vault 商店保持普通的消费行为。玩家商店必须显式集成玩家交易 API 才能强制执行赠款限制;普通的 Vault 存款退款被视为赚取的资金。MeowEco 无法在所有第三方商店中自动强制执行这些规则。
升级说明
升级前请备份数据库和配置文件。此版本添加了赠款、来源审计和支付收据表,而无需重写历史钱包余额。签名身份赠款默认禁用;来源追踪和转移政策适用于新的符合条件的赠款。
如果需要放宽赠款限制,请在此版本上更改策略。旧版 JAR 文件不维护来源标签或收据,因此降级期间进行的交易需要在重新启用来源限制之前进行对账。
兼容性矩阵
| Server | Java | Status |
|---|---|---|
| Paper 26.1.1 | 25 | Compile-tested |
| Paper 26.1.2 | 25 | Compile-tested |
| Paper 26.2 | 25 | Compatibility compile-tested |
| Paper 26.3 | 25 | Primary build target |
| Purpur based on the supported Paper lines | 25 | Expected compatible |
命令
| Command | Purpose |
|---|---|
/meoweco / /meco / /meow |
Unified command entry |
/money [player] [currency] |
Check balance |
/money exchange <amount> <from> <to> |
Exchange currencies |
/pay <player> <amount> [currency] |
Pay another player |
/baltop [currency] |
Show balance leaderboard |
| `/eco <give | take |
| `/eco <freeze | unfreeze |
/eco setrate <from> <to> <rate> |
Update exchange rate |
权限
| Permission | Default | Purpose |
|---|---|---|
meoweco.balance |
true | Check own balance |
meoweco.balance.other |
op | Check another player's balance |
meoweco.pay |
true | Pay players |
meoweco.top |
true | View leaderboard |
meoweco.take |
op | Use /take |
meoweco.reload |
op | Reload config and language files |
meoweco.eco.give |
op | Admin give |
meoweco.eco.take |
op | Admin take |
meoweco.eco.set |
op | Admin set |
meoweco.eco.freeze |
op | Freeze funds |
meoweco.eco.unfreeze |
op | Unfreeze funds |
meoweco.eco.deductfrozen |
op | Deduct frozen funds |
meoweco.debug |
op | Toggle debug mode |
meoweco.admin |
op | Parent admin permission |
配置
主配置文件:meoweco-paper/src/main/resources/config.yml
重要部分:
storage: 选择sqlite或mysql。default-currency: Vault 和默认命令行为使用的货币。exchange-rates: 启用/禁用并定义汇率。rich-tax: 配置按货币的周期性税收规则。currencies: 定义货币 ID、符号、名称、初始余额和转移税。initial-funds: 控制受追踪初始资金的玩家转账及消费顺序。identity-initial-balance: 为新钱包可选地设置签名身份的初始金额。
更新日志
最新版本:26.11.0 — 中文更新日志 · English release notes。
有关发布详情,请参阅 CHANGELOG.md。版本通过 Modrinth 分发;GitHub 托管源代码、CI 状态以及 Wiki 文档。
MeowEco Economy
🧊 Measure inflation. Tune policy. Keep every balance change explainable.
MeowEco is a Paper-first, multi-currency economy for servers that want an economy they can operate, not just a number they can display. It gives staff a practical loop for keeping progression healthy.
Give new players a useful starting balance while keeping the remaining grant separate from earned money. Configure whether grants can enter player trades, preserve their source through currency exchanges, and let integrated shops refund a payment once with its original source intact.
📊 Measure → ⚙️ Adjust → 🧾 Verify
- 📊 Measure supply and concentration with
/meco policy report: total supply, circulating balance, account count, richest-account share, and Top 10 concentration. - ⚙️ Adjust the money policy with per-currency rich tax, transfer tax, exchange rates, and frozen funds for sinks, locked deposits, penalties, and progression gates.
- 🧾 Verify every result with transaction-level audit history, before/after balances, actor, source, and shared transaction IDs.
You still get everything a modern server economy needs: 💰 coins, points, gems, tokens, and custom currencies; 🏪 Classic Vault and VaultUnlocked v2 compatibility; menu integrations; 📈 leaderboards; 🔄 safe migration; and 🛡️ SQLite/MySQL storage.
The project is focused exclusively on the Paper plugin, with a current runtime target of Paper 26.1.x / 26.2 / 26.3 on Java 25.
Chinese server: set messages.language: "zh_CN" in plugins/MeowEco/config.yml, then run /meco reload.
Runtime
- Server: Paper 26.1.x / 26.2 / 26.3
- Java: 25
- Optional integrations: Classic Vault, VaultUnlocked v2, PlaceholderAPI, TrMenu via commands/placeholders
- Optional signed-identity grants: your server's MeowIdentity bridge plus PlaceholderAPI; neither is bundled
- Storage: SQLite by default; MySQL supports multiple Paper instances sharing one database
Build
.\gradlew.bat :meoweco-paper:check
.\gradlew.bat :meoweco-paper:shadowJar
These commands are for contributors and CI verification. 服务器用户请只从 Modrinth 下载构建好的插件 JAR:
Main Features
- 🎁 Tracked starting funds: keep a remaining-grant ledger alongside the total balance; allow personal spending while controlling direct player transfers.
- 🛒 Trade and refund APIs: atomically check eligible funds, debit with a persistent reference, and refund once to the original wallet with its original grant labels.
- 🪪 Optional identity grants: new wallets receive an offline base amount, then a verified premium session receives its supplement once. Existing wallets are not reset or retroactively granted money.
- 🔔 Compatible update notices: only consider releases for the running Minecraft version and Paper, including correct handling of local build metadata.
- 🧊 Anti-inflation policy loop: measure supply and wealth concentration, apply targeted tax or fund controls, then compare the next report and audit trail.
- 📉 Controlled sinks and locked funds: rich tax can remove or redirect balances above a threshold, while transfer tax and frozen funds shape how money enters, moves through, and leaves the economy.
- 🧾 Accountability by default: deposits, withdrawals, payments, exchanges, admin edits, API/Vault writes, taxes, and migrations record who changed what and why.
- 🪙 Multi-currency accounts with custom names, symbols, precision, starting balances, and transfer tax.
- 🔌 Classic Vault bridge for the default currency, plus an optional VaultUnlocked v2 provider with UUID accounts, multiple currencies, transfers, and async operations.
- 🧩 PlaceholderAPI placeholders for balances, frozen balances, total balance, and leaderboard-style displays.
- 🏪 Menu-friendly command flows for shops, VIP pages, exchanges, and reward systems.
- 🧊 Admin tools for give, take, set, freeze, unfreeze, deduct frozen funds, hide/unhide, reload, and debug.
- 📊 SQLite and MySQL storage with indexed balance queries for leaderboard and tax workflows, including consistent balances across multiple Paper instances sharing MySQL.
- ⚖️ Progressive rich-tax and transfer-tax tiers per currency, applying marginal rates to slow runaway inflation without manual spreadsheet work.
- 🔄 Dry-run migration from live Vault providers, EssentialsX userdata, or CSV with automatic pre-import backups.
- 🧾 Transaction audit history for commands, transfers, exchanges, Vault/API writes, tax cycles, and migrations.
Policy Loop: Measure → Adjust → Verify
📊 Measure
Run /meco policy report to inspect each currency's total supply, circulating balance, account count, richest-account share, Top 10 concentration, and active rich-tax settings.
⚙️ Adjust
- Progressive rich tax removes or redirects balances through configurable marginal wealth brackets.
- Progressive transfer tax turns high-volume transfers into a controlled sink with the same bracket model.
- Frozen funds reserve deposits, support penalties, and gate progression.
- Exchange rates keep currencies independent while defining deliberate conversion paths.
- Multiple currencies separate rewards, premium tokens, and event economies.
🧾 Verify
Use /meco audit <player> [currency] [limit] or /meco audit export [limit] to review the result. Audit entries include the operation, source, actor, amount, before/after balances, timestamp, and transaction ID; related sides of a payment or exchange share one transaction ID.
MeowEco does not promise fixed prices or automatic protection from every inflation source. It gives staff the measurements and policy levers to make deliberate changes and verify their effect.
New in 26.11.0: Starting Funds and Safe Refunds
This feature release adds grant-source tracking, optional signed-identity starting balances, persistent payment receipts, and a fix for 26.x servers being offered the Minecraft 1.21.11 backport.
Configure how starting funds can be used
initial-funds:
allow-player-transfer: false
spending-order: GIFT_FIRST
- The default blocks the remaining tracked grant from direct player payments while allowing ordinary personal spending. Set
allow-player-transfer: trueto permit grant transfers. GIFT_FIRSTspends grants before earned funds;EARNED_FIRSTreverses that order. Changes take effect with/meco reload.- New configured starting balances and future signed-identity supplements are tracked. Existing balances with unknown sources are not relabeled.
- Exchanges and permitted direct transfers preserve grant labels. Frozen funds also reduce the earned amount eligible for transfer.
- A rejected
/payexplains when the available money is restricted starting funds.
Optional signed-identity starting balances
identity-initial-balance:
enabled: false
balances:
coins:
offline: 100.0
premium: 1000.0
Enable this only when your server provides the MeowIdentity signed-session bridge and PlaceholderAPI. These integrations are not included in MeowEco. Amounts must fit currency precision, with premium >= offline >= 0.
A newly eligible wallet receives the offline amount first. When a signed session confirms premium status, MeowEco adds the difference once without replacing later earnings, spending, or frozen funds. Missing or unresolved identity data remains pending. Existing wallets are not backfilled, and pending grants retain the amounts recorded when the wallet was created.
Integrate player shops and refunds
MeowEcoAPI exposes getInitialGiftBalance, getTransferableBalance, and atomic withdrawForPlayerTrade. For a payment that may need a refund, use debitWithReceipt(uuid, currency, amount, reference, playerTrade), getReceiptState, and refundReceipt.
Use a unique persistent reference per payment. Retrying the same debit does not charge twice; refunding it restores the original wallet and source labels once. Keep receipts to preserve duplicate protection.
Generic Vault withdrawals do not identify the counterparty or transaction purpose. Existing Vault shops keep ordinary spending behavior. A player shop must explicitly integrate the player-trade API to enforce grant restrictions; a plain Vault deposit refund is treated as earned money. MeowEco cannot automatically enforce these rules across every third-party shop.
Upgrade notes
Back up the database and configuration before upgrading. This release adds grant, source-audit, and payment-receipt tables without rewriting historical wallet balances. Signed-identity grants are disabled by default; source tracking and the transfer policy apply to new qualifying grants.
If you need to relax grant restrictions, change the policy on this version. An older JAR does not maintain source labels or receipts, so transactions made during a downgrade require reconciliation before source restrictions are enabled again.
Compatibility Matrix
| Server | Java | Status |
|---|---|---|
| Paper 26.1.1 | 25 | Compile-tested |
| Paper 26.1.2 | 25 | Compile-tested |
| Paper 26.2 | 25 | Compatibility compile-tested |
| Paper 26.3 | 25 | Primary build target |
| Purpur based on the supported Paper lines | 25 | Expected compatible |
Commands
| Command | Purpose |
|---|---|
/meoweco / /meco / /meow |
Unified command entry |
/money [player] [currency] |
Check balance |
/money exchange <amount> <from> <to> |
Exchange currencies |
/pay <player> <amount> [currency] |
Pay another player |
/baltop [currency] |
Show balance leaderboard |
| `/eco <give | take |
| `/eco <freeze | unfreeze |
/eco setrate <from> <to> <rate> |
Update exchange rate |
Permissions
| Permission | Default | Purpose |
|---|---|---|
meoweco.balance |
true | Check own balance |
meoweco.balance.other |
op | Check another player's balance |
meoweco.pay |
true | Pay players |
meoweco.top |
true | View leaderboard |
meoweco.take |
op | Use /take |
meoweco.reload |
op | Reload config and language files |
meoweco.eco.give |
op | Admin give |
meoweco.eco.take |
op | Admin take |
meoweco.eco.set |
op | Admin set |
meoweco.eco.freeze |
op | Freeze funds |
meoweco.eco.unfreeze |
op | Unfreeze funds |
meoweco.eco.deductfrozen |
op | Deduct frozen funds |
meoweco.debug |
op | Toggle debug mode |
meoweco.admin |
op | Parent admin permission |
Configuration
Primary config: meoweco-paper/src/main/resources/config.yml
Important sections:
storage: choosesqliteormysql.default-currency: currency used by Vault and default command behavior.exchange-rates: enable/disable and define rates.rich-tax: configure per-currency periodic tax rules.currencies: define currency ids, symbols, names, initial balances, and transfer tax.initial-funds: control player transfers of tracked starting funds and the spending order.identity-initial-balance: optionally set signed-identity starting amounts for new wallets.
Release Notes
Latest: 26.11.0 — 中文更新日志 · English release notes.
See CHANGELOG.md for release details. Releases are distributed through Modrinth; GitHub hosts the source code, CI status, and Wiki documentation.
下载 MeowEco Economy
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MeowEco Economy
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MeowEco Economy
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MeowEco Economy
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MeowEco Economy
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MeowEco Economy
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MeowEco Economy
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MeowEco Economy
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MeowEco Economy
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MeowEco Economy
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
MeowEco Economy 26.11.0
发布日期:2026-11-13
这是从 26.10.7 升级的功能版本,新增初始赠额未使用部分的追踪、可选的签名身份赠额、玩家交易扣款以及持久化的退款凭证。它还修复了 26.x 服务端收到 Minecraft 1.21.11 回溯版本的更新提示问题。新增的功能和 API 使得主版本号递增为 26.11.0。
新增
- 初始赠额来源账本: 追踪初始赠额的未使用部分及总余额。余额、来源标签和来源审计提交或回滚时保持一致。
- 可重载的赠额策略:
initial-funds.allow-player-transfer默认为false;spending-order默认为GIFT_FIRST(优先使用赠额),也支持EARNED_FIRST(优先使用赚取的资金)。通过/meco reload应用更改。 - 可选的签名身份赠额: 通过 MeowIdentity 签名会话桥接和 PlaceholderAPI,为新钱包配置离线基础金额和高级总金额的赠额。先支付基础金额,随后在验证的高级会话中补充一次。示例为 100/1000;此集成默认禁用,且其桥接插件不随包分发。
- 玩家交易 API: 提供
getInitialGiftBalance、getTransferableBalance以及原子性的withdrawForPlayerTrade,供需要强制执行可用资金源限制的商店使用。 - 持久化支付凭证: 包含
debitWithReceipt、getReceiptState和refundReceipt。重复引用同一笔扣款不会重复收费;退款将资金退回原钱包一次,并恢复其原始赠额标签。对引用的冲突性重用会导致失败。 - 回归测试覆盖: 延迟的身份解析、一次性补充、消费顺序、转账、兑换、冻结/管理员/导入扣款、审计回滚、重复凭证、独立实例/重启、更新选择以及 Vault 异步清理。
变更
- 追踪新符合资格的配置初始余额及未来高级补充。来源未知的现有余额不会被重新标记或重置。
- 默认情况下,赠额仍可用于普通个人消费,但无法通过
/pay发送。允许的直接转账会将赠额标签传递给接收方;货币兑换按比例保留标签。 - 保守地减少可用于转账的已赚取资金作为冻结资金。普通提款、管理员扣款和迁移扣款遵循消费顺序。
- 通用 Vault 提款保留普通消费行为。Vault 不识别交易对手或支付目的:第三方玩家商店必须显式集成玩家交易 API 以强制执行赠额限制。普通的 Vault 存款退款被视为赚取的资金。
- 根据当前运行的 Minecraft 版本和 Paper 加载器过滤更新请求和响应,选择最高兼容的插件版本,而不是第一个上传的版本。
- 更新了项目介绍、发布摘要和中英文发行说明;JAR 文件现在包含原始的 MIT 许可证。
- 保留了通胀报告、渐进式富裕/转账税、多币种账户、Classic Vault、可选的 VaultUnlocked v2、迁移和 SQL 存储。现有税率不变。
修复
- 修复了 26.x 服务端收到仅适用于 Minecraft 1.21.11 的
26.10.7.1-mc1.21.11构建版本的更新提示的问题。 - 修复了带点的数字版本比较问题,未将
+maowo.2构建元数据或-mc1.21.11目标后缀合并到版本号中。 - 防止在重连、重启和并发实例之间出现重复的身份补充,同时不替换在此期间累积的消费、收益或冻结资金。
- 防止兑换和允许的直转丢弃赠额限制;防止重复退款、冲突引用和来源审计失败导致产生无效余额。
- 当存在可用资金但其赠额来源阻止转账时,添加了
/pay的英文和中文反馈。 - 修复了命令、玩家查询、通知、格式化、迁移和测试中的空值诊断问题;当供应商返回 null 或抛出异常时,一致地完成 Vault 异步 Future 和清理操作。
升级与回滚
- 请先备份数据库和配置文件。需要 Java 25 以及 Paper 26.1 / 26.1.1 / 26.1.2 / 26.2 / 26.3。Purpur 的兼容性遵循相应的 Paper 版本线。
- 新增了独立的赠额表、来源审计表和支付凭证表,无需重写历史钱包余额。现有钱包不会追溯获得资金。待处理的身分赠额保留其原始配置金额。
- 如果禁用身分赠额,货币仍会使用现有的
initial-balance。新符合资格的初始资金将被追踪,并遵循默认的赠额转账限制。 - 若要放宽赠额限制,请在此版本上更改策略。旧版 JAR 不维护标签或凭证;降级期间的交易需要在重新启用限制之前进行对账。不要用旧数据库覆盖后来的玩家交易,也不要删除提供防重复保护的凭证。
验证
- 完整的 Gradle 构建涵盖核心经济系统、SQLite、迁移、Classic Vault、VaultUnlocked v2 和更新检查器的回归测试。
- 针对 Paper 26.1.1、26.1.2 和 26.2 进行兼容性编译;主要构建针对 Paper 26.3。
- Modrinth 上的实时请求针对 26.2 / Paper 进行了过滤,排除了 1.21.11 分支;回归测试套件覆盖了多个支持的 26.x 版本。
- 新的来源账本和凭证行为已在真实的 SQLite 数据库中验证。此版本未对这些新功能添加真实的 MySQL 集成验证;Purpur 未经过单独的运行时测试。
下载
-
编译好的插件 JAR:Modrinth 版本
-
源代码和问题追踪器:GitHub
-
初始赠币来源账本:在总余额之外记录尚未花掉的赠额,来源和来源审计与余额变更在同一事务提交或回滚。
-
赠币转账与消费顺序配置:
initial-funds.allow-player-transfer默认false;spending-order默认GIFT_FIRST,也支持EARNED_FIRST,可通过/meco reload生效。 -
可选签名身份赠额:通过 MeowIdentity 签名会话桥与 PlaceholderAPI,为新钱包设置离线基础额和正版总赠额;先发基础额,确认正版后只补一次差额。示例为 100/1000,默认关闭,相关桥接插件不随 MeowEco 提供。
-
玩家交易 API:
getInitialGiftBalance、getTransferableBalance、withdrawForPlayerTrade,供商店原子检查并扣除可交易来源。 -
持久化支付收据 API:
debitWithReceipt、getReceiptState、refundReceipt;同一引用重试不重复扣款,退款只回原钱包一次并恢复原赠额标签,冲突参数复用引用会失败。 -
回归覆盖:身份延迟与一次性补差、消费顺序、转账、兑换、冻结与管理扣款、导入覆盖、审计失败回滚、收据防重、双实例与重启,以及更新筛选和 Vault 异步异常清理。
Changed / 变更
- 新建且符合配置的初始余额、后续正版补差开始记录来源;旧钱包的未知来源不会猜测回填,不重置玩家已有余额。
- 默认赠币可以自行消费,但不能直接
/pay给其他玩家。允许赠币转账时,收款方继续保留相应赠币标签;货币兑换也按比例保留来源。 - 冻结金额保守地从可转出的赚取余额中扣除;普通扣款、管理扣款和迁移减额遵循消费顺序。
- 普通 Vault 扣款继续按个人消费规则处理。Vault 不包含交易目的或收款方,第三方玩家商店必须明确接入玩家交易 API,才会执行赠币交易限制;普通 Vault 入账退款视为赚取余额。
- 更新检查同时按实际 Minecraft 版本和 Paper 加载器筛选,并从兼容版本中选择最高插件版本,不再直接取最新上传记录。
- 同步更新项目介绍、发布页面说明、中英文更新日志,并在 JAR 中保留 MIT 许可证。
- 原有通胀报告、阶梯富人税与转账税、多货币、Classic Vault、VaultUnlocked v2、迁移和 SQL 存储功能继续保留;本次不调整既有税率。
Fixed / 修复
- 修复 26.x 服务端被提示更新到仅支持 Minecraft 1.21.11 的
26.10.7.1-mc1.21.11。 - 修复点分版本号的数字比较;
+maowo.2等构建信息及-mc1.21.11目标后缀不会再拼入版本数字。 - 防止重连、重启或多实例并发重复补发身份赠额,避免用设定总余额的方式覆盖期间消费、收入或冻结资金。
- 防止通过兑换或允许的直接转账丢失赠币来源,以及重复退款、引用冲突或审计失败造成余额异常。
/pay因赠币不可转出而失败时,提供中英文原因提示。- 修复命令注册、玩家查询、更新通知、格式化、迁移和测试中的空值诊断,并完善 Vault 异步任务返回 null 或抛异常时的 future 完成与操作清理。
升级与回退
- 升级前备份数据库与配置。支持 Paper 26.1 / 26.1.1 / 26.1.2 / 26.2 / 26.3,要求 Java 25;Purpur 按对应 Paper 版本兼容。
- 新增独立赠额、来源审计及支付收据表,原账户和历史余额不批量重写;旧钱包不追溯补币。待确认赠额沿用创建时金额,调价只影响以后新建钱包。
- 不启用身份赠额时,仍使用货币原有
initial-balance;新发放且符合配置的初始金额会记录来源,并适用默认赠币转账限制。 - 如需放开赠币转账,可在当前版本修改配置。旧版 JAR 不维护来源标签与支付收据;降级期间发生交易后,重新启用来源限制前需要核对账本。不要用旧数据库覆盖升级后的玩家交易,也不要清理仍用于防重的收据。
验证
- 完整 Gradle build:核心经济、SQLite、迁移、Classic Vault、VaultUnlocked v2 及更新检查回归。
- Paper 26.1.1、26.1.2、26.2 兼容编译,主构建使用 Paper 26.3。
- 实际 Modrinth 查询确认按 26.2 / Paper 筛选会排除 1.21.11 分支;多条 26.x 版本的筛选由回归覆盖。
- 本次新来源账本与收据功能经过 SQLite 实库验证,未新增实际 MySQL 集成验收;Purpur 未单独实服验证。
下载
- 插件 JAR:Modrinth 版本页
- 源代码与问题反馈:GitHub
MeowEco Economy 26.10.7.1-mc1.21.11
此 LTS(长期支持)兼容版本将当前 MeowEco 交易账本、审计命令和政策分析功能引入 Paper 1.21.11,同时保持现代主线分支的 Java 25 基础环境不变。
新增
- 为 Paper 1.21.11 添加了
/meco audit交易历史记录及导出支持。 - 为 Paper 1.21.11 添加了
/meco policy report供应量和集中度分析。 - 包含了来自 MeowEco 26.10.7 的共享 MySQL 多实例一致性修复。
更改
- 目标 API 为 Paper API 1.21.11 和 Java 21。
- 使用
api-version: 1.21.11,以便服务器验证预期的兼容性基线。 - 作为独立的 LTS 制品发布,而现代主线分支仍基于 Paper 26.x 和 Java 25。
- 仅在 Paper 1.21.11 Modrinth 发布频道内检查更新。
修复
- 将仅适用于 Java 25 的未命名资源变量替换为兼容 Java 21 的代码,且未改变审计行为。
验证
- 使用 Java 21 字节码针对 Paper API 1.21.11 编译了完整的插件。
- 通过了核心经济、SQLite、迁移、Classic Vault 以及 VaultUnlocked v2 回归测试套件。
- 在真实的 Paper 1.21.11 服务器上验证了打包后的插件 JAR 文件。
兼容性
- Paper 1.21.11
- Java 21
- Classic Vault 继续受支持。
- VaultUnlocked v2 继续作为可选集成提供。
维护策略
- 该分支接收关键错误、安全、数据库正确性及兼容性修复。
- 仅限 Paper 26.x 的新功能保留在现代主分支上,除非明确选择进行反向移植。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
ExyliaPlugins 的库。
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
一个在游戏内运行的 Minecraft 地图编辑器! 支持选区、蓝图、复制粘贴、笔刷和脚本。 可在创造模式中使用,也可在生存模式中临时使用。
插件
创建用户友好的菜单以前往不同的世界
插件
专为 Velocity 打造的自制聊天插件,功能丰富——支持跨服群组/全局/私聊消息,并集成 LibertyBans 的禁言功能。
插件
一个高度兼容、功能完善且稳定的 TPA 模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧