MagicBees/src/main/java/magicbees/api/bees/ITransmutationEffectLogic.java

package magicbees.api.bees;

import net.minecraft.item.ItemStack;
import net.minecraft.world.World;
import net.minecraft.world.biome.BiomeGenBase;

/**
 * Class to control plugin logic for the Transmutation bee effect. Turns blocks
 * into other blocks based on biome, time of day, or whatever is deemed
 * appropriate at the time.
 *
 * @author MysteriousAges
 *
 */
public interface ITransmutationEffectLogic {
    /**
     * Allows an external mod to add transmutation logic to the Transmuting bee effect.
     * Called from a list of ITransmutationEffectLogic until one returns true. You can
     * implement more than one transmutation effect in a single implementation of the
     * interface. Function checks for a series of conditions based on block ID/meta, or
     * biome information, or world information.
     *
     * @param world World object
     * @param biome Biome information for current coordinates
     * @param sourceBlock ItemStack representing the block at current coordinates
     * @param x Current X coordinate to attempt a transmute
     * @param y Current Y coordinate to attempt a transmute
     * @param z Current Z coordinate to attempt a transmute
     * @return true if a block was changed.
     */
    public boolean tryTransmutation(World world, BiomeGenBase biome, ItemStack sourceBlock, int x, int y, int z);
}