MeowEco Economy

插件

· 作者 Meowmiao

Paper 26.1-26.3 经济系统,支持通胀报告、累进税制、追踪起始资金、安全交易退款、多货币 Vault 支持以及 SQLite/MySQL 存储。

0 本站下载 0 关注 更新于 4 天前

最新 26.11.0 · 26.3 · Paper / Purpur

一键开服(送7天)

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:

⬇️ 下载 MeowEco(Modrinth)

主要功能

  • 🎁 追踪初始资金:在总余额旁维护独立的剩余赠予账本;允许个人消费,但控制直接的玩家间转账。
  • 🛒 交易与退款 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 文档。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源