Custom Items

Item Configuration

Complete reference for all item configuration options.

Basic Properties

Property	Type	Required	Description
material	String	Yes	Minecraft material name (e.g., DIAMOND_SWORD)
name	String	No	Display name (supports color codes)
displayName	String	No	Alternative to name
lore	List	No	Item lore lines
amount	Integer	No	Stack size (default: 1)

example_item:
  material: DIAMOND_SWORD
  name: "&b&lDiamond Sword"
  lore:
    - "&7A powerful weapon"
    - ""
    - "&eClick to purchase!"
  amount: 1

Shop Properties

Property	Type	Description
slot	Integer	Inventory slot position (0-53)
page	Integer	Page number (default: 1)
price	Integer	Cost in shards
commands	List	Commands executed on purchase
CommandType	String	Command executor: PLAYER, CONSOLE, or BUNGEE
permission	String	Permission required to purchase

vip_rank:
  material: NETHER_STAR
  name: "&6&lVIP Rank"
  lore:
    - "&7Get VIP privileges!"
    - "&7Price: &a1000 Shards"
  slot: 13
  page: 1
  price: 1000
  permission: "shop.buy.vip"
  CommandType: CONSOLE
  commands:
    - "lp user %player% parent set vip"
    - "broadcast &a%player% purchased VIP!"

Visual Properties

Property	Type	Description
glow	Boolean	Add enchantment glow effect
unbreakable	Boolean	Make item unbreakable
damage	Integer	Durability damage value
custom-model-data	Integer	Custom model data for resource packs

glowing_item:
  material: DIAMOND
  name: "&bGlowing Diamond"
  glow: true
  unbreakable: true
  custom-model-data: 1001

Item Flags

Hide specific item attributes:

flags:
  - HIDE_ATTRIBUTES      # Hide attack damage, armor, etc.
  - HIDE_ENCHANTS        # Hide enchantment list
  - HIDE_UNBREAKABLE     # Hide "Unbreakable" text
  - HIDE_DESTROYS        # Hide "Can destroy" list
  - HIDE_PLACED_ON       # Hide "Can be placed on" list
  - HIDE_POTION_EFFECTS  # Hide potion effects
  - HIDE_DYE             # Hide dye color

Example:

clean_sword:
  material: NETHERITE_SWORD
  name: "&c&lBattle Sword"
  flags:
    - HIDE_ATTRIBUTES
    - HIDE_ENCHANTS
  glow: true

Note: HIDE_ATTRIBUTES requires Minecraft 1.21+ for full functionality.

Enchantments

Format: ENCHANTMENT_NAME:LEVEL

enchantments:
  - "SHARPNESS:5"
  - "UNBREAKING:3"
  - "FIRE_ASPECT:2"

Enchantment List: Bukkit Enchantment Enum

Player Heads

Using Base64 Texture:

custom_head:
  material: PLAYER_HEAD
  name: "&eCustom Head"
  texture: "eyJ0ZXh0d