FAQ

FAQ по сути - дерево навигации: список вопросов в корне, под каждый ответ - своё подменю. В этом примере используется блок menus { ... } с несколькими меню в одном файле, чтобы держать все четыре экрана в одном конфиге, а связи между ними - через вызовы openMenu. Общий шаблон ${buttonBack} получает переопределение на каждой странице, чтобы вести обратно на главную FAQ.

menu.conf
_shared/templates.conf

# FAQ - меню-хаб с вопросами, по клику открывается ответ в подменю
# Документация: https://abstractmenus.github.io/docs/ru/examples/info-pages/faq
# Открыть: /ame_faq
# Требует: -

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

menus {

  # Главная страница FAQ - список вопросов
  ame_faq {
    title: "&6Часто задаваемые вопросы"
    size: 3

    activators {
      command: "ame_faq"
    }

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

      {
        slot: 4
        material: WRITTEN_BOOK
        name: "&6&lFAQ"
        lore: ["&7Кликните по любому вопросу, чтобы увидеть ответ."]
      }

      {
        slot: 10
        material: PAPER
        name: "&aКак приватизировать территорию?"
        click { openMenu: "ame_faq_a1" }
      }
      {
        slot: 12
        material: PAPER
        name: "&aЧто даёт VIP?"
        click { openMenu: "ame_faq_a2" }
      }
      {
        slot: 14
        material: PAPER
        name: "&aКак пожаловаться на игрока?"
        click { openMenu: "ame_faq_a3" }
      }
      {
        slot: 16
        material: PAPER
        name: "&aГде найти правила сервера?"
        click { openMenu: "ame_rules" }
      }

      ${buttonClose} { slot: 22 }
    ]
  }

  # Ответ 1 - Приватизация территории
  ame_faq_a1 {
    title: "&6FAQ - Приватизация"
    size: 3
    items: [
      ${borderBlack} { slot: "0-8" }
      ${borderBlack} { slot: "18-26" }
      {
        slot: 13
        material: GRASS_BLOCK
        name: "&aКак приватизировать территорию?"
        lore: [
          "&7Используйте золотую лопату,"
          "&7чтобы отметить углы участка."
          ""
          "&7- ПКМ по первому углу"
          "&7- ПКМ по противоположному углу"
          ""
          "&7Каждый блок стоит 1 единицу приватизации."
          "&7Получайте больше за игру или покупайте"
          "&7через /buyclaimblocks."
        ]
      }
      ${buttonBack} { slot: 18, click { openMenu: "ame_faq" } }
    ]
  }

  # Ответ 2 - Привилегии VIP
  ame_faq_a2 {
    title: "&6FAQ - Привилегии VIP"
    size: 3
    items: [
      ${borderBlack} { slot: "0-8" }
      ${borderBlack} { slot: "18-26" }
      {
        slot: 13
        material: GOLDEN_HELMET
        name: "&6Что даёт VIP?"
        lore: [
          "&7VIP включает:"
          ""
          "&7- &fцветной ник в чате"
          "&7- &f5 точек дома (вместо 1 базовой)"
          "&7- &fежедневный VIP-кит"
          "&7- &f50% скидку в магазине"
          "&7- &fэффект частиц при заходе"
          ""
          "&7Получите VIP в &e/ame_donate&7."
        ]
      }
      ${buttonBack} { slot: 18, click { openMenu: "ame_faq" } }
    ]
  }

  # Ответ 3 - Жалобы на игроков
  ame_faq_a3 {
    title: "&6FAQ - Жалобы"
    size: 3
    items: [
      ${borderBlack} { slot: "0-8" }
      ${borderBlack} { slot: "18-26" }
      {
        slot: 13
        material: BARRIER
        name: "&cЖалобы на игроков"
        lore: [
          "&7Используйте &e/report <ник> <причина>&7"
          "&7или напишите в нашем Discord:"
          "&7&fhttps://discord.gg/example"
          ""
          "&7По возможности прикладывайте скриншоты."
          "&7Модерация отвечает в течение нескольких часов."
        ]
      }
      ${buttonBack} { slot: 18, click { openMenu: "ame_faq" } }
    ]
  }

}

# 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 { ... }, чтобы объявить хаб и несколько экранов с ответами в одном файле
Переопределение полей общего шаблона на месте использования - ${buttonBack} { slot: 18, click { openMenu: "..." } }
Паттерн “страница ответа”: крупный предмет с lore + кнопка “Назад”, больше никакой интерактивности
Один из вопросов ведёт в другое существующее меню (вопрос про правила открывает меню Правила сервера)

Почему FAQ удобно держать в одном файле с несколькими меню

FAQ из 10 вопросов в виде 10 отдельных файлов - неаккуратно: 10 путей, 10 строк include под общие шаблоны. Если собрать их в одном блоке menus { ... }, связанные экраны лежат вместе, а редактирование FAQ становится операцией над одним файлом.

Соглашение об именах важно: каждое меню получает уникальное имя в пределах сервера. Берите ame_faq, ame_faq_a1, ame_faq_a2 и т.д., чтобы не пересечься с другими меню из примеров или собственными конфигами пользователя.

Переопределение `${buttonBack}`

Общий шаблон buttonBack определяет стрелку с closeMenu: true. В FAQ нам нужно вместо этого вернуться на главную. Переопределим блок click на месте использования:

${buttonBack} { slot: 18, click { openMenu: "ame_faq" } }

${buttonBack} приносит материал, имя и lore. Переопределение заменяет блок click. Тот же паттерн работает для любого общего шаблона, который нужно специализировать под конкретное место использования.

Добавить вопрос

Две правки на новый вопрос:

В список items меню ame_faq добавьте бумажную плитку, ведущую на имя нового меню с ответом.
Добавьте новый блок ame_faq_aN в конец обёртки menus { ... } с содержимым ответа.

Попробовать

Закиньте бандл в plugins/AbstractMenus/menus/example/.
/am reload.
Введите /ame_faq в игре.
Кликните по любому вопросу. Прочитайте ответ. Кликните стрелку “Назад”, чтобы вернуться.

FAQ

Чему учит

Почему FAQ удобно держать в одном файле с несколькими меню

Переопределение ${buttonBack}

Добавить вопрос

Попробовать

Переопределение `${buttonBack}`