Syntax

items:
  "ItemName":
    material: TEXT
    slot: #

Note: Each item will have a name, in this example our item is called ItemName. This name should be unique, so there won't be two or more items with the same name.

Material

material: TEXT

Supported material values:

• ​Material name (STONE).

• Player head (head-extended_clip).

• Placeholder head (head-%player_name%).

• Argument placeholder head (head-{target}).

• ​BaseHead (basehead-<base64 (Value field in the head's give command)>).

• ​EpicHeads (heads-<ID>).

• ​HeadDatabase (hdb-<ID>).

• ​Placeholder material (placeholder-%player_item_in_hand%).

Sets the material of the item in the menu.

material: WOOL
data: 5

Data

data: #

Supported data values:

• Number (1).

• Placeholder that returns a number (placeholder-%player_item_in_hand_data%).

Sets the durability of the item (depends on the Material option).

Amount

amount: #

Sets the item's amount in the menu.

Dynamic Amount

dynamic_amount: '%placeholder%'

Sets the item's amount in the menu using a placeholder.

Custom Model Data

nbt_string: <Key>:<StringValue>
nbt_int: <Key>:<IntegerValue>

Allows you to use your custom models from your resource pack, to display custom items provided from your resource pack.

Banner Meta

banner_meta:
- <dyecolor>;<patterntype>
- <dyecolor>;<patterntype>

• ​Dye colors list.

• ​Pattern types list.

Allows you to create your custom banner (Used if the material is a banner).

Potion Effects

potion_effects:
- <PotionEffectType>;<duration>;<amplifier>
- <PotionEffectType>;<duration>;<amplifier>

• ​Potion effects list.​

Allows you to set effects (Used if the material is a potion or splash_potion). For potion_effects to work on potions you also need to give it a rgb value.

RGB

rgb: #,#,#

Example:

rgb: 38,192,210

​​

Sets the RGB (Red, Green, Blue) color for leather armor, potions and splash_potions (For rgb to work on potions you also need to give it a potion_effect).

Display Name

display_name: "TEXT"

Sets the item's display name. You can use placeholders and color/format codes.

Lore

lore:
  - "TEXT"
  - "TEXT"

Sets the item's lore (the text shown under the item's name). You can use placeholders and color/format codes and the new line character (\n) in this option.

Slot

slot: #

Multiple slots:

slots:
  - #
  - #
  - #
  
# OR
  
slots:
  - #-#
  - #-#

Sets in which slot the item should be inside the menu.

Priority

priority: #

Sets the item priority. It's used if you want different items in the same slot (by using the view requirement option). The item that has the highest priority will be checked first if the player has the required view requirement. It will display the item if they have the requirements and if not, it will check the next item and so on.

View Requirement

view_requirement: 'EXPRESSION'

Sets the requirements the player should have to see the item. (Check priority option for setting up multiple items in the same slot). Check the Requirements page for more info about this option's value and how to use it.

Update

update: BOOLEAN # true or false

If set to true, it will update the placeholders in the item's display name and lore only. Check the update interval GUI option to set the update speed.

Enchantments

enchantments:
  - enchantmentid;level
  - enchantmentid;level

• ​Enchantments list.

Enchants the item with the specified enchantments. (Check the hide enchantments option to hide the enchantments)

Hide Enchantments

hide_enchantments: BOOLEAN # true or false

If set to true, it will hide the enchantments you set for the item using the enchantments option from the item's tooltip (lore). Used to add the enchanting glow effect to the item without showing the enchantments text.

Hide Attributes

hide_attributes: BOOLEAN # true or false

If set to true, it will hide the vanilla attributes of an item/armor (e.g. 7 Attack Damage).

Hide Effects

hide_effects: BOOLEAN # true or false

If set to true, it will hide the potion's effect text beneath the item name.

Unbreakable

unbreakable: BOOLEAN # true or false

If set to true, it will show the item to be at full durability.

(Shift) Left/Middle/Right click Commands

# left_click_commands: or
# right_click_commands: or
# middle_click_commands: or
# shift_left_click_commands: or
shift_right_click_commands:
  - "[ACTIONTYPE] ACTION"
  - "[ACTIONTYPE] ACTION"

Sets the actions/commands that should be executed once the player clicks the item. they get executed in order from top to bottom. Check this for all action types and action tags.

(Shift) Left/Middle/Right click Requirement

# left_click_requirement: or
# right_click_requirement: or
# middle_click_requirement: or
# shift_left_click_requirement: or
shift_right_click_requirement:
  requirements: 'EXPRESSION'
  deny_commands:
    - "[ACTIONTYPE] ACTION"
    - "[ACTIONTYPE] ACTION"

Sets the requirements the player should have to click the item (Check the Requirements page for more info about the EXPRESSION value). Deny commands (optional) are the actions that are going to be executed if the player doesn't have the required requirements. But if (s)he does, it will execute the actions specified in the click commands option.

Check this for all action types and action tags.