Skip to main content

Item Format

Follow the format below to configure an item in config files.

warning

Don't follow this format if you are using Guilds plugin, follow instead the Gui Item Configuration format.

tip

Display names and lores support legacy (e.g. &c) and hex (e.g. #ff0000) color formats.

PropertyDescriptionExamples
materialSets the material of the item

Supports custom heads,
ItemsAdder, Nexo, Oraxen, MMOItems and EcoItems
<material> texture:<value>
<itemsadder/ia>:<namespace>:<id>
nexo:<id>
<oraxen/oxn>:<id>
mmoitems:<type>:<id>
ecoitems:<id>
nameSets the display name of the item&e&lExample
#ffff00Example
loreSets the lore of the item- "&dFirst Line"
- "&dSecond Line"
glowAdds a glowing effect to the itemtrue false
textureSets the texture of a player head<uuid> <username> <base64-value>
https://textures.minecraft.net/<hash>
amountSets the amount of the item<number>
custom-model-dataSets the custom model data of the item<number>
unbreakableSets the unbreakable state of the itemtrue false
durabilitySets the durability of the item<number>
colorSets the color of the item
Supports Dye Colors and RGB values
<dye-color>
<rr>:<gg>:<bb>
armor-trimSets the trim of the armor<material>:<pattern>
flagsAdds a list of item flags to the item- <flag>
effectsAdds a list of potion effects to a potion- <type>:[seconds]:[level]
enchantmentsAdds a list of enchantments to the item- <type>:[level]
modifiersAdds a list of attribute modifiers to the item- <type>:<value>:[equipment-slot]

Example Configuration

example-item:
material: DIAMOND_SWORD
name: "&e&lExample"
lore:
- "&dFirst Line"
- "&dSecond Line"
glow: true
amount: 1
custom-model-data: 123
unbreakable: true
flags:
- "HIDE_ENCHANTS"
enchantments:
- "FIRE_ASPECT,2"
modifiers:
- "GENERIC_MOVEMENT_SPEED,1"