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

In Player Auctions 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.

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.

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

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.

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

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.

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.

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

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.

1:
material: DIAMOND_SWORD
lore:
- "&bThis is a item"
- "&bdescription example."
amount: 1
slot: 0
Here is a preview of what the above example would look like in the menu.

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.

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

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.

1: # Example for 1.13+
material: PLAYER_HEAD
owner: [owner]
amount: 1
slot: 0
2: # Example for 1.12-
material: SKULL_ITEM
owner: [owner]
data: 3
amount: 1
slot: 0
Here is a preview of what the above example would look like in the menu.

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.

1: # Example for 1.13+
material: PLAYER_HEAD
texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYTc4Mjk1ZThlYzEwZjlmYmEzZjBjN2IxMTRkMzM0OTkyYjAzZjRlMjNmODA2NDc2NmVlNDM0ZGRjZGExMjdmMSJ9fX0=
amount: 1
slot: 0
2: # Example for 1.12-
material: SKULL_ITEM
owner: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYTc4Mjk1ZThlYzEwZjlmYmEzZjBjN2IxMTRkMzM0OTkyYjAzZjRlMjNmODA2NDc2NmVlNDM0ZGRjZGExMjdmMSJ9fX0=
data: 3
amount: 1
slot: 0
Here is a preview of what the above example would look like in the menu.

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.

1:
material: SPLASH_POTION
effect: SPEED
amplifier: 1
duration: 40
amount: 1
slot: 0
Here is a preview of what the above example would look like in the menu.

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.

1:
material: DIAMOND_SWORD
item-flags:
- "HIDE_ATTRIBUTES"
amount: 1
slot: 0
Here is a preview of what the above example would look like in the menu.

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.

1:
material: DIAMOND_SWORD
enchantments:
- "DURABILITY:1"
amount: 1
slot: 0
Here is a preview of what the above example would look like in the menu.

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.

1:
material: DIAMOND_SWORD
nbt-data:
- "Sword:Awesome"
amount: 1
slot: 0

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.

1:
material: DIAMOND_SWORD
custom-model-data: 1
amount: 1
slot: 0

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.

1:
material: DIAMOND_SWORD
unbreakable: true
amount: 1
slot: 0

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.

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

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.

1: # Only listening for right click
material: DIAMOND_SWORD
right-commands:
- "[message] hey"
amount: 1
slot: 0
2: # Only listening for left click
material: DIAMOND_SWORD
left-commands:
- "[message] hey"
amount: 1
slot: 0
3: # Listening for both
material: DIAMOND_SWORD
commands:
- "[message] hey"
amount: 1
slot: 0
Here is a preview of what the above example how it works in the menu.

Copy link
On this page
Item Creation
Item Material
Item Data
Item Amount
Item Name
Item Lore
Item Glowing
Skull Owner
Skull Texture
Potion Data
Item Flags
Item Enchantments
Item NBT Data
Item Model Data
Item Unbreakable
Item Slot
Item Commands
Item Placeholders