MyEconomy

插件

· 作者 Dominos111G

MyEconomy 为你的服务器提供开箱即用的完整经济系统——包括钱包、银行账户、实体纸币、被动收入、PvP 金钱盗窃以及完整的 Vault 集成。

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

最新 1.0.0 · 1.21.5 · Paper / Purpur

一键开服(送7天)

注意: 此描述由 AI 生成,欢迎提出您的建议!

? MyEconomy

专为 Paper Minecraft 1.20.x–1.21.x 服务器打造的丰富功能经济插件

MyEconomy 为您的服务器开箱即用地提供了一套完整的经济系统——包括钱包、银行账户、实体钞票、被动收入、PvP 金钱盗窃以及完整的 Vault 集成。所有功能均可切换,所有消息均可自定义,其他插件也能无缝接入。

✨ 主要特性

? 核心经济

  • 钱包余额,支持配置初始金额和货币单位
  • 可选的负余额支持
  • SQLite 数据库 —— 无需外部设置
  • 完整的 Vault 提供商 —— 其他插件通过标准 API 读取和写入余额

? 银行系统

  • 每位玩家独立的储蓄账户(/bank)
  • 从钱包存入、取回钱包、转账至其他玩家的银行账户
  • 可配置的最大余额和转账税率
  • 可在配置文件中完全禁用

? 实体钞票(提现)

  • /withdraw 创建实物道具 —— 右键点击即可存回
  • 整叠钞票?右键点击一次性存入整叠
  • 可配置的道具材质 —— 原版(PAPER, GOLD_INGOT)或自定义插件:
    • Oraxen → oraxen:banknote
    • ItemsAdder → itemsadder:custom_paper
    • Nexo → nexo:money_note
  • 支持资源包自定义模型数据
  • 名称和描述完全可自定义,支持 {amount}, {player}, {date} 占位符
  • 可在配置文件中完全禁用

? 被动收入(3 种系统)

  • 利息 —— 按可配置的时间间隔赚取钱包余额的一定百分比(仅限在线时)
  • 游戏时长奖励 —— 多层级系统,基于权限分配不同费率(VIP+, VIP, 默认,或您定义的任何自定义层级)
  • 离线增长 —— 根据离开时间计算复利(在登录时结算),支持可配置的时间间隔、最大小时数和增长上限

⚔️ PvP 金钱

  • 击杀者随机抽取受害者余额的一定百分比作为战利品
  • 每次击杀有最小/最大抽取限制
  • 可选择让受害者不损失金钱(击杀者从虚空中获取)
  • 双方玩家立即在行动栏看到反馈

? 智能通知

  • 行动栏弹窗 —— 每笔收益/损失都会在行动栏显示 +$1.23 或 -$20.00
  • 离线队列 —— 离线期间的转账、银行存款和事件会存储在数据库中,并在登录时展示
  • 可配置持续时间、格式和最大排队消息数

? 带税额的支付

  • /pay 支持可选的税额百分比
  • 可配置的最小/最大支付金额
  • 防止自我支付(可切换)

? 排行榜

  • /balancetop 显示最富有的玩家列表,格式美观
  • 高亮显示你自己的条目
  • 底部显示你的个人排名
  • 可配置条目数量和缓存间隔

? 集成

  • Vault —— 完整经济提供商,支持 deposit/withdraw/getBalance/has/createAccount
  • PlaceholderAPI —— 12+ 个占位符,包括排行榜位置
  • 交易日志记录 —— 所有操作均带时间戳记录到文件

♻️ 热重载与翻译

  • /myeconomy reload 无需重启即可应用更改
  • 每条消息都位于 lang.yml 中 —— 完全可翻译
  • 支持颜色代码和十六进制颜色

? 安装

  1. 从 Releases 下载最新的 .jar 文件
  2. 将其放入服务器的 plugins/ 文件夹
  3. 重启服务器
  4. 编辑 plugins/MyEconomy/config.yml 和 plugins/MyEconomy/lang.yml
  5. 运行 /myeconomy reload

要求: Paper(或其分支)1.20.x–1.21.x,Java 21。

可选依赖:

  • Vault —— 允许其他插件与 MyEconomy 交互
  • PlaceholderAPI —— 为记分板、全息图、标签页等添加占位符

? 玩家指令

指令 描述 权限
/balance [player] 查看钱包余额 myeconomy.balance / .others
/balancetop 查看最富有玩家 myeconomy.balancetop
/pay <player> <amount> 向玩家发送金钱 myeconomy.pay
/withdraw <amount> 创建实体钞票 myeconomy.withdraw
/bank 查看银行账户余额 myeconomy.bank
/bank deposit <amount> 钱包 → 银行 myeconomy.bank
/bank withdraw <amount> 银行 → 钱包 myeconomy.bank
/bank transfer <player> <amount> 你的银行 → 玩家银行 myeconomy.bank.transfer

别名: /bal 对应 /balance,/baltop 对应 /balancetop

? 管理员指令

指令 描述 权限
/myeconomy set <player> <amount> 设置玩家钱包余额 myeconomy.admin
/myeconomy change <player> <value> 增加或减少余额 myeconomy.admin
/myeconomy reload 重新加载配置和语言文件 myeconomy.admin

change 指令接受正值和负值(例如 /myeconomy change Steve -500)。

? 权限

权限 默认值 描述
myeconomy.balance true 查看自己的余额
myeconomy.balance.others true 查看其他玩家的余额
myeconomy.balancetop true 查看排行榜
myeconomy.pay true 向其他玩家付款
myeconomy.withdraw true 创建钞票
myeconomy.bank true 使用银行系统
myeconomy.bank.transfer true 在银行账户间转账
myeconomy.playtime.vip — VIP 游戏时长奖励层级
myeconomy.playtime.vipplus — VIP+ 游戏时长奖励层级
myeconomy.admin op 管理指令(set, change, reload)

示例:LuckPerms

/lp group vip permission set myeconomy.playtime.vip true
/lp group vip-plus permission set myeconomy.playtime.vipplus true
/lp group admin permission set myeconomy.admin true

? PlaceholderAPI

需要 PlaceholderAPI。

玩家占位符

占位符 描述
%myeconomy_balance% 格式化后的钱包余额(例如:$1,234.56)
%myeconomy_balance_raw% 原始钱包余额数值(例如:1234.56)
%myeconomy_balance_formatted% 不带货币符号的余额(例如:1,234.56)
%myeconomy_bank_balance% 格式化后的银行余额
%myeconomy_bank_balance_raw% 原始银行余额数值
%myeconomy_total_balance% 钱包 + 银行合计
%myeconomy_rank% 玩家的财富排名
%myeconomy_currency% 货币名称(单数/复数)
%myeconomy_currency_symbol% 货币符号(例如:$)

排行榜占位符

占位符 描述
%myeconomy_top_name_<N>% 排名第 N 的玩家名称
%myeconomy_top_balance_<N>% 排名第 N 的格式化余额
%myeconomy_top_balance_raw_<N>% 排名第 N 的原始余额

将 <N> 替换为任意数字(例如 %myeconomy_top_name_1% 表示最富有的玩家)。缓存有效期为 30 秒。

⚙️ 配置

MyEconomy 使用精简的配置文件:

文件 用途
config.yml 所有插件设置(经济、银行、利息、PvP 等)
lang.yml 所有面向玩家的消息(可翻译)
economy.db SQLite 数据库(自动生成)
transactions.log 交易历史记录(自动生成)

? 货币设置

starting-balance: 100.0
allow-negative-balance: false

currency:
  name-singular: "Dollar"
  name-plural: "Dollars"
  symbol: "$"
  format: "#,##0.00"

? 银行系统

bank:
  enabled: true
  starting-balance: 0.0
  minimum: 1.0
  max-balance: 0.0             # 0 = 无上限
  transfer-tax-percent: 0.0    # 银行间转账的税率

? 在线利息

interest:
  enabled: true
  rate-percent: 0.5
  interval-minutes: 60
  max-balance-for-interest: 100000.0
  min-balance-for-interest: 100.0

? 离线增长

当玩家登录时,根据其离线时长计算复利。

offline-growth:
  enabled: true
  interval-minutes: 60      # 每个间隔应用一次增长
  rate-percent: 0.3          # 每个间隔的百分比
  max-hours: 12              # 计算的最大离线时间
  max-growth: 5000.0         # 每次会话的上限(0 = 无上限)
  min-balance: 50.0          # 符合条件的最低余额

一名离线 6 小时、拥有 $10,000 且每小时增长率为 0.3% 的玩家,将在 6 个间隔内获得复利增长。

? 在线时长奖励层级

层级从上到下检查。每位玩家仅获得一个奖励——即其拥有权限的最高层级。

playtime-rewards:
  enabled: true
  interval-minutes: 15
  tiers:
    vip-plus:
      permission: "myeconomy.playtime.vipplus"
      type: "percent"        # "percent" 或 "flat"
      amount: 2.0
      min-balance: 0.0
      max-reward: 2000.0
    vip:
      permission: "myeconomy.playtime.vip"
      type: "percent"
      amount: 1.0
      min-balance: 0.0
      max-reward: 1000.0
    default:
      permission: "default"  # 适用于所有人
      type: "percent"
      amount: 0.5
      min-balance: 0.0
      max-reward: 500.0

根据需要添加尽可能多的层级——只需为每个层级提供唯一的键和权限节点即可。

⚔️ PvP 金钱

pvp-money:
  enabled: true
  steal-percent: 5.0
  minimum: 1.0          # 受害者必须至少拥有此金额
  maximum: 1000.0       # 每次击杀最多掠夺的金额(0 = 无上限)
  victim-loses: true     # false = 攻击者凭空获得金钱

? 纸币物品

支持原版材质和其他插件的自定义物品:

withdraw:
  enabled: true
  minimum: 1.0
  maximum: 1000000.0
  item-material: "PAPER"                    # 原版材质
  # item-material: "oraxen:banknote"        # Oraxen
  # item-material: "itemsadder:custom_paper" # ItemsAdder
  # item-material: "nexo:money_note"        # Nexo
  custom-model-data: 0                      # 用于资源包
  item-name: "&a&lBanknote &7- &f{amount}"
  item-lore:
    - ""
    - "&7Value: &a{amount} {currency}"
    - "&7Created by: &f{player}"
    - "&7Date: &f{date}"
    - ""
    - "&e&lRight-click &7to deposit"

? 通知

notifications:
  actionbar:
    enabled: true
    duration-ticks: 60                # 60 ticks = 3 秒
    gain-format: "&a+{amount}"
    loss-format: "&c-{amount}"
  offline-queue:
    enabled: true
    max-messages: 20

? 支付设置

pay:
  minimum: 1.0
  maximum: 1000000.0
  tax-percent: 0.0       # /pay 转账的税率
  allow-self-pay: false

? 交易记录

logging:
  enabled: true
  file: "transactions.log"
  log-pay: true
  log-withdraw: true
  log-deposit: true
  log-admin-changes: true
  log-interest: false
  log-playtime-rewards: false
  log-bank: true
  log-pvp: true
  log-offline-growth: true

日志格式:[2026-07-07 15:30:45] [PAY] Steve -> Alex | Amount: 500.00

? 用例

基础服务器经济

# config.yml — 仅启用钱包 + 支付,其他全部关闭
starting-balance: 500.0
bank:
  enabled: false
withdraw:
  enabled: false
interest:
  enabled: false
offline-growth:
  enabled: false
playtime-rewards:
  enabled: false
pvp-money:
  enabled: false

生存模式带 PvP 风险

pvp-money:
  enabled: true
  steal-percent: 10.0
  maximum: 5000.0
  victim-loses: true

bank:
  enabled: true          # 玩家可以将资金存入银行以保护资产

玩家将资金安全地存放在银行中——在 PvP 中只有钱包余额面临风险。

VIP 奖励服务器

playtime-rewards:
  enabled: true
  interval-minutes: 10
  tiers:
    mvp:
      permission: "myeconomy.playtime.mvp"
      type: "flat"
      amount: 50.0
      max-reward: 0.0
    vip:
      permission: "myeconomy.playtime.vip"
      type: "flat"
      amount: 25.0
      max-reward: 0.0
    default:
      permission: "default"
      type: "flat"
      amount: 10.0
      max-reward: 0.0

offline-growth: enabled: true rate-percent: 0.5 max-hours: 8


MVPs 每 10 分钟获得 $50,VIPs 获得 $25,其他玩家获得 $10。所有玩家均可享受最长 8 小时的离线成长收益。

## ? Vault 集成

MyEconomy 注册为一个完整的 Vault 经济提供商。其他插件可以:

```java
// 通过 Vault 获取 MyEconomy —— 标准 API
Economy economy = getServer().getServicesManager().getRegistration(Economy.class).getProvider();

economy.getBalance(player);              // 读取余额
economy.depositPlayer(player, 100.0);    // 存入资金
economy.withdrawPlayer(player, 50.0);    // 扣除资金
economy.has(player, 200.0);              // 检查玩家是否负担得起
economy.format(1234.56);                 // "$1,234.56"

在配置文件中设置 vault-integration: false 可禁用此功能 —— MyEconomy 仍可在其 SQLite 数据库支持下独立运行。

? 故障排除

插件无法加载

检查:

  1. 您是否使用的是 Paper 1.20.x–1.21.x?(执行 /version)
  2. JAR 文件是否在 plugins/ 文件夹中?
  3. 您是否安装了 Java 21?(执行 java -version)

Vault 提示未找到经济系统

检查:

  1. 是否已安装并加载了 Vault?(查看控制台是否有 [Vault] 日志)
  2. 配置文件中 vault-integration 是否为 true?
  3. MyEconomy 必须在 Vault 之后加载 —— 这已通过 softdepend 自动处理

余额未保存

检查:

  1. plugins/MyEconomy/ 目录下是否存在 economy.db 文件
  2. 服务器是否对该文件夹拥有写入权限
  3. 检查控制台中是否有 SQLite 错误日志

在线时长奖励不生效

检查:

  1. playtime-rewards.enabled: true
  2. 层级定义位于 playtime-rewards.tiers 下
  3. 玩家是否拥有对应层级的正确权限(或该层级使用了 permission: "default")
  4. 自服务器启动以来是否已过去 interval-minutes 设定的时间

右键纸币无反应

检查:

  1. 物品是否包含 MyEconomy NBT 标签 —— 只有由 /withdraw 命令创建的纸币才有效
  2. 在铁砧中重命名或修改物品不会移除该标签
  3. 自定义物品材质是否有效,且相关插件(Oraxen/ItemsAdder)是否已加载

离线成长未应用

检查:

  1. offline-growth.enabled: true
  2. 玩家余额是否高于 min-balance
  3. 玩家离线时间是否至少经过一个完整的 interval-minutes 周期
  4. 成长值是在登录时计算的,而非周期性后台计算

? 性能

MyEconomy 轻量高效,专为卓越性能而设计:

  • ✅ SQLite 数据库 —— 无需外部服务器
  • ✅ 离线成长在登录时计算,不使用后台任务
  • ✅ PlaceholderAPI 排行榜缓存支持可配置的 TTL
  • ✅ 异步安全的通知队列
  • ✅ 无外部依赖(Vault 和 PlaceholderAPI 为可选软依赖)
  • ✅ 单个 JAR 文件,零配置即可启动

? 版本历史

未来路线图

  • MySQL / MariaDB 支持
  • 游戏内 GUI 用于银行账户管理
  • 商店系统集成
  • 经济统计与图表
  • 按世界隔离的经济系统

1.0.0

  • 初始发布:钱包、银行账户、纸币(支持 Oraxen/ItemsAdder/Nexo)、利息、离线成长、多层级在线时长奖励、PvP 金钱窃取、ActionBar 通知、离线通知队列、Vault 提供商、PlaceholderAPI(12+ 个占位符含排行榜)、交易日志、管理员命令、Tab 补全、完整 lang.yml 翻译支持。

? 链接

  • GitHub:
  • Modrinth:
  • 问题反馈:

? 许可证

MIT License —— 允许自由修改和分发

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源