Item Configuration

Items are the visual elements displayed in your inventory buttons. This page documents all available item configuration options.

Basic Item Structure

item:
  material: DIAMOND
  name: "&bMy Item"
  lore:
    - "&7Line 1"
    - "&7Line 2"

Configuration Options

material

The material type for the item. zMenu supports vanilla Minecraft materials and many custom item plugins.

item:
  material: DIAMOND_SWORD

Material Loaders

zMenu supports many material sources through its loader system:

Plugin	Syntax	Price	Link
Bukkit	`STONE`, `DIAMOND_SWORD`	Built-in	Vanilla Minecraft
PlaceholderAPI	`%your_placeholder_material%`	Free	SpigotMC
Armor (slot)	`armor:HEAD`, `armor:CHEST`, `armor:LEGS`, `armor:FEET`	Built-in	Player's equipped armor
zHead	`zhd:<id>`	Free	Polymart
MagicCosmetics	`magic_cosmetics:HAT`, `magic_cosmetics:BAG`, etc.	Paid	Polymart
HMCCosmetics	`hmc_cosmetics:<type>`, `hmc_cosmetics:<type>-<player>`	Paid	SpigotMC
zItems	`zitems:<id>`	Paid	SpigotMC
HeadDatabase	`hdb:<id>`	Paid	SpigotMC
Oraxen	`oraxen:<item name>`	Paid	SpigotMC
ItemsAdder	`itemsadder:<item name>`	Paid	SpigotMC
SlimeFun	`slimefun:<item name>`	Free	GitHub
Nova	`nova:<item/block name>`	Free	GitHub
Base64	`base64:<item in base64>`	Built-in	Import items as base64 string
PlayerHead	`playerHead:<player name>`, `playerHead:%player%`	Built-in	Display a player's head
CraftEngine	`craftengine:<item id>`	Free	Modrinth
ExecutableItems	`ei:<item id>`	Paid	SpigotMC
ExecutableBlocks	`eb:<block id>`	Paid	SpigotMC
Nexo	`nexo:<item id>`	Paid	MCModels
MMOItems	`mmoitems:<type>:<item id>`	Paid	SpigotMC
BaseHead	`basehead-<head-url>`	Built-in	Use a base64 head texture directly in the material field

Examples:

# Vanilla material
material: DIAMOND_SWORD

# Player head
material: "playerHead:%player%"

# Custom head from zHead
material: "zhd:123"

# ItemsAdder custom item
material: "itemsadder:my_namespace:ruby_gem"

# Oraxen custom item
material: "oraxen:amethyst_sword"

name

The display name of the item.

name
display-name
display_name

item:
material: DIAMOND
name: "&b&lShiny Diamond"

item:
material: DIAMOND
display-name: "&b&lShiny Diamond"

item:
material: DIAMOND
display_name: "&b&lShiny Diamond"

Aliases:

name
display-name
display_name

Features:

Supports color codes (&6, &#FF5500)
Supports MiniMessage (if enabled)
Supports placeholders (%player%)

translated-name

Provides per-language translations of the item name. Each entry maps a locale to a name, and the plugin uses the one matching the player's client language. If no locale matches, the default name value is used instead.

translatedName
translated-name

item:
  material: DIAMOND_SWORD
  name: "&b&lShiny Diamond"
  translatedName:
    - locale: fr-fr
      name: "Nom en français"
    - locale: it-it
      name: "Nome in italiano"

item:
  material: DIAMOND_SWORD
  name: "&b&lShiny Diamond"
  translated-name:
    - locale: fr-fr
      name: "Nom en français"
    - locale: it-it
      name: "Nome in italiano"

The name is displayed in the player's client language. Players whose locale is not listed fall back to the default name.

lore

The description lines shown below the item name.

item:
  material: DIAMOND_SWORD
  name: "&6&lLegendary Sword"
  lore:
    - "&7A powerful weapon"
    - ""
    - "&7Damage: &c+50"
    - "&7Speed: &a+10%"
    - ""
    - "&eClick to equip!"

Each list item is a new line. Empty strings ("") create blank lines.

lore-type

Define how the lore should interact with existing item lore. This is especially useful when using material loaders (ItemsAdder, Oraxen, etc.) where the loaded item already has lore.

REPLACE (default)
APPEND
PREPEND

item:
  material: "oraxen:custom_item"
  lore:
    - "&7This replaces all existing lore"
  lore-type: REPLACE

item:
  material: "itemsadder:namespace:item"
  lore:
    - ""
    - "&eClick to use!"
  lore-type: APPEND

item:
  material: "zitems:legendary_sword"
  lore:
    - "&6&lLEGENDARY"
    - ""
  lore-type: PREPEND

Available Types:

Type	Description
`REPLACE`	Replace the existing lore entirely (default)
`APPEND`	Add lines after the existing lore
`PREPEND`	Add lines before the existing lore

translated-lore

Provides per-language translations of the item lore. Each entry maps a locale to a lore list, and the plugin uses the one matching the player's client language. If no locale matches, the default lore value is used instead.

translatedLore
translated-lore

item:
  material: DIAMOND_SWORD
  lore:
    - "&7A powerful weapon"
  translatedLore:
    - locale: fr-fr
      lore:
        - "Lore en français"
    - locale: it-it
      lore:
        - "Lore in italiano"

item:
  material: DIAMOND_SWORD
  lore:
    - "&7A powerful weapon"
  translated-lore:
    - locale: fr-fr
      lore:
        - "Lore en français"
    - locale: it-it
      lore:
        - "Lore in italiano"

The lore is displayed in the player's client language. Players whose locale is not listed fall back to the default lore.

amount

The stack size of the item.

item:
  material: DIAMOND
  amount: 64

You can also use placeholders:

item:
  material: DIAMOND
  amount: "%zmenu_player_value_coins%"  # Dynamic amount

durability

Set the durability/damage value for tools and armor.

item:
  material: DIAMOND_SWORD
  durability: 100  # 100 durability used

max-stack-size

Set a custom max stack size for the item.

item:
  material: DIAMOND
  max-stack-size: 16

max-damage

Set a custom max durability for the item.

item:
  material: DIAMOND_SWORD
  max-damage: 500

damage

Set the current durability damage for the item.

item:
  material: DIAMOND_SWORD
  damage: 50  # 50 durability used

repair-cost

Set the anvil repair cost for the item.

item:
  material: DIAMOND_SWORD
  repair-cost: 10

unbreakable

Make the item unbreakable (infinite durability).

item:
  material: DIAMOND_SWORD
  unbreakable: true

Show "Unbreakable" in the item tooltip when the item is unbreakable.

item:
  material: DIAMOND_SWORD
  unbreakable: true
  unbreakable-show-in-tooltip: false

fire-resistant

Make the item fire resistant (does not burn in lava or fire).

item:
  material: DIAMOND
  fire-resistant: true

Completely hide the item tooltip when hovering over the item in the inventory.

item:
  material: DIAMOND
  name: "&6&lHidden Tooltip" # You can still set a name and lore, but they won't be visible in the tooltip
  hide-tooltip: true

Hide the additional tooltip line that shows enchantments, attributes, etc. The item name and lore will still be visible.

item:
  material: DIAMOND_SWORD
  name: "&6&lHidden Additional Tooltip"
  enchantments:
    - SHARPNESS,5
  hide-additional-tooltip: true

enchantment-glint

Enable the enchantment glint effect without showing enchantments in the tooltip.

item:
  material: DIAMOND
  name: "&6&lGlowing Diamond"
  enchantment-glint: true

Define whether enchantments should be listed in the item tooltip.

item:
  material: DIAMOND_SWORD
  name: "&6&lTooltip Enchantments"
  enchantments:
    - SHARPNESS,5
  enchantment-show-in-tooltip: false

Define whether attribute modifiers should be listed in the item tooltip.

item:
  material: DIAMOND_SWORD
  name: "&6&lTooltip Attributes"
  attributes:
    - attribute: ATTACK_DAMAGE
      amount: 10
      operation: ADD_NUMBER
      slot: MAINHAND
  attribute-show-in-tooltip: false

item-rarity

Set the item rarity, which can be used by resource packs to apply different colors or effects.

item:
  material: DIAMOND
  name: "&6&lRare Diamond"
  item-rarity: RARE

Click to show rarity options

Available rarities:

COMMON
UNCOMMON
RARE
EPIC

Set the tooltip style, which can be used by resource packs to apply different formatting.

item:
  material: DIAMOND
  name: "&6&lStyled Diamond"
  tooltip-style: "fancy"

model-id

item:
  material: DIAMOND
  model-id: 12345

item:
  material: DIAMOND
  modelID: 12345

item:
  material: DIAMOND
  modelId: 12345

item:
  material: DIAMOND
  customModelId: 12345

item:
  material: DIAMOND
  customModelData: 12345

item:
  material: DIAMOND
  model_data: 12345

item:
  material: DIAMOND
  custom-model-id: 12345

item:
  material: DIAMOND
  custom-model-data: 12345

item:
  material: DIAMOND
  model-data: 12345

This allows resource packs to display custom models for items.

item-model 1.21+

Set the item model using a namespaced key (Minecraft 1.21+).

item:
  material: DIAMOND_SWORD
  item-model: "minecraft:custom/my_sword"

Or with a custom namespace:

item:
  material: DIAMOND_SWORD
  item-model: "mypack:weapons/legendary_blade"

equipped-model 1.21+

Set the model displayed when the item is equipped (Minecraft 1.21+).

item:
  material: DIAMOND_CHESTPLATE
  equipped-model: "minecraft:custom/my_armor"

This is used for armor and equipment that changes appearance when worn.

glow

Add an enchantment glow effect without showing enchantments. Equivalent to adding HIDE_ENCHANTS flag with a dummy enchantment.

item:
  material: NETHER_STAR
  name: "&6&lSpecial Item"
  glow: true

player-head

Display a player's head. The material is automatically set to PLAYER_HEAD.

item:
  player-head: "%player%"  # Current player's head
  name: "&a%player%'s Head"

You can also use a specific player name:

item:
  player-head: "Notch"

tip

You don't need to specify material: PLAYER_HEAD when using player-head. The plugin handles this automatically.

url

Use a custom head texture URL (base64 encoded texture).

item:
  material: PLAYER_HEAD
  url: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUv..."
  name: "&6Custom Head"

Get head textures from sites like minecraft-heads.com.

target

Set the target player for placeholders in the item name and lore.

item:
  material: DIAMOND_SWORD
  target: "%zmenu_argument_player%"  # Use a placeholder that resolves to a player name
  name: "&6&l%player_name%'s Sword"

So if the target placeholder resolves to "Notch", the item name will display as "Notch's Sword" for that player.

attributes

Define attribute modifiers for the item.

item:
  material: DIAMOND_SWORD
  attributes:
    - attribute: ATTACK_SPEED
      amount: 5
      operation: ADD_NUMBER
      slot: MAINHAND

Click to show attribute options

List of all available attributes here. Available operations:

ADD_NUMBER
ADD_SCALAR
MULTIPLY_SCALAR_1 Available slots can be found here.

attribute-merge-strategy

Define how attribute modifiers should merge with existing item attributes.

item:
  material: DIAMOND_SWORD
  attributes:
    - attribute: ATTACK_DAMAGE
      amount: 10
      operation: ADD_NUMBER
      slot: MAINHAND
  attribute-merge-strategy: REPLACE

Click to show merge strategy options

Merge Strategies:

REPLACE - Replace all existing attributes with the defined ones.
ADD - Add the defined attributes to the existing ones.
KEEP_HIGHEST - For each attribute, keep the highest value between existing and defined.
KEEP_LOWEST - For each attribute, keep the lowest value between existing and defined.
SUM - Sum the values of existing and defined attributes together.

clear-default-attributes

Remove default attributes from items (e.g., remove attack damage from swords).

item:
  material: DIAMOND_SWORD
  clear-default-attributes: true

enchantments

enchantments
enchants

item:
  material: DIAMOND_SWORD
  enchantments:
    - SHARPNESS,5
    - UNBREAKING,3

item:
  material: DIAMOND_SWORD
  enchants:
    - SHARPNESS,5
    - UNBREAKING,3

You can use either enchantments or enchants to add enchantments to your item.

Click to show supported enchantments and aliases

Supported Enchantments and Aliases:

Main Name	Aliases
SHARPNESS	DAMAGE_ALL, SHARPNESS, alldamage, alldmg, sharpness, sharp, dal
BANE_OF_ARTHROPODS	DAMAGE_ARTHROPODS, BANE_OF_ARTHROPODS, ardmg, baneofarthropods, baneofarthropod, arthropod, dar
SMITE	DAMAGE_UNDEAD, undeaddamage, smite, du
EFFICIENCY	DIG_SPEED, EFFICIENCY, digspeed, efficiency, minespeed, cutspeed, ds, eff
UNBREAKING	DURABILITY, dura, unbreaking, d
THORNS	thorns, highcrit, thorn, highercrit, t
FIRE_ASPECT	FIRE_ASPECT, fireaspect, fire, meleefire, meleeflame, fa
KNOCKBACK	knockback, kback, kb, k
FORTUNE	LOOT_BONUS_BLOCKS, FORTUNE, blockslootbonus, fortune, fort, lbb
LOOTING	LOOT_BONUS_MOBS, LOOTING, mobslootbonus, mobloot, looting, lbm
RESPIRATION	OXYGEN, RESPIRATION, oxygen, respiration, breathing, breath, o
PROTECTION	PROTECTION_ENVIRONMENTAL, PROTECTION, protection, prot, protect, p
BLAST_PROTECTION	PROTECTION_EXPLOSIONS, BLAST_PROTECTION, explosionsprotection, explosionprotection, expprot, blastprotection, bprotection, bprotect, blastprotect, pe
FEATHER_FALLING	PROTECTION_FALL, FEATHER_FALLING, fallprotection, fallprot, featherfall, featherfalling, pfa
FIRE_PROTECTION	PROTECTION_FIRE, FIRE_PROTECTION, fireprotection, flameprotection, fireprotect, flameprotect, fireprot, flameprot, pf
PROJECTILE_PROTECTION	PROTECTION_PROJECTILE, PROJECTILE_PROTECTION, projectileprotection, projprot, pp
SILK_TOUCH	SILK_TOUCH, silktouch, softtouch, st
AQUA_AFFINITY	WATER_WORKER, AQUA_AFFINITY, waterworker, aquaaffinity, watermine, ww
FLAME	ARROW_FIRE, FLAME, firearrow, flame, flamearrow, af
POWER	ARROW_DAMAGE, POWER, arrowdamage, power, arrowpower, ad
PUNCH	ARROW_KNOCKBACK, PUNCH, arrowknockback, arrowkb, punch, arrowpunch, ak
INFINITY	ARROW_INFINITE, INFINITY, infinitearrows, infarrows, infinity, infinite, unlimited, unlimitedarrows, ai
LUCK_OF_THE_SEA	LUCK, LUCK_OF_THE_SEA, luck, luckofsea, luckofseas, rodluck
LURE	lure, rodlure
DEPTH_STRIDER	DEPTH_STRIDER, depthstrider, depth, strider
FROST_WALKER	FROST_WALKER, frostwalker, frost, walker
MENDING	mending
BINDING_CURSE	BINDING_CURSE, bindingcurse, bindcurse, binding, bind
VANISHING_CURSE	VANISHING_CURSE, vanishingcurse, vanishcurse, vanishing, vanish
SWEEPING_EDGE	SWEEPING_EDGE, sweepingedge, sweepedge, sweeping
LOYALTY	loyalty, loyal, return
IMPALING	impaling, impale, oceandamage, oceandmg
RIPTIDE	riptide, rip, tide, launch
CHANNELING	channelling, chanelling, channeling, chaneling, channel
MULTISHOT	multishot, tripleshot
QUICK_CHARGE	QUICK_CHARGE, quickcharge, quickdraw, fastcharge, fastdraw
PIERCING	piercing
SOUL_SPEED	SOUL_SPEED, soulspeed, soilspeed, sandspeed
SWIFT_SNEAK	swiftsneak, SWIFT_SNEAK
BREACH	breach
DENSITY	density
WIND_BURST	WIND_BURST, windburst, wind, burst

Usage:

Each enchantment entry is in the format ENCHANTMENT_NAME,level (e.g., SHARPNESS,5).
You can use any alias listed above for the enchantment name.
These options are for the top-level item configuration, not for components.

trim

Define armor trim patterns and materials.

item:
  material: DIAMOND_CHESTPLATE
  trim:
    enable: true
    pattern: "coast"
    material: "iron"

Available Patterns: here Available Materials: here

flags

Hide certain item attributes using item flags.

item:
  material: DIAMOND_SWORD
  enchantments:
    - SHARPNESS,5
  flags:
    - HIDE_ENCHANTS
    - HIDE_ATTRIBUTES

Click to show all available flags

Flag	Description
`HIDE_ENCHANTS`	Hide enchantment list
`HIDE_ATTRIBUTES`	Hide attribute modifiers
`HIDE_UNBREAKABLE`	Hide "Unbreakable" tag
`HIDE_DESTROYS`	Hide "Can destroy" list
`HIDE_PLACED_ON`	Hide "Can be placed on" list
`HIDE_ADDITIONAL_TOOLTIP`	Hide additional tooltip
`HIDE_DYE`	Hide leather armor dye color
`HIDE_ARMOR_TRIM`	Hide armor trim pattern
`HIDE_CUSTOM_DATA`	Hide custom data
`HIDE_MAX_STACK_SIZE`	Hide max stack size
`HIDE_MAX_DAMAGE`	Hide max damage
`HIDE_DAMAGE`	Hide damage
`HIDE_CUSTOM_NAME`	Hide custom name
`HIDE_ITEM_NAME`	Hide item name
`HIDE_ITEM_MODEL`	Hide item model
`HIDE_LORE`	Hide lore
`HIDE_RARITY`	Hide rarity
`HIDE_ENCHANTMENTS`	Hide enchantments
`HIDE_CAN_PLACE_ON`	Hide can place on
`HIDE_CAN_BREAK`	Hide can break
`HIDE_ATTRIBUTE_MODIFIERS`	Hide attribute modifiers
`HIDE_CUSTOM_MODEL_DATA`	Hide custom model data
`HIDE_TOOLTIP_DISPLAY`	Hide tooltip display
`HIDE_REPAIR_COST`	Hide repair cost
`HIDE_CREATIVE_SLOT_LOCK`	Hide creative slot lock
`HIDE_ENCHANTMENT_GLINT_OVERRIDE`	Hide enchantment glint override
`HIDE_INTANGIBLE_PROJECTILE`	Hide intangible projectile
`HIDE_FOOD`	Hide food
`HIDE_CONSUMABLE`	Hide consumable
`HIDE_USE_REMAINDER`	Hide use remainder
`HIDE_USE_COOLDOWN`	Hide use cooldown
`HIDE_DAMAGE_RESISTANT`	Hide damage resistant
`HIDE_TOOL`	Hide tool
`HIDE_WEAPON`	Hide weapon
`HIDE_ENCHANTABLE`	Hide enchantable
`HIDE_EQUIPPABLE`	Hide equippable
`HIDE_REPAIRABLE`	Hide repairable
`HIDE_GLIDER`	Hide glider
`HIDE_TOOLTIP_STYLE`	Hide tooltip style
`HIDE_DEATH_PROTECTION`	Hide death protection
`HIDE_BLOCKS_ATTACKS`	Hide blocks attacks
`HIDE_STORED_ENCHANTMENTS`	Hide stored enchantments
`HIDE_DYED_COLOR`	Hide dyed color
`HIDE_MAP_COLOR`	Hide map color
`HIDE_MAP_ID`	Hide map id
`HIDE_MAP_DECORATIONS`	Hide map decorations
`HIDE_MAP_POST_PROCESSING`	Hide map post processing
`HIDE_CHARGED_PROJECTILES`	Hide charged projectiles
`HIDE_BUNDLE_CONTENTS`	Hide bundle contents
`HIDE_POTION_CONTENTS`	Hide potion contents
`HIDE_POTION_DURATION_SCALE`	Hide potion duration scale
`HIDE_SUSPICIOUS_STEW_EFFECTS`	Hide suspicious stew effects
`HIDE_WRITABLE_BOOK_CONTENT`	Hide writable book content
`HIDE_WRITTEN_BOOK_CONTENT`	Hide written book content
`HIDE_TRIM`	Hide trim
`HIDE_DEBUG_STICK_STATE`	Hide debug stick state
`HIDE_ENTITY_DATA`	Hide entity data
`HIDE_BUCKET_ENTITY_DATA`	Hide bucket entity data
`HIDE_BLOCK_ENTITY_DATA`	Hide block entity data
`HIDE_INSTRUMENT`	Hide instrument
`HIDE_PROVIDES_TRIM_MATERIAL`	Hide provides trim material
`HIDE_OMINOUS_BOTTLE_AMPLIFIER`	Hide ominous bottle amplifier
`HIDE_JUKEBOX_PLAYABLE`	Hide jukebox playable
`HIDE_PROVIDES_BANNER_PATTERNS`	Hide provides banner patterns
`HIDE_RECIPES`	Hide recipes
`HIDE_LODESTONE_TRACKER`	Hide lodestone tracker
`HIDE_FIREWORK_EXPLOSION`	Hide firework explosion
`HIDE_FIREWORKS`	Hide fireworks
`HIDE_PROFILE`	Hide profile
`HIDE_NOTE_BLOCK_SOUND`	Hide note block sound
`HIDE_BANNER_PATTERNS`	Hide banner patterns
`HIDE_BASE_COLOR`	Hide base color
`HIDE_POT_DECORATIONS`	Hide pot decorations
`HIDE_CONTAINER`	Hide container
`HIDE_BLOCK_STATE`	Hide block state
`HIDE_BEES`	Hide bees
`HIDE_LOCK`	Hide lock
`HIDE_CONTAINER_LOOT`	Hide container loot
`HIDE_BREAK_SOUND`	Hide break sound
`HIDE_VILLAGER_VARIANT`	Hide villager variant
`HIDE_WOLF_VARIANT`	Hide wolf variant
`HIDE_WOLF_SOUND_VARIANT`	Hide wolf sound variant
`HIDE_WOLF_COLLAR`	Hide wolf collar
`HIDE_FOX_VARIANT`	Hide fox variant
`HIDE_SALMON_SIZE`	Hide salmon size
`HIDE_PARROT_VARIANT`	Hide parrot variant
`HIDE_TROPICAL_FISH_PATTERN`	Hide tropical fish pattern
`HIDE_TROPICAL_FISH_BASE_COLOR`	Hide tropical fish base color
`HIDE_TROPICAL_FISH_PATTERN_COLOR`	Hide tropical fish pattern color
`HIDE_MOOSHROOM_VARIANT`	Hide mooshroom variant
`HIDE_RABBIT_VARIANT`	Hide rabbit variant
`HIDE_PIG_VARIANT`	Hide pig variant
`HIDE_COW_VARIANT`	Hide cow variant
`HIDE_CHICKEN_VARIANT`	Hide chicken variant
`HIDE_FROG_VARIANT`	Hide frog variant
`HIDE_HORSE_VARIANT`	Hide horse variant
`HIDE_PAINTING_VARIANT`	Hide painting variant
`HIDE_LLAMA_VARIANT`	Hide llama variant
`HIDE_AXOLOTL_VARIANT`	Hide axolotl variant
`HIDE_CAT_VARIANT`	Hide cat variant
`HIDE_CAT_COLLAR`	Hide cat collar
`HIDE_SHEEP_COLOR`	Hide sheep color
`HIDE_SHULKER_COLOR`	Hide shulker color

Components 1.20.5+

Starting from Minecraft 1.20.5, items use a new component system. zMenu provides full support for over 40+ component types including food, tools, weapons, attributes, and more.

item:
  material: DIAMOND_SWORD
  components:
    custom-name: "&6&lLegendary Sword"
    rarity: EPIC
    enchantments:
      sharpness: 5
    fire-resistant: true

For the complete components reference, see the dedicated Components page.

Complete Examples

Simple Item

item:
  material: DIAMOND
  name: "&b&lDiamond"
  lore:
    - "&7A precious gem"

Player Head with Texture

item:
  player-head: "%player%"
  name: "&6&lPlayer Profile"
  lore:
    - "&7Click to view!"
  glow: true

Or with a custom texture URL:

item:
  url: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA..."
  name: "&6&lTreasure Chest"
  lore:
    - "&7Click to open!"
  glow: true

Enchanted Tool

item:
  material: DIAMOND_PICKAXE
  name: "&a&lMiner's Dream"
  lore:
    - "&7The ultimate mining tool"
    - ""
    - "&7Efficiency V"
    - "&7Fortune III"
    - "&7Unbreaking III"
  enchantments:
    - EFFICIENCY,5
    - FORTUNE,3
    - UNBREAKING,3
  flags:
    - HIDE_ENCHANTS
  glow: true

Dynamic Item with Placeholders

item:
  player-head: "%player%"
  name: "&6&l%player%'s Profile"
  lore:
    - "&8&m─────────────────"
    - ""
    - "&7Level: &a%player_level%"
    - "&7Health: &c%player_health%/%player_max_health%"
    - "&7Balance: &6$%vault_eco_balance_formatted%"
    - ""
    - "&7Kills: &a%statistic_player_kills%"
    - "&7Deaths: &c%statistic_deaths%"
    - ""
    - "&8&m─────────────────"

Custom Model Item

item:
  material: PAPER
  name: "&e&lMagic Wand"
  lore:
    - "&7Cast powerful spells!"
  model-id: 10001
  glow: true

Using ItemsAdder/Oraxen

For custom items from ItemsAdder:

item:
  material: ITEMSADDER:my_namespace:ruby_gem
  name: "&c&lRuby Gem"

For Oraxen items:

item:
  material: ORAXEN:amethyst_sword
  name: "&d&lAmethyst Sword"

Best Practices

Use meaningful names - Make item names clear and descriptive
Format lore consistently - Use separators and spacing for readability
Hide unnecessary info - Use flags to hide enchantments/attributes when not needed
Use placeholders - Make items dynamic with PlaceholderAPI
Test with resource packs - If using customModelData, verify the models display correctly

Next Steps

Learn how to use items in Buttons
Add Actions to make items interactive
Create Patterns for reusable item templates

Basic Item Structure​

Configuration Options​

material​

Material Loaders​

name​

translated-name​

lore​

lore-type​

translated-lore​

amount​

durability​

max-stack-size​

max-damage​

damage​

repair-cost​

unbreakable​

unbreakable-show-in-tooltip​

fire-resistant​

hide-tooltip​

hide-additional-tooltip​

enchantment-glint​

enchantment-show-in-tooltip​

attribute-show-in-tooltip​

item-rarity​

tooltip-style​

model-id​

item-model 1.21+​

equipped-model 1.21+​

glow​

player-head​

url​

target​

attributes​

attribute-merge-strategy​

clear-default-attributes​

enchantments​

trim​

flags​

Components 1.20.5+​

Complete Examples​

Simple Item​

Player Head with Texture​

Enchanted Tool​

Dynamic Item with Placeholders​

Custom Model Item​

Using ItemsAdder/Oraxen​

Best Practices​

Next Steps​