Daily Kit with Cooldown

The classic daily kit pattern: a player claims a kit, gets locked out for 24 hours, then can claim again. Built with temporal variables (auto-expire after a duration), the dual-item pattern (different visual when on cooldown), and template substitution to share kit metadata between both states.

What it teaches

• The temporal variable shorthand: setVarp: "name::value::1d" (auto-expires after 1 day)
• The %varpt_:name% placeholder for “time remaining” display
• Template substitution: ${defaultKitTemplate} reused across READY and COOLDOWN states
• Lore extension: lore: ${defaultKitTemplate.lore} [ ... extra lines ... ] appends to the template’s lore
• The group: rule for LuckPerms-based gating on the VIP kit

advanced

Features: setVarp-temporalexistVarpvarpt-placeholdergroup-ruletemplate-substitutionlore-extensiondual-item-display

Requires: LuckPerms

Open: /ame_daily_kit Copy

menu.conf

# Daily Kit with Cooldown - temporal vars + dual-item pattern
# Docs: https://abstractmenus.github.io/docs/en/examples/kits-and-rewards/daily-kit-cooldown
# Open: /ame_daily_kit
# Requires: LuckPerms (for group rule on the VIP kit)

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

title: "&6Daily Kits"
size: 3
updateInterval: 20

activators {
  command: "ame_daily_kit"
}

# Template definitions - shared between the "ready" and "on cooldown" item variants

defaultKitTemplate {
  slot: 11
  material: WOODEN_SWORD
  name: "&aDefault Kit"
  flags: HIDE_ATTRIBUTES
  lore: [
    "&7Includes:"
    "&7- Leather armor set"
    "&7- Wooden sword"
    "&7- 32 cooked beef"
    "&7- 16 iron ingots"
  ]
}

vipKitTemplate {
  slot: 15
  material: STONE_SWORD
  name: "&6VIP Kit"
  flags: HIDE_ATTRIBUTES
  lore: [
    "&7Includes:"
    "&7- Leather armor set"
    "&7- Stone sword"
    "&7- 32 cooked beef"
    "&7- 32 iron ingots"
    "&7- 4 golden apples"
    ""
    "&8Requires: VIP group"
  ]
}

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

  # ========== Default kit ==========
  # READY state: shown when no cooldown variable exists. Clicking claims the kit.
  ${defaultKitTemplate} {
    lore: ${defaultKitTemplate.lore} [
      ""
      "&aClick to claim"
    ]
    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 }
        ]
        # Set a temporal var that expires after 1 day - the ::1d suffix.
        setVarp: "ame_kit_default::1::1d"
        sound: ${successSound}
        message: "&aDefault kit claimed. Come back in 24 hours."
        refreshMenu: true
      }
    }
  }
  # COOLDOWN state: shown only while the temporal var exists. Displays time remaining.
  ${defaultKitTemplate} {
    material: GRAY_DYE
    lore: ${defaultKitTemplate.lore} [
      ""
      "&cAvailable in &e%varpt_:ame_kit_default%"
    ]
    rules {
      existVarp: "ame_kit_default"
    }
  }

  # ========== VIP kit ==========
  ${vipKitTemplate} {
    lore: ${vipKitTemplate.lore} [
      ""
      "&aClick to claim"
    ]
    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 kit claimed. Come back in 24 hours."
        refreshMenu: true
      }
      denyActions: ${denyNoPerm}
    }
  }
  ${vipKitTemplate} {
    material: GRAY_DYE
    lore: ${vipKitTemplate.lore} [
      ""
      "&cAvailable in &e%varpt_:ame_kit_vip%"
    ]
    rules {
      existVarp: "ame_kit_vip"
    }
  }

  ${buttonClose} { slot: 22 }
]

_shared/templates.conf

# AbstractMenus example pack - shared templates
# Reusable HOCON snippets referenced from menus via ${blockName} substitution.
# Docs: https://abstractmenus.github.io/docs/en/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: "&cYou don't have enough money."
}
denyNoPerm {
  sound:   ${deniedSound}
  message: "&cYou don't have permission."
}
denyCooldown {
  sound:   ${deniedSound}
  message: "&cYou're on cooldown. Try again later."
}

# 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: "&cClose"
  click {
    closeMenu: true
  }
}
buttonBack {
  material: ARROW
  name: "&eBack"
  lore: ["&7Return to previous menu"]
  click {
    closeMenu: true
  }
}
buttonNext {
  material: ARROW
  name: "&eNext page"
  click {
    pageNext: 1
  }
}
buttonPrev {
  material: ARROW
  name: "&ePrevious page"
  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&lExample Menu"
  lore: ["&7Welcome to the AbstractMenus example pack"]
}

↓ menu.conf ↓ Bundle (.zip)

Bundle includes _shared/templates.conf and INSTALL.txt.

How temporal variables work

setVarp: "ame_kit_default::1::1d" parses as:

• Variable name: ame_kit_default
• Value: 1 (we don’t use the value, just the existence)
• Duration: 1d (one day - other units: s, m, h, d, w)

After 24 hours, the variable is auto-removed. The existVarp rule then evaluates to false, the cooldown item disappears, and the READY item shows again.

The %varpt_:ame_kit_default% placeholder returns the time-to-expire as a human-readable string (“23h 47m” or similar). Useful for showing “available in X” messages.

Template substitution + lore extension

Each kit defines its slot, material, name, and base lore once at the top of the file:

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

Both the READY and the COOLDOWN item references this template:

# READY: extends lore with a "Click to claim" line
${defaultKitTemplate} {
  lore: ${defaultKitTemplate.lore} [ "", "&aClick to claim" ]
  click { ... claim logic ... }
}

# COOLDOWN: extends lore with the time-remaining line
${defaultKitTemplate} {
  material: GRAY_DYE
  lore: ${defaultKitTemplate.lore} [ "", "&cAvailable in &e%varpt_:ame_kit_default%" ]
  rules { existVarp: "ame_kit_default" }
}

The ${defaultKitTemplate.lore} [ ... ] syntax: take the existing lore array, append the new entries. No copy-paste of the base lore.

When the var doesn’t exist, the COOLDOWN item’s existVarp rule fails, so it doesn’t render. The READY item (no rules) takes its place. When the var exists, COOLDOWN renders, READY is suppressed by the dual-slot tie-breaker.

Customizing

Add more kit tiers by:

1. Add a xxxKitTemplate block at the top with slot:, material:, name:, base lore:.
2. Add a READY item using the template + click { ... } with the kit contents and a unique setVarp name.
3. Add a COOLDOWN item using the template + rules { existVarp: "..." } with the matching var name.

For per-tier permission gates, add rules { group: "tier_name" } to the click block (or use permission: "..." for a simpler check).

Try it

After installing the example pack:

1. Drop the bundle into plugins/AbstractMenus/menus/example/.
2. /am reload.
3. Type /ame_daily_kit in-game.
4. Claim the default kit. The item turns gray and shows “Available in 23h 59m…”