Item Configuration
Here you can view all the configuration, examples and options for creating items in Player Warps.

Item Creation

In Player Warps you customize the items that are displayed in the menu, how they are displayed and what they do, there are a lot of item tags for you to be able to accomplish this.

Item Material

When creating an item, you will always need to provide a material type, material type is just what the item is. Make sure when using item materials, they're all capitals and they are a correct material from the list here.
Make sure the material you're using from the list, exists in your Minecraft version otherwise the item will not be shown in the menu. If you're using a Minecraft version lower than 1.13, you may want to also check out Item Data.
Here is an example on how to use materials, below in the example it will show a diamond sword in the menu.

Configuration Example

1
1:
2
material: DIAMOND_SWORD
3
amount: 1
4
slot: 0
Copied!
Here is a preview of what the above example would look like in the menu.

Preview

Item Data

When creating an item in Minecraft versions 1.12 and below, you may need to provide an item data type to correspond to the item you want. These item data types are usually used when you have multiple types or states of one block for example stained glass, you have multiple colors of this glass.
If you need to get the item data, you can use F3+H in game to enable advanced tooltips, then you will be able to view the item data type after the / like shown below.
The item above shows an item id of 2.
You can also use item data to specify the damage value of the item as well, this will only work if the item can actually be damaged though.
Here is an example on how to use materials with item data values, below in the example it will show a magenta stained glass pane in the menu.

Configuration Example

1
1:
2
material: STAINED_GLASS_PANE
3
data: 2
4
amount: 1
5
slot: 0
Copied!
Here is a preview of what the above example would look like in the menu.

Item Amount

When creating an item, you will need to specify the amount you want to be displayed in the menu. If you do not specify any amount, the default will be thus making it not showing in the menu.
You cannot exceed over the maximum stack size of the menu, which is 64, the number will also need to be a positive number as well.

Item Name

When creating an item, you can modify the item name that is displayed when you hover over the item. With display names you may also have color codes in the name as well to make it stand out in the menu.
Here is an example on how to use item names, below in the example it will show a diamond sword with the name as Knife as red in the menu.

Configuration Example

1
1:
2
material: DIAMOND_SWORD
3
name: "&cKnife"
4
amount: 1
5
slot: 0
Copied!
Here is a preview of what the above example would look like in the menu.

Preview

Item Lore

When creating an item, you can have a description in your item so when you hover over the item it will show the description below the item name. With lores you can have color codes and have multiple lines in the description as well.
The color will not go onto the next line so you will also need to put it on the other lines as well.
Here is an example on how to use item lores, below in the example it will show a diamond sword with the 1st line as This is a item, with the color blue with the second line as description example. with the color blue again in the menu.

Configuration Example

1
1:
2
material: DIAMOND_SWORD
3
lore:
4
- "&bThis is a item"
5
- "&bdescription example."
6
amount: 1
7
slot: 0
Copied!
Here is a preview of what the above example would look like in the menu.

Preview

Item Glowing

When creating an item, you can give the item a glowing affect, it gives the item an invisible enchantment that you cannot see and makes your menu look more shiny.
Here is an example on how to use the glowing affect, below in the example it will show a glowing diamond sword in the menu.

Configuration Example

1
1:
2
material: DIAMOND_SWORD
3
glowing: true
4
amount: 1
5
slot: i
Copied!
Here is a preview of what the above example would look like in the menu.

Preview

Skull Owner

When creating player heads, you can give the player head an owner. The owner of player head will be the skin of the head, you can put any players name as the owner or you could put [owner] for it to set the skulls owner as the player that is viewing the menu.
Remember, when creating player heads its different in 1.13 and 1.12 and below. If you're using 1.12 and below please make sure the data value is 3 and the material is SKULL, if you're using 1.13 you will not need a data value and the material will be PLAYER_HEAD
Here is an example on how to create player heads with an owner, below in the example it will show a skull with my skin as I'm viewing the menu.

Configuration Example

1
1: # Example for 1.13+
2
material: PLAYER_HEAD
3
owner: [owner]
4
amount: 1
5
slot: 0
6
2: # Example for 1.12-
7
material: SKULL_ITEM
8
owner: [owner]
9
data: 3
10
amount: 1
11
slot: 0
Copied!
Here is a preview of what the above example would look like in the menu.

Preview

Skull Texture

When creating player heads, you can give the player head a texture. Unlike the skull owners, an existing player has to have that skin textures don't and you can create and use some awesome looking skulls.
There are loads of sites you can get the Base64 texture from like here and then copy the value field for your texture.
Here is an example on how to create player heads with a texture, below in the example it will show a skull with as a computer.

Configuration Example

1
1: # Example for 1.13+
2
material: PLAYER_HEAD
3
texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYTc4Mjk1ZThlYzEwZjlmYmEzZjBjN2IxMTRkMzM0OTkyYjAzZjRlMjNmODA2NDc2NmVlNDM0ZGRjZGExMjdmMSJ9fX0=
4
amount: 1
5
slot: 0
6
2: # Example for 1.12-
7
material: SKULL_ITEM
8
owner: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYTc4Mjk1ZThlYzEwZjlmYmEzZjBjN2IxMTRkMzM0OTkyYjAzZjRlMjNmODA2NDc2NmVlNDM0ZGRjZGExMjdmMSJ9fX0=
9
data: 3
10
amount: 1
11
slot: 0
Copied!
Here is a preview of what the above example would look like in the menu.

Preview

Potion Data

When creating potions, you can select any type of potion material. For example SPASH_POTION, POTION, LINGERING_POTION etc...
A potion will also need the effect, duration and the amplifier.
The effect of potion is what is given to you when the potion is splashed. You can view all the potion effect names here.
The amplifier is how strong the potion is, remember this starts from 0!
The duration is how long the potion lasts, this is measured in ticks (20 ticks = 1 second) and not seconds!
Here is an example on how to create potions, below in the example it will show a splash potion with speed 2 lasting for 2 seconds.

Configuration Example

1
1:
2
material: SPLASH_POTION
3
effect: SPEED
4
amplifier: 1
5
duration: 40
6
amount: 1
7
slot: 0
Copied!
Here is a preview of what the above example would look like in the menu.

Preview

Item Flags

When creating items, you can disable the item flags for the item so it doesn't show information that you may not want to show when hovering over the item. Make sure when using item flags, they're all capitals and they are a correct flag from the list here.
Here is an example on how to use item flags, below in the example it will show a diamond sword in the menu without the When in main hand: in the menu.

Configuration Example

1
1:
2
material: DIAMOND_SWORD
3
item-flags:
4
- "HIDE_ATTRIBUTES"
5
amount: 1
6
slot: 0
Copied!
Here is a preview of what the above example would look like in the menu.

Preview

Item Enchantments

When creating an item, you can add enchantments and what level of those enchantments on that item. Make sure when you're adding enchantments, they're all capitals and they are a enchantment from the list here.
Here is an example on how to use enchantments, below in the example it will show a diamond sword in the menu with the unbreaking level 1 enchantment.

Configuration Example

1
1:
2
material: DIAMOND_SWORD
3
enchantments:
4
- "DURABILITY:1"
5
amount: 1
6
slot: 0
Copied!
Here is a preview of what the above example would look like in the menu.

Preview

Item NBT Data

When creating an item, you can specify NBT item tags for your item for whatever reason. NBT tags have two parts, the key and the value.
Here is an example on how to use item NBT data, below in the example it will show a diamond sword in the menu with a NBT data string named Sword and the value being Awesome.

Configuration Example

1
1:
2
material: DIAMOND_SWORD
3
nbt-data:
4
- "Sword:Awesome"
5
amount: 1
6
slot: 0
Copied!

Item Model Data

When creating an item, you may want the item be displayed as a texture from your texture pack.
Here is an example on how to use item custom model data, below in the example it will show a diamond sword in the menu with a custom model data of 1.

Configuration Example

1
1:
2
material: DIAMOND_SWORD
3
custom-model-data: 1
4
amount: 1
5
slot: 0
Copied!

Item Unbreakable

When creating an item with damage, you may want the durability status to be removed from the tooltip on the item if some players have the setting "Item Tooltips" enabled.
Here is an example on how to use unbreakable.

Configuration Example

1
1:
2
material: DIAMOND_SWORD
3
unbreakable: true
4
amount: 1
5
slot: 0
Copied!

Item Slot

When creating an item, you will need to specify a slot of where your item will be in the menu. Item slots always start from 0, meaning slot 0 will be slot 1 in the menu.
Slots can only be 0 to the menu size - 1, for example if your menu size is 27, it'll be 0-26. There are 3 different ways on how you can specify slots in the configuration.
Here is an example on how to use item slots, below in the example it will show a diamond sword in the slots 0, 1, 2, 3, 4, 5, 6, 7, 8 of the menu.
If you wish to remove an existing item from the inventory, but you want to keep it in the file. You can set the slot to -1 to remove it from the menu.

Configuration Example

1
1: # Using the slot range system
2
material: DIAMOND_SWORD
3
slot: 0-8
4
amount: 1
5
2: # Using the slot list system
6
material: DIAMOND_SWORD
7
slot: [0, 1, 2, 3, 4, 5, 6, 7, 8]
8
amount: 1
9
3:
10
# Using the manual slot system, then repeat this 7 more
11
# times but with a different slot number. (very painful)
12
material: DIAMOND_SWORD
13
slot: 0
14
amount: 1
Copied!

Item Commands

When creating an item, you may want the item to execute a type of action when left or right clicking the item. You can view the command actions and how to use them here.
Here is an example on how to use item commands, below in the example it will show a diamond sword in the menu and when you click on it it'll say hey in chat.

Configuration Example

1
1: # Only listening for right click
2
material: DIAMOND_SWORD
3
right-commands:
4
- "[message] hey"
5
amount: 1
6
slot: 0
7
2: # Only listening for left click
8
material: DIAMOND_SWORD
9
left-commands:
10
- "[message] hey"
11
amount: 1
12
slot: 0
13
3: # Listening for both
14
material: DIAMOND_SWORD
15
commands:
16
- "[message] hey"
17
amount: 1
18
slot: 0
Copied!
Here is a preview of what the above example how it works in the menu.

Preview

Item Placeholders