[Util] ItemBuilder: Chainable ItemStack Builder [v1.2]

Hello guys,
creating ItemStack with names and lores and stuff was always a pain when working with bukkit.
But I have a solution...... *drum-roll*
ItemBuilder: The Chainable ItemStack Builder!

Now you will ask: "What does this?" or "Why should I use it?".
The answer is pretty simple: It let you create ItemStacks with a easy-to-use chainable builder. And it's just one class. And it's free (credits appreciated)

Convinced? Wait, I will show you how to use it:

Code:java

ItemStack is = new ItemBuilder(Material.WOOL).amount(2)
.data(4).durability(4).enchantment(Enchantment.ARROW_INFINITE)
.enchantment(Enchantment.LUCK, 2).name(ChatColor.RED + "the name")
.lore(ChatColor.GREEN + "line 1").lore(ChatColor.BLUE + "line 2").build();

If you wanted to do that without a chainable builder it would look like this:

Code:java

ItemStack is = new ItemStack(Material.WOOL);
is.setAmount(2);
is.setData(new MaterialData(is.getType(), (byte) 4));
is.setDurability((short) 4);
is.addUnsafeEnchantment(Enchantment.ARROW_INFINITE, 1);
is.addUnsafeEnchantment(Enchantment.LUCK, 2);
ItemMeta meta = is.getItemMeta();
meta.setDisplayName(ChatColor.RED + "the name");
List<String> lore = new ArrayList<String>();
lore.add(ChatColor.GREEN + "line 1");
lore.add(ChatColor.BLUE + "line 2");
meta.setLore(lore);
is.setItemMeta(meta);

Looks like pain, right?
But ItemBuilder can more:
Just want to clear the lore and add a new line for the item in the players hand?

Code:java

is = new ItemBuilder(is).clearLore()
.lore("New Lore").build();

Old-school style:

Code:java

ItemMeta meta = is.getItemMeta();
List<String> lore = new ArrayList<String>();
lore.add("New Lore");
meta.setLore(lore);
is.setItemMeta(meta);

Just want to clear all enchantments and add a new one for the item in the players hand?

Code:java

is = new ItemBuilder(is).clearEnchantments()
.enchantment(Enchantment.LUCK).build();

Old-school style:

Code:java

for(Enchantment e : is.getEnchantments().keySet()){
is.removeEnchantment(e);
}
is.addUnsafeEnchantment(Enchantment.LUCK, 1);

Just want to change the color of a players armor? (v1.1)

Code:java

is = new ItemBuilder(is).color(Color.MAROON).build();

Old-school style:

Code:java

LeatherArmorMeta meta = (LeatherArmorMeta) is.getItemMeta();
meta.setColor(Color.MAROON);
is.setItemMeta(meta);

Now convinced? Here's the download

Liked it? Feel free to comment down below!

Changelog:

• v1.0: Release
• v1.1: Added color for leather armor
• v1.2: Added effect to apply potion effects when consuming an item

 

Cool! - Love chains. Pull req' into spigot or bukkit
- You don't need setMaterial, as you create it already in the itemstack.

 

Looks awesome! Great job will definitely try it out soon!

 

ChipDev Thank you, I would have already done it, if the repos where accessible I added type for the case you want to change the type of a predefind stack (e.g from the players inventory)
Monkey_Swag Thank you

 

Having your class extend ItemStack will get rid of the need for a lot *one of your methods.

 

teej107 can you give me an example?

 

....really?
http://docs.oracle.com/javase/tutorial/java/IandI/subclasses.html

PHP:

public class Whatever extends SomeObject

 

teej107 ^^ I know how inheritance works in java. But I don't see the benifits for this util extending ItemStack

 

You wouldn't need to call build(). You are making an ItemStack so why not make it an ItemStack?

 

teej107 because I want a chainable builder That's the whole point of this util

 

MiniDigger I know. I was just giving my advice. Extending ItemStack will get rid of the need for the build() method and will make the whole class an ItemStack eliminating the need to call build().

 

Yea, cause Bukkit and Spigot still accept PR's...

 

teej107 Now I understand what you mean. I don't realy think that this is necessary. I have no problems with that three extra lines. thanks anyway

 

Yea. I thought about that after I posted; too lazy to delete

 

UPDATE: Added changelog and the color(org.bukkit.Color) method to change the color a leather armor part

UPDATE: Added effect methods to add a potion effects to a item which gets applied when the player consumes that item. (documentation will follow) (next update will contain potion effects for wearables)

EDIT by Moderator: merged posts, please use the edit button instead of double posting.

 

Using the normal API to create items have always been a pain in the butt! thanks

 

MiniDigger Is it just me or that mob eggs don't work for this?

 

Jaaakee224 should works the same. What exactly is your problem? Can you pastbin your code and any errors you meight see? And what do you see ingame when giving the item? I can't work without any informations ;D

 

MiniDigger

Code:java

ItemStack pets = new ItemStackBuilder(Material.MONSTER_EGG).amount(1).data(98)
.name(ChatColor.GREEN + "Pets")
.lore("Want a follower? Pick your pet here!").build();

This should give me an Ocelot Spawn Egg, but it just gives a white egg instead. No errors in console/in game whatsoever.

 

Jaaakee224 I remenber there was that weird thing with eggs in bukkit. There is Material.MONSTER_EGG and MONSTER_EGGS. Try the other one ;D
http://jd.bukkit.org/rb/apidocs/org/bukkit/Material.html#MONSTER_EGGS

 

MiniDigger
When I change it to Material.MONSTER_EGGS it changes it to a stone block.

 

Jaaakee224 just searched a bit around. The client doesn't use the data tag but the durability for displaying the icon and spawning and stuff. So you just need to replace .data with .durability and it should works (tested that)

 

MiniDigger
Worked! Thank you!

 

Bukkit is so weird sometimes....