Implemented Item_Use events

src/main/java/org/bukkit/event/player/PlayerItemEvent.java

@@ -0,0 +1,67 @@
+package org.bukkit.event.player;
+
+import org.bukkit.ItemStack;
+import org.bukkit.Material;
+import org.bukkit.Player;
+import org.bukkit.event.Cancellable;
+
+/**
+ * 
+ * @author durron597
+ *
+ */
+public class PlayerItemEvent extends PlayerEvent implements Cancellable {
+    protected ItemStack item;
+    protected boolean cancel;
+    
+    public PlayerItemEvent(Type type, Player who, ItemStack item) {
+        super(type, who);
+        this.item = item;
+        cancel = false;
+    }
+
+    /**
+     * Gets the cancellation state of this event. Set to true if you
+     * want to prevent buckets from placing water and so forth
+     * 
+     * @return boolean cancellation state
+     */
+    public boolean isCancelled() {
+        return cancel;
+    }
+
+    /**
+     * Sets the cancellation state of this event. A cancelled event will not
+     * be executed in the server, but will still pass to other plugins
+     *
+     * Cancelling this event will prevent use of food (player won't lose the
+     * food item), prevent bows/snowballs/eggs from firing, etc. (player won't
+     * lose the ammo)
+     *
+     * @param cancel true if you wish to cancel this event
+     */
+    public void setCancelled(boolean cancel) {
+        this.cancel = cancel;
+    }
+    
+    /**
+     * Returns the item in hand represented by this event
+     * 
+     * @return ItemStack the item used
+     */
+    public ItemStack getItem() {
+        return this.item;
+    }
+    
+    /**
+     * Convenience method. Returns the material of the item represented by this
+     * event
+     * 
+     * @return Material the material of the item used
+     */
+    public Material getMaterial() {
+        if (this.item == null) return Material.Air;
+        
+        return item.getType();
+    }
+}