Custom Items

Item Definition

A kit's items is a map of named entries. Every property is optional except material.

items:
  sword:
    material: NETHERITE_SWORD
    name: "<gold>VIP Blade"
    lore:
    - "<gray>Forged for champions."
    enchantments:
    - "sharpness:5"
    - "unbreaking:3"
    unbreakable: true
    glow: true
    hide-flags: true
    custom-model-data: 1001
    item-model: "mypack:vip_blade"
  helmet:
    material: LEATHER_HELMET
    leather-color: "#55FF55"
    target: helmet

Key	Description
`material` / `head-texture`	A Bukkit material, or a base64 texture for a custom head
`amount`	Stack size (default 1)
`name` / `lore`	MiniMessage display name and lore lines
`enchantments`	List of `key:level` (e.g. `sharpness:5`) or a map
`custom-model-data` / `item-model`	Resource-pack model data / 1.20.5+ item model key
`unbreakable` / `glow` / `hide-flags` / `flags`	Unbreakable, glint, hide all flags, or specific item flags
`leather-color`	`#RRGGBB` or `R,G,B` for leather armour
`target`	`inventory` (default) · `helmet` · `chestplate` · `leggings` · `boots` · `offhand`
`slot`	A fixed inventory slot (0-35) for inventory-target items

Effects, Commands & Rewards

A kit can grant more than items on claim:

effects:
- "speed:120:1"          # type : durationSeconds : amplifier
- "regeneration:30:0"
commands:
- "broadcast %player% used the VIP kit!"   # console, %player% supported
rewards:
  money: 250
  currency: ""           # "" = Vault, else an XCore currency
  xp: 100
  levels: 2