Донат-ранги по уровням

Стандартная раскладка донат-магазина: плитки рангов по возрастанию, у каждой два варианта - “Куплено”, если у игрока уже есть нужное право, и цена + список бонусов, если права нет. Сделано на паттерне дублирующих предметов: по одному варианту на каждое состояние ранга.

menu.conf
_shared/templates.conf

# Донат-магазин с уровнями рангов - 4 ранга с двумя вариантами отображения HAS_RANK / NO_RANK
# Docs: https://abstractmenus.github.io/docs/ru/examples/donate/tiered-ranks
# Open: /ame_donate
# Requires: LuckPerms

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

title: "&6Донат-магазин - Ранги"
size: 5

activators {
  command: ["ame_donate", "ame_support"]
}

items: [
  ${borderBlack} { slot: "0-8" }
  ${borderBlack} { slot: "36-44" }

  # Заголовок
  {
    slot: 4
    material: NETHER_STAR
    name: "&6&lПоддержать MyTestServer"
    lore: ["&7Выберите ранг, чтобы узнать подробнее.", "&7Покупка рангов поддерживает сервер."]
  }

  # ========== Knight ==========
  # Вариант HAS_RANK: у игрока уже есть право knight, повторно купить нельзя.
  {
    slot: 19
    material: IRON_SWORD
    name: "&7Knight &8(&aКуплено&8)"
    lore: [
      "&7Ранг поддержки 1 уровня."
      ""
      "&aЭтот ранг уже куплен."
      "&7Подумайте об апгрейде ниже."
    ]
    flags: HIDE_ATTRIBUTES
    rules { permission: "myserver.rank.knight" }
  }
  # Вариант NO_RANK: ранга ещё нет, показываем цену.
  {
    slot: 19
    material: IRON_SWORD
    name: "&7Knight"
    lore: [
      "&7Ранг поддержки 1 уровня."
      ""
      "&7Включает:"
      "&7- &fцветной ник в чате"
      "&7- &f3 точки дома"
      ""
      "&eЦена: &a$5"
      ""
      "&aЛевый клик - подробнее"
    ]
    flags: HIDE_ATTRIBUTES
    click {
      actions {
        # В рабочем варианте здесь открывалось бы меню подтверждения / страница покупки.
        # В этом примере просто выводим сообщение.
        message: "&aОткройте страницу доната https://example.org, чтобы купить Knight."
        sound: ${clickSound}
      }
    }
  }

  # ========== Paladin ==========
  {
    slot: 21
    material: GOLDEN_SWORD
    name: "&6Paladin &8(&aКуплено&8)"
    lore: ["&7Ранг поддержки 2 уровня.", "", "&aЭтот ранг уже куплен."]
    flags: HIDE_ATTRIBUTES
    rules { permission: "myserver.rank.paladin" }
  }
  {
    slot: 21
    material: GOLDEN_SWORD
    name: "&6Paladin"
    lore: [
      "&7Ранг поддержки 2 уровня."
      ""
      "&7Включает:"
      "&7- &fвсё, что у Knight"
      "&7- &f5 точек дома"
      "&7- &f/fly в строительных мирах"
      ""
      "&eЦена: &a$15"
    ]
    flags: HIDE_ATTRIBUTES
    click {
      actions {
        message: "&aОткройте страницу доната https://example.org, чтобы купить Paladin."
        sound: ${clickSound}
      }
    }
  }

  # ========== Lord ==========
  {
    slot: 23
    material: DIAMOND_SWORD
    name: "&bLord &8(&aКуплено&8)"
    lore: ["&7Ранг поддержки 3 уровня.", "", "&aЭтот ранг уже куплен."]
    flags: HIDE_ATTRIBUTES
    rules { permission: "myserver.rank.lord" }
  }
  {
    slot: 23
    material: DIAMOND_SWORD
    name: "&bLord"
    lore: [
      "&7Ранг поддержки 3 уровня."
      ""
      "&7Включает:"
      "&7- &fвсё, что у Paladin"
      "&7- &fкастомные сообщения о входе"
      "&7- &f10 точек дома"
      ""
      "&eЦена: &a$30"
    ]
    flags: HIDE_ATTRIBUTES
    click {
      actions {
        message: "&aОткройте страницу доната https://example.org, чтобы купить Lord."
        sound: ${clickSound}
      }
    }
  }

  # ========== Monarch ==========
  {
    slot: 25
    material: NETHERITE_SWORD
    name: "&dMonarch &8(&aКуплено&8)"
    lore: ["&7Ранг поддержки 4 уровня.", "", "&aЭтот ранг уже куплен."]
    flags: HIDE_ATTRIBUTES
    rules { permission: "myserver.rank.monarch" }
  }
  {
    slot: 25
    material: NETHERITE_SWORD
    name: "&dMonarch"
    lore: [
      "&7Ранг поддержки 4 уровня, самый высокий."
      ""
      "&7Включает:"
      "&7- &fвсё, что у Lord"
      "&7- &fэффект частиц при входе"
      "&7- &fприоритет в очереди при заполнении"
      ""
      "&eЦена: &a$60"
    ]
    flags: HIDE_ATTRIBUTES
    click {
      actions {
        message: "&aОткройте страницу доната https://example.org, чтобы купить Monarch."
        sound: ${clickSound}
      }
    }
  }

  ${buttonClose} { slot: 40 }
]

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

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

Как масштабировать паттерн двух предметов на много уровней
Алиасы команд через command: [..., ...] (так что меню открывают и /ame_donate, и /ame_support)
Список бонусов в lore у каждого ранга
Куда вставить реальную логику покупки (в этом примере просто отправляется сообщение в чат)

Как складываются два варианта

В каждом слоте ранга объявлено по два предмета. Вариант HAS_RANK имеет rules { permission: "myserver.rank.knight" } и показывает “Куплено” + “Подумайте об апгрейде ниже”. Вариант NO_RANK без правил, показывает бонусы и цену.

Правило отрисовки то же, что и у Магазина с проверкой ранга: предметы обходятся в порядке объявления; в каждом слоте отрисовывается первый предмет, у которого правила прошли. HAS_RANK объявлен первым, поэтому если у игрока есть право - выигрывает он.

Как привязать реальную покупку

Настоящие донат-магазины интегрируются с платёжкой. Типичные варианты:

Внешний URL: в click-действии отправляем &aЗайдите на https://example.org/donate, чтобы купить. Игрок покупает на сайте, ранг выдаётся через API.
Внутриигровая валюта: ставим правило money и действие takeMoney, как в обычном магазине, потом выдаём ранг через addGroup: "knight".
Player Points / токены: то же самое, что money, но через другой провайдер. Можно прямо указать провайдера: takeMoney: { amount: 5, provider: "playerpoints" }.

В этом примере используется вариант с URL, потому что он самый универсальный. Заменяйте блок click под свой магазин.

Как добавить пятый уровень

Скопируйте пару (HAS_RANK + NO_RANK) для нового уровня, поменяйте слот на свободную позицию (хорошо подходят слоты 27 или 29 в 4-м ряду), обновите имя права, бонусы и цену.

Как попробовать

Закиньте бандл в plugins/AbstractMenus/menus/example/.
/am reload.
Введите /ame_donate или /ame_support в игре.
Выдайте себе право (например, lp user <you> permission set myserver.rank.knight true), чтобы увидеть вариант HAS_RANK.