Item Builders
🧭 Overview
The equipment-builder section defines every property of an item, including its appearance, behavior, and effects.
🛠 Field Table
Understanding these fields is crucial — items are the foundation of the plugin.
They’re used in menus, given to players, and interact with triggers, upgrades, and other systems.
ignore-slot
true/false
If true, the item will ignore menu slot restrictions.
name
String
Display name of the item, supports color codes (&).
lore
List<String>
Item description lines, supports multiple lines and color codes.
type
Minecraft Material
Item type (e.g., IRON_SWORD, BELL, PAPER).
amount
Integer
Stack size of the item (usually 1 for unique items).
damage
Integer
Item durability / damage value. Typically 0 for new items.
model
Integer
Custom model data (used for resource packs).
glint
true/false
Adds enchantment glow effect without an actual enchant.
head
String
Optional player head texture (Minecraft username or custom texture).
attributes
List<String>
Modifies Minecraft’s default item attributes (e.g., ATTACK_DAMAGE, ARMOR).
potions
List<String>
Only applies to POTION, SPLASH_POTION, and LINGERING_POTION. Format: effect{EFFECT} duration{TICKS} amplifier{LEVEL} ambient{true/false} particles{true/false}
tags
List<String>
Custom key/value data, primarily for other plugins or detecting custom data. No gameplay effect by default. Format: "key;value"
enchants
List<String>
Enchantments applied to the item. Format: enchant{ENCHANT} power{LEVEL}
💡 Examples
🔹 Necrotic Sword
🔹 Healing Splash Potion
Last updated