Item System

All menu types use the same item structure.

Full reference example

items:
  example_item:
    material: NETHERITE_SWORD
    name: '&c&lExample Item'
    display-name: '&fAlternative Name'
    lore:
      - '&7Line 1'
      - '&7Line 2'

    amount: 1

    glow: true
    hide-attributes: true
    hide-tooltip: false
    unbreakable: true
    max_stack_size: 1

    slot: 13
    # slots: '10-16,19-25'

    item_model: 'exylia:example_item'
    tooltip_style: 'exylia:rare'

    click_sounds:
      - 'UI_BUTTON_CLICK|1.0|1.0'

    enchantments:
      SHARPNESS: 5
      UNBREAKING: 3

    armor_trim:
      material: diamond
      pattern: sentry

    leather_color: '#55AAFF'

    potion:
      base_type: STRENGTH
      upgraded: true
      extended: false
      color: '#FF0000'
      custom_effects:
        - type: SPEED
          amplifier: 1
          duration: 200

    attributes:
      - 'GENERIC_ATTACK_DAMAGE:10:ADD_NUMBER'

    nbt:
      item_id: 'example_item'
      rarity: 'rare'

    dynamic_update: true
    update_interval: 20

    actions:
      - 'left: close'
      - 'right: next_page'

    commands:
      - 'left: player: msg You clicked'
      - 'right: console: say {player} clicked example_item'

    requires-target: false

Required fields

material
Position with slot or slots

Position formats

slot: 13

slots: '10-16,19-25'

slots:
  - 10
  - 13
  - 16

Do not use slot and slots together in the same item.

Visual and metadata keys

name, display-name, lore, amount
glow / glowing
hide-attributes / hide_attributes
hide-tooltip / hide_tooltip
unbreakable, max_stack_size
item_model, tooltip_style
enchantments
armor_trim
leather_color
potion, base_potion_type, potion_color, potion_effects
attributes
nbt

Dynamic keys

dynamic_update: Enables item-level dynamic refresh
update_interval: Tick interval for this item

Actions and commands

Use actions for Exylia action system entries and commands for command execution.

actions:
  - 'left: close'
  - 'right: next_page'

commands:
  - 'left: player: msg Hello'
  - 'right: console: say {player} clicked'

Command prefixes

player:
console:
player-proxy:
console-proxy:

Click prefixes

left, right, middle
shift_left, shift_right
drop, swap, double, number_key
any

You can combine prefixes: left,right: ...

Sound format

click_sounds:
  - 'UI_BUTTON_CLICK|1.0|1.0'

Material variants

Supported common head variants:

material: 'playerhead:Notch'
material: 'headbase:<base64>'
material: 'urlhead:https://textures.minecraft.net/texture/...'

Item System

On this page