Simple Currencies

插件

· 作者 Nitrox_XD

一个支持在一个插件中实现多种货币系统的货币插件

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

最新 1.6 · 26.3 · Paper / Spigot

一键开服(送7天)

SimpleCurrencies

一个轻量级的 Paper (1.21+) 插件,支持在单个插件内使用多个独立的货币系统。plugins/SimpleCurrencies/ 目录下的每个 .yml 文件都定义了自己的货币、自定义命令、规则和余额。


功能特性

  • 无限自定义货币 — 在 plugins/SimpleCurrencies/ 中创建一个新的 .yml 文件(例如 coins.yml、gems.yml),即可自动获得一个专用的 /<command> 命令。
  • 小数与余额限制 — 支持按货币配置小数位、初始余额、默认最大余额,以及通过权限覆盖的最大余额。
  • 玩家间转账 (/pay) — 允许玩家之间互相发送货币,并支持按货币设置 pay-enabled 开关以启用或禁用此功能。
  • 提取为物品 (/withdraw & /deposit) — 将货币提取为可定制的实体钞票物品(包含 item、display-name、lore),并使用 PersistentDataContainer 元数据进行保护。通过右键点击该物品或运行 /<command> deposit 来兑换。
  • 汇率与货币转换 — 可在 YAML 文件中或通过 /sc rate 命令定义货币间的汇率,并通过 /<command> transfer 命令迁移货币余额。
  • Vault 经济导入 — 从任何兼容 Vault 的经济系统(例如 EssentialsX、CMI)导入余额到 SimpleCurrencies 的某个货币中,可选设置汇率和清除 Vault 中的原始余额。
  • PlaceholderAPI 支持 — 内置扩展,支持获取玩家余额、格式化后的余额、全局余额及最大余额等占位符。

命令

主命令 (/simplecurrencies, /sc, /simplecurrencys)

命令 权限 默认权限 描述
/sc help — 所有人 显示插件命令概览
/sc reload <currency|all> simplecurrencies.reload op 重载一个或所有货币配置
/sc rate set <from> <to> <rate> simplecurrencies.rate op 设置汇率(1 <from> = <rate> <to>)
/sc rate get <from> <to> simplecurrencies.rate op 查看两个货币之间配置的汇率
/sc rate remove <from> <to> simplecurrencies.rate op 移除已配置的汇率
/sc rate list [currency] simplecurrencies.rate op 列出已配置的汇率
/sc import Vault <currency> [rate] [clearVault] simplecurrencies.import op 从 Vault 导入玩家余额到 <currency>

按货币划分的命令 (/<command>)

每种货币都会注册在其 .yml 文件的 command: 下配置的命令:

命令 权限 默认值 描述
/<command> — 所有人 查看你自己格式化后的余额
/<command> balance [player] — 所有人 查看你自己或其他玩家的余额
/<command> pay <player> <amount> simplecurrencies.pay true 向其他玩家付款(需要配置 pay-enabled: true)
/<command> withdraw <amount> simplecurrencies.withdraw true 将货币提取为纸币物品(需要配置 withdraw.enabled: true)
/<command> deposit simplecurrencies.deposit true 存入手中持有的纸币物品(或右键点击该物品)
/<command> give <player> <amount> simplecurrencies.give op 增加玩家的货币余额
/<command> remove <player> <amount> simplecurrencies.remove op 减少玩家的货币余额
/<command> wipe simplecurrencies.wipe op 清除所有玩家在该货币下的余额
/<command> transfer <targetCurrency> [rate] simplecurrencies.transfer op 使用配置的或提供的汇率,将所有余额转移到 <targetCurrency>,然后清除源货币的余额

配置文件 (plugins/SimpleCurrencies/<id>.yml)

在首次启动时(当不存在 .yml 文件时),会自动生成 default.yml:

# 此货币的显示名称
name: "默认货币"

# 为此货币注册的命令
command: "default"

# 此货币是否支持小数?
decimals: false

# 玩家能否使用此货币互相支付?
pay-enabled: true

# 将货币提取为实体物品(纸币)
# display-name 和 lore 中的占位符:%amount%, %currency%, %currency_id%, %player%
withdraw:
  enabled: false
  item: "PAPER"
  display-name: "&a%amount% %currency%"
  lore:
    - "&7价值:&e%amount% %currency%"
    - "&7提取者:&f%player%"
    - "&7右键点击以兑换"

平衡:新玩家初始余额

start-balance: 0

玩家最大余额(<= 0 表示无限制)

max-balance: 0

按权限设置自定义最大余额

如果玩家拥有多个权限,取最高值

max-balance-permissions: simplecurrencies.maxbalance.premium: 10000

禁用该货币的世界列表

disabled-worlds:

  • example_world

将此货币转换为其他货币时的汇率

格式:<目标货币ID>: <汇率> (1单位此货币 = <rate> 单位目标货币)

exchange-rates: points: 0.5

balances: 00000000-0000-0000-0000-000000000000: name: "玩家" balance: 0


---

## PlaceholderAPI 占位符

需要 [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/)。将 `<id>` 替换为货币的文件名(不含 `.yml`):

| 占位符 | 描述 |
| :--- | :--- |
| `%simplecurrencies_<id>_balance%` | 玩家的数值余额 |
| `%simplecurrencies_<id>_balance_formatted%` | 带有货币显示名称的玩家余额 |
| `%simplecurrencies_<id>_global_balance%` | `<id>` 中所有玩家余额的总和 |
| `%simplecurrencies_<id>_max_balance%` | 为 `<id>` 配置的默认最大余额 |

---

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源