📥 安装

环境要求

安装步骤

1. 将 AdventureCraftings-1.1.0.jar 放入 plugins/
2. 重启服务器，自动生成配置文件和 recipes/ 目录
3. 编辑 config.yml 调整全局设置
4. 使用 /acraft create <ID> 通过 GUI 创建配方
5. 使用 /acraft menu 打开配方菜单

目录结构

plugins/AdventureCraftings/
├── config.yml           # 全局配置
├── messages.yml         # 消息配置
└── recipes/             # 配方文件夹
    ├── example.yml      # 示例配方
    └── *.yml            # 自定义配方文件

📝 更新日志

v1.1.0 LATEST

• NEW AdventureManage 绑定物品过滤 — 合成时自动检测并跳过 AdventureManage 绑定物品，防止绑定物品被用作合成材料消耗。通过反射调用 ItemBindManager，无编译依赖
• CONFIG softdepend 更新 — plugin.yml 新增 AdventureManage 为可选依赖

v1.0.0

• NEW 完整配方系统 — 支持有序(SHAPED)、无序(SHAPELESS)、熔炉(FURNACE)、烟熏炉(SMOKING)、高炉(BLASTING)、锻造台(SMITHING) 六种类型
• NEW GUI 配方编辑器 — /acraft create 和 /acraft edit，3×3 材料格 + 结果槽 + 可视化设置面板
• NEW 配方分类菜单 — 分类浏览、翻页、详情页、一键合成
• NEW 合成时间系统 — BossBar 进度 + GUI 进度面板 + 可取消
• NEW 条件系统 — 等级、金钱(Vault)、职业(SkillAPI)、变量(PAPI)
• NEW 随机配方 — 权重随机结果、随机附魔等级、随机 Lore 池
• NEW 物品交互命令 — 右键物品执行命令系统（冷却/消耗/权限）
• NEW 完全物品兼容 — NBT、药水、怪物蛋、彩色盔甲、头颅、盾牌、附魔书、烟花
• NEW 原版配方注册 — 自动注册 Bukkit 配方，工作台即可合成
• NEW 外部插件集成 — Vault 经济、PlaceholderAPI 变量、SkillAPI 职业

⌨️ 命令总表

基础命令

编辑器命令

管理命令

📋 配方浏览菜单

菜单流程

1. 分类选择页 — 显示所有有配方的分类，图标和配方数量
2. 配方列表页 — 该分类下所有可见配方，支持翻页（每页28个）
3. 配方详情页 — 3×3 材料排列、结果物品、合成信息，可直接点击合成

配方详情页布局

┌─────────────────────────────────┐
│  [材料] [材料] [材料]    [信息]  │
│  [材料] [材料] [材料]  → [结果]  │
│  [材料] [材料] [材料]    [条件]  │
│                                 │
│         [合成按钮]  [返回]       │
└─────────────────────────────────┘

满足所有条件时合成按钮显示为绿色；否则显示红色并附带失败原因。

🔧 配方编辑器

编辑器布局 (54格)

行1: [黑] [黑] [黑] [黑] [黑] [黑] [黑] [黑] [黑]
行2: [黑] [格1][格2][格3] [黑] [类型][权限][分类]
行3: [黑] [格4][格5][格6] [黑] [→]  [结果] [黑]
行4: [黑] [格7][格8][格9] [黑] [时间][概率][条件]
行5: [黑] [黑] [黑] [黑] [黑] [命令][1次] [无限]
行6: [保存][黑] [黑] [黑] [黑] [黑] [黑] [黑] [取消]

设置按钮

⏳ 合成进度界面

当配方设置了合成时间 (craft-time > 0) 时，点击合成按钮后打开进度界面：

┌──────────────────────────────┐
│                              │
│  [红] [红] [红] [结果] [红] [红] [红]  │
│                              │
│           [取消]              │
└──────────────────────────────┘

进度条从红色逐渐变为绿色
同时显示 BossBar 进度条

• 材料在开始合成时立即消耗
• BossBar 显示剩余秒数，实时更新
• 点击底部取消按钮可取消合成（材料已消耗不退还）
• 关闭 GUI 或下线会自动取消合成
• 合成完成后自动判定成功率，给予结果物品

📦 配方类型

📁 配方配置格式

配方存储在 plugins/AdventureCraftings/recipes/ 目录下的 YAML 文件中。每个文件可包含多个配方。

有序合成 (SHAPED) 示例

recipes:
  diamond_hammer:
    enabled: true
    display-name: "&b&l钻石锤"
    category: "tool"
    type: SHAPED
    shape:
      - "DDD"
      - " S "
      - " S "
    ingredients:
      D: { material: DIAMOND }
      S: { material: STICK }
    result:
      material: DIAMOND_PICKAXE
      amount: 1
      name: "&b&l钻石锤"
      enchantments: { efficiency: 5, unbreaking: 3 }
    craft-time: 0
    success-chance: 100

配方字段详解

物品格式

🔒 合成条件

PAPI 变量条件

conditions:
  variables:
    "%player_level%": ">=30"
    "%vault_eco_balance%": ">=1000"
    "%player_world%": "==world"

支持的运算符

🎲 随机配方

权重随机结果

random-results:
  - weight: 50
    material: DIAMOND
    amount: 5
    name: "&b钻石奖励"
  - weight: 30
    material: NETHERITE_INGOT
    amount: 1
    name: "&4下界合金"
  - weight: 20
    material: ENCHANTED_GOLDEN_APPLE
    amount: 3
    name: "&6&l终极奖励"

随机附魔等级

random-enchant-levels:
  sharpness: "3-5"     # 锋利 3-5 级随机
  unbreaking: "1-3"    # 耐久 1-3 级随机
  fire_aspect: "1-2"   # 火焰附加 1-2 级随机

随机 Lore 池

random-lore-pool:
  - ["&7普通品质", "&7攻击力 +10"]
  - ["&a优秀品质", "&a攻击力 +20"]
  - ["&6&l传说品质", "&6攻击力 +50", "&e暴击率 +15%"]

⚡ 高级特性

一次性配方

设置 one-time: true 后，每个玩家只能合成该配方一次。记录在内存中，服务器重启后重置。

无限材料模式

设置 infinite-materials: true 后，合成不消耗材料。适用于展示、测试或特殊活动。

隐藏配方

设置 hidden: true 后，不满足条件的玩家在菜单中看不到该配方。全局设置 settings.hide-no-permission: true 会隐藏无权限的所有配方。

合成命令

commands:
  - "effect give %player% regeneration 30 2"
  - "broadcast &e%player% &6合成了一个传说物品!"
  - "title %player% title {\"text\":\"合成成功!\",\"color\":\"gold\"}"

支持 %player% 占位符，命令以控制台身份执行。

⚙️ config.yml

settings 全局设置

crafting-gui 合成 GUI

menu 配方菜单

💬 messages.yml

所有消息支持 & 颜色代码和 %placeholder% 占位符。

占位符变量

🏷️ 分类配置

在 config.yml 的 categories 节点定义配方分类：

categories:
  general:
    display-name: "&f通用"
    icon: CRAFTING_TABLE
    description: ["&7通用配方分类"]
    priority: 0
  weapon:
    display-name: "&c武器"
    icon: DIAMOND_SWORD
    description: ["&7武器类配方"]
    priority: 1
  tool:
    display-name: "&a工具"
    icon: DIAMOND_PICKAXE
    description: ["&7工具类配方"]
    priority: 3

🖱️ 交互命令配置

在 config.yml 的 interact-commands 节点配置物品交互命令：

interact-commands:
  enabled: true
  items:
    magic_wand:
      material: BLAZE_ROD
      name: "&d&l魔法棒"
      lore: ["&7右键使用"]
      commands:
        - "effect give %player% speed 30 1"
      cooldown: 60
      consume: false
      permission: "adventurecraftings.interact.magic_wand"

🔗 物品与插件兼容

完全兼容的物品类型

外部插件集成

🔐 权限节点