Энхансер предметов

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

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

Тип правила oneof и его семантику “первое совпадение выигрывает”
Действия per-ветке внутри записей oneof (у каждой записи свой actions {})
Drag-and-drop слоты и правило placedItem для матчинга входа
Сборку drag-and-drop примитивов (placeItem, removePlaced, setButton) в пайплайн трансформации
Шаблоны для переиспользуемых правил и действий (${inputSlotRule}, ${outputAction})

menu.conf
_shared/templates.conf

# Энхансер предметов - drag-and-drop с условной трансформацией через правило oneof
# Docs: https://abstractmenus.github.io/docs/ru/examples/state-and-vars/item-enhancer
# Open: /ame_enhancer
# Requires: -

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

title: "&6Энхансер предметов"
size: 1

activators {
  command: "ame_enhancer"
}

# Слоты 2 (вход) и 6 (результат) - drag-and-drop. Слот 4 - кнопка триггера.
draggable: [
  "--x---x--"
]

# Заглушка для слота результата при открытии меню или невалидном вводе.
resultStub {
  slot: 6
  material: WHITE_STAINED_GLASS_PANE
  name: "&7Результат"
}

# Переиспользуемые блоки
inputSlotRule { slot: 2 }
outputAction  { slot: 6, count: "%changed_item_amount%" }

# Таблица трансформаций: каждая запись связывает правило "положенный предмет совпадает с X"
# с действием, которое выдаёт результат Y. `oneof` короткозамыкается на первом совпадении -
# выигрывает первая подходящая трансформация.
enhanceRules {
  oneof: [
    {
      placedItem: ${inputSlotRule} { material: STONE }
      actions { placeItem: ${outputAction} { material: COAL_ORE } }
    }
    {
      placedItem: ${inputSlotRule} { material: APPLE }
      actions { placeItem: ${outputAction} { material: GOLDEN_APPLE } }
    }
    {
      placedItem: ${inputSlotRule} { material: WOODEN_SWORD }
      actions { placeItem: ${outputAction} { material: DIAMOND_SWORD } }
    }
    {
      placedItem: ${inputSlotRule} { material: WOODEN_AXE }
      actions { placeItem: ${outputAction} { material: DIAMOND_AXE } }
    }
  ]
}

items: [
  # Декоративные стёкла вокруг drag-and-drop слотов
  {
    slot: [ "xx-x-x-x-" ]
    material: BLACK_STAINED_GLASS_PANE
    name: " "
  }

  # Заглушка слота результата по умолчанию
  ${resultStub}

  # Карточка с рецептами
  {
    slot: 8
    material: NAME_TAG
    name: "&aРецепты"
    lore: [
      "&fКамень &7-> &bУгольная руда"
      "&fЯблоко &7-> &bЗолотое яблоко"
      "&fДеревянный меч &7-> &bАлмазный меч"
      "&fДеревянный топор &7-> &bАлмазный топор"
    ]
  }

  # Кнопка "Улучшить!"
  {
    slot: 4
    material: NETHER_STAR
    name: "&bУлучшить!"
    click {
      rules: ${enhanceRules}
      actions {
        removePlaced: 2
        sound: ${successSound}
      }
      denyActions {
        rules {
          placedItem { slot: 6, material: AIR }
        }
        actions {
          setButton: ${resultStub}
          sound: ${deniedSound}
        }
      }
    }
  }
]

# 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

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

Почему state-and-vars?

Этот пример лежит в state-and-vars, потому что drag-and-drop сама по себе - форма состояния меню: предметы, физически лежащие в слотах 2 и 6, это сессионные “переменные” меню. setVar/setVarp тут не используются, но концептуальный паттерн (читать состояние слота, ветвиться по нему, мутировать его) тот же.

Как работает `oneof`

oneof - логическая обёртка-правило, принимающая список записей. Она проходит список сверху вниз и останавливается на первой, чьё собственное правило совпадает. Блок actions {} совпавшей записи и выполняется.

oneof: [
  { placedItem: { slot: 2, material: STONE }, actions { placeItem: { ..., material: COAL_ORE } } }
  { placedItem: { slot: 2, material: APPLE }, actions { placeItem: { ..., material: GOLDEN_APPLE } } }
  ...
]

Если ни одна запись не совпала, весь oneof возвращает false. Внешний click тогда выполняет denyActions вместо успешной ветки.

Чище, чем вложенные if/and/or, для switch-подобной логики.

Добавить новый рецепт

Допишите в список oneof внутри enhanceRules:

{ placedItem: ${inputSlotRule} { material: COAL }
  actions { placeItem: ${outputAction} { material: DIAMOND } } }

Подстановки ${inputSlotRule} и ${outputAction} держат номера слотов в одном месте - если переразметите меню, поменяются только два якорных блока, а не каждая запись рецепта.

Попробовать

После установки example pack:

Положите бандл в plugins/AbstractMenus/menus/example/.
/am reload.
Введите /ame_enhancer в игре.
Перетащите блок камня в левый слот.
Кликните “Улучшить!”. В правом слоте появится угольная руда.