AdventureCraftings
中文配置 Wiki

plugins/AdventureCrafings/
├─ config.yml                 # 服务端标识、语言、调试开关
├─ settings.yml               # 队列、配方书、原版工作台入口
├─ messages.yml               # 玩家消息
├─ database.yml               # MySQL、Redis、文件降级
├─ guis/
│  ├─ crafting-gui.yml        # 默认 /craft 界面
│  └─ crafting-gui-2.yml      # 可自行复制新增
├─ recipes/
│  ├─ example.yml             # 示例；可拆分任意数量 YAML
│  ├─ weapons.yml
│  └─ materials.yml
├─ imports/                   # /craft editor tools 导入目录；放入待导入 yml
├─ exports/                   # /craft editor tools 导出目录
├─ backups/
│  ├─ recipes-delete/         # 删除配方时的单配方备份
│  └─ recipes-revisions/      # 保存/移动配方前的 revision 备份
└─ data/
   ├─ player-data.yml         # 解锁数据本地副本
   ├─ craft-history.yml       # 时段内/终身制作次数记录
   └─ storage-fallback.yml    # 存储不可用时的日志降级

server-id: "lobby"   # 当前子服唯一标识；写入合成和队列日志
language: "zh_CN"   # 预留语言标识；当前玩家文本主要来自 messages.yml
debug: false        # 调试开关；生产服建议 false

native-workbench-entry: false  # true：原版工作台匹配到 AC 配方后转入自定义 GUI
queue:
  default-slots: 5            # 所有玩家默认队列槽数量
  maximum-slots: 10           # 队列硬上限，同时受 GUI output-slots 数量限制
recipe-book:
  title: "&8AdventureCrafings · 配方书"  # 配方书标题
  show-only-public: true      # true：仅展示 public: true 的配方

storage:
  fallback-to-file: true  # MySQL 不可用时写入 data/storage-fallback.yml
  fail-fast: false        # true：MySQL/Redis 按配置启用但连接失败时停用插件
mysql:
  enabled: true           # 是否启用 MySQL
  host: localhost         # 主机或 IP
  port: 3306              # 端口
  database: adventurecrafings # 数据库名（需预先创建）
  username: root          # 用户名
  password: ""            # 密码；含特殊字符时加引号
  pool-size: 10           # HikariCP 最大连接数
redis:
  enabled: true           # 是否启用 Redis
  host: localhost
  port: 6379
  password: ""            # 无密码保持空字符串
  database: 0             # Redis 逻辑库编号
  timeout-ms: 3000        # 连接/操作超时毫秒

prefixes:
  info: "&a[!] &r"
  warn: "&e[!] &r"
  error: "&c[!] &r"
default-prefix: info
message-types:
  no-permission: error
  task-created: success
condition-failed: "%reason%" # %reason% 来自 condition-lore.yml → failures
notify:
  ready-title: "&a制作完成"
  ready-actionbar: "&a制作完成：&f%recipe%"

editor-tools:
  title: "&8Recipe Editor Tools"     # 工具主界面标题
  state:
    none: "<none>"
    public: "&aPUBLIC"
    private: "&cPRIVATE"
    on: "&aON"
    off: "&cOFF"
  buttons:
    search:
      name: "&eSearch"
      lore:
        - "&7Current: &f%query%"
        - "&7Click and type recipe id/name/folder."
    health:
      name: "&cRecipe Health Check"
      lore:
        - "&7List duplicate ids, missing result/material,"
        - "&7invalid material/sound and non-yml files."
  health:
    title: "&8Recipe Health Check"
    issue-line-prefix: "&7"
    issues:
      duplicate-id: "duplicate id %id% in %files%"
      bad-result-material: "%file% -> %id%: invalid result material %value%"
  export:
    success: "&aExported %count% recipe(s) to %path%"
    failed: "&cExport failed: %reason%"
  import:
    empty: "&ePut yml files into %path% first."
    success: "&aImported %count% file(s), recipes reloaded."
    rejected: "&cImport rejected: %reason%"

status:
  met: "&a[已满足]"
  unmet: "&c[未满足]"
labels:
  vault: "Vault 余额：%value%"
  permission: "权限：%value%"
lore:
  met:
    default: "&7%condition% &a%status%"
  unmet:
    default: "&7%condition% &c%status%"
failures:
  vault-missing: "&cVault 余额不足，需要：&f%amount%"
  permission-missing: "&c缺少权限：&f%permission%"

# 文件名：crafting-gui.yml → GUI ID 为 crafting-gui
open-permission: "adventurecraftings.gui.crafting-gui" # 打开权限；空字符串表示不额外限制
title: "&8AdventureCrafings · 自定义合成" # GUI 标题，支持颜色与 MiniMessage
rows: 6                         # 箱子行数：1-6，每行9格

# 3×3 材料区，必须正好9个有效槽位。GUI 槽位从0开始。
matrix-slots: [10, 11, 12, 19, 20, 21, 28, 29, 30]
result-slot: 24                 # 匹配配方后的可点击预览/制作按钮

# 延时任务与待领取成品显示位置，至少1个、最多10个。
output-slots: [44, 45, 46, 47, 48, 49, 50, 51, 52, 53]

filler:
  enabled: true                # 是否自动填充全部非功能槽
  material: BLACK_STAINED_GLASS_PANE # Bukkit Material 名称
  name: " "                    # 填充物名称；空格可隐藏名称
  lore: []                     # 填充物 Lore

preview:
  use-recipe-item: true        # true：复制配方第一个结果的外观
  material: CRAFTING_TABLE     # false 时使用此材质
  name: "&a%recipe%"           # false 或非空时作为预览名称
  append-lore: true            # true：保留成品 Lore 后追加；false：替换
  lore:
    - "&a点击开始制作"
    - "%time%"
  instant-time: "&7瞬时合成"  # %time% 在0秒配方中替换为此文本
  delayed-time: "&7制作时间：&f%seconds% 秒"

output:
  show-empty: false            # 是否在空队列槽显示占位物品
  empty-material: GRAY_STAINED_GLASS_PANE
  empty-name: "&7空闲制作槽"
  empty-lore: ["&8等待新的制作任务"]
  crafting:                    # 正在计时的队列任务样式
    use-recipe-item: true
    material: CLOCK
    name: "&e%recipe%"
    append-lore: true
    lore: ["&e制作中 · 剩余 %seconds% 秒"]
  ready:                       # 已完成、等待点击领取的样式
    use-recipe-item: true
    material: CHEST
    name: "&a%recipe%"
    append-lore: true
    lore: ["&a✔ 点击领取"]
    glint: true                # 是否显示附魔光效

# 自定义静态装饰物；键名可自定义。与材料/结果/输出槽冲突时功能槽优先。
decorations:
  info:
    slots: [4, 13]
    material: KNOWLEDGE_BOOK
    name: "&6冒险合成说明"
    lore:
      - "&7把材料放入左侧3×3区域"
      - "&7点击右侧成品开始制作"

第1行： 0  1  2  3  4  5  6  7  8
第2行： 9 10 11 12 13 14 15 16 17
第3行：18 19 20 21 22 23 24 25 26
第4行：27 28 29 30 31 32 33 34 35
第5行：36 37 38 39 40 41 42 43 44
第6行：45 46 47 48 49 50 51 52 53

notify:
  message: true     # 聊天消息；省略时默认 true
  title: false      # 屏幕标题
  actionbar: false  # 动作栏
  bossbar: false    # 临时 BossBar
  sound: true       # 升级提示音；省略时默认 true

type: shaped
matrix:
  - " D " # 第一行：中间放 D
  - " I " # 第二行：中间放 I
  - " S " # 第三行：中间放 S
ingredients:
  D: "DIAMOND*1"    # 此格至少1颗钻石
  I: "IRON_INGOT*2" # 此格至少2个铁锭；制作时从该格扣2
  S: "STICK*2"      # 此格至少2根木棍

type: shapeless
matrix: ["DA_", "___", "___"] # 字符位置只用于列出需求，不限制玩家摆放
ingredients:
  D: "DIAMOND*1"
  A: "AMETHYST_SHARD*4"

# 仍可读取，但新配方推荐使用字符矩阵。
matrix:
  1: "DIAMOND*1" # 1-9 对应3×3矩阵
  5: "STICK*2"

results:
  - material: DIAMOND_SWORD # 必填：Bukkit Material
    amount: 1               # 数量，最小1；默认1
    chance: 100             # 百分比 0.01-100；默认100
    custom-model-data: 10001 # 可选：资源包自定义模型ID；0/省略表示不用
    display-name: "&#FFD700冒险长剑" # 名称
    lore:                   # Lore 列表
      - "&7专属冒险装备"
      - "<gradient:#FFD700:#FF6600>稀有品质</gradient>"
    glow: true              # 添加隐藏附魔以显示光效
    unbreakable: false      # 是否不可破坏

  - material: DIAMOND      # 第二结果独立判定
    amount: 2
    chance: 5.5
    display-name: "&b幸运返还"

result:
  material: EMERALD
  amount: 1
  chance: 100
  display-name: "&a旧格式结果"

requirements:
  # Vault 经济费用。0 = 不使用；旧 money-cost 仍兼容。
  vault-cost: 0

  adventure-money:
    # NONE = 关闭；MONEY = 主货币；ACOIN = A币；GCOIN = G币
    currency: NONE
    amount: 0                 # 需要并消费的数量；0 = 不使用

  # 只检查权限。玩家缺少任意一项即失败；成功后不会移除。
  permissions:
    - "adventure.vip"

  # 同样要求玩家拥有，但制作成功时通过 LuckPerms 从玩家移除。
  consume-permissions:
    - "adventure.crafting.ticket"

  # 所有 PAPI 条件为 AND 关系，必须全部满足。
  papi:
    - placeholder: "%player_level%" # 变量先解析
      operator: ">="                 # == != > >= < <= contains matches
      value: "30"                    # 值也会解析 PAPI
    - placeholder: "%player_world%"
      operator: "=="
      value: "world"

  time:
    enabled: false             # false = 不限制时段
    start: "08:00"             # HH:mm，包含开始时刻
    end: "22:00"               # HH:mm，包含结束时刻
    timezone: "Asia/Shanghai"  # Java ZoneId

  craft-limit:
    max-crafts: 0              # 0 = 不限制
    period-days: 0             # 0 = 终身累计；大于0 = 最近X×24小时滚动窗口

requirement-lore:
  met:
    vault: "&7金币需求：&f%value% &a✔"
    permission: "&7专属权限：&f%value% &a已拥有"
  unmet:
    vault: "&7金币需求：&f%value% &c✘"
    permission: "&7专属权限：&f%value% &c未拥有"

recipes:
  mixed_crystal:
    display-name: "&d混合水晶"
    public: true
    default-unlocked: true
    type: shapeless
    permission: ""
    crafting-guis: ["crafting-gui"]
    craft-time: 0             # 点击后立即产出，GUI不关闭
    matrix: ["DA_", "___", "___"]
    ingredients:
      D: "DIAMOND*1"
      A: "AMETHYST_SHARD*4"
    results:
      - material: AMETHYST_SHARD
        amount: 2
        chance: 100
        display-name: "&d混合水晶"
        lore: ["&7位置不限"]
        glow: true
    # requirements 完全省略 = 无经济、权限、PAPI、时间和次数条件

recipes:
  adventurer_blade:
    display-name: "<gradient:#FFD700:#FF6600>冒险者之刃</gradient>"
    public: true
    default-unlocked: false
    type: shaped
    crafting-guis: ["crafting-gui"]
    craft-time: 30
    matrix:
      - " D "
      - " I "
      - " S "
    ingredients:
      D: "DIAMOND*2"
      I: "IRON_INGOT*4"
      S: "STICK*1"
    results:
      - material: DIAMOND_SWORD
        amount: 1
        chance: 100
        custom-model-data: 10001
        display-name: "&#FFD700冒险者之刃"
        lore: ["&7必定产物"]
        glow: true
      - material: DIAMOND
        amount: 1
        chance: 8.25
        display-name: "&b幸运返还"
      - material: NETHER_STAR
        amount: 1
        chance: 0.01
        display-name: "&d奇迹之星"
    notify:
      message: true
      title: true
      actionbar: false
      bossbar: false
      sound: true

recipes:
  weekly_night_box:
    display-name: "&5每周夜行宝箱"
    public: true
    default-unlocked: true
    type: shapeless
    crafting-guis: ["vip-crafting"]
    craft-time: 60
    matrix: ["ABC", "___", "___"]
    ingredients:
      A: "DIAMOND*8"
      B: "EMERALD*16"
      C: "CHEST*1"
    results:
      - material: CHEST
        amount: 1
        chance: 100
        custom-model-data: 20010
        display-name: "&5夜行宝箱"
    requirements:
      vault-cost: 5000
      adventure-money:
        currency: ACOIN
        amount: 20
      permissions: ["rank.vip"]
      consume-permissions: ["adventure.ticket.weekly-box"]
      papi:
        - placeholder: "%player_level%"
          operator: ">="
          value: "50"
      time:
        enabled: true
        start: "20:00"
        end: "02:00"
        timezone: "Asia/Shanghai"
      craft-limit:
        max-crafts: 1
        period-days: 7

# guis/crafting-gui-2.yml
open-permission: "adventurecraftings.gui.crafting-gui-2"
title: "&1高级工坊"
rows: 6
# 其余布局参考默认文件……

# recipes/high-tier.yml 中的配方
recipes:
  high_tier_item:
    display-name: "高级物品"
    type: shaped
    default-unlocked: true
    crafting-guis: ["crafting-gui-2"] # 默认 /craft 中不会匹配
    craft-time: 0
    matrix: ["AAA", "ABA", "AAA"]
    ingredients:
      A: "DIAMOND*1"
      B: "NETHER_STAR*1"
    results:
      - material: BEACON
        chance: 100
        display-name: "&b高级信标"

# 示例
今日制作：%adventurecraftings_today_crafts%
解锁进度：%adventurecraftings_unlocked_recipes%/%adventurecraftings_total_recipes%
长剑解锁：%adventurecraftings_recipe_unlocked_advance_sword%

display-name: "&a传统绿色"                          # 默认推荐
display-name: "#FFD700十六进制金色"                # 6位Hex
display-name: "&#55D9E8带&前缀的Hex"
display-name: "&{#FF6688}花括号Hex"
display-name: "<gradient:#FF0000:#00FFFF>渐变</gradient>" # MiniMessage