Магазин по категориям

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

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

Файлы с несколькими меню через обёртку menus { ... }
Навигацию между меню через openMenu
Повторение паттерна покупки по категориям без дублирования кода
Сочетание статических рамок и предметов магазина
Шорткат flags: HIDE_ATTRIBUTES для иконок инструментов и оружия

menu.conf
_shared/templates.conf

# Multi-Category Shop - паттерн навигации хаб + подмагазины
# Docs: https://abstractmenus.github.io/docs/ru/examples/shops/paginated-shop
# Open: /ame_shop
# Requires: Vault

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

menus {

  # Главный хаб: открывается по /ame_shop. Плитки ведут в подмагазины.
  ame_shop {
    title: "&6Магазин предметов"
    size: 1

    activators {
      command: "ame_shop"
    }

    items: [
      {
        slot: 2
        material: BREAD
        name: "&aЕда"
        lore: ["&7Хлеб, яблоки, золотая морковь."]
        click {
          openMenu: "ame_shop_food"
        }
      }
      {
        slot: 6
        material: IRON_PICKAXE
        name: "&aИнструменты"
        lore: ["&7Кирки, топоры, лопаты."]
        flags: HIDE_ATTRIBUTES
        click {
          openMenu: "ame_shop_tools"
        }
      }
      ${buttonClose} { slot: 8 }
    ]
  }

  # Подмагазин еды: 4 предмета, демонстрация паттерна покупки.
  # Паттерн повторяется для любой другой категории - просто копируйте это меню и меняйте предметы.
  ame_shop_food {
    title: "&6Магазин > Еда"
    size: 3

    items: [
      ${borderBlack} { slot: "0-8" }
      ${borderBlack} { slot: "18-25" }

      {
        slot: 10
        material: APPLE
        count: 16
        name: "&aЯблоко x16"
        lore: ["", "&eЦена: &a$50", "", "&8Кликните, чтобы купить"]
        click {
          rules { money: 50 }
          actions {
            takeMoney: 50
            itemAdd { material: APPLE, count: 16 }
            sound: ${successSound}
          }
          denyActions: ${denyNoMoney}
        }
      }
      {
        slot: 12
        material: BREAD
        count: 8
        name: "&aХлеб x8"
        lore: ["", "&eЦена: &a$60", "", "&8Кликните, чтобы купить"]
        click {
          rules { money: 60 }
          actions {
            takeMoney: 60
            itemAdd { material: BREAD, count: 8 }
            sound: ${successSound}
          }
          denyActions: ${denyNoMoney}
        }
      }
      {
        slot: 14
        material: COOKED_BEEF
        count: 8
        name: "&aСтейк x8"
        lore: ["", "&eЦена: &a$120", "", "&8Кликните, чтобы купить"]
        click {
          rules { money: 120 }
          actions {
            takeMoney: 120
            itemAdd { material: COOKED_BEEF, count: 8 }
            sound: ${successSound}
          }
          denyActions: ${denyNoMoney}
        }
      }
      {
        slot: 16
        material: GOLDEN_CARROT
        count: 4
        name: "&6Золотая морковь x4"
        lore: ["", "&eЦена: &a$300", "", "&8Кликните, чтобы купить"]
        click {
          rules { money: 300 }
          actions {
            takeMoney: 300
            itemAdd { material: GOLDEN_CARROT, count: 4 }
            sound: ${successSound}
          }
          denyActions: ${denyNoMoney}
        }
      }

      # Назад в главный хаб
      {
        slot: 26
        material: ARROW
        name: "&eНазад"
        lore: ["&7Вернуться в главное меню магазина"]
        click {
          openMenu: "ame_shop"
        }
      }
    ]
  }

  # Подмагазин инструментов: 3 предмета, демонстрация флагов и более высоких цен.
  ame_shop_tools {
    title: "&6Магазин > Инструменты"
    size: 3

    items: [
      ${borderBlack} { slot: "0-8" }
      ${borderBlack} { slot: "18-25" }

      {
        slot: 11
        material: STONE_PICKAXE
        name: "&aКаменная кирка"
        lore: ["", "&eЦена: &a$200", "", "&8Кликните, чтобы купить"]
        flags: HIDE_ATTRIBUTES
        click {
          rules { money: 200 }
          actions {
            takeMoney: 200
            itemAdd { material: STONE_PICKAXE }
            sound: ${successSound}
          }
          denyActions: ${denyNoMoney}
        }
      }
      {
        slot: 13
        material: IRON_PICKAXE
        name: "&aЖелезная кирка"
        lore: ["", "&eЦена: &a$800", "", "&8Кликните, чтобы купить"]
        flags: HIDE_ATTRIBUTES
        click {
          rules { money: 800 }
          actions {
            takeMoney: 800
            itemAdd { material: IRON_PICKAXE }
            sound: ${successSound}
          }
          denyActions: ${denyNoMoney}
        }
      }
      {
        slot: 15
        material: DIAMOND_PICKAXE
        name: "&bАлмазная кирка"
        lore: ["", "&eЦена: &a$3000", "", "&8Кликните, чтобы купить"]
        flags: HIDE_ATTRIBUTES
        click {
          rules { money: 3000 }
          actions {
            takeMoney: 3000
            itemAdd { material: DIAMOND_PICKAXE }
            sound: ${successSound}
          }
          denyActions: ${denyNoMoney}
        }
      }

      {
        slot: 26
        material: ARROW
        name: "&eНазад"
        lore: ["&7Вернуться в главное меню магазина"]
        click {
          openMenu: "ame_shop"
        }
      }
    ]
  }

}

# 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.

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

В файле через обёртку menus { ... } объявлены три именованных меню:

ame_shop - главный хаб. На нём активатор command: "ame_shop", показывает плитки категорий.
ame_shop_food и ame_shop_tools - подмагазины, открывающиеся из хаба.

Каждая плитка в хабе - это просто предмет с click { openMenu: "ame_shop_food" }. Никаких правил на деньги, никаких action’ов помимо самой навигации. Подмагазины открываются по имени.

Внутри подмагазина предметы построены по тому же паттерну, что и в магазине тортов: rules { money: ... }, блок actions {}, который списывает деньги и выдаёт предмет, и denyActions: ${denyNoMoney} из общих шаблонов на случай отказа.

Кнопка “назад” использует openMenu: "ame_shop", чтобы вернуться в хаб. Встроенного “назад” нет. Навигация по меню - это просто вызов openMenu с именем предыдущего меню.

Масштабирование

Добавление новой категории - механическое:

Добавьте новую плитку в список items хаба с click { openMenu: "ame_shop_<your_category>" }.
Скопируйте любой блок подмагазина (например, ame_shop_food), переименуйте в ame_shop_<your_category>, замените предметы.
Перезагрузите меню через /am reload.

Попробовать

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

Закиньте бандл в plugins/AbstractMenus/menus/example/.
/am reload.
Введите /ame_shop в игре.

Дальше

Магазин тортов - самый простой одностраничный магазин.
Документация по генерации - пагинация по динамическому каталогу (когда предметы приходят из кода - например, онлайн-игроки или миры).