Ежедневный кит с кулдауном

Классический паттерн ежедневного кита: игрок забирает кит, блокируется на 24 часа, потом снова может забрать. Построено на временных переменных (автоистечение через заданный срок), паттерне с двумя предметами (разный вид во время кулдауна) и подстановке шаблонов, чтобы метаданные кита расшаривались между обоими состояниями.

Что показывает пример

Сокращение для временных переменных: setVarp: "name::value::1d" (автоистечение через 1 день)
Плейсхолдер %varpt_:name% для отображения “оставшееся время”
Подстановка шаблона: ${defaultKitTemplate} переиспользуется в состояниях ДОСТУПЕН и КУЛДАУН
Расширение lore: lore: ${defaultKitTemplate.lore} [ ... extra lines ... ] дописывает к lore из шаблона
Правило group: для гейтинга через LuckPerms на VIP-ките

menu.conf
_shared/templates.conf

# Daily Kit with Cooldown - временные переменные + паттерн с двумя предметами
# Docs: https://abstractmenus.github.io/docs/ru/examples/kits-and-rewards/daily-kit-cooldown
# Open: /ame_daily_kit
# Requires: LuckPerms (для правила group на VIP-ките)

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

title: "&6Ежедневные киты"
size: 3
updateInterval: 20

activators {
  command: "ame_daily_kit"
}

# Шаблоны - общие для вариантов "доступен" и "на кулдауне"

defaultKitTemplate {
  slot: 11
  material: WOODEN_SWORD
  name: "&aОбычный кит"
  flags: HIDE_ATTRIBUTES
  lore: [
    "&7В составе:"
    "&7- Кожаный комплект брони"
    "&7- Деревянный меч"
    "&7- 32 жареной говядины"
    "&7- 16 железных слитков"
  ]
}

vipKitTemplate {
  slot: 15
  material: STONE_SWORD
  name: "&6VIP-кит"
  flags: HIDE_ATTRIBUTES
  lore: [
    "&7В составе:"
    "&7- Кожаный комплект брони"
    "&7- Каменный меч"
    "&7- 32 жареной говядины"
    "&7- 32 железных слитка"
    "&7- 4 золотых яблока"
    ""
    "&8Требуется: группа VIP"
  ]
}

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

  # ========== Обычный кит ==========
  # Состояние ДОСТУПЕН: показывается, когда переменная кулдауна не существует. По клику - забрать кит.
  ${defaultKitTemplate} {
    lore: ${defaultKitTemplate.lore} [
      ""
      "&aНажми, чтобы забрать"
    ]
    click {
      actions {
        itemAdd: [
          { material: LEATHER_HELMET }
          { material: LEATHER_CHESTPLATE }
          { material: LEATHER_LEGGINGS }
          { material: LEATHER_BOOTS }
          { material: WOODEN_SWORD }
          { material: COOKED_BEEF, count: 32 }
          { material: IRON_INGOT, count: 16 }
        ]
        # Ставим временную переменную, которая истекает через 1 день - суффикс ::1d.
        setVarp: "ame_kit_default::1::1d"
        sound: ${successSound}
        message: "&aОбычный кит забран. Возвращайся через 24 часа."
        refreshMenu: true
      }
    }
  }
  # Состояние КУЛДАУН: показывается только пока существует временная переменная. Отображает оставшееся время.
  ${defaultKitTemplate} {
    material: GRAY_DYE
    lore: ${defaultKitTemplate.lore} [
      ""
      "&cДоступен через &e%varpt_:ame_kit_default%"
    ]
    rules {
      existVarp: "ame_kit_default"
    }
  }

  # ========== VIP-кит ==========
  ${vipKitTemplate} {
    lore: ${vipKitTemplate.lore} [
      ""
      "&aНажми, чтобы забрать"
    ]
    click {
      rules {
        group: "vip"
      }
      actions {
        itemAdd: [
          { material: LEATHER_HELMET }
          { material: LEATHER_CHESTPLATE }
          { material: LEATHER_LEGGINGS }
          { material: LEATHER_BOOTS }
          { material: STONE_SWORD }
          { material: COOKED_BEEF, count: 32 }
          { material: IRON_INGOT, count: 32 }
          { material: GOLDEN_APPLE, count: 4 }
        ]
        setVarp: "ame_kit_vip::1::1d"
        sound: ${successSound}
        message: "&6VIP-кит забран. Возвращайся через 24 часа."
        refreshMenu: true
      }
      denyActions: ${denyNoPerm}
    }
  }
  ${vipKitTemplate} {
    material: GRAY_DYE
    lore: ${vipKitTemplate.lore} [
      ""
      "&cДоступен через &e%varpt_:ame_kit_vip%"
    ]
    rules {
      existVarp: "ame_kit_vip"
    }
  }

  ${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.

Как работают временные переменные

setVarp: "ame_kit_default::1::1d" парсится так:

Имя переменной: ame_kit_default
Значение: 1 (само значение не используется, важен только факт существования)
Срок: 1d (один день - другие единицы: s, m, h, d, w)

Через 24 часа переменная автоматически удаляется. Правило existVarp после этого даёт false, предмет с кулдауном пропадает, и снова показывается предмет ДОСТУПЕН.

Плейсхолдер %varpt_:ame_kit_default% возвращает оставшееся до истечения время в человекочитаемом виде (“23h 47m” или похожее). Удобно для сообщений “доступно через X”.

Подстановка шаблона + расширение lore

Каждый кит один раз в начале файла определяет свой слот, материал, имя и базовый lore:

defaultKitTemplate {
  slot: 11
  material: WOODEN_SWORD
  name: "&aDefault Kit"
  lore: [ "&7Includes:", "&7- Leather armor set", ... ]
}

Оба предмета - ДОСТУПЕН и КУЛДАУН - ссылаются на этот шаблон:

# ДОСТУПЕН: дополняет lore строкой "Click to claim"
${defaultKitTemplate} {
  lore: ${defaultKitTemplate.lore} [ "", "&aClick to claim" ]
  click { ... claim logic ... }
}

# КУЛДАУН: дополняет lore строкой с оставшимся временем
${defaultKitTemplate} {
  material: GRAY_DYE
  lore: ${defaultKitTemplate.lore} [ "", "&cAvailable in &e%varpt_:ame_kit_default%" ]
  rules { existVarp: "ame_kit_default" }
}

Синтаксис ${defaultKitTemplate.lore} [ ... ]: взять существующий массив lore и дописать в конец новые элементы. Базовый lore не нужно копипастить.

Когда переменной не существует, у предмета КУЛДАУН проваливается правило existVarp, и он не отрисовывается. На его место встаёт предмет ДОСТУПЕН (без правил). Когда переменная есть, отрисовывается КУЛДАУН, а ДОСТУПЕН подавляется по логике конфликта слотов.

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

Чтобы добавить ещё тиры китов:

Добавь блок xxxKitTemplate в начале со своими slot:, material:, name:, базовым lore:.
Добавь предмет ДОСТУПЕН на основе шаблона + click { ... } с содержимым кита и уникальным именем setVarp.
Добавь предмет КУЛДАУН на основе шаблона + rules { existVarp: "..." } с тем же именем переменной.

Для гейтинга по правам на конкретный тир добавь rules { group: "tier_name" } в click-блок (или permission: "..." для более простой проверки).

Попробовать

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

Положи бандл в plugins/AbstractMenus/menus/example/.
/am reload.
Введи /ame_daily_kit в игре.
Забери обычный кит. Предмет станет серым и покажет “Доступен через 23h 59m…”