❓ 常见问题解答

A: 请检查以下几点：

• 确保服务器版本为 1.19 或更高
• 确保使用的是 Java 8 或更高版本
• 重新下载插件文件，可能文件损坏
• 检查 plugins 文件夹权限是否正确

A: 文件夹会在首次使用相关命令时创建：

• exchanges/ 文件夹在执行 /kkdhkk create 时创建
• items/ 文件夹在执行 /kkdhkk items 时创建
• 如果仍未创建，检查服务器日志是否有错误信息

A: 不是必须的。

• 如果不需要金币兑换功能，可以不安装 Vault
• 如果配置中设置了 required-money，则需要安装 Vault
• 没有 Vault 时，金币需求会被忽略

A: 不是必须的。

• 如果不使用 MM 物品，可以不安装 MythicMobs
• 只使用普通 Minecraft 物品也能正常工作
• 安装 MM 后可以使用更多自定义物品

A: 这是最常见的问题，请按以下步骤排查：

A: 修改配置后需要重载：

• 使用命令 /kkdhkk reload 重载配置
• 或者重启服务器
• 检查配置文件的 YAML 格式是否正确（缩进、冒号等）
• 查看控制台是否有配置错误提示

A: 使用列表格式：

input-item:
  - "材料1:数量1"
  - "材料2:数量2"
  - "材料3:数量3"

注意事项：

• 每个材料占一行，前面有两个空格缩进
• 格式为 "材料名称:数量"，中间用英文冒号
• 所有材料必须同时满足才能兑换

A: 确保使用正确的颜色代码格式：

• 使用 & 符号，不是 §
• 例如："&6&l金色加粗文字"
• 颜色代码需要用引号包裹
• 常用颜色：&0-&9, &a-&f, &l(粗体), &o(斜体)

A: 只需要按顺序配置配方即可：

recipes:
  # 第一级
  - input-item: "腐肉"
    input-amount: 100
    output-item: "物品A"
    ...
  
  # 第二级（使用第一级的输出）
  - input-item: "物品A"
    input-amount: 100
    output-item: "装备B"
    ...
  
  # 第三级（使用第二级的输出）
  - input-item: "装备B"
    input-amount: 4
    output-item: "武器A"
    ...

插件会自动识别兑换链，玩家只要有腐肉就能看到完整路径！

A: 可能的原因：

• 玩家背包是空的：插件只显示与背包物品相关的兑换链
• 配置文件没有配方：检查 yml 文件中是否有 recipes 配置
• 所有物品加载失败：查看控制台错误信息
• 权限问题：确认玩家有 kkdhkk.use 权限

A: 这是智能兑换链的特性：

• 插件只显示与玩家背包物品相关的兑换链
• 例如：玩家只有腐肉，就只显示腐肉相关的兑换链
• 如果想看到钻石的兑换链，背包里需要有钻石
• 这样设计是为了避免界面混乱，让玩家专注于当前可用的兑换

A: 检查以下几点：

• 查看物品 Lore 中的状态，是否显示"§c条件不足"
• 确认材料数量是否充足（所有材料都要满足）
• 检查金币余额是否足够
• 检查经验值是否足够
• 不要点击边框或介绍物品

A: 批量兑换的条件：

• 必须按住 Shift 键再点击
• 材料、金币、经验都必须充足
• 插件会自动计算最大兑换次数
• 如果只能兑换1次，批量和单次效果相同

A: 可能的原因：

• 背包已满：确保背包有足够空间
• 使用了命令类型：检查配置中 output-type 是否为"指令"
• 命令执行失败：查看控制台是否有命令错误
• 权限问题：确认命令执行需要的权限

A: 使用权限插件添加权限：

# 使用 LuckPerms 示例
/lp user 玩家名 permission set kkdhkk.use true

# 或者给予组权限
/lp group default permission set kkdhkk.use true

默认情况下，所有玩家都有 kkdhkk.use 权限

A: 排查步骤：

1. 确认 MythicMobs 插件已正确加载
2. 使用 /mm items list 查看所有 MM 物品 ID
3. 检查配置中的 MM 物品 ID 是否正确（区分大小写）
4. 查看控制台的详细错误信息
5. 确保 MM 物品配置文件没有错误

A: 不需要！

• MM 物品会自动从 MythicMobs 读取
• 直接在配置文件中使用 MM 物品 ID 即可
• 只有普通 Minecraft 物品需要保存

A: 直接在配置中混合使用：

input-item:
  - "q1:10"           # MM物品（无需保存）
  - "腐肉:50"         # 普通物品（需要保存）
  - "哥布林盔甲:5"    # MM物品（无需保存）

插件会自动识别并正确处理

A: 使用 hide-lore 选项：

- input-item: "q1:10"
  output-item: "传奇宝箱"
  hide-lore: true     # 隐藏原物品Lore

这样只会显示兑换信息，界面更简洁

A: 使用 custom-display 选项：

- output-item: "传奇长枪"
  custom-display: "&6&l传奇长枪 &7(特殊奖励)"
  hide-lore: true

这会覆盖 MM 物品的原始显示名称

A: 在配置文件中添加 info 部分：

info:
  - "&7第一行介绍"
  - "&e第二行介绍"
  - ""              # 空行
  - "&a第三行介绍"

介绍会显示在GUI左下角（槽位45）

A: 目前支持两个占位符：

• %player% - 玩家名称
• [数量] - output-amount 的值

commands:
  - "mm items give %player% 物品 [数量]"
  - "eco give %player% 1000"

A: 创建多个配置文件：

/kkdhkk create 僵尸材料
/kkdhkk create 矿物兑换
/kkdhkk create 装备升级

每个配置文件都是独立的兑换界面

A: 直接复制文件夹：

• 备份 plugins/kkdhkk/exchanges/ 文件夹
• 备份 plugins/kkdhkk/items/ 文件夹
• 建议定期备份，避免配置丢失

A: 支持以下服务端：

• ✅ Spigot 1.19+
• ✅ Paper 1.19+
• ✅ Purpur 1.19+
• ✅ 其他基于 Spigot 的服务端
• ❌ 不支持 Bukkit（功能不完整）