docs - MyDevelopement

安装与入门

要求

Paper 服务器 1.21+（或衍生版）。推荐 Vault 以与其他插件（商店、职业等）集成。可选：PlaceholderAPI、DecentHolograms、MyCore。

分步安装

从下载页下载 MyEconomy.jar。
将文件放入服务器的 plugins/ 文件夹。
重启服务器（或执行 /reload，若主机允许）。
首次运行时会自动创建 plugins/MyEconomy/config.yml。

验证

游戏中输入 /balance（或 /bal）。若插件已加载会显示余额。新玩家获得配置中定义的起始余额。

第一步

基本命令：/balance 或 /bal 查看余额，/pay <玩家> <金额> 转账，/ecomenu 打开菜单。在 config.yml 中自定义货币与排行榜。

配置示例

config.yml 中货币与起始余额片段：

currency:
  name: "coins"
  symbol: ""
  decimals: 2
starting-balance:
  amount: 100.0
  welcome-message: "&aYou received &e{amount} {currency} &a!"

命令

玩家命令

命令	说明	别名
`/balance [玩家]`	显示余额	bal, money
`/pay <玩家> <金额>`	转账	send
`/baltop [weekly\|monthly]`	富豪榜	topbalance, topbal
`/ecomenu`	打开经济菜单	moneymenu, economy, market, prices
`/transactions [玩家] [页]`	交易记录	history, tx

管理员命令

/eco <give|take|set|reset> <玩家> [金额] — 给予、扣除、设置或重置玩家余额。

权限

myeconomy.player — 玩家命令（balance, pay, baltop, menu, transactions）
myeconomy.balance.others — 查看他人余额
myeconomy.admin — /eco 命令
myeconomy.admin.hologram — 管理全息图

配置 (config.yml)

常规

general.language — 语言（en, fr, es, de 等）。general.prefix — 消息前缀。general.debug — 调试消息。

货币

currency.name、currency.singular、currency.plural、currency.symbol、currency.decimals、currency.display-format（name 或 symbol）、currency.short-format（1.5K、1.2M）。

起始余额

starting-balance.amount — 新玩家金额。starting-balance.welcome-message — 欢迎消息（占位符：{amount}、{currency}）。

支付 (/pay)

pay.enabled、pay.min-amount、pay.max-amount、pay.tax-percentage、pay.require-confirmation-above、pay.allow-self-pay、pay.quick-amounts。

排行榜

rankings.top-size。周：rankings.weekly.enabled、reset-day、rewards.positions。月：rankings.monthly（结构相同）。

安全

security.max-transactions-per-minute、transaction-cooldown、max-balance、min-balance、allow-negative-balance。

数据库

database.type — yaml、mysql 或 sqlite。然后 database.mysql 或 database.sqlite。

全息图 (DecentHolograms)

holograms.enabled、update-interval、format.title-global、format.line-format（占位符：{rank}、{player}、{balance}、{currency}）。

功能

完整经济

可自定义货币（名称、符号、小数位）、起始余额、交易记录。

排行榜

全局、周、月排行榜，自动奖励（前 1、2、3）。可配置重置（星期或日期）。

GUI 菜单

/ecomenu — 查看余额、转账（快捷金额）、查看排行榜的界面。

集成

Vault — 经济 API 供其他插件使用
PlaceholderAPI — 占位符（余额、排名等）
DecentHolograms — 排行榜全息图
MyCore — 事件与 API
拍卖行（税收、交易追踪）

安全

每分钟交易上限、冷却、余额上限、大额确认。

MyEconomy