Item Settings

These settings will be found inside of any item, custom or not.

Material

The material an item will be.

#A regular material
material: IRON_INGOT

#A custom tag material
material: cps= self

If you want to use a custom material, use one of the following Material Tags.

Tag	Description
cps=	Used for heads. Use cps= self for your own head. Use https://minecraft-heads.com/custom-heads and find a nice custom head When you scroll to the bottom of the page when you find the head, you will see a section named "Other" where you can copy the code called "Value:" You can use cps= <value> to use this. Alternatively, use cps= <username> to make a custom head using a players username. Note this may not be as efficient as using custom heads.
cpi=	Used for panel custom items. Simply do cpi= <custom item> and it will change the material to the item. View the Panel Settings page and navigate to custom items for more information on how to make one of them.
hdb=	Uses Head Database to add your head into the panel. Simply find a head in the database https://www.spigotmc.org/resources/head-database.14280/ and get its number. eg. hdb= <number>
mmo=	Uses MMOItems to make an item in the panel slot. Just use the following material template: mmo= <item type> <id>
book=	This will create a writable book item. book= <author> is how to use the tag, the author does not need to be a real username. Adding a section similar to the lore in your item but called "write" will become the contents of the book.
%cp-player-online-1%	You can change the number 1, to any number, it will check server slots and find the player in that slot. If you are the only one online and use the number 1, It will show up as yourself. If you then make it 2, it will show offline, since there is only one player on the server. It will show the players head.

Item Type

This is where you can declare special types for items.

• placeable this will allow the player to take the item and place other items in this slot.

• noAttributes this will stop the attributes of the items from being hidden automatically.

• noNBT this will remove the NBT from items in panels, so they will not be removed if taken out of the GUI. This is useful for panel custom items, so that items will not be deleted when the panel is closed.

• dropItem will make the item that is in the current slot always drop when the panel is closed. This is useful in conjunction with the placeable item type

• removeItem will make the item that is in the slot go back into the players inventory when the panel is closed.

itemType:
- placeable
- noAttributes
- noNBT
- dropItem
- removeItem

Item ID

The ID for your material, leave it as 0 unless you, for example, want an item that is coloured like coloured wool. This is only necessary for legacy Minecraft versions.

ID: '0'

Item Name

The name of the item. If you would like the item to have no name/an empty name, you will need to name the item '&f'.

name: '&aSurvival'

Item Stack

How many are in the stack of the item. If this is removed from the item it will not be stacked.

stack: 1

Enchantments

Set to true, if you want the item to be enchanted. You can remove this to set it to false. You can add a specific enchantment. eg "enchanted: KNOCKBACK 3".

enchanted: true

You can also list multiple custom enchantments, find the example below:

enchanted:
- KNOCKBACK 3
- SHARPNESS 4

Item NBT Data

Add different NBT values to your item. A key (title) and a value are required for every NBT tag. In the example below, if you search for the NBT tag "example", it will output 'test'.

nbt:
  example: test

Custom Model Data

Set the Custom Model Data value for the item to anything you would like.

customdata: 1000001

Item Damage

Set the amount of damage to an item. In non-legacy versions of Minecraft setting this to -1 will make the item unbreakable.

damage: 10

Armour Colour

This will allow you to change armour colour if you have leather armour You can use an RGB colour, or you can find a specific colour from the spigot's API.

leatherarmor: 136,0,255
OR
leatherarmor: CYAN

Potion Effects

You can change your potion effect type by using the following figure in your item To view different potion names, find PotionType from spigot's API. You can use this for all items that can have potion effects (eg. tipped arrows). The [extended?] spot should be replaced with true/false, depending on if you want the potion to be the longer-lasting version of that potion or not. The [upgraded?] area is also true/false if you want the potion to be a higher level. For example Instant Healing II

(Legacy versions of Minecraft do not use this feature, instead use the Item ID)

potion: HEAL [extended?] [upgraded?]

Item Lore

Add as many lines as you need, this is the item's lore. You can also use the \n symbol in order to create new lines instead.

lore:
- '&2Heal Yourself and'
- '&2change gamemode to survival.'

Item Commands

Commands that will execute when the user clicks the item, it will execute in order and if the player doesn't have permission to use a command, they will not be able to execute it. You can use Panel Command Tags in this section!

commands:
- heal
- gamemode survival

Item Refresh Commands

Refresh commands will execute when the panel items refresh. If these commands are behind a Has Section, they will not run unless the Has Section parameters allow them to do so.

refresh-commands:
- "cpc"
- "msg= Closed due to inactivity!"

Duplicate Items

If you have an item that you want to duplicate across the panel, using the duplicate method will be the way to do it, simply add the below to your item to duplicate it. Keep in mind this will only duplicate the item visually and if there are commands in the item they will not work in the duplicated items. The below example will duplicate the item into the slots 0 to 9, the slot 13 and then slots 17 to 27.

duplicate: "0-9,13,17-27"