CustomCurrency丨自定义货币

YanSeng

                                                                                

原作者授权信息

已获得授权

版本兼容1.20,1.20.6.1.21

其他的可能也兼容，就测试了这一些版本

自定义货币插件：

一个强大且可自定义的 Minecraft 服务器货币系统

核心功能：

[•] 多货币系统

• 支持无限量的自定义货币
• 每种货币均可配置独特属性
  
  

[•] 功能特性

• 支持离线玩家操作
  [ISPOILER]- 即将推出：可配置手续费的点对点转账[/ISPOILER]
  [ISPOILER]- 即将推出：交易日志与历史记录查询[/ISPOILER]
  
  

[•] 管理员工具

• 全面的余额管理功能
• 批量操作（如全员发放）
  
  

[•] 集成支持

• Vault：完整的经济系统API兼容
• PlaceholderAPI：为所有货币提供动态占位符
• 数据库：支持 MySQL
  
  

2. 宣传介绍版
此版本在翻译基础上增强了宣传语气和吸引力，适合用于视频或帖子开头来吸引用户。

强大核心 功能一览

💎 多货币系统

• 随心创建无限种自定义货币！
• 每种货币都能拥有独一无二的属性和配置。
  
  

⚙️ 丰富功能

• 全面支持离线玩家操作。
• 🚧 重磅在路上：支持自定义手续费的玩家间转账！
• 🚧 重磅在路上：详尽的交易日志与查询功能！
  
  

🛠️ 高效管理

• 功能完备的后台管理工具，轻松掌控全区余额。
• 支持“一键全员发放”等批量操作，省时省力。
  
  

🔌 无缝集成

• 全面兼容 Vault 经济API，生态无忧。
• 对接 PlaceholderAPI，所有货币数据均可动态显示。
• 支持 MySQL 数据库，数据安全稳固。
  
  [td]

  命令	说明	权限
  /[currency] balance [玩家]	查询（自己或他人的）余额	customcurrency.balance
  /[currency] pay <玩家> <金额>	向指定玩家转账指定货币	customcurrency.pay
  /pay <玩家> <金额>	使用默认货币向玩家转账	customcurrency.pay
  /balance [玩家]	查询（自己或他人的）默认货币余额	customcurrency.balance
  /[currency] admin check <玩家>	管理员：查询玩家余额	customcurrency.admin
  /[currency] admin give <玩家> <金额>	管理员：为玩家增加余额	customcurrency.admin
  /[currency] admin remove <玩家> <金额>	管理员：扣除玩家余额	customcurrency.admin
  /[currency] admin set <玩家> <金额>	管理员：设置玩家余额	customcurrency.admin

                         （问一个小问题怎么进入文本格式啊！！如果教我我马上更改）
• 
  

⚙️ Configuration

# config.yml (主配置文件)

# Vault 兼容性设置

vault-currency: "money" # 指定与 Vault 经济系统挂钩的货币名称

default-currency: "money" # 设置插件的默认货币名称

# storage.yml (数据库存储配置文件)

MySQL:

  host: '127.0.0.1' # 数据库服务器地址

  port: 3306        # 数据库连接端口 (MySQL 默认端口)

  database: 'customcurrency' # 指定插件使用的数据库名称

  Auth:

    user: 'root'     # 连接数据库的用户名

    password: ''     # 连接数据库的密码 (请务必填写并妥善保管)

# money.yml (货币配置文件)

# ========== 货币基础设置 ==========

name: "money"              # 货币的内部ID（不可更改）

displayName: "&6Money"     # 货币的显示名称（支持颜色代码，如 &6 代表金色）

symbol: ""                 # 货币符号（例如 $、€，留空则无符号）

# ========== 货币经济设置 ==========

starting-balance: 1000     # 玩家的初始余额

max-balance: 1000000       # 玩家的最大余额上限

can-be-negative: false     # 是否允许余额为负数

# ========== 命令设置 ==========

commands:

  command: "money"         # 该货币的主命令（例如 /money）

  # 支付命令设置

  pay:

    enabled: true          # 是否启用支付功能

    usage: "&c用法: /{command} pay <玩家> <金额>"  # 命令使用提示

    permission: "money.pay" # 执行此命令所需的权限

    description: "向另一名玩家支付指定金额。"      # 命令描述

  # 查询余额命令设置

  balance:

    enabled: true          # 是否启用查询余额功能

    usage: "&c用法: /{command} balance [玩家]"    # 命令使用提示

    permission: "money.balance" # 执行此命令所需的权限

    description: "查询自己或另一名玩家的余额。"    # 命令描述

    settings:

      allow-check-others: true  # 是否允许查询其他玩家的余额

  # 管理员命令设置

  admin:

    enabled: true          # 是否启用管理员命令

    permission: "money.admin"   # 管理员权限节点

    usage: "&c用法: /{command} admin <check|give|giveall|remove|set>"  # 命令使用提示

=============================

PlaceholderAPI 占位符

[•] %customcurrency_[currency]_balance%

• 说明：玩家的指定货币原始余额。
• 示例：如货币ID为money，此占位符将返回纯数字，如 1000。
  
  

[•] %customcurrency_[currency]_balanceFormatted%

• 说明：玩家的指定货币格式化后余额。
• 示例：如货币ID为money且显示名称为金币，此占位符可能返回 1,000金币，更易于直接显示
  
  

❓ 常见问题

**故障排查步骤**

问题：货币未接入 Vault（经济系统不显示）

1.  **确保 Vault 已安装**

    确认服务器 `plugins` 文件夹内包含 `Vault.jar`。没有 Vault，大部分经济插件将无法工作。

2.  **检查货币是否设为默认**

    在插件配置文件中，确认 `default-currency` 项已正确设置为该货币（例如 `default-currency: "money"`）。

3.  **在控制台验证 Vault 挂钩**

    重启服务器后，在控制台输入 `vault-info` 或检查启动日志，确认经济系统已成功挂钩到您的货币插件。

4.  **必要时重启服务器**

    完成上述更改后，重启服务器是确保所有配置生效的最可靠方式。

如果您需要将这些步骤嵌入到更大的故障排除指南中，我可以为您进一步调整格式和内容。

因为有一些兄弟没有科学上网工具的人准备的
[url=]CustomCurrency-1.1.0.jar[/url]
支持原创作者!!!

YanSeng

好的排版不细节不好意思