Basic Kit

The simplest reward menu shape: a description card, a claim button, and a close button. Click the claim button to get a bundle of items, some XP, a sound effect, and a confirmation message.

What it teaches

• Multiple actions in sequence inside one click { actions { ... } } block
• The list-form of itemAdd: to give several items at once
• giveXp action for vanilla XP points
• Delayed closeMenu: 20 (close after 20 ticks = 1 second, so the player sees the success message before the menu closes)

beginner

Features: itemAddgiveXpsoundmessagecloseMenu-delay

Open: /ame_kit Copy

menu.conf

# Basic Kit - one-click reward bundle
# Docs: https://abstractmenus.github.io/docs/en/examples/kits-and-rewards/basic-kit
# Open: /ame_kit
# Requires: -

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

title: "&6Starter Kit"
size: 3

activators {
  command: "ame_kit"
}

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

  # Description card
  {
    slot: 4
    material: PAPER
    name: "&6&lStarter Kit"
    lore: [
      "&7Get a one-time bundle of starter items"
      "&7and 50 XP to begin your adventure."
      ""
      "&eContents:"
      "&7- Iron Sword"
      "&7- Iron Pickaxe"
      "&7- Bread x16"
      "&7- 50 XP"
    ]
  }

  # Claim button
  {
    slot: 13
    material: CHEST
    name: "&aClaim Kit"
    lore: [
      "&7Click to receive your kit."
    ]
    click {
      actions {
        itemAdd: [
          { material: IRON_SWORD }
          { material: IRON_PICKAXE }
          { material: BREAD, count: 16 }
        ]
        giveXp: 50
        sound: ${successSound}
        message: "&aYou claimed the Starter Kit!"
        closeMenu: 20
      }
    }
  }

  ${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 it works

The claim button’s click block runs five actions in order:

1. itemAdd: [ ... ] - the list form lets multiple items go into the player’s inventory in one shot.
2. giveXp: 50 - adds 50 XP via the configured levels provider (vanilla XP by default).
3. sound: ${successSound} - plays a success chime from shared templates.
4. message: - confirmation in chat.
5. closeMenu: 20 - close after 20 ticks (1 second). Using a number instead of true adds the delay so the player perceives the actions completing.

There are no cooldown checks here. Anyone can keep clicking and keep getting kits. To gate this with a cooldown, see the daily kit example which adds a setVarp timestamp + an if rule comparing it to the current time.

Customizing

Swap any item in the itemAdd list with the materials you want. Add as many entries as you need. The count: field is optional - default is 1.

For enchanted items, an enchantments field on the item works too:

itemAdd: [
  {
    material: DIAMOND_SWORD
    enchantments {
      sharpness: 5
      unbreaking: 3
    }
  }
]

Try it

After installing the example pack:

1. Drop the bundle into plugins/AbstractMenus/menus/example/.
2. /am reload.
3. Type /ame_kit in-game.