Инвентарный крафт

Меню в стиле верстака, которое “крафтит” предметы: игрок должен иметь ингредиенты рецепта в инвентаре, клик по рецепту их расходует и выдаёт результат. Механика отличается от слотов с drag-and-drop - здесь проверяется обычный инвентарь игрока.

Что показывает

• Правило inventoryItems для проверки “есть ли у игрока эти предметы”
• itemRemove для расхода подходящих предметов
• itemAdd для выдачи результата крафта
• Объявление рецептов как именованных блоков на уровне файла, на которые ссылаются через подстановку ${name}

средний

Фичи: inventoryItems-ruleitemRemoveitemAddtemplate-substitutionrecipe-template

Открыть: /ame_craft Скопировать

menu.conf

# Инвентарный крафт - крафт предметов с расходом ингредиентов из инвентаря
# Документация: https://abstractmenus.github.io/docs/ru/examples/snippets/inventory-crafting
# Открыть: /ame_craft
# Требования: -

include required(file("./plugins/AbstractMenus/menus/example/_shared/templates.conf"))

title: "&6Верстак охотника"
size: 1

activators {
  command: "ame_craft"
}

# Определения рецептов на уровне файла - блок click ссылается на них через ${...}.

helmetRecipe {
  output {
    material: LEATHER_HELMET
    name: "&aШляпа охотника"
    enchantments {
      durability: 2
    }
  }
  requirements: [
    { material: LEATHER, count: 5 }
  ]
}

chestplateRecipe {
  output {
    material: LEATHER_CHESTPLATE
    name: "&aКуртка охотника"
    enchantments {
      durability: 2
      thorns: 1
    }
  }
  requirements: [
    { material: LEATHER, count: 8 }
    { material: STRING,  count: 1 }
    { material: IRON_INGOT, count: 1 }
  ]
}

items: [
  ${helmetRecipe.output} {
    slot: 2
    flags: HIDE_ATTRIBUTES
    lore: [
      "&7Требуется:"
      "&7- Кожа x5"
      ""
      "&aКлик для крафта"
    ]
    click {
      rules {
        inventoryItems: ${helmetRecipe.requirements}
      }
      actions {
        itemRemove: ${helmetRecipe.requirements}
        itemAdd: ${helmetRecipe.output}
        sound: ${successSound}
        message: "&aВы скрафтили Шляпу охотника!"
      }
      denyActions: ${denyNotEnoughItems}
    }
  }

  ${chestplateRecipe.output} {
    slot: 6
    flags: HIDE_ATTRIBUTES
    lore: [
      "&7Требуется:"
      "&7- Кожа x8"
      "&7- Нить x1"
      "&7- Железный слиток x1"
      ""
      "&aКлик для крафта"
    ]
    click {
      rules {
        inventoryItems: ${chestplateRecipe.requirements}
      }
      actions {
        itemRemove: ${chestplateRecipe.requirements}
        itemAdd: ${chestplateRecipe.output}
        sound: ${successSound}
        message: "&aВы скрафтили Куртку охотника!"
      }
      denyActions: ${denyNotEnoughItems}
    }
  }

  ${buttonClose} { slot: 8 }
]

# Локальное действие для случая нехватки ингредиентов
denyNotEnoughItems {
  sound:   ${deniedSound}
  message: "&cУ вас недостаточно материалов."
}

_shared/templates.conf

# AbstractMenus example pack - shared templates (RU)
# Reusable HOCON snippets referenced from menus via ${blockName} substitution.
# Docs: https://abstractmenus.github.io/docs/ru/examples

# Sound presets (Paper 1.21+ registry keys)
clickSound:    "ui.button.click"
openSound:     "block.chest.open"
closeSound:    "block.chest.close"
successSound:  "entity.experience_orb.pickup"
failSound:     "block.note_block.bass"
deniedSound:   "block.anvil.land"

# Deny action snippets (use as: denyActions: ${denyNoMoney})
denyNoMoney {
  sound:   ${deniedSound}
  message: "&cУ вас недостаточно денег."
}
denyNoPerm {
  sound:   ${deniedSound}
  message: "&cНет прав."
}
denyCooldown {
  sound:   ${deniedSound}
  message: "&cВы на кулдауне. Попробуйте позже."
}

# Border items (use as: ${borderBlack} { slot: "0-8" })
borderBlack {
  material: BLACK_STAINED_GLASS_PANE
  name: " "
}
borderGray {
  material: GRAY_STAINED_GLASS_PANE
  name: " "
}
borderBlue {
  material: BLUE_STAINED_GLASS_PANE
  name: " "
}

# Navigation buttons (use as: ${buttonClose} { slot: 22 })
buttonClose {
  material: BARRIER
  name: "&cЗакрыть"
  click {
    closeMenu: true
  }
}
buttonBack {
  material: ARROW
  name: "&eНазад"
  lore: ["&7Вернуться в предыдущее меню"]
  click {
    closeMenu: true
  }
}
buttonNext {
  material: ARROW
  name: "&eСледующая страница"
  click {
    pageNext: 1
  }
}
buttonPrev {
  material: ARROW
  name: "&eПредыдущая страница"
  click {
    pagePrev: 1
  }
}

# Rule shortcut snippets (use as: rules: ${rulesAdmin})
rulesAdmin   { permission: "abstractmenus.admin" }
rulesVip     { permission: "abstractmenus.vip" }
rulesDonator { permission: "abstractmenus.donator" }

# Common decorative header (use as: ${commonHeader} { slot: 4 })
commonHeader {
  material: NETHER_STAR
  name: "&6&lМеню примера"
  lore: ["&7Добро пожаловать в пак примеров AbstractMenus"]
}

↓ menu.conf ↓ Бандл (.zip)

Бандл включает _shared/templates.conf и INSTALL.txt.

Как это работает

Каждый рецепт описывает output (полученный предмет) и список requirements (ингредиенты):

helmetRecipe {
  output {
    material: LEATHER_HELMET
    name: "&aHunter's Hat"
    enchantments { durability: 2 }
  }
  requirements: [
    { material: LEATHER, count: 5 }
  ]
}

Блок click ссылается на оба:

click {
  rules { inventoryItems: ${helmetRecipe.requirements} }
  actions {
    itemRemove: ${helmetRecipe.requirements}
    itemAdd: ${helmetRecipe.output}
    ...
  }
  denyActions: ${denyNotEnoughItems}
}

Этот паттерн держит данные рецепта в одном месте: правило, расход и результат - всё ссылается на один и тот же блок helmetRecipe. Добавить или поправить рецепт значит править один блок, а не три.

Инвентарный крафт vs drag-and-drop

Два разных паттерна “крафта” в AbstractMenus:

• Инвентарный крафт (этот пример): предметы остаются в обычном инвентаре игрока. Правило inventoryItems смотрит в инвентарь, itemRemove списывает оттуда. Игрок ничего не перемещает руками.
• Drag-and-drop крафт: в меню есть слоты, в которые можно перетаскивать. Игрок физически перетягивает предметы. Использует действие placeItem, правило placedItem и поле draggable у предметов. Альтернативный паттерн смотрите в документации drag-and-drop.

Этот сниппет показывает паттерн инвентарного крафта, потому что он хорошо сочетается с магазинными интерфейсами и не требует кастомной настройки слотов.

Добавление новых рецептов

Опишите новый блок xxxRecipe на уровне файла с output {} и requirements: [...]. Добавьте предмет в список items, ссылающийся на него по той же схеме, что и шлем. Рецепт упоминается в трёх местах: предмет в отображении, правило, действия. Если везде стоит ${xxxRecipe.something}, рецепты не разъедутся.

Попробовать

После установки набора примеров:

1. Положите бандл в plugins/AbstractMenus/menus/example/.
2. /am reload.
3. Получите 5 кожи в инвентарь.
4. Введите в игре /ame_craft.
5. Кликните по рецепту шлема. Кожа расходуется, шапка появляется.