net.minecraftforge.common

Interface IShearable

All Known Implementing Classes:

BlockDeadBush, BlockDoublePlant, BlockLeaves, BlockNewLeaf, BlockOldLeaf, BlockTallGrass, BlockVine, BlockWeb, EntityMooshroom, EntitySheep, EntitySnowman

public interface IShearable

This allows for mods to create there own Shear-like items and have them interact with Blocks/Entities without extra work. Also, if your block/entity supports the Shears, this allows you to support mod-shears as well.

Method Summary

Modifier and Type	Method and Description
boolean	isShearable(ItemStack item, IBlockAccess world, BlockPos pos) Checks if the object is currently shearable Example: Sheep return false when they have no wool
java.util.List<ItemStack>	onSheared(ItemStack item, IBlockAccess world, BlockPos pos, int fortune) Performs the shear function on this object.

Method Detail

isShearable

boolean isShearable(@Nonnull
                    ItemStack item,
                    IBlockAccess world,
                    BlockPos pos)

Checks if the object is currently shearable Example: Sheep return false when they have no wool

Parameters:

item - The ItemStack that is being used, may be empty.

world - The current world.

pos - Block's position in world.

Returns:

If this is shearable, and onSheared should be called.

onSheared

@Nonnull
java.util.List<ItemStack> onSheared(@Nonnull
                                             ItemStack item,
                                             IBlockAccess world,
                                             BlockPos pos,
                                             int fortune)

Performs the shear function on this object. This is called for both client, and server. The object should perform all actions related to being sheared, except for dropping of the items, and removal of the block. As those are handled by ItemShears itself. Returns a list of items that resulted from the shearing process. For entities, they should trust there internal location information over the values passed into this function.

Parameters:

item - The ItemStack that is being used, may be empty.

world - The current world.

pos - If this is a block, the block's position in world.

fortune - The fortune level of the shears being used.

Returns:

A List containing all items from this shearing. May be empty.