Главный хаб

Хаб - это просто список кнопок, каждая из которых открывает другое меню. Полезен как главная команда /menu сервера или как способ организовать большой набор подфункций. Этот пример ссылается на остальные меню пака, так что его можно использовать как лаунчер при изучении.

Чему учит

• Действие openMenu - единственное, что делают кнопки
• Простой layout на 3 ряда с рамкой, заголовком и рядом плиток
• Переиспользуемый паттерн для любого UI типа “выбери категорию”

новичок

Фичи: openMenumenu-launcher

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

menu.conf

# Главный хаб - точка входа для примеров пака
# Docs: https://abstractmenus.github.io/docs/ru/examples/hub-and-nav/main-hub
# Открыть: /ame_hub
# Требует: -

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

title: "&6Пак примеров - Главный хаб"
size: 3

activators {
  command: "ame_hub"
}

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

  # Заголовок
  {
    slot: 4
    material: NETHER_STAR
    name: "&6&lПак примеров AbstractMenus"
    lore: ["&7Кликни по плитке, чтобы открыть пример."]
  }

  # Магазины
  {
    slot: 10
    material: CAKE
    name: "&aМагазин тортов"
    lore: ["&7Простой магазин с money + itemAdd.", "", "&8Открывает /ame_cake_shop"]
    click {
      openMenu: "ame_cake_shop"
    }
  }

  {
    slot: 11
    material: BREAD
    name: "&aМагазин с категориями"
    lore: ["&7Хаб + навигация по подменю.", "", "&8Открывает /ame_shop"]
    click {
      openMenu: "ame_shop"
    }
  }

  # Состояние
  {
    slot: 12
    material: BOOK
    name: "&aСчётчик и переключатель"
    lore: ["&7Переменные на игрока в действии.", "", "&8Открывает /ame_counter"]
    click {
      openMenu: "ame_counter"
    }
  }

  # Инфо
  {
    slot: 13
    material: WRITTEN_BOOK
    name: "&aПравила сервера"
    lore: ["&7Меню только для чтения.", "", "&8Открывает /ame_rules"]
    click {
      openMenu: "ame_rules"
    }
  }

  # Киты
  {
    slot: 14
    material: CHEST
    name: "&aБазовый кит"
    lore: ["&7Набор наград в один клик.", "", "&8Открывает /ame_kit"]
    click {
      openMenu: "ame_kit"
    }
  }

  ${buttonClose} { slot: 22 }
]

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

Как работает

Каждая плитка одинаковая по форме: предмет с material:, name:, lore: и click { openMenu: "ame_<имя>" }. Никаких правил, никаких действий кроме навигации, никаких проверок денег. Задача хаба - только диспетчеризация.

Заголовок в слоте 4 чисто декоративный - так же, как в Магазине тортов. Без обработчика клика.

Кастомизация

Чтобы добавить новую плитку:

1. Выбери свободный слот (10-16 в этом layout подходят).
2. Скопируй блок любой плитки.
3. Поменяй material:, name:, lore: и цель openMenu:.

Хаб не зависит от того, какие меню реально существуют. Если плитка указывает на несуществующее меню, клик просто покажет предупреждение “menu not found” - удобно для подготовки будущих меню до их сборки.

Попробовать

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

1. Положи бандл в plugins/AbstractMenus/menus/example/.
2. /am reload.
3. Введи /ame_hub в игре.