Chisel/src/main/java/com/cricketcraft/chisel/api/IChiselItem.java

package com.cricketcraft.chisel.api;

import net.minecraft.block.Block;
import net.minecraft.entity.player.EntityPlayer;
import net.minecraft.inventory.IInventory;
import net.minecraft.item.ItemStack;
import net.minecraft.world.World;

/**
 * Implement this on items which can be used to chisel blocks.
 */
public interface IChiselItem extends IChiselMode {

	/**
	 * Checks whether the chisel can have its GUI opened
	 * 
	 * @param world
	 *            {@link World} object
	 * @param player
	 *            The player holding the chisel. It can always be assumed that the player's current item will be this.
	 * @param chisel
	 *            The {@link ItemStack} representing your chisel
	 * @return True if the GUI should open. False otherwise.
	 */
	boolean canOpenGui(World world, EntityPlayer player, ItemStack chisel);

	/**
	 * Called when an item is chiseled using this chisel
	 * 
	 * @param world
	 *            {@link World} object
	 * @param inv
	 *            The inventory this chisel is currently in
	 * @param slot
	 *            The slot index of the chisel in the inventory
	 * @param chisel
	 *            The {@link ItemStack} representing the chisel
	 * @param target
	 *            The {@link ItemStack} representing the target item
	 */
	void onChisel(World world, IInventory inv, int slot, ItemStack chisel, ItemStack target);

	/**
	 * Allows you to control if your item can chisel this block in the world.
	 * 
	 * @param world
	 *            World object
	 * @param x
	 *            X coord of the block being chiseled
	 * @param y
	 *            Y coord of the block being chiseled
	 * @param z
	 *            Z coord of the block being chiseled
	 * @param block
	 *            The {@link Block} being chiseled
	 * @param metadata
	 *            The blocks' metadata
	 * @return True if the chiseling should take place. False otherwise.
	 */
	boolean canChiselBlock(World world, int x, int y, int z, Block block, int metadata);
}