All item related options & configurations
items:"ItemName":material: TEXTslot: #
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: TEXTSupported material values:
- Player head (
- Placeholder head (
- Argument placeholder head (
- Minecraft Texture (
texture-<id>) - The
idis what's after
- Item in main hand (
- Item in off hand (
- Items in armor equipment slots (
- Water bottle material is:
- Air material is:
Sets the material of the item in the menu.
Now supports AIR as a valid material. The item will be an empty slot with just click commands and click requirements.
For version 1.12.2 or older: Check Data option to specify the data of the item (the number after the colon
:). e.g. Lime Wool would be
data: #Supported data values:
- Number (
- Placeholder that returns a number (
For version 1.12.2 or older: This option will specify the data value (the number after the colon
:) of the item or the item's durability (depends on the Material option).
Sets the item's amount in the menu.
Allows you to set a CustomModelData for your item. Example of usage:
nbt_string: '<Key>:<StringValue>'nbt_strings:- '<Key>:<StringValue>'- '<Key>:<StringValue>'nbt_int: '<Key>:<IntegerValue>'nbt_ints:- '<Key>:<IntegerValue>'- '<Key>:<IntegerValue>'
Allows you to add custom NBT tags to your items like model data.
Deprecated! Should use the new model_data option instead for CustomModelData. You can still use it for other tags tho.
The nbt tags options support PlaceholderAPI placeholders now!
banner_meta:- <dyecolor>;<patterntype>- <dyecolor>;<patterntype>
Allows you to create your custom banners and shields.
Allows you to specify base colors for shields and also for banners on 1.12.2 and lower versions.
Allows you to set item flags.
potion_effects:- <PotionEffectType>;<duration>;<amplifier>- <PotionEffectType>;<duration>;<amplifier>
This is mainly targeted for 1.12.2 and lower servers and allows you to specify monster egg types and also monster spawner types.
rgb: #, #, #Example:rgb: 38, 192, 210
Sets the RGB (Red, Green, Blue) color for leather armor, potions, splash potions, tipped arrows and firework stars
For RGB option to work on potions and tipped arrows you also need to give it at least one potion_effect.
You can find a list of default potion colors
HERE. You will have to use an online converter to convert the hex values to rgb.
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: #Multiple slots:slots:- #- #- ## ORslots:- #-#- #-#
Sets in which slot the item should be inside the menu.
- Slots start at 0.
- Multiple items can be in the same slot, but you'll have to use view requirement and priority options to work properly.
Slots number in a chest
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.
- The highest priority is 0.
- The lowest priority is 2147483647.
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: 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.
An example showing how the update option works in placeholders
Enchants the item with the specified enchantments. (Check the hide enchantments option to hide the enchantments)
Some items cannot have the enchanting glow effect
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: 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: BOOLEAN # true or false
If set to true, it will hide the potion's effect text beneath the item name.
hide_unbreakable: BOOLEAN # true or false
If set to true, it will hide the unbreakable tag if the "unbreakable:" option is enabled.
unbreakable: BOOLEAN # true or false
If set to true, it will show the item to be at full durability.
# click_commands: or# left_click_commands: or# right_click_commands: or# middle_click_commands: or# shift_left_click_commands: orshift_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.
Middle clicking was removed by Mojang in 1.18 and newer!
# click_requirement: or# left_click_requirement: or# right_click_requirement: or# middle_click_requirement: or# shift_left_click_requirement: orshift_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
EXPRESSIONvalue). 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.