Item Builders

🧭 Overview

The item-builder section defines every property of an item, including its appearance, behavior, and effects. This system is used across all menus in ArenaLegends.

---

🛠 Field Table

Field	Type	Description
name	string	Display name of the item. Supports color codes (&).
lore	list	Item description lines. Supports multiple lines.
type	material	Bukkit Material type (e.g., IRON_SWORD, PAPER).
amount	integer	Stack size (default: 1).
damage	integer	Durability/damage value (default: 0).
model	integer	Custom model data for resource packs.
glint	boolean	Adds enchantment glow without an actual enchant.
head	string	Player head texture (Username, UUID, or Base64).
attributes	list	Modifies default attributes (e.g., ATTACK_DAMAGE).
potions	list	Potion effects (for SPLASH_POTION, etc.).
tags	list	Custom NBT tags (key;value).
enchants	list	Enchantments (enchant{NAME} power{LEVEL}).

---

💡 Examples

🔹 Simple Icon

meta-builder:
  name: "&aSimple Icon"
  lore:
    - "&7Just a description."
  type: PAPER
  amount: 1
  model: 1001
  glint: false

🔹 Complex Weapon

meta-builder:
  name: "&cNecrotic Sword"
  lore:
    - "&8A blade that drains life."
  type: IRON_SWORD
  attributes:
    - "attribute{ATTACK_DAMAGE} operation{ADD_NUMBER} value{7.0} slot{HAND}"
  enchants:
    - "enchant{SHARPNESS} power{5}"
    - "enchant{UNBREAKING} power{3}"