Магазин с проверкой ранга

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

menu.conf
_shared/templates.conf

# Rank-Gated Shop - паттерн отображения двух вариантов HAS/NO_PERM
# Docs: https://abstractmenus.github.io/docs/ru/examples/shops/rank-gated-shop
# Open: /ame_rank_shop
# Requires: Vault, LuckPerms (или любой провайдер прав)

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

title: "&6Магазин с проверкой ранга"
size: 3

activators {
  command: "ame_rank_shop"
}

# Переиспользуемый обработчик клика для VIP-скидки - списывает сниженную цену.
discountClick {
  rules { money: 50 }
  actions {
    takeMoney: 50
    itemAdd { material: GOLDEN_APPLE }
    sound: ${successSound}
    message: "&aКуплено со скидкой VIP."
  }
  denyActions: ${denyNoMoney}
}

# Переиспользуемый обработчик клика для обычной цены.
regularClick {
  rules { money: 100 }
  actions {
    takeMoney: 100
    itemAdd { material: GOLDEN_APPLE }
    sound: ${successSound}
    message: "&aКуплено по обычной цене."
  }
  denyActions: ${denyNoMoney}
}

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

  # ========== Золотое яблоко - два варианта по правилу VIP ==========

  # VIP-вариант: со скидкой, виден только VIP-игрокам.
  {
    slot: 13
    material: GOLDEN_APPLE
    name: "&6Золотое яблоко &8(&aцена VIP&8)"
    lore: [
      "&7Премиальный фрукт."
      ""
      "&eЦена: &a$50 &m$100"
      "&8(скидка VIP 50%)"
      ""
      "&aКликните, чтобы купить"
    ]
    rules { permission: "abstractmenus.vip" }
    click: ${discountClick}
  }

  # Обычный вариант: полная цена, показывается всем остальным (без правил = всегда видим,
  # но VIP-вариант перекрывает его, когда правило VIP проходит).
  {
    slot: 13
    material: GOLDEN_APPLE
    name: "&6Золотое яблоко"
    lore: [
      "&7Премиальный фрукт."
      ""
      "&eЦена: &a$100"
      ""
      "&aКликните, чтобы купить"
      "&8Ранг VIP даёт скидку 50%."
    ]
    click: ${regularClick}
  }

  ${buttonClose} { slot: 22 }
]

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

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

Паттерн с двумя предметами в одном слоте и правилом на право
Цены по рангам без сложных правил if
Переиспользуемые обработчики кликов через подстановки ${discountClick} / ${regularClick}
Как взаимодействуют короткое замыкание правил и порядок объявления слотов

Как работают два предмета в одном слоте

В одном слоте объявлены два предмета:

# Вариант A: показывается только VIP
{ slot: 13, name: "Golden Apple (VIP price)", rules { permission: "...vip" }, click: ${discountClick} }

# Вариант B: фолбэк для всех остальных
{ slot: 13, name: "Golden Apple",                                               click: ${regularClick} }

Когда меню рендерится, плагин проходит по списку предметов. Для слота 13 он находит вариант A, проверяет его правила и:

Использует A, если правило прошло (VIP видит вариант со скидкой)
Пропускает A и ищет следующее объявление для слота 13. Находит B. У B правил нет. Рендерится B.

Это БОЕВОЙ паттерн с реальных магазинов. Масштабируется на много рангов (4-уровневые донат-магазины и т.д.) - по одному варианту на ранг, в порядке приоритета, с самым высоким рангом в правиле первым.

Почему это лучше `if` для проверки рангов

Правило if могло бы выразить ту же логику, но добавило бы две проблемы:

Сам отображаемый предмет не менялся бы - менялось бы только действие на клик. Для визуального различия всё равно нужны два предмета.
if парсится как выражение на каждом рендере. Два предмета по правам обходятся дешевле.

if нужен, когда сравниваете числовые/строковые значения, которые нельзя выразить встроенным правилом (математика по уровню, кастомные значения переменных). Для “игрок в ранге X” - паттерн с двумя предметами и правом.

Расширение на больше уровней

Добавляйте варианты в порядке приоритета. Mythic > Donor > VIP > обычный:

{ slot: 13, ..., rules { permission: "myplugin.mythic" }, click: ${mythicClick} }
{ slot: 13, ..., rules { permission: "myplugin.donor"  }, click: ${donorClick}  }
{ slot: 13, ..., rules { permission: "myplugin.vip"    }, click: ${vipClick}    }
{ slot: 13, ..., click: ${regularClick} }   # фолбэк - без правил

Порядок важен: ранг с самым высоким приоритетом - первым. Побеждает первый подходящий вариант.

Магазин с проверкой ранга

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

Как работают два предмета в одном слоте

Почему это лучше if для проверки рангов

Расширение на больше уровней

Почему это лучше `if` для проверки рангов