配置示例 - KKDHKK 无限兑换插件

🔰 基础配方示例

示例1：单个材料兑换物品

最简单的配方：用腐肉兑换骨头

- input-item: "腐肉"          # 输入材料名称
  input-amount: 10            # 需要10个
  output-type: "物品"         # 输出类型：物品
  output-item: "骨头"         # 输出物品名称
  output-amount: 1            # 给予1个
  commands: []                # 物品类型留空
  required-money: 0           # 不需要金币
  required-exp: 0             # 不需要经验

效果：玩家用10个腐肉可以兑换1个骨头

示例2：需要金币的兑换

兑换时需要消耗金币

- input-item: "骨头"
  input-amount: 100
  output-type: "物品"
  output-item: "钻石"
  output-amount: 1
  commands: []
  required-money: 1000.50     # 需要1000.50金币
  required-exp: 0

效果：玩家用100个骨头 + 1000.50金币可以兑换1个钻石

示例3：需要经验的兑换

兑换时需要消耗经验值

- input-item: "钻石"
  input-amount: 10
  output-type: "物品"
  output-item: "下界之星"
  output-amount: 1
  commands: []
  required-money: 0
  required-exp: 500           # 需要500经验值

效果：玩家用10个钻石 + 500经验值可以兑换1个下界之星

📦 多材料配方示例

示例4：两种材料组合

需要多种材料才能兑换

- input-item:                 # 多个材料用列表格式
    - "腐肉:10"               # 格式：材料名称:数量
    - "骨头:5"
  output-type: "物品"
  output-item: "钻石"
  output-amount: 1
  commands: []
  required-money: 0
  required-exp: 0

效果：玩家需要同时拥有10个腐肉和5个骨头才能兑换1个钻石

示例5：三种材料 + 金币 + 经验

复杂的兑换条件

- input-item:
    - "腐肉:20"
    - "骨头:10"
    - "蜘蛛眼:5"
  output-type: "物品"
  output-item: "附魔金苹果"
  output-amount: 1
  commands: []
  required-money: 5000        # 还需要5000金币
  required-exp: 1000          # 还需要1000经验

效果：玩家需要20腐肉 + 10骨头 + 5蜘蛛眼 + 5000金币 + 1000经验才能兑换

示例6：创建兑换链

设计一条完整的升级路径

recipes:
  # 第一级：腐肉 → 物品A
  - input-item: "腐肉"
    input-amount: 100
    output-type: "物品"
    output-item: "物品A"
    output-amount: 10
    commands: []
    required-money: 0
    required-exp: 0

  # 第二级：物品A → 装备B
  - input-item: "物品A"
    input-amount: 100
    output-type: "物品"
    output-item: "装备B"
    output-amount: 1
    commands: []
    required-money: 1000
    required-exp: 500

  # 第三级：装备B → 武器A
  - input-item:
    - "装备B:4"
    - "钻石:10"
  output-type: "物品"
  output-item: "武器A"
  output-amount: 1
  commands: []
  required-money: 10000
  required-exp: 5000

效果：玩家只要有腐肉，就能看到完整的升级路径（腐肉→物品A→装备B→武器A）

⚔️ MythicMobs物品示例

💡 重要提示：MythicMobs物品无需使用 /kkdhkk items 保存，直接在配置中使用MM物品ID即可！

示例7：使用MM物品作为材料

- input-item:
    - "q1:10"                 # MM物品ID（自动从MythicMobs读取）
    - "q2:5"
    - "哥布林盔甲:5"
  output-type: "物品"
  output-item: "传奇宝箱"     # MM物品ID
  output-amount: 1
  commands: []
  required-money: 100
  required-exp: 50

效果：使用MM物品作为材料和奖励，插件自动读取MM物品信息

示例8：混合使用MM物品和普通物品

- input-item:
    - "q1:10"                 # MM物品
    - "腐肉:50"               # 普通物品（需要先保存）
    - "哥布林盔甲:5"          # MM物品
  output-type: "物品"
  output-item: "终极宝箱"
  output-amount: 1
  commands: []
  required-money: 5000
  required-exp: 1000

效果：可以混合使用MM物品和普通物品作为材料

示例9：自定义MM物品显示名称

- input-item:
    - "q1:50"
    - "q2:25"
  output-type: "指令"
  output-item: "传奇长枪"     # MM物品ID
  custom-display: "&6&l传奇长枪 &7(特殊奖励)"  # 自定义显示名称
  output-amount: 1
  commands:
    - "mm items give %player% 传奇长枪 [数量]"
  required-money: 0
  required-exp: 0
  hide-lore: true             # 隐藏原物品的Lore

效果：使用自定义名称覆盖MM物品原有名称，并隐藏原Lore

💻 命令类型配方示例

示例10：执行单条命令

- input-item: "骨头"
  input-amount: 1000
  output-type: "指令"         # 使用指令类型
  output-item: "骨头"         # 用于显示的物品
  output-amount: 1
  commands:
    - "mm items give %player% 100仙气 [数量]"
  required-money: 0
  required-exp: 0

效果：兑换时执行命令给予MM物品，[数量]会被替换为output-amount的值

示例11：执行多条命令

- input-item:
    - "腐肉:100"
    - "骨头:50"
  output-type: "指令"
  output-item: "钻石"
  output-amount: 5
  commands:
    - "mm items give %player% 高级仙气 [数量]"
    - "eco give %player% 5000"
    - "give %player% diamond [数量]"
  required-money: 0
  required-exp: 0

效果：兑换时依次执行三条命令，给予MM物品、金币和钻石

示例12：纯自定义显示（不使用实际物品）

- input-item:
    - "腐肉:100"
    - "骨头:50"
  output-type: "指令"
  output-item: "自定义奖励"   # 可以是任意名称
  custom-display: "&c&l神秘礼包 &e[点击兑换]"
  output-amount: 1
  commands:
    - "give %player% diamond 10"
    - "eco give %player% 5000"
    - "xp give %player% 1000"
  required-money: 1000
  required-exp: 500
  hide-lore: false

效果：使用纸张作为占位符，显示自定义名称，执行多条命令

🚀 高级配置示例

示例13：完整的兑换配置文件

name: 僵尸材料
display-name: "§6僵尸材料兑换"

# 兑换介绍
info:
  - "&7━━━━━━━━━━━━━━━━━━━━━━"
  - "&6&l  僵尸材料兑换中心"
  - "&7━━━━━━━━━━━━━━━━━━━━━━"
  - ""
  - "&7本界面提供僵尸材料的升级服务"
  - "&7将低级材料逐步升级为高级装备"
  - ""
  - "&e操作说明："
  - "&a  ▸ 左键点击 &7- 兑换1次"
  - "&a  ▸ Shift+左键 &7- 兑换全部"
  - ""
  - "&c注意：兑换会消耗材料、金币和经验"
  - "&7━━━━━━━━━━━━━━━━━━━━━━"

recipes:
  # 第一级：基础材料兑换
  - input-item: "腐肉"
    input-amount: 100
    output-type: "物品"
    output-item: "初级材料"
    output-amount: 10
    commands: []
    required-money: 0
    required-exp: 0

  # 第二级：中级材料兑换
  - input-item:
    - "初级材料:100"
    - "骨头:50"
  output-type: "物品"
  output-item: "中级材料"
  output-amount: 10
  commands: []
  required-money: 1000
  required-exp: 500

  # 第三级：高级装备兑换
  - input-item:
    - "中级材料:50"
    - "钻石:10"
  output-type: "物品"
  output-item: "高级装备"
  output-amount: 1
  commands: []
  required-money: 5000
  required-exp: 2000

  # 第四级：终极武器兑换（使用MM物品）
  - input-item:
    - "高级装备:4"
    - "下界之星:1"
  output-type: "指令"
  output-item: "终极武器"
  custom-display: "&c&l终极武器 &6[传说]"
  output-amount: 1
  commands:
    - "mm items give %player% 终极武器 [数量]"
    - "eco give %player% 50000"
    - "broadcast &e恭喜玩家 &6%player% &e成功兑换了 &c&l终极武器！"
  required-money: 50000
  required-exp: 10000
  hide-lore: true

示例14：隐藏Lore的使用

当物品有复杂的Lore时，可以选择隐藏

- input-item: "q1:10"
  output-type: "物品"
  output-item: "传奇宝箱"
  output-amount: 1
  commands: []
  required-money: 0
  required-exp: 0
  hide-lore: true             # 隐藏原物品Lore，只显示兑换信息

hide-lore: false（默认）

显示原物品的所有Lore
在下方添加兑换信息
适合简单物品

hide-lore: true

隐藏原物品的Lore
只显示兑换信息
适合复杂的MM物品

占位符说明

占位符	说明	示例
`%player%`	玩家名称	Steve
`[数量]`	output-amount的值	如果output-amount是5，则替换为5