Tiered Kits

A simpler counterpart to Daily Kit with Cooldown. Same tier idea (default / VIP / Elite) but no temporal-var lockout - the kits can be claimed any time. Useful for “starter packs” or “always-available perks for premium ranks”.

intermediate

Features: itemAdd-listpermission-ruledenyActions-substitutionno-cooldown

Requires: LuckPerms

Open: /ame_kit_tiers Copy

menu.conf

# Tiered Kits - 3 kit tiers gated by permission, no cooldown
# Docs: https://abstractmenus.github.io/docs/en/examples/kits-and-rewards/tiered-kits
# Open: /ame_kit_tiers
# Requires: LuckPerms

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

title: "&6Tiered Kits"
size: 3

activators {
  command: "ame_kit_tiers"
}

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

  # ========== Default kit (everyone) ==========
  {
    slot: 11
    material: WOODEN_SWORD
    name: "&7Default Kit"
    flags: HIDE_ATTRIBUTES
    lore: [
      "&7Includes:"
      "&7- Wooden sword"
      "&7- 8 bread"
      ""
      "&aFree for everyone"
      "&aClick to claim"
    ]
    click {
      actions {
        itemAdd: [
          { material: WOODEN_SWORD }
          { material: BREAD, count: 8 }
        ]
        sound: ${successSound}
        message: "&aDefault kit claimed."
      }
    }
  }

  # ========== VIP kit (permission-gated) ==========
  {
    slot: 13
    material: STONE_SWORD
    name: "&6VIP Kit"
    flags: HIDE_ATTRIBUTES
    lore: [
      "&7Includes:"
      "&7- Stone sword"
      "&7- Iron armor (full set)"
      "&7- 16 bread, 4 golden apples"
      ""
      "&8Requires: VIP rank"
      "&aClick to claim"
    ]
    click {
      rules { permission: "abstractmenus.vip" }
      actions {
        itemAdd: [
          { material: STONE_SWORD }
          { material: IRON_HELMET }
          { material: IRON_CHESTPLATE }
          { material: IRON_LEGGINGS }
          { material: IRON_BOOTS }
          { material: BREAD, count: 16 }
          { material: GOLDEN_APPLE, count: 4 }
        ]
        sound: ${successSound}
        message: "&6VIP kit claimed."
      }
      denyActions: ${denyNoPerm}
    }
  }

  # ========== Elite kit (higher permission) ==========
  {
    slot: 15
    material: DIAMOND_SWORD
    name: "&dElite Kit"
    flags: HIDE_ATTRIBUTES
    lore: [
      "&7Includes:"
      "&7- Diamond sword"
      "&7- Diamond armor (full set)"
      "&7- 32 bread, 8 enchanted golden apples"
      ""
      "&8Requires: Elite rank"
      "&aClick to claim"
    ]
    click {
      rules { permission: "abstractmenus.elite" }
      actions {
        itemAdd: [
          { material: DIAMOND_SWORD }
          { material: DIAMOND_HELMET }
          { material: DIAMOND_CHESTPLATE }
          { material: DIAMOND_LEGGINGS }
          { material: DIAMOND_BOOTS }
          { material: BREAD, count: 32 }
          { material: ENCHANTED_GOLDEN_APPLE, count: 8 }
        ]
        sound: ${successSound}
        message: "&dElite kit claimed."
      }
      denyActions: ${denyNoPerm}
    }
  }

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

What it teaches

• Click-level permission gates with rules { permission: "..." }
• Composing denyActions: ${denyNoPerm} from shared templates for the rejection
• The itemAdd: [ ... ] list form for delivering a multi-item bundle

Why no dual-item display here?

This menu shows ALL three kits to everyone. The VIP and Elite kits are visible regardless of whether the player can claim them - the rule check happens on click, not on display. If a regular player clicks VIP, they hit denyActions and see the “no permission” message.

This is intentional UX. Players see what they could unlock - it’s a soft sales pitch for the donate ranks. The dual-item pattern (hide locked tiles entirely) is what Tiered Donate Ranks uses; pick whichever fits your server.

Add a tier

Copy any kit block, change the slot, name, lore, permission node, and itemAdd contents. For more visual variety, swap material: per tier (NETHERITE_SWORD for Mythic etc.).

Try it

1. Drop the bundle into plugins/AbstractMenus/menus/example/.
2. /am reload.
3. Type /ame_kit_tiers in-game.
4. The Default kit works for anyone. Grant yourself abstractmenus.vip or abstractmenus.elite to claim the others.