注意: 此描述由 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 中 —— 完全可翻译
- 支持颜色代码和十六进制颜色
? 安装
- 从 Releases 下载最新的
.jar 文件
- 将其放入服务器的
plugins/ 文件夹
- 重启服务器
- 编辑
plugins/MyEconomy/config.yml 和 plugins/MyEconomy/lang.yml
- 运行
/myeconomy reload
要求: Paper(或其分支)1.20.x–1.21.x,Java 21。
可选依赖:
? 玩家指令
| 指令 |
描述 |
权限 |
/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 数据库支持下独立运行。
? 故障排除
插件无法加载
检查:
- 您是否使用的是 Paper 1.20.x–1.21.x?(执行
/version)
- JAR 文件是否在
plugins/ 文件夹中?
- 您是否安装了 Java 21?(执行
java -version)
Vault 提示未找到经济系统
检查:
- 是否已安装并加载了 Vault?(查看控制台是否有
[Vault] 日志)
- 配置文件中
vault-integration 是否为 true?
- MyEconomy 必须在 Vault 之后加载 —— 这已通过
softdepend 自动处理
余额未保存
检查:
plugins/MyEconomy/ 目录下是否存在 economy.db 文件
- 服务器是否对该文件夹拥有写入权限
- 检查控制台中是否有 SQLite 错误日志
在线时长奖励不生效
检查:
playtime-rewards.enabled: true
- 层级定义位于
playtime-rewards.tiers 下
- 玩家是否拥有对应层级的正确权限(或该层级使用了
permission: "default")
- 自服务器启动以来是否已过去
interval-minutes 设定的时间
右键纸币无反应
检查:
- 物品是否包含 MyEconomy NBT 标签 —— 只有由
/withdraw 命令创建的纸币才有效
- 在铁砧中重命名或修改物品不会移除该标签
- 自定义物品材质是否有效,且相关插件(Oraxen/ItemsAdder)是否已加载
离线成长未应用
检查:
offline-growth.enabled: true
- 玩家余额是否高于
min-balance
- 玩家离线时间是否至少经过一个完整的
interval-minutes 周期
- 成长值是在登录时计算的,而非周期性后台计算
? 性能
MyEconomy 轻量高效,专为卓越性能而设计:
- ✅ SQLite 数据库 —— 无需外部服务器
- ✅ 离线成长在登录时计算,不使用后台任务
- ✅ PlaceholderAPI 排行榜缓存支持可配置的 TTL
- ✅ 异步安全的通知队列
- ✅ 无外部依赖(Vault 和 PlaceholderAPI 为可选软依赖)
- ✅ 单个 JAR 文件,零配置即可启动
? 版本历史
未来路线图
- MySQL / MariaDB 支持
- 游戏内 GUI 用于银行账户管理
- 商店系统集成
- 经济统计与图表
- 按世界隔离的经济系统
1.0.0
- 初始发布:钱包、银行账户、纸币(支持 Oraxen/ItemsAdder/Nexo)、利息、离线成长、多层级在线时长奖励、PvP 金钱窃取、ActionBar 通知、离线通知队列、Vault 提供商、PlaceholderAPI(12+ 个占位符含排行榜)、交易日志、管理员命令、Tab 补全、完整
lang.yml 翻译支持。
? 链接
? 许可证
MIT License —— 允许自由修改和分发
NOTE: I generated ONLY this description with AI and I'm open for your ideas!
? MyEconomy
A feature-rich economy plugin for Paper Minecraft 1.20.x–1.21.x servers
MyEconomy gives your server a complete economy system out of the box — wallet, bank accounts, physical banknotes, passive income, PvP money stealing, and full Vault integration. Every feature is toggleable, every message is customizable, and other plugins can hook into it seamlessly.
✨ Key Features
? Core Economy
- Wallet balance with configurable starting amount and currency
- Optional negative balance support
- SQLite database — no external setup required
- Full Vault provider — other plugins read and write balances through the standard API
? Bank System
- Separate savings account per player (
/bank)
- Deposit from wallet, withdraw to wallet, transfer to other players' banks
- Configurable max balance and transfer tax
- Can be disabled entirely in config
? Physical Banknotes (Withdraw)
/withdraw creates a real item — right-click to deposit back
- Stack of banknotes? Right-click deposits the entire stack at once
- Configurable item material — vanilla (
PAPER, GOLD_INGOT) or custom plugins:
- Oraxen →
oraxen:banknote
- ItemsAdder →
itemsadder:custom_paper
- Nexo →
nexo:money_note
- Custom model data support for resource packs
- Fully customizable name and lore with
{amount}, {player}, {date} placeholders
- Can be disabled entirely in config
? Passive Income (3 Systems)
- Interest — percentage of wallet balance earned at configurable intervals (online only)
- Playtime Rewards — multi-tier system with per-permission rates (VIP+, VIP, default, or any custom tiers you define)
- Offline Growth — compound interest calculated on login based on time away (configurable interval, max hours, growth cap)
⚔️ PvP Money
- Killer steals a configurable percentage of victim's balance on kill
- Min/max steal limits per kill
- Option for victim to not lose money (killer gets it from thin air)
- Both players see ActionBar feedback instantly
? Smart Notifications
- ActionBar popups — every gain/loss shows
+$1.23 or -$20.00 on the action bar
- Offline queue — transfers, bank deposits, and events while offline are stored in the database and shown on login
- Configurable duration, formats, and max queued messages
? Payments with Tax
/pay supports optional tax percentage
- Configurable min/max payment amounts
- Self-pay prevention (toggleable)
? Leaderboard
/balancetop shows top richest players with formatted display
- Your own entry is highlighted
- Your personal rank shown at the bottom
- Configurable entry count and cache interval
? Integrations
- Vault — full economy provider with deposit/withdraw/getBalance/has/createAccount
- PlaceholderAPI — 12+ placeholders including leaderboard positions
- Transaction logging — every action logged to file with timestamps
♻️ Live Reload & Translations
/myeconomy reload applies changes without a restart
- Every message lives in
lang.yml — fully translatable
- Color codes and hex colors supported
? Installation
- Download the latest
.jar from Releases
- Place it in your server's
plugins/ folder
- Restart the server
- Edit
plugins/MyEconomy/config.yml and plugins/MyEconomy/lang.yml
- Run
/myeconomy reload
Requirements: Paper (or fork) 1.20.x–1.21.x, Java 21.
Optional dependencies:
- Vault — allows other plugins to interact with MyEconomy
- PlaceholderAPI — adds placeholders for scoreboards, holograms, tab, etc.
? Player Commands
| Command |
Description |
Permission |
/balance [player] |
Check wallet balance |
myeconomy.balance / .others |
/balancetop |
Top richest players |
myeconomy.balancetop |
/pay <player> <amount> |
Send money to a player |
myeconomy.pay |
/withdraw <amount> |
Create a physical banknote |
myeconomy.withdraw |
/bank |
View bank balance |
myeconomy.bank |
/bank deposit <amount> |
Wallet → Bank |
myeconomy.bank |
/bank withdraw <amount> |
Bank → Wallet |
myeconomy.bank |
/bank transfer <player> <amount> |
Your bank → Player's bank |
myeconomy.bank.transfer |
Aliases: /bal for /balance, /baltop for /balancetop
? Admin Commands
| Command |
Description |
Permission |
/myeconomy set <player> <amount> |
Set player's wallet balance |
myeconomy.admin |
/myeconomy change <player> <value> |
Add or remove from balance |
myeconomy.admin |
/myeconomy reload |
Reload config and lang files |
myeconomy.admin |
The change command accepts positive and negative values (e.g. /myeconomy change Steve -500).
? Permissions
| Permission |
Default |
Description |
myeconomy.balance |
true |
Check own balance |
myeconomy.balance.others |
true |
Check other players' balance |
myeconomy.balancetop |
true |
View leaderboard |
myeconomy.pay |
true |
Pay other players |
myeconomy.withdraw |
true |
Create banknotes |
myeconomy.bank |
true |
Use bank system |
myeconomy.bank.transfer |
true |
Transfer between bank accounts |
myeconomy.playtime.vip |
— |
VIP playtime reward tier |
myeconomy.playtime.vipplus |
— |
VIP+ playtime reward tier |
myeconomy.admin |
op |
Admin commands (set, change, reload) |
Example: 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
Requires PlaceholderAPI.
Player Placeholders
| Placeholder |
Description |
%myeconomy_balance% |
Formatted wallet balance (e.g. $1,234.56) |
%myeconomy_balance_raw% |
Raw wallet balance number (e.g. 1234.56) |
%myeconomy_balance_formatted% |
Balance without currency symbol (e.g. 1,234.56) |
%myeconomy_bank_balance% |
Formatted bank balance |
%myeconomy_bank_balance_raw% |
Raw bank balance number |
%myeconomy_total_balance% |
Wallet + Bank combined |
%myeconomy_rank% |
Player's wealth rank |
%myeconomy_currency% |
Currency name (singular/plural) |
%myeconomy_currency_symbol% |
Currency symbol (e.g. $) |
Leaderboard Placeholders
| Placeholder |
Description |
%myeconomy_top_name_<N>% |
Name of player at rank N |
%myeconomy_top_balance_<N>% |
Formatted balance at rank N |
%myeconomy_top_balance_raw_<N>% |
Raw balance at rank N |
Replace <N> with any number (e.g. %myeconomy_top_name_1% for the richest player). Cached with 30-second TTL.
⚙️ Configuration
MyEconomy uses focused config files:
| File |
Purpose |
config.yml |
All plugin settings (economy, bank, interest, PvP, etc.) |
lang.yml |
Every player-facing message (translatable) |
economy.db |
SQLite database (auto-generated) |
transactions.log |
Transaction history (auto-generated) |
? Currency Settings
starting-balance: 100.0
allow-negative-balance: false
currency:
name-singular: "Dollar"
name-plural: "Dollars"
symbol: "$"
format: "#,##0.00"
? Bank System
bank:
enabled: true
starting-balance: 0.0
minimum: 1.0
max-balance: 0.0 # 0 = unlimited
transfer-tax-percent: 0.0 # tax on bank-to-bank transfers
? Interest (Online)
interest:
enabled: true
rate-percent: 0.5
interval-minutes: 60
max-balance-for-interest: 100000.0
min-balance-for-interest: 100.0
? Offline Growth
Compound interest calculated when a player logs in, based on how long they were offline.
offline-growth:
enabled: true
interval-minutes: 60 # growth applied per this interval
rate-percent: 0.3 # percent per interval
max-hours: 12 # max offline time counted
max-growth: 5000.0 # cap per session (0 = no cap)
min-balance: 50.0 # minimum balance to qualify
A player offline for 6 hours with $10,000 and 0.3% per hour earns compound growth over 6 intervals.
? Playtime Reward Tiers
Tiers are checked top-to-bottom. Each player receives one reward — the best tier they have permission for.
playtime-rewards:
enabled: true
interval-minutes: 15
tiers:
vip-plus:
permission: "myeconomy.playtime.vipplus"
type: "percent" # "percent" or "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" # applies to everyone
type: "percent"
amount: 0.5
min-balance: 0.0
max-reward: 500.0
Add as many tiers as you need — just give each a unique key and permission node.
⚔️ PvP Money
pvp-money:
enabled: true
steal-percent: 5.0
minimum: 1.0 # victim must have at least this much
maximum: 1000.0 # max stolen per kill (0 = no cap)
victim-loses: true # false = killer gets money from thin air
? Banknote Item
Supports vanilla materials and custom items from other plugins:
withdraw:
enabled: true
minimum: 1.0
maximum: 1000000.0
item-material: "PAPER" # vanilla material
# item-material: "oraxen:banknote" # Oraxen
# item-material: "itemsadder:custom_paper" # ItemsAdder
# item-material: "nexo:money_note" # Nexo
custom-model-data: 0 # for resource packs
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
notifications:
actionbar:
enabled: true
duration-ticks: 60 # 60 ticks = 3 seconds
gain-format: "&a+{amount}"
loss-format: "&c-{amount}"
offline-queue:
enabled: true
max-messages: 20
? Pay Settings
pay:
minimum: 1.0
maximum: 1000000.0
tax-percent: 0.0 # tax on /pay transfers
allow-self-pay: false
? Transaction Logging
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
Log format: [2026-07-07 15:30:45] [PAY] Steve -> Alex | Amount: 500.00
? Use Cases
Basic Server Economy
# config.yml — just wallet + pay, everything else off
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
Survival with PvP Risk
pvp-money:
enabled: true
steal-percent: 10.0
maximum: 5000.0
victim-loses: true
bank:
enabled: true # players can protect money in the bank
Players keep money safe in the bank — only wallet balance is at risk in PvP.
VIP Rewards Server
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 earn $50 every 10 minutes, VIPs earn $25, everyone else $10. All players earn offline growth up to 8 hours.
? Vault Integration
MyEconomy registers as a full Vault economy provider. Other plugins can:
// Get MyEconomy through Vault — standard API
Economy economy = getServer().getServicesManager().getRegistration(Economy.class).getProvider();
economy.getBalance(player); // read balance
economy.depositPlayer(player, 100.0); // add money
economy.withdrawPlayer(player, 50.0); // remove money
economy.has(player, 200.0); // check if player can afford
economy.format(1234.56); // "$1,234.56"
Set vault-integration: false in config to disable — MyEconomy will still work standalone with its SQLite database.
? Troubleshooting
Plugin won't load
Check:
- Are you using Paper 1.20.x–1.21.x? (
/version)
- Is the JAR in the
plugins/ folder?
- Do you have Java 21? (
java -version)
Vault says no economy found
Check:
- Is Vault installed and loaded? (Check console for
[Vault])
- Is
vault-integration: true in config?
- MyEconomy must load after Vault — it's handled automatically via
softdepend
Balance not saving
Check:
- The
economy.db file exists in plugins/MyEconomy/
- The server has write permissions to that folder
- Check console for SQLite errors
Playtime rewards not working
Check:
playtime-rewards.enabled: true
- Tiers are defined under
playtime-rewards.tiers
- Player has the correct permission for their tier (or tier uses
permission: "default")
interval-minutes has passed since server start
Banknote right-click does nothing
Check:
- The item has the MyEconomy NBT tag — only banknotes created by
/withdraw work
- Renaming or modifying the item in an anvil doesn't remove the tag
- Custom item material is valid and the plugin (Oraxen/ItemsAdder) is loaded
Offline growth not applying
Check:
offline-growth.enabled: true
- Player's balance is above
min-balance
- Player was offline for at least one full
interval-minutes period
- Growth is calculated on login, not periodically
? Performance
MyEconomy is lightweight and built for clean performance:
- ✅ SQLite database — no external server required
- ✅ Offline growth calculated on login, not with background tasks
- ✅ PlaceholderAPI leaderboard cached with configurable TTL
- ✅ Async-safe notification queue
- ✅ No external dependencies (Vault and PlaceholderAPI are optional soft-depends)
- ✅ Single JAR, zero configuration required to start
? Version History
Future Roadmap
- MySQL / MariaDB support
- In-game GUI for bank management
- Shop system integration
- Economy statistics and graphs
- Per-world economy separation
1.0.0
- Initial release: wallet, bank accounts, banknotes (with Oraxen/ItemsAdder/Nexo support), interest, offline growth, multi-tier playtime rewards, PvP money stealing, ActionBar notifications, offline notification queue, Vault provider, PlaceholderAPI (12+ placeholders with leaderboard), transaction logging, admin commands, tab completion, full
lang.yml translation support.
? Links
- GitHub:
- Modrinth:
- Issues:
? License
MIT License - Free to modify and distribute
评论 0
登录后参与评分
还没有评论,来抢沙发吧