ItemBuilder

The ItemBuilder is a utility in LarroxUtilsAPI that simplifies the creation of custom ItemStacks in Bukkit/Spigot.
It provides a fluent API to set names, lores, enchantments, flags, and even skull owners, making item creation cleaner and more readable.

---

Note

Don’t forget to import:

import dev.larrox.ItemBuilder;

---

🚀 Features

• Create items with custom names (supports & color codes).
• Add lores (multi-line descriptions) with automatic color conversion.
• Apply enchantments with levels.
• Add item flags (e.g., hide enchantments).
• Set player skull owners (works only for PLAYER_HEAD).
• Build the final ItemStack in one line.

---

🛠️ Examples

Create a custom sword

ItemStack sword = new ItemBuilder(Material.DIAMOND_SWORD)
    .setName("&bEpic Sword")
    .setLore("&7This sword was forged by Larrox", "&cHandle with care!")
    .addEnchant(Enchantment.DAMAGE_ALL, 5)
    .addFlags(ItemFlag.HIDE_ENCHANTS)
    .build();

---

Create a player head with owner

OfflinePlayer player = Bukkit.getOfflinePlayer("Larrox");

ItemStack skull = new ItemBuilder(Material.PLAYER_HEAD)
    .setName("&aLarrox's Head")
    .setOwner(player)
    .build();

---

Create a simple item with lore

ItemStack apple = new ItemBuilder(Material.APPLE)
    .setName("&cMagic Apple")
    .setLore("&7Restores health", "&7Tastes delicious")
    .build();

---

✅ Best Practices

• Always call .build() at the end to get the finished ItemStack.
• Use & color codes in names and lores — they are automatically converted to §.
• Use .addFlags(ItemFlag.HIDE_ENCHANTS) if you want to hide enchantment glow while still applying effects.
• Only call .setOwner() if the item is a PLAYER_HEAD, otherwise it has no effect.

---