Cleanup, sounds for Chainsaws.

src/api/java/baubles/api/BaubleType.java

@@ -0,0 +1,7 @@
+package baubles.api;
+
+public enum BaubleType {
+    RING,
+    AMULET,
+    BELT
+}

src/api/java/baubles/api/BaublesApi.java

@@ -0,0 +1,35 @@
+package baubles.api;
+
+import cpw.mods.fml.common.FMLLog;
+import net.minecraft.entity.player.EntityPlayer;
+import net.minecraft.inventory.IInventory;
+
+import java.lang.reflect.Method;
+
+/**
+ * @author Azanor
+ */
+public class BaublesApi {
+    static Method getBaubles;
+
+    /**
+     * Retrieves the baubles inventory for the supplied player
+     */
+    public static IInventory getBaubles(EntityPlayer player) {
+        IInventory ot = null;
+
+        try {
+            if (getBaubles == null) {
+                Class<?> fake = Class.forName("baubles.common.lib.PlayerHandler");
+                getBaubles = fake.getMethod("getPlayerBaubles", EntityPlayer.class);
+            }
+
+            ot = (IInventory) getBaubles.invoke(null, player);
+        } catch (Exception ex) {
+            FMLLog.warning("[Baubles API] Could not invoke baubles.common.lib.PlayerHandler method getPlayerBaubles");
+        }
+
+        return ot;
+    }
+
+}

src/api/java/baubles/api/IBauble.java

@@ -0,0 +1,44 @@
+package baubles.api;
+
+import net.minecraft.entity.EntityLivingBase;
+import net.minecraft.item.ItemStack;
+
+/**
+ * @author Azanor
+ *         <p/>
+ *         This interface should be extended by items that can be worn in bauble slots
+ */
+
+public interface IBauble {
+
+    /**
+     * This method return the type of bauble this is.
+     * Type is used to determine the slots it can go into.
+     */
+    public BaubleType getBaubleType(ItemStack itemstack);
+
+    /**
+     * This method is called once per tick if the bauble is being worn by a player
+     */
+    public void onWornTick(ItemStack itemstack, EntityLivingBase player);
+
+    /**
+     * This method is called when the bauble is equipped by a player
+     */
+    public void onEquipped(ItemStack itemstack, EntityLivingBase player);
+
+    /**
+     * This method is called when the bauble is unequipped by a player
+     */
+    public void onUnequipped(ItemStack itemstack, EntityLivingBase player);
+
+    /**
+     * can this bauble be placed in a bauble slot
+     */
+    public boolean canEquip(ItemStack itemstack, EntityLivingBase player);
+
+    /**
+     * Can this bauble be removed from a bauble slot
+     */
+    public boolean canUnequip(ItemStack itemstack, EntityLivingBase player);
+}

src/api/java/baubles/api/package-info.java

@@ -0,0 +1,3 @@
+@API(apiVersion = "1.7.10-1.0.1.5", owner = "Baubles", provides = "Baubles|API") package baubles.api;
+
+import cpw.mods.fml.common.API;

src/api/java/ic2/api/Direction.java

@@ -0,0 +1,135 @@
+package ic2.api;
+
+import java.util.EnumSet;
+import java.util.Set;
+
+import net.minecraft.tileentity.TileEntity;
+import net.minecraft.world.World;
+
+import net.minecraftforge.common.util.ForgeDirection;
+
+/**
+ * Represents the 6 possible directions along the axis of a block.
+ */
+public enum Direction {
+	/**
+	 * -X
+	 */
+	XN,
+	/**
+	 * +X
+	 */
+	XP,
+
+	/**
+	 * -Y
+	 */
+	YN, //MC-Code starts with 0 here
+	/**
+	 * +Y
+	 */
+	YP, // 1...
+
+	/**
+	 * -Z
+	 */
+	ZN,
+	/**
+	 * +Z
+	 */
+	ZP;
+
+	private Direction() {
+		int side = ordinal() / 2;
+		int sign = getSign();
+
+		xOffset = side == 0 ? sign : 0;
+		yOffset = side == 1 ? sign : 0;
+		zOffset = side == 2 ? sign : 0;
+	}
+
+	public static Direction fromSideValue(int side) {
+		return directions[(side + 2) % 6];
+	}
+
+	public static Direction fromForgeDirection(ForgeDirection dir) {
+		if (dir == ForgeDirection.UNKNOWN) return null;
+
+		return fromSideValue(dir.ordinal());
+	}
+
+	/**
+	 * Get the tile entity next to a tile entity following this direction.
+	 *
+	 * @param tileEntity tile entity to check
+	 * @return Adjacent tile entity or null if none exists
+	 */
+	public TileEntity applyToTileEntity(TileEntity te) {
+		return applyTo(te.getWorldObj(), te.xCoord, te.yCoord, te.zCoord);
+	}
+
+	/**
+	 * Get the tile entity next to a position following this direction.
+	 *
+	 * @param world World to check
+	 * @param x X coordinate to check from
+	 * @param y Y coordinate to check from
+	 * @param z Z coordinate to check from
+	 * @return Adjacent tile entity or null if none exists
+	 */
+	public TileEntity applyTo(World world, int x, int y, int z) {
+		int coords[] = { x, y, z };
+
+		coords[ordinal() / 2] += getSign();
+
+		if (world != null && world.blockExists(coords[0], coords[1], coords[2])) {
+			try {
+				return world.getTileEntity(coords[0], coords[1], coords[2]);
+			} catch (Exception e) {
+				throw new RuntimeException("error getting TileEntity at dim "+world.provider.dimensionId+" "+coords[0]+"/"+coords[1]+"/"+coords[2]);
+			}
+		}
+
+		return null;
+	}
+
+	/**
+	 * Get the inverse of this direction (XN -> XP, XP -> XN, etc.)
+	 *
+	 * @return Inverse direction
+	 */
+	public Direction getInverse() {
+		return directions[ordinal() ^ 1];
+	}
+
+	/**
+	 * Convert this direction to a Minecraft side value.
+	 *
+	 * @return Minecraft side value
+	 */
+	public int toSideValue() {
+		return (ordinal() + 4) % 6;
+	}
+
+	/**
+	 * Determine direction sign (N for negative or P for positive).
+	 *
+	 * @return -1 if the direction is negative, +1 if the direction is positive
+	 */
+	private int getSign() {
+		return (ordinal() % 2) * 2 - 1;
+	}
+
+	public ForgeDirection toForgeDirection() {
+		return ForgeDirection.getOrientation(toSideValue());
+	}
+
+	public final int xOffset;
+	public final int yOffset;
+	public final int zOffset;
+
+	public static final Direction[] directions = Direction.values();
+	public static final Set<Direction> noDirections = EnumSet.noneOf(Direction.class);
+	public static final Set<Direction> allDirections = EnumSet.allOf(Direction.class);
+}
+

src/api/java/ic2/api/crops/BaseSeed.java

@@ -0,0 +1,82 @@
+package ic2.api.crops;
+
+/**
+ * Base agriculture seed. Used to determine the state of a plant once it is planted from an item.
+ */
+public class BaseSeed {
+	/**
+	 * Create a BaseSeed object.
+	 *
+	 * @param crop plant
+	 * @param size plant size
+	 * @param statGrowth1 plant growth stat
+	 * @param statGain1 plant gain stat
+	 * @param statResistance1 plant resistance stat
+	 * @param stackSize1 for internal usage only
+	 */
+	@SuppressWarnings("deprecation")
+	public BaseSeed(CropCard crop, int size, int statGrowth, int statGain, int statResistance, int stackSize) {
+		super();
+		this.crop = crop;
+		this.id = Crops.instance.getIdFor(crop);
+		this.size = size;
+		this.statGrowth = statGrowth;
+		this.statGain = statGain;
+		this.statResistance = statResistance;
+		this.stackSize = stackSize;
+	}
+
+	/**
+	 * @deprecated Use the CropCard version.
+	 */
+	@Deprecated
+	public BaseSeed(int id, int size, int statGrowth, int statGain, int statResistance, int stackSize) {
+		this(getCropFromId(id), size, statGrowth, statGain, statResistance, stackSize);
+	}
+
+	@SuppressWarnings("deprecation")
+	private static CropCard getCropFromId(int id) {
+		CropCard[] crops = Crops.instance.getCropList();
+
+		if (id < 0 || id >= crops.length) return null;
+
+		return crops[id];
+	}
+
+
+	/**
+	 * Plant.
+	 */
+	public final CropCard crop;
+
+	/**
+	 * @deprecated IDs aren't used anymore.
+	 */
+	@Deprecated
+	public int id;
+
+	/**
+	 * Plant size.
+	 */
+	public int size;
+
+	/**
+	 * Plant growth stat.
+	 */
+	public int statGrowth;
+
+	/**
+	 * Plant gain stat.
+	 */
+	public int statGain;
+
+	/**
+	 * Plant resistance stat.
+	 */
+	public int statResistance;
+
+	/**
+	 * For internal usage only.
+	 */
+	public int stackSize;
+}

src/api/java/ic2/api/crops/CropCard.java

@@ -0,0 +1,431 @@
+package ic2.api.crops;
+
+import net.minecraft.client.renderer.texture.IIconRegister;
+import net.minecraft.entity.Entity;
+import net.minecraft.entity.EntityLivingBase;
+import net.minecraft.entity.player.EntityPlayer;
+import net.minecraft.item.ItemStack;
+import net.minecraft.util.IIcon;
+
+import cpw.mods.fml.common.Loader;
+import cpw.mods.fml.common.ModContainer;
+import cpw.mods.fml.relauncher.Side;
+import cpw.mods.fml.relauncher.SideOnly;
+
+/**
+ * Base agriculture crop.
+ *
+ * Any crop extending this can be registered using registerCrop to be added into the game.
+ */
+public abstract class CropCard {
+	public CropCard() {
+		modId = getModId(); // initialize mod id while we should be in the real owner's init event
+	}
+
+	/**
+	 * Plant name for identifying this crop within your mod.
+	 *
+	 * The name has to be unique within the mod and is used for saving.
+	 * By default this name will be also used to determine displayKey() and registerSprites().
+	 *
+	 * @note changing name or owner will cause existing crops in users' worlds to disappear.
+	 *
+	 * @return Plant name
+	 */
+	public abstract String name();
+
+	/**
+	 * Determine the mod id owning this crop.
+	 *
+	 * It's recommended to hard code this to your mod id.
+	 *
+	 * @note changing name or owner will cause existing crops in users' worlds to disappear.
+	 *
+	 * @return Mod id.
+	 */
+	public String owner() {
+		return modId;
+	}
+
+	/**
+	 * Translation key for display to the player.
+	 *
+	 * It's highly recommended to specify a valid key from your language file here, e.g. add
+	 * "yourmod.crop.yourCropName = Your crop's name" to the language file, override name() to
+	 * return "yourCropName" and override displayName() to return "yourmod.crop."+name().
+	 *
+	 * @return Unlocalized name.
+	 */
+	public String displayName() {
+		return name(); // return the raw name for backwards compatibility
+	}
+
+	/**
+	 * Your name here, will be shown in "Discovered by:" when analyzing seeds.
+	 *
+	 * @return Your name
+	 */
+	public String discoveredBy() {
+		return "unknown";
+	}
+
+	/**
+	 * Description of your plant. Keep it short, a few characters per line for up to two lines.
+	 * Default is showing attributes of your plant, 2 per line.
+	 *
+	 * @param i line to get, starting from 0
+	 * @return The line
+	 */
+	public String desc(int i) {
+		String[] att = attributes();
+
+		if (att == null || att.length == 0) return "";
+
+		if (i == 0) {
+			String s = att[0];
+			if (att.length >= 2) {
+				s+=", "+att[1];
+				if (att.length >= 3) s+=",";
+			}
+			return s;
+		}
+		if (att.length < 3) return "";
+		String s = att[2];
+		if (att.length >= 4) s+=", "+att[3];
+		return s;
+	}
+
+	/**
+	 * *
+	 * @param crop reference to ICropTile
+	 * @return roots lengt use in isBlockBelow
+	 */
+	public int getrootslength(ICropTile crop) {
+		return 1;
+	}
+
+	/**
+	 * Tier of the plant. Ranges from 1 to 16, 0 is Weed.
+	 * Valuable and powerful crops have higher tiers, useless and weak ones have lower tiers.
+	 *
+	 * @return Tier
+	 */
+	public abstract int tier();
+
+	/**
+	 * Describe the plant through a set of stats, influencing breeding.
+	 * Plants sharing stats and attributes will tend to cross-breed more often.
+	 *
+	 * Stats:
+	 * - 0: Chemistry (Industrial uses based on chemical plant components)
+	 * - 1: Consumable (Food, potion ingredients, stuff meant to be eaten or similarly used)
+	 * - 2: Defensive (Plants with defense capabilities (damaging, explosive, chemical) or special abilities in general)
+	 * - 3: Colorful (How colorful/aesthetically/beautiful is the plant, like dye-plants or plants without actual effects)
+	 * - 4: Weed (Is this plant weed-like and rather unwanted/quick-spreading? Rare super-breed plants should have low values here)
+	 *
+	 * @param n index of the requested stat
+	 * @return The requested value of the stats
+	 */
+	public abstract int stat(int n);
+
+	/**
+	 * Additional attributes of the plant, also influencing breeding.
+	 * Plants sharing stats and attributes will tend to cross-breed more often.
+	 *
+	 * @return Attributes as an array of strings
+	 */
+	public abstract String[] attributes();
+
+	/**
+	 * Determine the max crop size.
+	 *
+	 * Currently only used for texture allocation.
+	 */
+	public abstract int maxSize();
+
+	/**
+	 * Instantiate your Icons here.
+	 *
+	 * This method will get called by IC2, don't call it yourself.
+	 *
+	 * It's highly recommended to use your own assert domain here, e.g. yourmod:crop/* instead of
+	 * ic2:crop/*, which will then read assets/yourmod/textures/blocks/crop/*.png.
+	 */
+	@SideOnly(Side.CLIENT)
+	public void registerSprites(IIconRegister iconRegister) {
+		textures = new IIcon[maxSize()];
+
+		for (int i = 1; i <= textures.length; i++) {
+			// ic2:crop/blockCrop.NAME.n is the legacy name for backwards compatiblity
+			textures[i - 1] = iconRegister.registerIcon("ic2:crop/blockCrop."+name()+"."+i);
+		}
+	}
+
+	/**
+	 * Sprite the crop is meant to be rendered with.
+	 *
+	 * @param crop reference to ICropTile
+	 * @return 0-255, representing the sprite index on the crop's spritesheet.
+	 */
+	@SideOnly(Side.CLIENT)
+	public IIcon getSprite(ICropTile crop) {
+		if (crop.getSize() <= 0 || crop.getSize() > textures.length) return null;
+
+		return textures[crop.getSize() - 1];
+	}
+
+	/**
+	 * Amount of growth points needed to increase the plant's size.
+	 * Default is 200 * tier.
+	 */
+	public int growthDuration(ICropTile crop) {
+		return tier() * 200;
+	}
+
+	/**
+	 * Check whether the plant can grow further.
+	 *
+	 * Consider:
+	 * - Humidity, nutrients and air quality
+	 * - Current size
+	 * - Light level
+	 * - Special biomes or conditions, accessible through crop.worldObj
+	 *
+	 * This method will be called upon empty upgraded crops to check whether a neighboring plant can cross onto it! Don't check if the size is greater than 0 and if the ID is real.
+	 *
+	 * @param crop reference to ICropTile
+	 * @return Whether the crop can grow
+	 */
+	public abstract boolean canGrow(ICropTile crop);
+
+	/**
+	 * Calculate the influence for the plant to grow based on humidity, nutrients and air.
+	 * Normal behavior is rating the three stats "normal", with each of them ranging from 0-30.
+	 * Basic rule: Assume everything returns 10. All together must equal 30. Add the factors to your likings, for example (humidity*0.7)+(nutrients*0.9)+(air*1.4)
+	 *
+	 * Default is humidity + nutrients + air (no factors).
+	 *
+	 * @param crop reference to ICropTile
+	 * @param humidity ground humidity, influenced by hydration
+	 * @param nutrients nutrient quality in ground, based on fertilizers
+	 * @param air air quality, influences by open gardens and less crops surrounding this one
+	 * @return 0-30
+	 */
+	public int weightInfluences(ICropTile crop, float humidity, float nutrients, float air) {
+		return (int) (humidity+nutrients+air);
+	}
+
+	/**
+	 * Used to determine whether the plant can crossbreed with another crop.
+	 * Default is allow crossbreeding if the size is greater or equal than 3.
+	 *
+	 * @param crop crop to crossbreed with
+	 */
+	public boolean canCross(ICropTile crop) {
+		return crop.getSize() >= 3;
+	}
+
+
+	/**
+	 * Called when the plant is rightclicked by a player.
+	 * Default action is harvesting.
+	 *
+	 * Only called Serverside.
+	 *
+	 * @param crop reference to ICropTile
+	 * @param player player rightclicking the crop
+	 * @return Whether the plant has changed
+	 */
+	public boolean rightclick(ICropTile crop, EntityPlayer player) {
+		return crop.harvest(true);
+	}
+
+	/**
+	 * Use in Crop Havester with insert Cropnalyzer to get best Output.
+	 *
+	 * @param crop reference to ICropTile
+	 * @return  need crop  size for best output.
+	 */
+
+	public abstract int getOptimalHavestSize(ICropTile crop);
+
+	/**
+	 * Check whether the crop can be harvested.
+	 *
+	 * @param crop reference to ICropTile
+	 * @return Whether the crop can be harvested in its current state.
+	 */
+	public abstract boolean canBeHarvested(ICropTile crop);
+
+	/**
+	 * Base chance for dropping the plant's gains, specify values greater than 1 for multiple drops.
+	 * Default is 0.95^tier.
+	 *
+	 * @return Chance to drop the gains
+	 */
+	public float dropGainChance() { // TODO: change to double
+		return (float) Math.pow(0.95, tier());
+	}
+
+	/**
+	 * Item obtained from harvesting the plant.
+	 *
+	 * @param crop reference to ICropTile
+	 * @return Item obtained
+	 */
+	public abstract ItemStack getGain(ICropTile crop);
+
+	/**
+	 * Get the size of the plant after harvesting.
+	 * Default is 1.
+	 *
+	 * @param crop reference to ICropTile
+	 * @return Plant size after harvesting
+	 */
+	public byte getSizeAfterHarvest(ICropTile crop) {return 1;}
+
+
+	/**
+	 * Called when the plant is leftclicked by a player.
+	 * Default action is picking the plant.
+	 *
+	 * Only called Serverside.
+	 *
+	 * @param crop reference to ICropTile
+	 * @param player player leftclicked the crop
+	 * @return Whether the plant has changed
+	 */
+	public boolean leftclick(ICropTile crop, EntityPlayer player) {
+		return crop.pick(true);
+	}
+
+	/**
+	 * Base chance for dropping seeds when the plant is picked.
+	 * Default is 0.5*0.8^tier with a bigger chance for sizes greater than 2 and absolutely no chance for size 0.
+	 *
+	 * @param crop reference to ICropTile
+	 * @return Chance to drop the seeds
+	 */
+	public float dropSeedChance(ICropTile crop) {
+		if (crop.getSize() == 1) return 0;
+		float base = 0.5F;
+		if (crop.getSize() == 2) base/=2F;
+		for (int i = 0; i < tier(); i++) {base*=0.8;}
+		return base;
+	}
+
+	/**
+	 * Obtain seeds dropped when the plant is picked.
+	 * Multiple drops of the returned ItemStack can occur.
+	 * Default action is generating a seed from this crop.
+	 *
+	 * @param crop reference to ICropTile
+	 * @return Seeds
+	 */
+	public ItemStack getSeeds(ICropTile crop) {
+		return crop.generateSeeds(crop.getCrop(), crop.getGrowth(), crop.getGain(), crop.getResistance(), crop.getScanLevel());
+	}
+
+	/**
+	 * Called when a neighbor block to the crop has changed.
+	 *
+	 * @param crop reference to ICropTile
+	 */
+	public void onNeighbourChange(ICropTile crop) {
+		//
+	}
+
+	/**
+	 * Check if the crop should emit redstone.
+	 *
+	 * @return Whether the crop should emit redstone
+	 */
+	public int emitRedstone(ICropTile crop) {return 0;}
+
+	/**
+	 * Called when the crop is destroyed.
+	 *
+	 * @param crop reference to ICropTile
+	 */
+	public void onBlockDestroyed(ICropTile crop) {
+		//
+	}
+
+	/**
+	 * Get the light value emitted by the plant.
+	 *
+	 * @param crop reference to ICropTile
+	 * @return Light value emitted
+	 */
+	public int getEmittedLight(ICropTile crop) {
+		return 0;
+	}
+
+	/**
+	 * Default is true if the entity is an EntityLiving in jumping or sprinting state.
+	 *
+	 * @param crop reference to ICropTile
+	 * @param entity entity colliding
+	 * @return Whether trampling calculation should happen, return false if the plant is no longer valid.
+	 */
+	public boolean onEntityCollision(ICropTile crop, Entity entity) {
+		if (entity instanceof EntityLivingBase) {
+			return ((EntityLivingBase) entity).isSprinting();
+		}
+
+		return false;
+	}
+
+
+	/**
+	 * Called every time the crop ticks.
+	 * Should be called every 256 ticks or around 13 seconds.
+	 *
+	 * @param crop reference to ICropTile
+	 */
+	public void tick(ICropTile crop) {
+		// nothing by default
+	}
+
+	/**
+	 * Check whether this plant spreads weed to surrounding tiles.
+	 * Default is true if the plant has a high growth stat (or is weeds) and size greater or equal than 2.
+	 *
+	 * @param crop reference to ICropTile
+	 * @return Whether the plant spreads weed
+	 */
+	public boolean isWeed(ICropTile crop) {
+		return crop.getSize() >= 2 &&
+				(crop.getCrop() == Crops.weed || crop.getGrowth() >= 24);
+	}
+
+
+	/**
+	 * Get this plant's ID.
+	 *
+	 * @return ID of this CropCard or -1 if it's not registered
+	 * @deprecated IDs aren't used anymore.
+	 */
+	@Deprecated
+	public final int getId() {
+		return Crops.instance.getIdFor(this);
+	}
+
+	private static String getModId() {
+		ModContainer modContainer = Loader.instance().activeModContainer();
+
+		if (modContainer != null) {
+			return modContainer.getModId();
+		} else {
+			// this is bad if you are not actually IC2
+			assert false;
+
+			return "unknown";
+		}
+	}
+
+	@SideOnly(Side.CLIENT)
+	protected IIcon textures[];
+
+	private final String modId; // TODO: make owner abstract, remove modId auto detection
+}

src/api/java/ic2/api/crops/Crops.java

@@ -0,0 +1,151 @@
+package ic2.api.crops;
+
+import java.util.Collection;
+
+import net.minecraft.client.renderer.texture.IIconRegister;
+import net.minecraft.item.ItemStack;
+import net.minecraft.world.biome.BiomeGenBase;
+
+import cpw.mods.fml.relauncher.Side;
+import cpw.mods.fml.relauncher.SideOnly;
+
+import net.minecraftforge.common.BiomeDictionary.Type;
+
+/**
+ * General management of the crop system.
+ */
+public abstract class Crops {
+	public static Crops instance;
+
+	public static CropCard weed; // weed has special properties, thus it's exposed here
+
+	/**
+	 * Adds a crop nutrient biome bonus.
+	 *
+	 * +10/-10  0 indicates no bonus and negative values indicate a penalty.
+	 *
+	 * @param type Forge biome type to apply the bonus in
+	 * @param nutrientsBonus Nutrient stat bonus
+	 */
+	public abstract void addBiomenutrientsBonus(Type type, int nutrientsBonus);
+
+	/**
+	 * Adds a crop humidity biome bonus.
+	 *
+	 * +10/-10 0 indicates no bonus and negative values indicate a penalty.
+	 *
+	 * @param type Forge biome type to apply the bonus in
+	 * @param humidityBonus Humidity stat bonus
+	 */
+	public abstract void addBiomehumidityBonus(Type type, int humidityBonus);
+
+
+	/**
+	 * Gets the humidity bonus for a biome.
+	 *
+	 * @param biome Biome to check
+	 * @return Humidity bonus or 0 if none
+	 */
+	public abstract int getHumidityBiomeBonus(BiomeGenBase biome);
+
+	/**
+	 * Gets the nutrient bonus for a biome.
+	 *
+	 * @param biome Biome to check
+	 * @return Nutrient bonus or 0 if none
+	 */
+	public abstract int getNutrientBiomeBonus(BiomeGenBase biome);
+
+	/**
+	 * Get the crop card for the specified owner and name.
+	 *
+	 * @param owner CropCard owner mod id.
+	 * @param name CropCard name.
+	 * @return Matching CropCard.
+	 */
+	public abstract CropCard getCropCard(String owner, String name);
+
+	/**
+	 * Get the crop card for the specified seed item stack.
+	 *
+	 * @param stack ItemStack containing seeds for the crop.
+	 * @return Matching CropCard.
+	 */
+	public abstract CropCard getCropCard(ItemStack stack);
+
+	/**
+	 * Returns a list of all crops.
+	 *
+	 * @return All registered crops.
+	 */
+	public abstract Collection<CropCard> getCrops();
+
+	/**
+	 * Returns the list of registered crops.
+	 *
+	 * @return Registered crops by ID
+	 */
+	@Deprecated
+	public abstract CropCard[] getCropList();
+
+	/**
+	 * Register a plant.
+	 *
+	 * @param crop Plant to register.
+	 * @return Autoassigned id for legacy compatibility, TODO: change to void.
+	 */
+	public abstract short registerCrop(CropCard crop);
+
+	/**
+	 * Register a plant and provide a legacy id for migration.
+	 *
+	 * @param crop Plant to register.
+	 * @param legacyId ID previously used for this crop.
+	 * @return true, TODO: change to void.
+	 */
+	public abstract boolean registerCrop(CropCard crop, int legacyId);
+
+	/**
+	 * @deprecated use the CropCard version.
+	 */
+	@Deprecated
+	public abstract boolean registerBaseSeed(ItemStack stack, int id, int size, int growth, int gain, int resistance);
+
+	/**
+	 * Registers a base seed, an item used to plant a crop.
+	 *
+	 * @param stack item
+	 * @param id plant ID
+	 * @param size initial size
+	 * @param growth initial growth stat
+	 * @param gain initial gain stat
+	 * @param resistance initial resistance stat
+	 * @return True if successful
+	 */
+	public abstract boolean registerBaseSeed(ItemStack stack, CropCard crop, int size, int growth, int gain, int resistance);
+
+	/**
+	 * Finds a base seed from the given item.
+	 *
+	 * @return Base seed or null if none found
+	 */
+	public abstract BaseSeed getBaseSeed(ItemStack stack);
+
+	/**
+	 * Execute registerSprites for all registered crop cards.
+	 *
+	 * This method will get called by IC2, don't call it yourself.
+	 */
+	@SideOnly(Side.CLIENT)
+	public abstract void startSpriteRegistration(IIconRegister iconRegister);
+
+	/**
+	 * Returns the ID for the given crop.
+	 *
+	 * @param crop Crop to look up
+	 * @return ID, or -1 if not found
+	 * @deprecated IDs aren't used anymore.
+	 */
+	@Deprecated
+	public abstract int getIdFor(CropCard crop);
+}

src/api/java/ic2/api/crops/ICropTile.java

@@ -0,0 +1,280 @@
+package ic2.api.crops;
+
+import net.minecraft.block.Block;
+import net.minecraft.item.ItemStack;
+import net.minecraft.nbt.NBTTagCompound;
+import net.minecraft.util.ChunkCoordinates;
+import net.minecraft.world.World;
+
+/**
+ * Interface implemented by the crop tile entity.
+ */
+public interface ICropTile {
+	/**
+	 * Get the crop.
+	 *
+	 * @return CropCard, or null if there is no plant currently on the crop
+	 */
+	public CropCard getCrop();
+
+	/**
+	 * Set the crop.
+	 *
+	 * @param cropCard CropCard or null for no plant
+	 */
+	public void setCrop(CropCard cropCard);
+
+	/**
+	 * @deprecated IDs have been removed.
+	 */
+	@Deprecated
+	public short getID();
+
+	/**
+	 * @deprecated IDs have been removed.
+	 */
+	@Deprecated
+	public void setID(short id);
+
+	/**
+	 * Get the crop's plant size.
+	 *
+	 * @return Plant size, starting with 1 and maximum varies depending on plant
+	 */
+	public byte getSize();
+
+	/**
+	 * Set the crop's plant size.
+	 *
+	 * @param size Plant size
+	 */
+	public void setSize(byte size);
+
+	/**
+	 * Get the crop's plant growth stat.
+	 * Higher values indicate faster growth.
+	 *
+	 * @return Plant growth stat
+	 */
+	public byte getGrowth();
+
+	/**
+	 * Set the crop's plant growth stat.
+	 *
+	 * @param growth Plant growth stat
+	 */
+	public void setGrowth(byte growth);
+
+	/**
+	 * Get the crop's plant gain stat.
+	 * Higher values indicate more drops.
+	 *
+	 * @return Plant gain stat
+	 */
+	public byte getGain();
+
+	/**
+	 * Set the crop's plant gain stat.
+	 *
+	 * @param gain Plant gain stat
+	 */
+	public void setGain(byte gain);
+
+	/**
+	 * Get the crop's plant resistance stat.
+	 * Higher values indicate more resistance against trampling.
+	 *
+	 * @return Plant resistance stat
+	 */
+	public byte getResistance();
+
+	/**
+	 * Set the crop's plant resistance stat.
+	 *
+	 * @param resistance Plant resistance stat
+	 */
+	public void setResistance(byte resistance);
+
+	/**
+	 * Get the crop's plant scan level.
+	 * Increases every time the seed is analyzed.
+	 *
+	 * @return Plant scan level
+	 */
+	public byte getScanLevel();
+
+	/**
+	 * Set the crop's plant scan level.
+	 *
+	 * @param scanLevel Plant scan level
+	 */
+	public void setScanLevel(byte scanLevel);
+
+	/**
+	 * Get the crop's plant custom data, stored alongside the crop.
+	 * Can be modified in place.
+	 *
+	 * @return Plant custom data
+	 */
+	public NBTTagCompound getCustomData();
+
+	/**
+	 * Get the crop's nutrient storage.
+	 * Ranges from 0 to 100.
+	 *
+	 * @return Crop nutrient storage
+	 */
+	public int getNutrientStorage();
+
+	/**
+	 * Set the crop's nutrient storage.
+	 *
+	 * @param nutrientStorage Crop nutrient storage
+	 */
+	public void setNutrientStorage(int nutrientStorage);
+
+	/**
+	 * Get the crop's hydration storage.
+	 * 0 indicates nothing, 1-10 indicate water hydration and 11-100 for hydration cells.
+	 *
+	 * @return Crop hydration storage
+	 */
+	public int getHydrationStorage();
+
+	/**
+	 * Set the crop's hydration storage.
+	 *
+	 * @param hydrationStorage Crop hydration storage
+	 */
+	public void setHydrationStorage(int hydrationStorage);
+
+	/**
+	 * Get the crop's Weed-Ex storage.
+	 *
+	 * @return Crop Weed-Ex storage
+	 */
+	public int getWeedExStorage();
+
+	/**
+	 * Set the crop's Weed-Ex storage.
+	 *
+	 * @param weedExStorage Crop Weed-Ex storage
+	 */
+	public void setWeedExStorage(int weedExStorage);
+
+	/**
+	 * Get the crop's humidity.
+	 * Ranges from 0 (dry) to 10 (humid).
+	 * Updates every couple of seconds or when an update is requested.
+	 *
+	 * @see #updateState()
+	 *
+	 * @return Crop humidity level
+	 */
+	public byte getHumidity();
+
+	/**
+	 * Get the crop's nutrient level.
+	 * Ranges from 0 (empty) to 10 (full).
+	 * Updates every couple of seconds or when an update is requested.
+	 *
+	 * @see #updateState()
+	 *
+	 * @return Crop nutrient level
+	 */
+	public byte getNutrients();
+
+	/**
+	 * Get the crop's air quality.
+	 * Ranges from 0 (cluttered) to 10 (fresh).
+	 * Updates every couple of seconds or when an update is requested.
+	 *
+	 * @see #updateState()
+	 *
+	 * @return Crop air quality
+	 */
+	public byte getAirQuality();
+
+	/**
+	 * Get the crop's world.
+	 *
+	 * @return Crop world
+	 */
+	public World getWorld();
+
+	/**
+	 * Get the crop's location.
+	 *
+	 * @return Crop location
+	 */
+	public ChunkCoordinates getLocation();
+
+	/**
+	 * Get the crop's light level.
+	 *
+	 * @return Crop light level
+	 */
+	public int getLightLevel();
+
+	/**
+	 * Pick the crop, removing and giving seeds for the plant.
+	 *
+	 * @param manual whether it was done by hand (not automated)
+	 * @return true if successfully picked
+	 */
+	public boolean pick(boolean manual);
+
+	/**
+	 * Harvest the crop, turning it into gain and resetting its size.
+	 * drop output on ground
+	 * @param manual
+	 * @return true if successfully harvested
+	 */
+	public boolean harvest(boolean manual);
+
+	/**
+	 * Harvest the crop, turning it into gain and resetting its size.
+	 * drop output on ground
+	 * @param Optimal force check getOptimalHavestSize() for harvest
+	 * @return ItemStack[] of harvest output
+	 */
+
+	ItemStack[] harvest_automated(boolean Optimal);
+
+	/**
+	 * Fully clears the crop without dropping anything.
+	 */
+	public void reset();
+
+	/**
+	 * Request a texture and lighting update.
+	 */
+	public void updateState();
+
+	/**
+	 * Check if a block is under the farmland containing the crop.
+	 * Searches up to 2 blocks below the farmland or an air space, whichever appears first.
+	 *
+	 * @param block block to search
+	 * @return Whether the block was found
+	 */
+	public boolean isBlockBelow(Block block);
+
+	/**
+	 * Generate plant seeds with the given parameters.
+	 *
+	 * @param crop plant
+	 * @param growth plant growth stat
+	 * @param gain plant gain stat
+	 * @param resis plant resistance stat
+	 * @param scan plant scan level
+	 * @return Plant seed item
+	 */
+	public ItemStack generateSeeds(CropCard crop, byte growth, byte gain, byte resis, byte scan);
+
+	/**
+	 * @deprecated Use the CropCard version instead.
+	 */
+	@Deprecated
+	public ItemStack generateSeeds(short plant, byte growth, byte gain, byte resis, byte scan);
+}

src/api/java/ic2/api/crops/package-info.java

@@ -0,0 +1,4 @@
+@API(apiVersion="1.0", owner="IC2", provides="IC2API")
+package ic2.api.crops;
+import cpw.mods.fml.common.API;
+

src/api/java/ic2/api/energy/EnergyNet.java

@@ -0,0 +1,18 @@
+package ic2.api.energy;
+
+
+/**
+ * Provides access to the energy network.
+ * 
+ * The old EnergyNet methods missing in IEnergyNet have been migrated to events (load, unload) or
+ * removed (tiles no longer emit energy actively, the energy net implementation requests it).
+ * 
+ * See ic2/api/energy/usage.txt for an overall description of the energy net api.
+ */
+public final class EnergyNet {
+	/**
+	 * Instance of the global EnergyNet class.
+	 */
+	public static IEnergyNet instance;
+}
+

src/api/java/ic2/api/energy/IEnergyNet.java

@@ -0,0 +1,86 @@
+package ic2.api.energy;
+
+import net.minecraft.tileentity.TileEntity;
+import net.minecraft.world.World;
+
+import net.minecraftforge.common.util.ForgeDirection;
+
+/**
+ * Interface representing the methods provided by the global EnergyNet class.
+ * 
+ * See ic2/api/energy/usage.txt for an overall description of the energy net api.
+ */
+public interface IEnergyNet {
+	/**
+	 * Get the EnergyNet-registered tile entity at the specified position.
+	 * 
+	 * This is not the same as World.getTileEntity(), it's possible to register delegate tile
+	 * entities with the energy net which are different from what's actually in the world. Those
+	 * delegates allow to use separate TileEntity objects just for the EnergyNet interfaces,
+	 * simplifying cross-mod dependencies and multi-blocks.
+	 * 
+	 * @param world World containing the tile entity
+	 * @param x x-coordinate
+	 * @param y y-coordinate
+	 * @param z z-coordinate
+	 * @return tile entity registered to the energy net or null if none is registered
+	 */
+	TileEntity getTileEntity(World world, int x, int y, int z);
+
+	/**
+	 * Get the EnergyNet-registered neighbor tile entity at the specified position.
+	 * 
+	 * @param te TileEntity indicating the world and position to search from
+	 * @param dir direction the neighbor is to be found
+	 * @return neighbor tile entity registered to the energy net or null if none is registered
+	 */
+	TileEntity getNeighbor(TileEntity te, ForgeDirection dir);
+
+	/**
+	 * determine how much energy has been emitted by the EnergyEmitter specified
+	 *
+	 * @note call this twice with x ticks delay to get the avg. emitted power p = (call2 - call1) / x EU/tick
+	 *
+	 * @param tileEntity energy emitter
+	 * @deprecated Discontinued, use getNodeStats instead.
+	 */
+	@Deprecated
+	double getTotalEnergyEmitted(TileEntity tileEntity);
+
+	/**
+	 * determine how much energy has been sunken by the EnergySink specified
+	 *
+	 * @note call this twice with x ticks delay to get the avg. sunken power p = (call2 - call1) / x EU/tick
+	 *
+	 * @param tileEntity energy emitter
+	 * @deprecated Discontinued, use getNodeStats instead.
+	 */
+	@Deprecated
+	double getTotalEnergySunken(TileEntity tileEntity);
+
+	/**
+	 * Retrieve statistics for the tile entity specified.
+	 * 
+	 * The statistics apply to the last simulated tick.
+	 * 
+	 * @param te Tile entity to check.
+	 * @return Statistics for the tile entity.
+	 */
+	NodeStats getNodeStats(TileEntity te);
+
+	/**
+	 * Determine the typical power used by the specific tier, e.g. 128 eu/t for tier 2.
+	 * 
+	 * @param tier tier
+	 * @return power in eu/t
+	 */
+	double getPowerFromTier(int tier);
+
+	/**
+	 * Determine minimum tier required to handle the specified power, e.g. tier 2 for 128 eu/t.
+	 * 
+	 * @param power in eu/t
+	 * @return tier
+	 */
+	int getTierFromPower(double power);
+}

src/api/java/ic2/api/energy/NodeStats.java

@@ -0,0 +1,25 @@
+package ic2.api.energy;
+
+public class NodeStats {
+	public NodeStats(double energyIn, double energyOut, double voltage) {
+		this.energyIn = energyIn;
+		this.energyOut = energyOut;
+		this.voltage = voltage;
+	}
+
+	public double getEnergyIn() {
+		return energyIn;
+	}
+
+	public double getEnergyOut() {
+		return energyOut;
+	}
+
+	public double getVoltage() {
+		return voltage;
+	}
+
+	protected double energyIn;
+	protected double energyOut;
+	protected double voltage;
+}

src/api/java/ic2/api/energy/event/EnergyTileEvent.java

@@ -0,0 +1,25 @@
+package ic2.api.energy.event;
+
+import net.minecraft.tileentity.TileEntity;
+
+import net.minecraftforge.event.world.WorldEvent;
+
+import ic2.api.energy.tile.IEnergyTile;
+
+/**
+ * Base class for energy net events, don't use it directly.
+ *
+ * See ic2/api/energy/usage.txt for an overall description of the energy net api.
+ */
+public class EnergyTileEvent extends WorldEvent {
+	public final IEnergyTile energyTile;
+
+	public EnergyTileEvent(IEnergyTile energyTile1) {
+		super(((TileEntity) energyTile1).getWorldObj());
+
+		if (world == null) throw new NullPointerException("world is null");
+
+		this.energyTile = energyTile1;
+	}
+}
+

src/api/java/ic2/api/energy/event/EnergyTileLoadEvent.java

@@ -0,0 +1,26 @@
+package ic2.api.energy.event;
+
+import ic2.api.energy.tile.IEnergyTile;
+
+/**
+ * Event announcing new energy tiles.
+ *
+ * This event notifies subscribers of loaded energy tiles, e.g. after getting
+ * loaded through the chunk they are in or after being placed down by the
+ * player or another deployer mechanism.
+ *
+ * Every energy tile which wants to get connected to the IC2 Energy Network has
+ * to either post this event or alternatively call EnergyNet.addTileEntity().
+ *
+ * You may use this event to build a static representation of energy tiles for
+ * your own energy grid implementation if you need to. It's not required if you
+ * always lookup energy paths on demand.
+ * 
+ * See ic2/api/energy/usage.txt for an overall description of the energy net api.
+ */
+public class EnergyTileLoadEvent extends EnergyTileEvent {
+	public EnergyTileLoadEvent(IEnergyTile energyTile1) {
+		super(energyTile1);
+	}
+}
+

src/api/java/ic2/api/energy/event/EnergyTileUnloadEvent.java

@@ -0,0 +1,27 @@
+package ic2.api.energy.event;
+
+import ic2.api.energy.tile.IEnergyTile;
+
+/**
+ * Event announcing terminated energy tiles.
+ *
+ * This event notifies subscribers of unloaded energy tiles, e.g. after getting
+ * unloaded through the chunk they are in or after being destroyed by the
+ * player or another block pick/destruction mechanism.
+ *
+ * Every energy tile which wants to get disconnected from the IC2 Energy
+ * Network has to either post this event or alternatively call
+ * EnergyNet.removeTileEntity().
+ *
+ * You may use this event to build a static representation of energy tiles for
+ * your own energy grid implementation if you need to. It's not required if you
+ * always lookup energy paths on demand.
+ * 
+ * See ic2/api/energy/usage.txt for an overall description of the energy net api.
+ */
+public class EnergyTileUnloadEvent extends EnergyTileEvent {
+	public EnergyTileUnloadEvent(IEnergyTile energyTile1) {
+		super(energyTile1);
+	}
+}
+

src/api/java/ic2/api/energy/event/package-info.java

@@ -0,0 +1,4 @@
+@API(apiVersion="1.0", owner="IC2", provides="IC2API")
+package ic2.api.energy.event;
+import cpw.mods.fml.common.API;
+

src/api/java/ic2/api/energy/package-info.java

@@ -0,0 +1,4 @@
+@API(apiVersion="1.0", owner="IC2", provides="IC2API")
+package ic2.api.energy;
+import cpw.mods.fml.common.API;
+

src/api/java/ic2/api/energy/prefab/BasicSink.java

@@ -0,0 +1,373 @@
+package ic2.api.energy.prefab;
+
+import net.minecraft.item.ItemStack;
+import net.minecraft.nbt.NBTTagCompound;
+import net.minecraft.tileentity.TileEntity;
+
+import cpw.mods.fml.common.FMLCommonHandler;
+
+import net.minecraftforge.common.MinecraftForge;
+import net.minecraftforge.common.util.ForgeDirection;
+
+import ic2.api.energy.event.EnergyTileLoadEvent;
+import ic2.api.energy.event.EnergyTileUnloadEvent;
+import ic2.api.energy.tile.IEnergySink;
+import ic2.api.info.Info;
+import ic2.api.item.ElectricItem;
+
+/**
+ * BasicSink is a simple adapter to provide an ic2 energy sink.
+ * 
+ * It's designed to be attached to a tile entity as a delegate. Functionally BasicSink acts as a
+ * one-time configurable input energy buffer, thus providing a common use case for machines.
+ * 
+ * Sub-classing BasicSink instead of using it as a delegate works as well, but isn't recommended.
+ * The delegate can be extended with additional functionality through a sub class though.
+ * 
+ * The constraints set by BasicSink like the strict tank-like energy buffering should provide a
+ * more easy to use and stable interface than using IEnergySink directly while aiming for
+ * optimal performance.
+ * 
+ * Using BasicSink involves the following steps:
+ * - create a BasicSink instance in your TileEntity, typically in a field
+ * - forward invalidate, onChunkUnload, readFromNBT, writeToNBT and updateEntity to the BasicSink
+ *   instance.
+ *   If you have other means of determining when the tile entity is fully loaded, notify onLoaded
+ *   that way instead of forwarding updateEntity.
+ * - call useEnergy whenever appropriate. canUseEnergy determines if enough energy is available
+ *   without consuming the energy.
+ * - optionally use getEnergyStored to display the output buffer charge level
+ * - optionally use setEnergyStored to sync the stored energy to the client (e.g. in the Container)
+ *
+ * Example implementation code:
+ * @code{.java}
+ * public class SomeTileEntity extends TileEntity {
+ *     // new basic energy sink, 1000 EU buffer, tier 1 (32 EU/t, LV)
+ *     private BasicSink ic2EnergySink = new BasicSink(this, 1000, 1);
+ * 
+ *     @Override
+ *     public void invalidate() {
+ *         ic2EnergySink.invalidate(); // notify the energy sink
+ *         ...
+ *         super.invalidate(); // this is important for mc!
+ *     }
+ * 
+ *     @Override
+ *     public void onChunkUnload() {
+ *         ic2EnergySink.onChunkUnload(); // notify the energy sink
+ *         ...
+ *     }
+ * 
+ *     @Override
+ *     public void readFromNBT(NBTTagCompound tag) {
+ *         super.readFromNBT(tag);
+ * 
+ *         ic2EnergySink.readFromNBT(tag);
+ *         ...
+ *     }
+ * 
+ *     @Override
+ *     public void writeToNBT(NBTTagCompound tag) {
+ *         super.writeToNBT(tag);
+ * 
+ *         ic2EnergySink.writeToNBT(tag);
+ *         ...
+ *     }
+ * 
+ *     @Override
+ *     public void updateEntity() {
+ *         ic2EnergySink.updateEntity(); // notify the energy sink
+ *         ...
+ *         if (ic2EnergySink.useEnergy(5)) { // use 5 eu from the sink's buffer this tick
+ *             ... // do something with the energy
+ *         }
+ *         ...
+ *     }
+ * 
+ *     ...
+ * }
+ * @endcode
+ */
+public class BasicSink extends TileEntity implements IEnergySink {
+	// **********************************
+	// *** Methods for use by the mod ***
+	// **********************************
+
+	/**
+	 * Constructor for a new BasicSink delegate.
+	 * 
+	 * @param parent1 TileEntity represented by this energy sink.
+	 * @param capacity1 Maximum amount of eu to store.
+	 * @param tier1 IC2 tier, 1 = LV, 2 = MV, ...
+	 */
+	public BasicSink(TileEntity parent1, int capacity1, int tier1) {
+		this.parent = parent1;
+		this.capacity = capacity1;
+		this.tier = tier1;
+	}
+
+	// in-world te forwards	>>
+
+	/**
+	 * Forward for the base TileEntity's updateEntity(), used for creating the energy net link.
+	 * Either updateEntity or onLoaded have to be used.
+	 */
+	@Override
+	public void updateEntity() {
+		if (!addedToEnet) onLoaded();
+	}
+
+	/**
+	 * Notification that the base TileEntity finished loaded, for advanced uses.
+	 * Either updateEntity or onLoaded have to be used.
+	 */
+	public void onLoaded() {
+		if (!addedToEnet &&
+				!FMLCommonHandler.instance().getEffectiveSide().isClient() &&
+				Info.isIc2Available()) {
+			worldObj = parent.getWorldObj();
+			xCoord = parent.xCoord;
+			yCoord = parent.yCoord;
+			zCoord = parent.zCoord;
+
+			MinecraftForge.EVENT_BUS.post(new EnergyTileLoadEvent(this));
+
+			addedToEnet = true;
+		}
+	}
+
+	/**
+	 * Forward for the base TileEntity's invalidate(), used for destroying the energy net link.
+	 * Both invalidate and onChunkUnload have to be used.
+	 */
+	@Override
+	public void invalidate() {
+		super.invalidate();
+
+		onChunkUnload();
+	}
+
+	/**
+	 * Forward for the base TileEntity's onChunkUnload(), used for destroying the energy net link.
+	 * Both invalidate and onChunkUnload have to be used.
+	 */
+	@Override
+	public void onChunkUnload() {
+		if (addedToEnet &&
+				Info.isIc2Available()) {
+			MinecraftForge.EVENT_BUS.post(new EnergyTileUnloadEvent(this));
+
+			addedToEnet = false;
+		}
+	}
+
+	/**
+	 * Forward for the base TileEntity's readFromNBT(), used for loading the state.
+	 * 
+	 * @param tag Compound tag as supplied by TileEntity.readFromNBT()
+	 */
+	@Override
+	public void readFromNBT(NBTTagCompound tag) {
+		super.readFromNBT(tag);
+
+		NBTTagCompound data = tag.getCompoundTag("IC2BasicSink");
+
+		energyStored = data.getDouble("energy");
+	}
+
+	/**
+	 * Forward for the base TileEntity's writeToNBT(), used for saving the state.
+	 * 
+	 * @param tag Compound tag as supplied by TileEntity.writeToNBT()
+	 */
+	@Override
+	public void writeToNBT(NBTTagCompound tag) {
+		try {
+			super.writeToNBT(tag);
+		} catch (RuntimeException e) {
+			// happens if this is a delegate, ignore
+		}
+
+		NBTTagCompound data = new NBTTagCompound();
+
+		data.setDouble("energy", energyStored);
+
+		tag.setTag("IC2BasicSink", data);
+	}
+
+	// << in-world te forwards
+	// methods for using this adapter >>
+
+	/**
+	 * Get the maximum amount of energy this sink can hold in its buffer.
+	 * 
+	 * @return Capacity in EU.
+	 */
+	public int getCapacity() {
+		return capacity;
+	}
+
+	/**
+	 * Set the maximum amount of energy this sink can hold in its buffer.
+	 * 
+	 * @param capacity1 Capacity in EU.
+	 */
+	public void setCapacity(int capacity1) {
+		this.capacity = capacity1;
+	}
+
+	/**
+	 * Get the IC2 energy tier for this sink.
+	 * 
+	 * @return IC2 Tier.
+	 */
+	public int getTier() {
+		return tier;
+	}
+
+	/**
+	 * Set the IC2 energy tier for this sink.
+	 * 
+	 * @param tier1 IC2 Tier.
+	 */
+	public void setTier(int tier1) {
+		this.tier = tier1;
+	}
+
+	/**
+	 * Determine the energy stored in the sink's input buffer.
+	 * 
+	 * @return amount in EU, may be above capacity
+	 */
+	public double getEnergyStored() {
+		return energyStored;
+	}
+
+	/**
+	 * Set the stored energy to the specified amount.
+	 * 
+	 * This is intended for server -> client synchronization, e.g. to display the stored energy in
+	 * a GUI through getEnergyStored().
+	 * 
+	 * @param amount
+	 */
+	public void setEnergyStored(double amount) {
+		energyStored = amount;
+	}
+
+	/**
+	 * Determine if the specified amount of energy is available.
+	 * 
+	 * @param amount in EU
+	 * @return true if the amount is available
+	 */
+	public boolean canUseEnergy(double amount) {
+		return energyStored >= amount;
+	}
+
+	/**
+	 * Use the specified amount of energy, if available.
+	 * 
+	 * @param amount amount to use
+	 * @return true if the amount was available
+	 */
+	public boolean useEnergy(double amount) {
+		if (canUseEnergy(amount) && !FMLCommonHandler.instance().getEffectiveSide().isClient()) {
+			energyStored -= amount;
+
+			return true;
+		}
+		return false;
+	}
+
+	/**
+	 * Discharge the supplied ItemStack into this sink's energy buffer.
+	 * 
+	 * @param stack ItemStack to discharge (null is ignored)
+	 * @param limit Transfer limit, values <= 0 will use the battery's limit
+	 * @return true if energy was transferred
+	 */
+	public boolean discharge(ItemStack stack, int limit) {
+		if (stack == null || !Info.isIc2Available()) return false;
+
+		double amount = capacity - energyStored;
+		if (amount <= 0) return false;
+
+		if (limit > 0 && limit < amount) amount = limit;
+
+		amount = ElectricItem.manager.discharge(stack, amount, tier, limit > 0, true, false);
+
+		energyStored += amount;
+
+		return amount > 0;
+	}
+
+	// << methods for using this adapter
+
+	// backwards compatibility (ignore these) >>
+
+	@Deprecated
+	public void onUpdateEntity() {
+		updateEntity();
+	}
+
+	@Deprecated
+	public void onInvalidate() {
+		invalidate();
+	}
+
+	@Deprecated
+	public void onOnChunkUnload() {
+		onChunkUnload();
+	}
+
+	@Deprecated
+	public void onReadFromNbt(NBTTagCompound tag) {
+		readFromNBT(tag);
+	}
+
+	@Deprecated
+	public void onWriteToNbt(NBTTagCompound tag) {
+		writeToNBT(tag);
+	}
+
+	// << backwards compatibility
+
+	// ******************************
+	// *** Methods for use by ic2 ***
+	// ******************************
+
+	// energy net interface >>
+
+	@Override
+	public boolean acceptsEnergyFrom(TileEntity emitter, ForgeDirection direction) {
+		return true;
+	}
+
+	@Override
+	public double getDemandedEnergy() {
+		return Math.max(0, capacity - energyStored);
+	}
+
+	@Override
+	public double injectEnergy(ForgeDirection directionFrom, double amount, double voltage) {
+		energyStored += amount;
+
+		return 0;
+	}
+
+	@Override
+	public int getSinkTier() {
+		return tier;
+	}
+
+	// << energy net interface
+
+
+	public final TileEntity parent;
+
+	protected int capacity;
+	protected int tier;
+	protected double energyStored;
+	protected boolean addedToEnet;
+}

src/api/java/ic2/api/energy/prefab/BasicSource.java

@@ -0,0 +1,375 @@
+package ic2.api.energy.prefab;
+
+import net.minecraft.item.ItemStack;
+import net.minecraft.nbt.NBTTagCompound;
+import net.minecraft.tileentity.TileEntity;
+
+import cpw.mods.fml.common.FMLCommonHandler;
+
+import net.minecraftforge.common.MinecraftForge;
+import net.minecraftforge.common.util.ForgeDirection;
+
+import ic2.api.energy.EnergyNet;
+import ic2.api.energy.event.EnergyTileLoadEvent;
+import ic2.api.energy.event.EnergyTileUnloadEvent;
+import ic2.api.energy.tile.IEnergySource;
+import ic2.api.info.Info;
+import ic2.api.item.ElectricItem;
+
+/**
+ * BasicSource is a simple adapter to provide an ic2 energy source.
+ * 
+ * It's designed to be attached to a tile entity as a delegate. Functionally BasicSource acts as a
+ * one-time configurable output energy buffer, thus providing a common use case for generators.
+ * 
+ * Sub-classing BasicSource instead of using it as a delegate works as well, but isn't recommended.
+ * The delegate can be extended with additional functionality through a sub class though.
+ * 
+ * The constraints set by BasicSource like the strict tank-like energy buffering should provide a
+ * more easy to use and stable interface than using IEnergySource directly while aiming for
+ * optimal performance.
+ * 
+ * Using BasicSource involves the following steps:
+ * - create a BasicSource instance in your TileEntity, typically in a field
+ * - forward invalidate, onChunkUnload, readFromNBT, writeToNBT and updateEntity to the BasicSource
+ *   instance.
+ *   If you have other means of determining when the tile entity is fully loaded, notify onLoaded
+ *   that way instead of forwarding updateEntity.
+ * - call addEnergy whenever appropriate, using getFreeCapacity may determine if e.g. the generator
+ *   should run
+ * - optionally use getEnergyStored to display the output buffer charge level
+ * - optionally use setEnergyStored to sync the stored energy to the client (e.g. in the Container)
+ *
+ * Example implementation code:
+ * @code{.java}
+ * public class SomeTileEntity extends TileEntity {
+ *     // new basic energy source, 1000 EU buffer, tier 1 (32 EU/t, LV)
+ *     private BasicSource ic2EnergySource = new BasicSource(this, 1000, 1);
+ * 
+ *     @Override
+ *     public void invalidate() {
+ *         ic2EnergySource.invalidate(); // notify the energy source
+ *         ...
+ *         super.invalidate(); // this is important for mc!
+ *     }
+ * 
+ *     @Override
+ *     public void onChunkUnload() {
+ *         ic2EnergySource.onChunkUnload(); // notify the energy source
+ *         ...
+ *     }
+ * 
+ *     @Override
+ *     public void readFromNBT(NBTTagCompound tag) {
+ *         super.readFromNBT(tag);
+ * 
+ *         ic2EnergySource.readFromNBT(tag);
+ *         ...
+ *     }
+ * 
+ *     @Override
+ *     public void writeToNBT(NBTTagCompound tag) {
+ *         super.writeToNBT(tag);
+ * 
+ *         ic2EnergySource.writeToNBT(tag);
+ *         ...
+ *     }
+ * 
+ *     @Override
+ *     public void updateEntity() {
+ *         ic2EnergySource.updateEntity(); // notify the energy source
+ *         ...
+ *         ic2EnergySource.addEnergy(5); // add 5 eu to the source's buffer this tick
+ *         ...
+ *     }
+ * 
+ *     ...
+ * }
+ * @endcode
+ */
+public class BasicSource extends TileEntity implements IEnergySource {
+	// **********************************
+	// *** Methods for use by the mod ***
+	// **********************************
+
+	/**
+	 * Constructor for a new BasicSource delegate.
+	 * 
+	 * @param parent1 Base TileEntity represented by this energy source.
+	 * @param capacity1 Maximum amount of eu to store.
+	 * @param tier1 IC2 tier, 1 = LV, 2 = MV, ...
+	 */
+	public BasicSource(TileEntity parent1, double capacity1, int tier1) {
+		double power = EnergyNet.instance.getPowerFromTier(tier1);
+
+		this.parent = parent1;
+		this.capacity = capacity1 < power ? power : capacity1;
+		this.tier = tier1;
+		this.power = power;
+	}
+
+	// in-world te forwards	>>
+
+	/**
+	 * Forward for the base TileEntity's updateEntity(), used for creating the energy net link.
+	 * Either updateEntity or onLoaded have to be used.
+	 */
+	@Override
+	public void updateEntity() {
+		if (!addedToEnet) onLoaded();
+	}
+
+	/**
+	 * Notification that the base TileEntity finished loading, for advanced uses.
+	 * Either updateEntity or onLoaded have to be used.
+	 */
+	public void onLoaded() {
+		if (!addedToEnet &&
+				!FMLCommonHandler.instance().getEffectiveSide().isClient() &&
+				Info.isIc2Available()) {
+			worldObj = parent.getWorldObj();
+			xCoord = parent.xCoord;
+			yCoord = parent.yCoord;
+			zCoord = parent.zCoord;
+
+			MinecraftForge.EVENT_BUS.post(new EnergyTileLoadEvent(this));
+
+			addedToEnet = true;
+		}
+	}
+
+	/**
+	 * Forward for the base TileEntity's invalidate(), used for destroying the energy net link.
+	 * Both invalidate and onChunkUnload have to be used.
+	 */
+	@Override
+	public void invalidate() {
+		super.invalidate();
+
+		onChunkUnload();
+	}
+
+	/**
+	 * Forward for the base TileEntity's onChunkUnload(), used for destroying the energy net link.
+	 * Both invalidate and onChunkUnload have to be used.
+	 */
+	@Override
+	public void onChunkUnload() {
+		if (addedToEnet &&
+				Info.isIc2Available()) {
+			MinecraftForge.EVENT_BUS.post(new EnergyTileUnloadEvent(this));
+
+			addedToEnet = false;
+		}
+	}
+
+	/**
+	 * Forward for the base TileEntity's readFromNBT(), used for loading the state.
+	 * 
+	 * @param tag Compound tag as supplied by TileEntity.readFromNBT()
+	 */
+	@Override
+	public void readFromNBT(NBTTagCompound tag) {
+		super.readFromNBT(tag);
+
+		NBTTagCompound data = tag.getCompoundTag("IC2BasicSource");
+
+		energyStored = data.getDouble("energy");
+	}
+
+	/**
+	 * Forward for the base TileEntity's writeToNBT(), used for saving the state.
+	 * 
+	 * @param tag Compound tag as supplied by TileEntity.writeToNBT()
+	 */
+	@Override
+	public void writeToNBT(NBTTagCompound tag) {
+		try {
+			super.writeToNBT(tag);
+		} catch (RuntimeException e) {
+			// happens if this is a delegate, ignore
+		}
+
+		NBTTagCompound data = new NBTTagCompound();
+
+		data.setDouble("energy", energyStored);
+
+		tag.setTag("IC2BasicSource", data);
+	}
+
+	// << in-world te forwards
+	// methods for using this adapter >>
+
+	/**
+	 * Get the maximum amount of energy this source can hold in its buffer.
+	 * 
+	 * @return Capacity in EU.
+	 */
+	public double getCapacity() {
+		return capacity;
+	}
+
+	/**
+	 * Set the maximum amount of energy this source can hold in its buffer.
+	 * 
+	 * @param capacity1 Capacity in EU.
+	 */
+	public void setCapacity(double capacity1) {
+		if (capacity1 < power) capacity1 = power;
+
+		this.capacity = capacity1;
+	}
+
+	/**
+	 * Get the IC2 energy tier for this source.
+	 * 
+	 * @return IC2 Tier.
+	 */
+	public int getTier() {
+		return tier;
+	}
+
+	/**
+	 * Set the IC2 energy tier for this source.
+	 * 
+	 * @param tier1 IC2 Tier.
+	 */
+	public void setTier(int tier1) {
+		double power = EnergyNet.instance.getPowerFromTier(tier1);
+
+		if (capacity < power) capacity = power;
+
+		this.tier = tier1;
+		this.power = power;
+	}
+
+
+	/**
+	 * Determine the energy stored in the source's output buffer.
+	 * 
+	 * @return amount in EU
+	 */
+	public double getEnergyStored() {
+		return energyStored;
+	}
+
+	/**
+	 * Set the stored energy to the specified amount.
+	 * 
+	 * This is intended for server -> client synchronization, e.g. to display the stored energy in
+	 * a GUI through getEnergyStored().
+	 * 
+	 * @param amount
+	 */
+	public void setEnergyStored(double amount) {
+		energyStored = amount;
+	}
+
+	/**
+	 * Determine the free capacity in the source's output buffer.
+	 * 
+	 * @return amount in EU
+	 */
+	public double getFreeCapacity() {
+		return capacity - energyStored;
+	}
+
+	/**
+	 * Add some energy to the output buffer.
+	 * 
+	 * @param amount maximum amount of energy to add
+	 * @return amount added/used, NOT remaining
+	 */
+	public double addEnergy(double amount) {
+		if (FMLCommonHandler.instance().getEffectiveSide().isClient()) return 0;
+		if (amount > capacity - energyStored) amount = capacity - energyStored;
+
+		energyStored += amount;
+
+		return amount;
+	}
+
+	/**
+	 * Charge the supplied ItemStack from this source's energy buffer.
+	 * 
+	 * @param stack ItemStack to charge (null is ignored)
+	 * @return true if energy was transferred
+	 */
+	public boolean charge(ItemStack stack) {
+		if (stack == null || !Info.isIc2Available()) return false;
+
+		double amount = ElectricItem.manager.charge(stack, energyStored, tier, false, false);
+
+		energyStored -= amount;
+
+		return amount > 0;
+	}
+
+	// << methods for using this adapter
+
+	// backwards compatibility (ignore these) >>
+
+	@Deprecated
+	public void onUpdateEntity() {
+		updateEntity();
+	}
+
+	@Deprecated
+	public void onInvalidate() {
+		invalidate();
+	}
+
+	@Deprecated
+	public void onOnChunkUnload() {
+		onChunkUnload();
+	}
+
+	@Deprecated
+	public void onReadFromNbt(NBTTagCompound tag) {
+		readFromNBT(tag);
+	}
+
+	@Deprecated
+	public void onWriteToNbt(NBTTagCompound tag) {
+		writeToNBT(tag);
+	}
+
+	// << backwards compatibility
+
+	// ******************************
+	// *** Methods for use by ic2 ***
+	// ******************************
+
+	// energy net interface >>
+
+	@Override
+	public boolean emitsEnergyTo(TileEntity receiver, ForgeDirection direction) {
+		return true;
+	}
+
+	@Override
+	public double getOfferedEnergy() {
+		return Math.min(energyStored, power);
+	}
+
+	@Override
+	public void drawEnergy(double amount) {
+		energyStored -= amount;
+	}
+
+	@Override
+	public int getSourceTier() {
+		return tier;
+	}
+
+	// << energy net interface
+
+
+	public final TileEntity parent;
+
+	protected double capacity;
+	protected int tier;
+	protected double power;
+	protected double energyStored;
+	protected boolean addedToEnet;
+}

src/api/java/ic2/api/energy/prefab/package-info.java

@@ -0,0 +1,4 @@
+@API(apiVersion="1.0", owner="IC2", provides="IC2API")
+package ic2.api.energy.prefab;
+import cpw.mods.fml.common.API;
+

src/api/java/ic2/api/energy/tile/IEnergyAcceptor.java

@@ -0,0 +1,27 @@
+package ic2.api.energy.tile;
+
+import net.minecraft.tileentity.TileEntity;
+
+import net.minecraftforge.common.util.ForgeDirection;
+
+/**
+ * For internal/multi-block usage only.
+ *
+ * @see IEnergySink
+ * @see IEnergyConductor
+ * 
+ * See ic2/api/energy/usage.txt for an overall description of the energy net api.
+ */
+public interface IEnergyAcceptor extends IEnergyTile {
+	/**
+	 * Determine if this acceptor can accept current from an adjacent emitter in a direction.
+	 * 
+	 * The TileEntity in the emitter parameter is what was originally added to the energy net,
+	 * which may be normal in-world TileEntity, a delegate or an IMetaDelegate.
+	 * 
+	 * @param emitter energy emitter, may also be null or an IMetaDelegate
+	 * @param direction direction the energy is being received from
+	 */
+	boolean acceptsEnergyFrom(TileEntity emitter, ForgeDirection direction);
+}
+

src/api/java/ic2/api/energy/tile/IEnergyConductor.java

@@ -0,0 +1,53 @@
+package ic2.api.energy.tile;
+
+/**
+ * Tile entities which conduct energy pulses without buffering (mostly cables) have to implement this
+ * interface.
+ * 
+ * See ic2/api/energy/usage.txt for an overall description of the energy net api.
+ */
+public interface IEnergyConductor extends IEnergyAcceptor, IEnergyEmitter {
+	/**
+	 * Energy loss for the conductor in EU per block.
+	 * 
+	 * @return Energy loss
+	 */
+	double getConductionLoss();
+
+	/**
+	 * Amount of energy the insulation will handle before shocking nearby players and mobs.
+	 * 
+	 * @return Insulation energy absorption in EU
+	 */
+	double getInsulationEnergyAbsorption();
+
+	/**
+	 * Amount of energy the insulation will handle before it is destroyed.
+	 * Ensure that this value is greater than the insulation energy absorption + 64.
+	 *
+	 * @return Insulation-destroying energy in EU
+	 */
+	double getInsulationBreakdownEnergy();
+
+	/**
+	 * Amount of energy the conductor will handle before it melts.
+	 * 
+	 * @return Conductor-destroying energy in EU
+	 */
+	double getConductorBreakdownEnergy();
+
+	/**
+	 * Remove the conductor's insulation if the insulation breakdown energy was exceeded.
+	 * 
+	 * @see #getInsulationBreakdownEnergy()
+	 */
+	void removeInsulation();
+
+	/**
+	 * Remove the conductor if the conductor breakdown energy was exceeded.
+	 * 
+	 * @see #getConductorBreakdownEnergy()
+	 */
+	void removeConductor();
+}
+

src/api/java/ic2/api/energy/tile/IEnergyEmitter.java

@@ -0,0 +1,28 @@
+package ic2.api.energy.tile;
+
+import net.minecraft.tileentity.TileEntity;
+
+import net.minecraftforge.common.util.ForgeDirection;
+
+/**
+ * For internal/multi-block usage only.
+ *
+ * @see IEnergySource
+ * @see IEnergyConductor
+ * 
+ * See ic2/api/energy/usage.txt for an overall description of the energy net api.
+ */
+public interface IEnergyEmitter extends IEnergyTile {
+	/**
+	 * Determine if this emitter can emit energy to an adjacent receiver.
+	 * 
+	 * The TileEntity in the receiver parameter is what was originally added to the energy net,
+	 * which may be normal in-world TileEntity, a delegate or an IMetaDelegate.
+	 * 
+	 * @param receiver receiver, may also be null or an IMetaDelegate
+	 * @param direction direction the receiver is from the emitter
+	 * @return Whether energy should be emitted
+	 */
+	boolean emitsEnergyTo(TileEntity receiver, ForgeDirection direction);
+}
+

src/api/java/ic2/api/energy/tile/IEnergySink.java

@@ -0,0 +1,45 @@
+package ic2.api.energy.tile;
+
+import net.minecraftforge.common.util.ForgeDirection;
+
+/**
+ * Allows a tile entity (mostly a machine) to receive energy.
+ * 
+ * See ic2/api/energy/usage.txt for an overall description of the energy net api.
+ */
+public interface IEnergySink extends IEnergyAcceptor {
+	/**
+	 * Determine how much energy the sink accepts.
+	 *
+	 * Make sure that injectEnergy() does accepts energy if demandsEnergy() returns anything > 0.
+	 * 
+	 * @note Modifying the energy net from this method is disallowed.
+	 *
+	 * @return max accepted input in eu
+	 */
+	double getDemandedEnergy();
+
+	/**
+	 * Determine the tier of this energy sink.
+	 * 1 = LV, 2 = MV, 3 = HV, 4 = EV etc.
+	 * 
+	 * @note Modifying the energy net from this method is disallowed.
+	 * @note Return Integer.MAX_VALUE to allow any voltage.
+	 *
+	 * @return tier of this energy sink
+	 */
+	int getSinkTier();
+
+	/**
+	 * Transfer energy to the sink.
+	 * 
+	 * It's highly recommended to accept all energy by letting the internal buffer overflow to
+	 * increase the performance and accuracy of the distribution simulation.
+	 *
+	 * @param directionFrom direction from which the energy comes from
+	 * @param amount energy to be transferred
+	 * @return Energy not consumed (leftover)
+	 */
+	double injectEnergy(ForgeDirection directionFrom, double amount, double voltage);
+}
+

src/api/java/ic2/api/energy/tile/IEnergySource.java

@@ -0,0 +1,38 @@
+package ic2.api.energy.tile;
+
+/**
+ * Allows a tile entity (mostly a generator) to emit energy.
+ * 
+ * See ic2/api/energy/usage.txt for an overall description of the energy net api.
+ */
+public interface IEnergySource extends IEnergyEmitter {
+	/**
+	 * Energy output provided by the source this tick.
+	 * This is typically Math.min(stored energy, max output/tick).
+	 * 
+	 * @note Modifying the energy net from this method is disallowed.
+	 * 
+	 * @return Energy offered this tick
+	 */
+	double getOfferedEnergy();
+
+	/**
+	 * Draw energy from this source's buffer.
+	 * 
+	 * If the source doesn't have a buffer, this is a no-op.
+	 * 
+	 * @param amount amount of EU to draw, may be negative
+	 */
+	void drawEnergy(double amount);
+
+	/**
+	 * Determine the tier of this energy source.
+	 * 1 = LV, 2 = MV, 3 = HV, 4 = EV etc.
+	 * 
+	 * @note Modifying the energy net from this method is disallowed.
+	 *
+	 * @return tier of this energy source
+	 */
+	int getSourceTier();
+}
+

src/api/java/ic2/api/energy/tile/IEnergyTile.java

@@ -0,0 +1,15 @@
+package ic2.api.energy.tile;
+
+/**
+ * For internal usage only, base class for all energy tiles.
+ *
+ * @see IEnergySink
+ * @see IEnergySource
+ * @see IEnergyConductor
+ * 
+ * See ic2/api/energy/usage.txt for an overall description of the energy net api.
+ */
+public interface IEnergyTile {
+	//
+}
+

src/api/java/ic2/api/energy/tile/IHeatSource.java

@@ -0,0 +1,23 @@
+package ic2.api.energy.tile;
+
+import net.minecraftforge.common.util.ForgeDirection;
+
+public interface IHeatSource {
+	
+	/*
+	 *  Return max heat transmission peer Tick (only theoretical bandwidth not available amount)
+	 */
+	int  maxrequestHeatTick(ForgeDirection directionFrom);
+	
+	/*
+	 * @param requested amount of heat to transfer
+	 * 
+	 * @return transmitted amount of heat
+	 * 
+	 * example: You Request 100 units of heat but the Source have only 50 units left
+	 * 
+	 * requestHeat(100) : return 50 : so 50 units of heat remove from HeatSource
+	 */
+	
+	int requestHeat(ForgeDirection directionFrom, int requestheat);
+}

src/api/java/ic2/api/energy/tile/IKineticSource.java

@@ -0,0 +1,22 @@
+package ic2.api.energy.tile;
+
+import net.minecraftforge.common.util.ForgeDirection;
+
+public interface IKineticSource {
+	/*
+	 *  Return max kinetic energy transmission peer Tick (only theoretical bandwidth not available amount)
+	 */
+	int  maxrequestkineticenergyTick(ForgeDirection directionFrom);
+
+	/*
+	 * @param requested amount of kinetic energy to transfer
+	 * 
+	 * @return transmitted amount of kineticenergy
+	 * 
+	 * example: You Request 100 units of kinetic energy but the Source have only 50 units left
+	 * 
+	 * requestkineticenergy(100) : return 50 : so 50 units of kinetic energy remove from KineticSource
+	 */
+
+	int requestkineticenergy(ForgeDirection directionFrom, int requestkineticenergy);
+}

src/api/java/ic2/api/energy/tile/IMetaDelegate.java

@@ -0,0 +1,36 @@
+package ic2.api.energy.tile;
+
+import java.util.List;
+
+import net.minecraft.tileentity.TileEntity;
+
+/**
+ * Interface for grouping multi-block structures to a single energy net delegate.
+ * 
+ * The energy net uses TileEntity to refer to a specific xyz+world position. If multiple of those
+ * positions should belong to the same functional structure, i.e. they consume or produce energy
+ * only once for the whole multi-block instead of once per every single block, this interface
+ * allows to do so.
+ * 
+ * The tile entity implementing IMetaDelegate has to be added/removed to/from the energy net
+ * instead of every single sub-TileEntity. The energy net interaction will be handled by the
+ * IMetaDelegate TileEntity as well.
+ * 
+ * The sub tile array TileEntity[] just provides optional connectivity (IEnergyAcceptor,
+ * IEnergyEmitter) and mandatory position (x, y, z, World) data.
+ * If the connectivity data on the sub tile is missing, the meta delegate is queried instead.
+ * 
+ * See ic2/api/energy/usage.txt for an overall description of the energy net api.
+ */
+public interface IMetaDelegate extends IEnergyTile {
+	/**
+	 * Get the sub-TileEntities belonging to this Meta TileEntity.
+	 * 
+	 * @note The list has to be consistent between the EnergyNet Load and Unload events.
+	 * @note The list must have at least 1 element.
+	 * @note The parent te implementing IMetaDelegate isn't automatically included.
+	 * 
+	 * @return sub-TileEntity array
+	 */
+	List<TileEntity> getSubTiles();
+}

src/api/java/ic2/api/energy/tile/package-info.java

@@ -0,0 +1,4 @@
+@API(apiVersion="1.0", owner="IC2", provides="IC2API")
+package ic2.api.energy.tile;
+import cpw.mods.fml.common.API;
+

src/api/java/ic2/api/energy/usage.txt

@@ -0,0 +1,144 @@
+--------------------------------
+-- Energy Network Description --
+--------------------------------
+
+There are currently three different types of energy network blocks:
+- energy sources, e.g. generators or the output side of a storage block/transformer
+- energy sinks, e.g. machines or the input side of a storage block/transformer
+- conductors, e.g. cables
+
+Note that storage blocks or transformers are both sources and sinks.
+
+All those blocks have to have a tile entity which has to implement the interface corresponding to
+its function and also post events to the Forge event bus.
+
+The energy generation, distribution and consumption is strictly limited to the simulating (server)
+side, use the proper side checks before posting the related events. One possibility is to check for
+FMLCommonHandler.instance().getEffectiveSide().isClient() being false.
+
+The energy network works by calculating the energy flow between the sources which offer energy
+through getOfferedEnergy() and the sinks which request energy through demandedEnergyUnits().
+Conductors will carry the energy over a distance. Once the energy distribution is calculated, the
+energy net will update the sources and sinks through drawEnergy() and injectEnergyUnits() respectively.
+
+
+---------------------------
+-- Energy Network Events --
+---------------------------
+
+The energy network currently requires 2 events to manage its internal representation of the grids:
+
+-- EnergyTileLoadEvent --
+
+For all energy network tiles (sources, sinks, conductors) you have to post an EnergyTileLoadEvent.
+
+The event has to be posted as soon as the implementing tile entity is fully loaded, usually after
+loading the chunk which contains it or after the user placing the block.
+
+The energy net implementation will use the event to add it to its energy grid map, taking it into
+account for further energy transfers.
+
+You can detect the loading by either using the 1st iteration of updateEntity() or by waiting for
+the next world tick after TileEntity.validate(). The 2nd approach is obviously more sophisticated
+and requires to use some tick queuing mechanism.
+
+The event can by posted as following:
+  MinecraftForge.EVENT_BUS.post(new EnergyTileLoadEvent(this));
+
+-- EnergyTileUnloadEvent --
+
+Another event every energy tile has to post is the EnergyTileUnloadEvent.
+
+The event has to be posted as soon as the implementing tile entity is being unloaded, either by
+unloading the containing chunk or by destroying the block containing it.
+
+It's possible to detect the unloading by triggering on both the beginning of
+TileEntity.invalidate() and the beginning of TileEntity.onChunkUnload().
+
+It is important that the tile entity is still properly linked to the world while posting the unload
+event, otherwise the energy net can't find all affected connections.
+
+
+--------------------------------------
+-- Participating Block Requirements --
+--------------------------------------
+
+The energy net blocks have to do the following to work properly:
+
+-- energy source --
+
+An energy source has to post the following events:
+ - EnergyTileLoadEvent on load
+ - EnergyTileUnloadEvent on unload
+
+Additionally the interface IEnergySource has to be implemented.
+
+-- energy sink --
+
+An energy sink has to post the following events:
+ - EnergyTileLoadEvent on load
+ - EnergyTileUnloadEvent on unload
+
+Additionally the interface IEnergySink has to be implemented.
+
+-- energy conductor --
+
+An energy conductor has to post the following events:
+ - EnergyTileLoadEvent on load
+ - EnergyTileUnloadEvent on unload
+
+Additionally the interface IEnergyConductor has to be implemented.
+
+
+------------------------------
+-- Energy Network Delegates --
+------------------------------
+
+A delegate is a separate object which performs tasks for the original object, in this case handling
+the energy net interaction.
+
+The TileEntity instances used by the events don't have to be the same as the in-world TileEntity
+instance for the corresponding position, it can be delegated to a separate TileEntity instance.
+This separate instance (delegate) needs to have its world and xyz coordinate fields set to match
+the in-world instance. The delegate implements the energy net interfaces and is added and removed
+to/from the energy net through EnergyTileLoadEvent and EnergyTileUnloadEvent.
+
+Separating the interfaces through a delegate allows to isolate the IC2 API usage into separate
+classes an potentially share common code like an input buffer with battery discharging outside the
+class hierarchy.
+It's even possible to use an ic2 energy net delegate alongside an in-world TileEntity which isn't
+designed to work with ic2 energy at all, like making a furnace electric by receiving energy through
+a delegate and adding the corresponding fuel amount to the in-world furnace TileEntity.
+
+Getting the in-world TileEntity for a delegate involves calling World.getBlockTileEntity() with the
+delegate's world and xyz coordinate information.
+
+
+------------------
+-- Multi Blocks --
+------------------
+
+Multi blocks are a group of blocks which act as one functional entity. 
+
+The IMetaDelegate interface groups multiple TileEntity instances (=sub tiles) representing the
+individual blocks to a single Energy Net relevant node. The sub tiles may be normal in-world or
+delegate TileEntity instances.
+
+The meta delegate is added to energy net once for the whole multi block structure and implements
+the energy net interfaces as well. The sub tiles may optionally implement IEnergyEmitter and/or
+IEnergyAcceptor to specify their connectivity rules independently, otherwise the meta delegate will
+be queried.
+
+
+--------------------------------------------------
+-- How to implement/add your own energy network --
+--------------------------------------------------
+
+If you want to create an alternative way of distributing energy, e.g. to have different
+distribution rules or to use energy networks provided by other mods, you can register to the energy
+tile events and use the interfaces to handle the energy distribution yourself. It's no longer
+required to use conversion blocks.
+
+IC2's EnergyNet itself is built on top of the api events and interfaces, providing their default
+use case.
+

src/api/java/ic2/api/event/ExplosionEvent.java

@@ -0,0 +1,44 @@
+package ic2.api.event;
+
+import net.minecraft.entity.Entity;
+import net.minecraft.entity.EntityLivingBase;
+import net.minecraft.world.World;
+
+import cpw.mods.fml.common.eventhandler.Cancelable;
+
+import net.minecraftforge.event.world.WorldEvent;
+
+@Cancelable
+public class ExplosionEvent extends WorldEvent {
+	public ExplosionEvent(World world, Entity entity,
+			double x, double y, double z,
+			double power,
+			EntityLivingBase igniter,
+			int radiationRange, double rangeLimit) {
+		super(world);
+
+		this.entity = entity;
+		this.x = x;
+		this.y = y;
+		this.z = z;
+		this.power = power;
+		this.igniter = igniter;
+		this.radiationRange = radiationRange;
+		this.rangeLimit = rangeLimit;
+	}
+
+	/**
+	 * Entity representing the explosive, may be null.
+	 */
+	public final Entity entity;
+	public double x;
+	public double y;
+	public double z;
+	public double power;
+	/**
+	 * Entity causing the explosion, may be null.
+	 */
+	public final EntityLivingBase igniter;
+	public final int radiationRange;
+	public final double rangeLimit;
+}

src/api/java/ic2/api/event/LaserEvent.java

@@ -0,0 +1,114 @@
+package ic2.api.event;
+
+import net.minecraft.entity.Entity;
+import net.minecraft.entity.EntityLivingBase;
+import net.minecraft.item.ItemStack;
+import net.minecraft.world.World;
+
+import cpw.mods.fml.common.eventhandler.Cancelable;
+
+import net.minecraftforge.event.world.WorldEvent;
+
+/**
+ * A bunch of Events to handle the power of the Mining Laser.
+ */
+@Cancelable
+public class LaserEvent extends WorldEvent {
+	// the Laser Entity
+	public final Entity lasershot;
+
+	// the following variables can be changed and the Laser will adjust to them
+
+	// the Player firing the Laser. If the Laser gets "reflected" the Player could change.
+	public EntityLivingBase owner;
+	// Range of the Laser Shot. Determine the amount of broken blocks, as well, as each broken block will subtract ~1F from range.
+	public float range, power;
+	public int blockBreaks;
+	// Determines whether the laser will explode upon hitting something
+	public boolean explosive, smelt;
+
+	public LaserEvent(World world1, Entity lasershot1, EntityLivingBase owner1, float range1, float power1, int blockBreaks1, boolean explosive1, boolean smelt1) {
+		super(world1);
+		this.lasershot = lasershot1;
+		this.owner = owner1;
+		this.range = range1;
+		this.power = power1;
+		this.blockBreaks = blockBreaks1;
+		this.explosive = explosive1;
+		this.smelt = smelt1;
+	}
+
+	/**
+	 * Event when the Laser is getting shot by a Player.
+	 * 
+	 * The Item is the Laser Gun which the "Player" has shot
+	 */
+	public static class LaserShootEvent extends LaserEvent {
+		ItemStack laseritem;
+
+		public LaserShootEvent(World world1, Entity lasershot1, EntityLivingBase owner1, float range1, float power1, int blockBreaks1, boolean explosive1, boolean smelt1, ItemStack laseritem1) {
+			super(world1, lasershot1, owner1, range1, power1, blockBreaks1, explosive1, smelt1);
+			this.laseritem = laseritem1;
+		}
+	}
+
+	/**
+	 * Event when the Laser is exploding for some Reason.
+	 * 
+	 * The Laser will no longer exist after this Event is posted as it either Explodes or despawns after the Event is fired.
+	 */
+	public static class LaserExplodesEvent extends LaserEvent {
+		// explosion strength, even that can be changed!
+		public float explosionpower, explosiondroprate, explosionentitydamage;
+
+		public LaserExplodesEvent(World world1, Entity lasershot1, EntityLivingBase owner1, float range1, float power1, int blockBreaks1, boolean explosive1, boolean smelt1, float explosionpower1, float explosiondroprate1, float explosionentitydamage1) {
+			super(world1, lasershot1, owner1, range1, power1, blockBreaks1, explosive1, smelt1);
+			this.explosionpower = explosionpower1;
+			this.explosiondroprate = explosiondroprate1;
+			this.explosionentitydamage = explosionentitydamage1;
+		}
+	}
+
+	/**
+	 * Event when the Laser is hitting a Block
+	 * x, y and z are the Coords of the Block.
+	 * 
+	 * Canceling this Event stops the Laser from attempting to break the Block, what is very useful for Glass.
+	 * Use lasershot.setDead() to remove the Shot entirely.
+	 */
+	public static class LaserHitsBlockEvent extends LaserEvent {
+		// targeted block, even that can be changed!
+		public int x, y, z;
+		public int side;
+		// removeBlock determines if the Block will be removed. dropBlock determines if the Block should drop something.
+		public boolean removeBlock, dropBlock;
+		public float dropChance;
+
+		public LaserHitsBlockEvent(World world1, Entity lasershot1, EntityLivingBase owner1, float range1, float power1, int blockBreaks1, boolean explosive1, boolean smelt1, int x1, int y1, int z1, int side1, float dropChance1, boolean removeBlock1, boolean dropBlock1) {
+			super(world1, lasershot1, owner1, range1, power1, blockBreaks1, explosive1, smelt1);
+			this.x = x1;
+			this.y = y1;
+			this.z = z1;
+			this.side = side1;
+			this.removeBlock = removeBlock1;
+			this.dropBlock = dropBlock1;
+			this.dropChance = dropChance1;
+		}
+	}
+
+	/**
+	 * Event when the Laser is getting at a Living Entity
+	 * 
+	 * Canceling this Event ignores the Entity
+	 * Use lasershot.setDead() to remove the Shot entirely.
+	 */
+	public static class LaserHitsEntityEvent extends LaserEvent {
+		// the Entity which the Laser has shot at, even the target can be changed!
+		public Entity hitentity;
+
+		public LaserHitsEntityEvent(World world1, Entity lasershot1, EntityLivingBase owner1, float range1, float power1, int blockBreaks1, boolean explosive1, boolean smelt1, Entity hitentity1) {
+			super(world1, lasershot1, owner1, range1, power1, blockBreaks1, explosive1, smelt1);
+			this.hitentity = hitentity1;
+		}
+	}
+}

src/api/java/ic2/api/event/PaintEvent.java

@@ -0,0 +1,32 @@
+package ic2.api.event;
+
+import net.minecraft.world.World;
+
+import cpw.mods.fml.common.eventhandler.Cancelable;
+
+import net.minecraftforge.event.world.WorldEvent;
+
+@Cancelable
+public class PaintEvent extends WorldEvent {
+	// target block
+	public final int x;
+	public final int y;
+	public final int z;
+	public final int side;
+
+	// color to paint the block
+	public final int color;
+
+	// set to true to confirm the operation
+	public boolean painted = false;
+
+	public PaintEvent(World world1, int x1, int y1, int z1, int side1, int color1) {
+		super(world1);
+
+		this.x = x1;
+		this.y = y1;
+		this.z = z1;
+		this.side = side1;
+		this.color = color1;
+	}
+}

src/api/java/ic2/api/event/RetextureEvent.java

@@ -0,0 +1,37 @@
+package ic2.api.event;
+
+import net.minecraft.block.Block;
+import net.minecraft.world.World;
+
+import cpw.mods.fml.common.eventhandler.Cancelable;
+
+import net.minecraftforge.event.world.WorldEvent;
+
+@Cancelable
+public class RetextureEvent extends WorldEvent {
+	// target block
+	public final int x;
+	public final int y;
+	public final int z;
+	public final int side;
+
+	// referenced block (to grab the texture from)
+	public final Block referencedBlock;
+	public final int referencedMeta;
+	public final int referencedSide;
+
+	// set to true to confirm the operation
+	public boolean applied = false;
+
+	public RetextureEvent(World world1, int x1, int y1, int z1, int side1, Block referencedBlock, int referencedMeta1, int referencedSide1) {
+		super(world1);
+
+		this.x = x1;
+		this.y = y1;
+		this.z = z1;
+		this.side = side1;
+		this.referencedBlock = referencedBlock;
+		this.referencedMeta = referencedMeta1;
+		this.referencedSide = referencedSide1;
+	}
+}

src/api/java/ic2/api/event/package-info.java

@@ -0,0 +1,4 @@
+@API(apiVersion="1.0", owner="IC2", provides="IC2API")
+package ic2.api.event;
+import cpw.mods.fml.common.API;
+

src/api/java/ic2/api/info/IEnergyValueProvider.java

@@ -0,0 +1,17 @@
+package ic2.api.info;
+
+import net.minecraft.item.ItemStack;
+
+public interface IEnergyValueProvider {
+	/**
+	 * Determine the energy value for a single item in the supplied stack.
+	 * The value is used by most machines in the discharge slot.
+	 * 
+	 * This only applies to basic single use items, others are to be queried
+	 * through e.g. ElectricItem.manager.getCharge().
+	 * 
+	 * @param itemStack ItemStack containing the item to evaluate.
+	 * @return energy in EU
+	 */
+	double getEnergyValue(ItemStack itemStack);
+}

src/api/java/ic2/api/info/IFuelValueProvider.java

@@ -0,0 +1,15 @@
+package ic2.api.info;
+
+import net.minecraft.item.ItemStack;
+
+public interface IFuelValueProvider {
+	/**
+	 * Determine the fuel value for a single item in the supplied stack.
+	 * The information currently applies to Generators and the Iron Furnace.
+	 * 
+	 * @param itemStack ItemStack containing the item to evaluate.
+	 * @param allowLava Determine if lava has a fuel value, currently only true for the Iron Furnace.
+	 * @return fuel value
+	 */
+	int getFuelValue(ItemStack itemStack, boolean allowLava);
+}

src/api/java/ic2/api/info/Info.java

@@ -0,0 +1,32 @@
+package ic2.api.info;
+
+import net.minecraft.util.DamageSource;
+
+import cpw.mods.fml.common.Loader;
+import cpw.mods.fml.common.LoaderState;
+
+public class Info {
+	public static IEnergyValueProvider itemEnergy;
+	public static IFuelValueProvider itemFuel;
+	public static Object ic2ModInstance;
+
+	/**
+	 * Damage Sources used by IC2.
+	 * Getting assigned in preload.
+	 */
+	public static DamageSource DMG_ELECTRIC, DMG_NUKE_EXPLOSION, DMG_RADIATION;
+
+	public static boolean isIc2Available() {
+		if (ic2Available != null) return ic2Available;
+
+		boolean loaded = Loader.isModLoaded("IC2");
+
+		if (Loader.instance().hasReachedState(LoaderState.CONSTRUCTING)) {
+			ic2Available = loaded;
+		}
+
+		return loaded;
+	}
+
+	private static Boolean ic2Available = null;
+}

src/api/java/ic2/api/info/package-info.java

@@ -0,0 +1,4 @@
+@API(apiVersion="1.0", owner="IC2", provides="IC2API")
+package ic2.api.info;
+import cpw.mods.fml.common.API;
+

src/api/java/ic2/api/item/ElectricItem.java

@@ -0,0 +1,59 @@
+package ic2.api.item;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import net.minecraft.item.ItemStack;
+
+/**
+ * Allows for charging, discharging and using electric items (IElectricItem).
+ */
+public final class ElectricItem {
+	/**
+	 * IElectricItemManager to use for interacting with IElectricItem ItemStacks.
+	 * 
+	 * This manager will act as a gateway and delegate the tasks to the final implementation
+	 * (rawManager or a custom one) as necessary.
+	 */
+	public static IElectricItemManager manager;
+
+	/**
+	 * Standard IElectricItemManager implementation, only call it directly from another
+	 * IElectricItemManager. Use manager instead.
+	 */
+	public static IElectricItemManager rawManager;
+
+	/**
+	 * Register an electric item manager for items not implementing IElectricItem.
+	 * 
+	 * This method is only designed for special purposes, implementing IElectricItem or
+	 * ISpecialElectricItem instead of using this is faster.
+	 * 
+	 * Managers used with ISpecialElectricItem shouldn't be registered.
+	 * 
+	 * @param manager Manager to register.
+	 */
+	public static void registerBackupManager(IBackupElectricItemManager manager) {
+		backupManagers.add(manager);
+	}
+
+	/**
+	 * Get the electric item manager suitable for the supplied item stack.
+	 * 
+	 * This method is for internal use only.
+	 * 
+	 * @param stack ItemStack to be handled.
+	 * @return First suitable electric item manager.
+	 */
+	public static IBackupElectricItemManager getBackupManager(ItemStack stack) {
+		for (IBackupElectricItemManager manager : backupManagers) {
+			if (manager.handles(stack)) return manager;
+		}
+
+		return null;
+	}
+
+
+	private static final List<IBackupElectricItemManager> backupManagers = new ArrayList<IBackupElectricItemManager>();
+}
+

src/api/java/ic2/api/item/IBackupElectricItemManager.java

@@ -0,0 +1,12 @@
+package ic2.api.item;
+
+import net.minecraft.item.ItemStack;
+
+/**
+ * This interface specifies a manager applicable to items not implementing IElectricItem.
+ *
+ * The manager implementing this has to be registered with ElectricItem.registerBackupManager().
+ */
+public interface IBackupElectricItemManager extends IElectricItemManager {
+	boolean handles(ItemStack stack);
+}

src/api/java/ic2/api/item/IBlockCuttingBlade.java

@@ -0,0 +1,6 @@
+package ic2.api.item;
+
+
+public interface IBlockCuttingBlade {
+	int gethardness();
+}

src/api/java/ic2/api/item/IBoxable.java

@@ -0,0 +1,14 @@
+package ic2.api.item;
+
+import net.minecraft.item.ItemStack;
+
+
+public interface IBoxable {
+	/**
+	 * Determine whether an item can be stored in a toolbox or not.
+	 * 
+	 * @param itemstack item to be stored
+	 * @return Whether to store the item in the toolbox or not
+	 */
+	public abstract boolean canBeStoredInToolbox(ItemStack itemstack);
+}

src/api/java/ic2/api/item/IC2Items.java

@@ -0,0 +1,598 @@
+package ic2.api.item;
+
+import net.minecraft.item.ItemStack;
+
+/**
+ * Provides access to IC2 blocks and items.
+ * 
+ * Some items can be acquired through the ore dictionary which is the recommended way.
+ * The items are initialized while IC2 is being loaded - try to use ModsLoaded() or load your mod after IC2.
+ * Some blocks/items can be disabled by a config setting, so it's recommended to check if they're null first.
+ * 
+ * Getting the associated Block/Item for an ItemStack x:
+ *   Blocks: Block.blocksList[x.itemID]
+ *   Items: x.getItem()
+ */
+public final class IC2Items {
+	/**
+	 * Get an ItemStack for a specific item name, example: Items.getItem("resin")
+	 * See the list below for item names.
+	 * Make sure to copy() the ItemStack if you want to modify it.
+	 *
+	 * @param name item name
+	 * @return The item or null if the item does not exist or an error occurred
+	 */
+	public static ItemStack getItem(String name) {
+		try {
+			if (Ic2Items == null) Ic2Items = Class.forName(getPackage() + ".core.Ic2Items");
+
+			Object ret = Ic2Items.getField(name).get(null);
+
+			if (ret instanceof ItemStack) {
+				return (ItemStack) ret;
+			}
+			return null;
+		} catch (Exception e) {
+			System.out.println("IC2 API: Call getItem failed for "+name);
+
+			return null;
+		}
+	}
+
+	/* Possible values:
+
+	// ores
+	  copperOre; 			// Copper Ore block, currently not meta sensitive, meta in ItemStack set to 0, ore dictionary: oreCopper, null with enableWorldGenOreCopper = false
+	  tinOre; 			// Tin Ore block, currently not meta sensitive, meta in ItemStack set to 0, ore dictionary: oreTin, null with enableWorldGenOreTin = false
+	  uraniumOre; 		// Tin Ore block, currently not meta sensitive, meta in ItemStack set to 0, ore dictionary: oreUranium, null with enableWorldGenOreUranium = false
+	  leadOre;            // Lead Ore Block, currently not meta sensitive,  meta in ItemStack set to 0, ore dictionary: oreLead, null with enableWorldGenOreLead = false
+
+	// rubber related
+
+	  Rubber wood block, meta reflects the state, meta in ItemStack set to 0, ore dictionary: woodRubber (with meta 0), null with enableWorldGenTreeRubber = false
+	  dropped (as an item)  -> metadata 0
+	  block, no resin spot  -> metadata 0 or 1
+	  block, wet resin spot -> metadata 2-5 (according to the side)
+	  block, dry resin spot -> metadata 8-11 (wet state + 6)
+
+	  rubberWood;
+	  rubberLeaves; 		// Rubber Leaves block, currently not meta sensitive, meta in ItemStack set to 0, null with enableWorldGenTreeRubber = false
+	  rubberSapling; 		// Rubber Sapling block, currently not meta sensitive, meta in ItemStack set to 0, null with enableWorldGenTreeRubber = false
+	  resinSheet; 		// Resin Sheet block, currently not meta sensitive
+	  rubberTrampoline; 	// Rubber Trampoline block, meta reflects internal state, meta in ItemStack set to 0
+
+	// building/storage
+	  ironFence; 				// Iron Fence block, currently not meta sensitive
+
+	  reinforcedStone; 		// Reinforced Stone block, currently not meta sensitive
+	  reinforcedGlass; 		// Reinforced Glass block, currently not meta sensitive
+	  reinforcedDoorBlock; 	// Reinforced Door block, meta reflects the state (see vanilla doors), meta in ItemStack set to 0
+
+	  constructionreinforcedFoam; //  Construction Reinforced Foam block, currently not meta sensitive
+	  constructionFoam; 		// Construction Foam block, currently not meta sensitive
+	  constructionFoamWall; 	// Construction Foam Wall block, meta = color, implements IPaintableBlock
+	  scaffold; 				// Scaffold block, meta reflects internal physical model data
+	  ironScaffold; 				// Scaffold block, meta reflects internal physical model data
+
+	  bronzeBlock; 			// Bronze block, meta sensitive
+	  copperBlock; 			// Copper block, meta sensitive
+	  tinBlock; 				// Tin block, meta sensitive
+	  uraniumBlock; 			// Uranium block, meta sensitive
+	  leadBlock;          // Uranium block, meta sensitive
+
+	// cables (when placed as a block, inventory items are different; TE implements IEnergyConductor)
+
+	  copperCableBlock; 				// Copper Cable block, meta sensitive
+	  insulatedCopperCableBlock; 		// Insulated Copper Cable block, meta sensitive
+
+	  goldCableBlock; 				// Gold Cable block, meta sensitive
+	  insulatedGoldCableBlock; 		// Insulated Gold Cable block, meta sensitive
+	  doubleInsulatedGoldCableBlock; 	// Double Insulated Gold Cable block, meta sensitive
+
+	  ironCableBlock; 				// Iron Cable block, meta sensitive
+	  insulatedIronCableBlock; 		// Insulated Iron Cable block, meta sensitive
+	  doubleInsulatedIronCableBlock; 	// Double Insulated Iron Cable block, meta sensitive
+	  trippleInsulatedIronCableBlock; // Tripple Insulated Iron Cable block, meta sensitive
+
+	  glassFiberCableBlock; 			// Glass Fiber Cable block, meta sensitive
+
+	  tinCableBlock; 					// Tin Cable block, meta sensitive
+	  insulatedtinCableBlock;         // Insulated Tin Cable item, meta sensitive
+	  detectorCableBlock; 			// Detector Cable block, meta sensitive
+	  splitterCableBlock; 			// Splitter Cable block, meta sensitive
+
+	// generators + related (TE implements IEnergySource ex. reactorChamber)
+
+	  generator; 				// Generator block, meta sensitive
+	  geothermalGenerator; 	// Geothermal Generator block, meta sensitive
+	  waterMill; 				// Water Mill block, meta sensitive
+	  solarPanel; 			// Solar Panel block, meta sensitive
+	  windMill; 				// Wind Mill block, meta sensitive
+	  nuclearReactor; 		// Nuclear Reactor block, meta sensitive
+	  reactorChamber; 		// Reactor Chamber block, currently not meta sensitive
+	  RTGenerator;             //  Radioisotope Thermoelectric Generator block, meta sensitive
+	  semifluidGenerator;      //  Semifluid Generator block, meta sensitive
+
+
+	// energy storages (TE implements IEnergySource and IEnergyConductor)
+
+	  batBox; 			// BatBox block, meta sensitive
+	  cesuUnit;           // CESU Unit block, meta sensitive
+	  mfeUnit; 			// MFE Unit block, meta sensitive
+	  mfsUnit; 			// MFS Unit block, meta sensitive
+
+	// transformers (TE implements IEnergySource and IEnergyConductor)
+
+	  lvTransformer; 		// LV Transformer block, meta sensitive
+	  mvTransformer; 		// MV Transformer block, meta sensitive
+	  hvTransformer; 		// HV Transformer block, meta sensitive
+	  evTransformer; 		// EV Transformer block, meta sensitive
+
+	// machines + related (TE implements IEnergySink ex. machine, miningPipe, miningPipeTip)
+
+	  machine; 			// Machine block, meta sensitive
+	  advancedMachine; 	// Advanced Machine block, meta sensitive
+
+	  ironFurnace; 		// Iron Furnace block, meta sensitive
+	  electroFurnace; 	// Electro Furnace block, meta sensitive
+	  macerator; 			// Macerator block, meta sensitive
+	  extractor; 			// Extractor block, meta sensitive
+	  compressor; 		// Compressor block, meta sensitive
+	  canner; 			// Canner block, meta sensitive
+	  miner; 				// Miner block, meta sensitive
+	  pump; 				// Pump block, meta sensitive
+	  magnetizer;			// Magnetizer block, meta sensitive
+	  electrolyzer; 		// Electrolyzer block, meta sensitive
+	  recycler; 			// Recycler block, meta sensitive
+	  inductionFurnace; 	// Induction Furnace block, meta sensitive
+	  massFabricator; 	// Mass Fabricator block, meta sensitive
+	  terraformer;		// Terraformer block, meta sensitive
+	  teleporter; 		// Teleporter block, meta sensitive
+	  teslaCoil; 			// Tesla Coil block, meta sensitive
+	  luminator; 			// Passive (dark) Luminator block, meta = facing
+	  activeLuminator; 	// Active (bright) Luminator block, meta = facing
+	  centrifuge;         // Centrifuge block, meta sensitive
+	  metalformer;         // MetalFormer block , meta sensitive
+	  orewashingplant;    // Ore Wasching Plant, Meta sensitive
+	  patternstorage;    // Pattern Storage, Meta sensitive
+	  scanner;           // Scanner, Meta sensitive
+	  replicator;           // Replicator, Meta sensitive
+
+	  miningPipe; 		// Mining Pipe block, currently not meta sensitive, meta in ItemStack set to 0
+	  miningPipeTip; 		// Mining Pipe Tip block, currently not meta sensitive, meta in ItemStack set to 0
+
+
+	// personal blocks
+
+	  personalSafe; 		// Personal Safe block, meta sensitive
+	  tradeOMat; 			// Trade-O-Mat block, meta sensitive
+	  energyOMat; 		// Energy-O-Mat block, meta sensitive
+
+	// explosives
+
+	  industrialTnt; 			// Industrial TNT block, currently not meta sensitive
+	  nuke; 					// Nuke block, currently not meta sensitive
+	  dynamiteStick; 			// Dynamite Stick block, meta = placement, meta in ItemStack set to 0
+	  dynamiteStickWithRemote; // Dynamite Stick with Remote block, meta = placement, meta in ItemStack set to 0
+
+	// Agriculture Stuff
+
+	  crop; // Crop Block, empty, not meta sensitive
+	  cropmatron; // Cropmatron machien block, meta sensititve
+
+	// ----- items -----
+
+	// rubber + related
+	  resin; 				// Resin item, currently not meta sensitive
+	  rubber; 			// Rubber item, currently not meta sensitive, ore dictionary: itemRubber
+
+	  FluidCell;
+
+	//  Lithium -> Tritium
+
+	  reactorLithiumCell;    // LithiumCell use in Reaktor, , meta = damage value
+	  TritiumCell;           // Tritium, currently not meta sensitive
+
+	// Nuclear Fuel
+
+	  UranFuel;               // , currently not meta sensitive
+	  MOXFuel;                // , currently not meta sensitive
+	  Plutonium;              // , currently not meta sensitive
+	  smallPlutonium;         // , currently not meta sensitive
+	  Uran235;                // , currently not meta sensitive
+	  smallUran235;           // , currently not meta sensitive
+	  Uran238;                // , currently not meta sensitive
+
+	  reactorDepletedUraniumSimple;   // Depleted Uranium Cell items, currently not meta sensitive
+	  reactorDepletedUraniumDual;
+	  reactorDepletedUraniumQuad;
+	  reactorDepletedMOXSimple;   // Depleted MOX Cell items, currently not meta sensitive
+	  reactorDepletedMOXDual;
+	  reactorDepletedMOXQuad;
+	  reactorMOXSimple;   // Depleted MOX Cell items, currently not meta sensitive
+	  reactorMOXDual;
+	  reactorMOXQuad;
+	  RTGPellets;
+
+
+	// Recipe Parts
+
+	  coil;                   // Coil,  meta sensitive
+	  elemotor;               // electric motor,  meta sensitive
+	  powerunit;              // Item Power Unit,  meta sensitive
+	  powerunitsmall;              // Item Power Unit,  meta sensitive
+
+
+	// ItemCasing
+
+	  casingcopper;           //  Copper ItemCasing,  meta sensitive
+	  casingtin;              //  Tin ItemCasing,  meta sensitive
+	  casingbronze;           //  Bronze ItemCasing,  meta sensitive
+	  casinggold;             //  Gold ItemCasing,  meta sensitive
+	  casingiron;             //  Iron ItemCasing,  meta sensitive
+	@Deprecated
+	  casingadviron;          //  Refined Iron ItemCasing,  meta sensitive
+	  casinglead;             //  Lead ItemCasing,  meta sensitive
+
+	// Crushed Ore
+	  crushedIronOre;       // Crushed Iron Ore,  meta sensitive
+	  crushedCopperOre;     // Crushed Copper Ore,  meta sensitive
+	  crushedGoldOre;       // Crushed Gold Ore,  meta sensitive
+	  crushedTinOre;        // Crushed Tin Ore,  meta sensitive
+	  crushedUraniumOre;    // Crushed Uranium Ore,  meta sensitive
+	  crushedSilverOre;     // Crushed Silver Ore,  meta sensitive
+	  crushedLeadOre;       // Crushed Lead Ore,  meta sensitive
+
+
+	//Purify Crushed Ore
+	  purifiedCrushedIronOre;       // Purify Crushed Iron Ore,  meta sensitive
+	  purifiedCrushedCopperOre;     // Purify Crushed Copper Ore,  meta sensitive
+	  purifiedCrushedGoldOre;       // Purify Crushed Gold Ore,  meta sensitive
+	  purifiedCrushedTinOre;        // Purify Crushed Tin Ore,  meta sensitive
+	  purifiedCrushedUraniumOre;    // Purify Crushed Uranium Ore,  meta sensitive
+	  purifiedCrushedSilverOre;     // Purify Crushed Silver Ore,  meta sensitive
+	  purifiedCrushedLeadOre;       // Purify Crushed Lead Ore,  meta sensitive
+
+	// dusts
+	  stoneDust;
+	  bronzeDust; 		// Bronze Dust item,   meta sensitive, ore dictionary: dustBronze
+	  clayDust; 			// Clay Dust item,   meta sensitive, ore dictionary: dustClay
+	  coalDust; 			// Coal Dust item,   meta sensitive, ore dictionary: dustCoal
+	  copperDust; 		// Copper Dust item,   meta sensitive, ore dictionary: dustCopper
+	  goldDust; 			// Gold Dust item,   meta sensitive, ore dictionary: dustGold
+	  ironDust; 			// Iron Dust item,   meta sensitive, ore dictionary: dustIron
+	  silverDust; 		// Silver Dust item,   meta sensitive, ore dictionary: dustSilver
+	  tinDust; 			// Tin Dust item,   meta sensitive, ore dictionary: dustTin
+	  hydratedCoalDust; 	// Hydrated Coal Dust item,   meta sensitive
+	  leadDust;           // Lead Dust item,   meta sensitive, ore dictionary: dustLead
+	  obsidianDust;       // Obsidian Dust item,   meta sensitive, ore dictionary: dustObsidian
+	  lapiDust;           // Lapi Dust item,   meta sensitive, ore dictionary: dustLapi
+	  sulfurDust;         // Sulfur Dust item,   meta sensitive, ore dictionary: dustSulfur
+	  lithiumDust;        // Lithium dust,   meta sensitive, ore dictionary: dustLithium
+
+	// small dusts
+
+	  smallIronDust;      // Small Iron Dust item,  meta sensitive
+	  smallCopperDust;    // Small Copper Dust item, meta sensitive
+	  smallGoldDust;      // Small Gold Dust item,  meta sensitive
+	  smallTinDust;       // Small Tin Dust item,  meta sensitive
+	  smallSilverDust;    // Small Silver Dust item,  meta sensitive
+	  smallLeadDust;      // Small Lead Dust item,  meta sensitive
+	  smallSulfurDust;    // Small Sulfur Dust item,  meta sensitive
+	  smallLithiumDust;   // Small Lithium Dust item,  meta sensitive
+
+
+	// ingots
+	@Deprecated
+	  refinedIronIngot; 	// Refined Iron Ingot item, currently not meta sensitive, ore dictionary: ingotRefinedIron
+	  copperIngot; 		// Copper Ingot item, currently not meta sensitive, ore dictionary: ingotCopper
+	  tinIngot; 			// Tin Ingot item, currently not meta sensitive, ore dictionary: ingotTin
+	  bronzeIngot; 		// Bronze Ingot item, currently not meta sensitive, ore dictionary: ingotBronze
+	  mixedMetalIngot; 	// Mixed Metal Ingot item, currently not meta sensitive
+	  leadIngot;          // Lead Ingot item, currently not meta sensitive
+
+
+	// tools/weapons (without electric tools)
+	  treetap; 					// Treetap item, meta = damage value
+	  wrench; 					// Wrench item, meta = damage value
+	  cutter; 					// Insulation Cutter item, meta = damage value
+	  constructionFoamSprayer; 	// Construction Foam Sprayer item, meta = charges (as of v1.45)
+
+	  bronzePickaxe; 		// Bronze Pickaxe item, meta = damage value
+	  bronzeAxe; 			// Bronze Axe item, meta = damage value
+	  bronzeSword; 		// Bronze Sword item, meta = damage value
+	  bronzeShovel; 		// Bronze Shovel item, meta = damage value
+	  bronzeHoe; 			// Bronze Hoe item, meta = damage value
+
+	  ForgeHammer;             // Refine Iron Hammer item, meta = damage value
+
+	// el. tools/devices/weapons
+	  miningDrill; 		// Mining Drill item, meta = damage value for charge level
+	  diamondDrill; 		// Diamond Tipped Mining Drill item, meta = damage value for charge level
+	  iridiumDrill;		// Iridium Tipped Mining Drill item, meta = damage value for charge level
+	  chainsaw; 			// Chainsaw item, meta = damage value for charge level
+	  electricWrench;		// Electric Wrench item, meta = damage value for charge level
+	  electricTreetap;	// Electric Treetap item, meta = damage value for charge level
+	  miningLaser; 		// Mining Laser item, meta = damage value for charge level
+
+	  ecMeter; 			// EC-Mater item, meta = itemdata db index (as of v1.45)
+	  odScanner; 			// Ore Density Scanner item, meta = damage value for charge level
+	  ovScanner; 			// Ore Value Scanner item, meta = damage value for charge level
+	  obscurator;			// Obscurator item, meta = damage value for charge level
+
+	  frequencyTransmitter; // Frequency Transmitter item, meta = itemdata db index (as of v1.45)
+
+	  nanoSaber; 			// Idle Nano Saber item, meta = damage value for charge level
+	  enabledNanoSaber; 	// Enabled Nano Saber item, meta = damage value for charge level
+
+	  toolbox; 			// Open/Empty toolbox, meta = Open (0) / Closed (1)
+
+	// armor/wearable
+	  hazmatHelmet; 		// Hazmat Helmet item, meta = damage value
+	  hazmatChestplate; 	// Hazmat Chestplate item, meta = damage value
+	  hazmatLeggings; 	// Hazmat Leggings item, meta = damage value
+	  hazmatBoots; 		// Hazmat Boots item, meta = damage value
+
+	  bronzeHelmet; 		// Bronze Helmet Armor item, meta = damage value
+	  bronzeChestplate; 	// Bronze Chestplate Armor item, meta = damage value
+	  bronzeLeggings; 	// Bronze Leggings Armor item, meta = damage value
+	  bronzeBoots; 		// Bronze Boots Armor item, meta = damage value
+
+	  compositeArmor; 	// Composite Armor item, meta = damage value for charge level
+
+	  nanoHelmet; 		// Nano Helmet Armor item, meta = damage value for charge level
+	  nanoBodyarmor; 		// Nano Bodyarmor item, meta = damage value for charge level
+	  nanoLeggings; 		// Nano Leggings Armor item, meta = damage value for charge level
+	  nanoBoots; 			// Nano Boots Armor item, meta = damage value for charge level
+
+	  quantumHelmet; 		// Quantum Helmet Armor item, meta = damage value for charge level
+	  quantumBodyarmor; 	// Quantum Bodyarmor item, meta = damage value for charge level
+	  quantumLeggings; 	// Quantum Leggings Armor item, meta = damage value for charge level
+	  quantumBoots; 		// Quantum Boots Armor item, meta = damage value for charge level
+
+	  jetpack; 			// Jetpack item, meta = damage value for fuel level
+	  electricJetpack; 	// Electric Jetpack item, meta = damage value for charge level
+
+	  batPack; 			// BatPack item, meta = damage value for charge level
+	  advbatPack; 		// Adv.BatPack item, meta = damage value for charge level
+	  lapPack; 			// LapPack item, meta = damage value for charge level
+	  energyPack; 		// EnergyPack item, meta = damage value for charge level
+
+	  cfPack; 			// CF Pack item, meta = charges (as of v1.45)
+	  solarHelmet;		// Solar Helmet, currently not meta sensitive
+	  staticBoots;		// Static Boots, currently not meta sensitive
+	  nightvisionGoggles;	// Nightvision Goggles, meta = damage value for charge level
+
+	// batteries
+	  reBattery; 			// Empty RE Battery item, currently not meta sensitive
+	  chargedReBattery; 	// RE Battery item, meta = damage value for charge level
+	  advBattery;         // Adv Batteryitem, meta = damage value for charge level
+	  energyCrystal; 		// Energy Crystal item, meta = damage value for charge level
+	  lapotronCrystal; 	// Lapotron Crystal item, meta = damage value for charge level
+	  suBattery; 			// SU Battery item, meta = damage value for charge level
+
+	// cables
+	  copperCableItem; 				// Copper Cable item, meta sensitive
+	  insulatedCopperCableItem; 		// Insulated Copper Cable item, meta sensitive
+
+	  goldCableItem; 					// Gold Cable item, meta sensitive
+	  insulatedGoldCableItem; 		// Insulated Gold Cable item, meta sensitive
+
+	@Deprecated
+	  doubleInsulatedGoldCableItem; 	// Double Insulated Gold Cable item, meta sensitive
+
+	  ironCableItem; 					// Iron Cable item, meta sensitive
+	  insulatedIronCableItem; 		// Insulated Iron Cable item, meta sensitive
+
+	@Deprecated
+	  doubleInsulatedIronCableItem; 	// Double Insulated Iron Cable item, meta sensitive
+	@Deprecated
+	  trippleInsulatedIronCableItem; 	// Tripple Insulated Iron Cable item, meta sensitive
+	  insulatedTinCableItem;
+	  glassFiberCableItem; 			// Glass Fiber Cable item, meta sensitive
+	  tinCableItem; 					// Tin Cable item, meta sensitive
+
+
+	  detectorCableItem; 				// Detector Cable item, meta sensitive
+	  splitterCableItem; 				// Splitter Cable item, meta sensitive
+
+	// cells/containers (without reactor components)
+
+	  cell; 					// Empty Cell item, meta sensitive
+	  lavaCell; 				// Lava Cell item,  meta sensitive
+	  waterCell; 				// Water Cell item, meta sensitive
+	  UuMatterCell;			// UUMatter Cell item, meta sensitive
+	  CFCell;					// constructionFoam Cell item, meta sensitive
+
+
+	  fuelRod;                // Empy Fuel Rod item, currently not meta sensitive
+	  hydratedCoalCell; 		// Hydrated Coal Cell item, currently not meta sensitive
+	  bioCell; 				// Bio Cell item, currently not meta sensitive
+	  coalfuelCell; 			// Coalfuel Cell item, currently not meta sensitive
+	  biofuelCell; 			// Biofuel Cell item, currently not meta sensitive
+	  electrolyzedWaterCell; 	// Electrolyzed Water Cell item, currently not meta sensitive
+	  airCell; 				// Compressed Air item, currently not meta sensitive
+
+	  fuelCan; 				// Empty Fuel Can item, currently not meta sensitive
+	  filledFuelCan; 			// Fuel Can item, meta = fuel value (as of v1.45)
+
+	  tinCan; 				// Empty Tin Can item, currently not meta sensitive
+	  filledTinCan; 			// Filled Tin Can item, currently not meta sensitive
+
+	// reactor components
+	  reactorUraniumSimple; 	   // Uranium Cell items, meta = consumed uranium ticks
+	  reactorUraniumDual;
+	  reactorUraniumQuad;
+
+	  reactorCoolantSimple;
+	  reactorCoolantTriple ;		// Coolant Cell item, NBT for heat-storage, meta is 0-10000 for display
+	  reactorCoolantSix;
+
+	  reactorPlating; 			// Integrated Reactor Plating item, currently not meta sensitive
+	  reactorPlatingHeat;
+	  reactorPlatingExplosive;
+
+	  reactorHeatSwitch;	// Integrated Heat Disperser item,  NBT for heat-storage, meta is 0-10000 for display
+	  reactorHeatSwitchCore;
+	  reactorHeatSwitchSpread;
+	  reactorHeatSwitchDiamond;
+
+	  reactorVent;			// Heat Venting component,  NBT for heat-storage, meta is 0-10000 for display
+	  reactorVentCore;
+	  reactorVentGold;
+	  reactorVentSpread;// Special: Does not store heat
+	  reactorVentDiamond;
+
+	  reactorReflector;			// Increase efficiency without additional ticks,  NBT for heat-storage, meta is 0-10000 for display
+	  reactorReflectorThick;			// Increase efficiency without additional ticks,   NBT for heat-storage, meta is 0-10000 for display
+	  reactorCondensator;			// Consumes redstone to absorb heat, NBT for storage, meta is 0-10000 for display
+	  reactorCondensatorLap;			// Consumes redstone/lapis to absorb heat, mNBT for storage, meta is 0-10000 for display
+
+	// terraformer blueprints
+	  terraformerBlueprint; 				// Empty Terraformer Blueprint item, currently not meta sensitive
+	  cultivationTerraformerBlueprint; 	// Cultivation Terraformer Blueprint item, currently not meta sensitive
+	  irrigationTerraformerBlueprint; 	// Irrigation Terraformer Blueprint item, currently not meta sensitive
+	  chillingTerraformerBlueprint; 		// Chilling Terraformer Blueprint item, currently not meta sensitive
+	  desertificationTerraformerBlueprint; // Desertification Terraformer Blueprint item, currently not meta sensitive
+	  flatificatorTerraformerBlueprint; 	// Flatificator Terraformer Blueprint item, currently not meta sensitive
+	  mushroomTerraformerBlueprint; 	    // Mushroom Terraformer Blueprint item, currently not meta sensitive
+
+	// diamond chain
+	  coalBall; 			// Coal Ball item, currently not meta sensitive
+	  compressedCoalBall; // Compressed Coal Ball item, currently not meta sensitive
+	  coalChunk; 			// Coal Chunk item, currently not meta sensitive
+	  industrialDiamond; 	// Industrial Diamond item, currently not meta sensitive, DEPRECATED
+
+	// recycler chain
+	  scrap; 				// Scrap item, currently not meta sensitive
+	  scrapBox; 			// Scrap Box item, currently not meta sensitive
+
+	// fuel production chain
+	  hydratedCoalClump; 		// Hydrated Coal Clump item, currently not meta sensitive
+	  plantBall; 				// Plant Ball item, currently not meta sensitive
+	  compressedPlantBall; 	// Compressed Plant Ball item, currently not meta sensitive
+
+	// painting
+	  painter; 			// Painter item, currently not meta sensitive
+
+	  blackPainter; 		// Black Painter item, meta = damage value
+	  redPainter; 		// Red Painter item, meta = damage value
+	  greenPainter; 		// Green Painter item, meta = damage value
+	  brownPainter; 		// Brown Painter item, meta = damage value
+	  bluePainter; 		// Blue Painter item, meta = damage value
+	  purplePainter; 		// Purple Painter item, meta = damage value
+	  cyanPainter; 		// Cyan Painter item, meta = damage value
+	  lightGreyPainter; 	// Light Grey Painter item, meta = damage value
+	  darkGreyPainter; 	// Dark Grey Painter item, meta = damage value
+	  pinkPainter; 		// Pink Painter item, meta = damage value
+	  limePainter; 		// Lime Painter item, meta = damage value
+	  yellowPainter; 		// Yellow Painter item, meta = damage value
+	  cloudPainter; 		// Cloud Painter item, meta = damage value
+	  magentaPainter; 	// Magenta Painter item, meta = damage value
+	  orangePainter; 		// Orange Painter item, meta = damage value
+	  whitePainter; 		// White Painter item, meta = damage value
+
+	// explosives + related
+	  dynamite; 			// Throwable Dynamite item, currently not meta sensitive
+	  stickyDynamite; 	// Throwable Sticky Dynamite item, currently not meta sensitive
+
+	  remote; 			// Dynamite Remote item, currently not meta sensitive
+
+	// misc intermediate recipe ingredients
+	  electronicCircuit; 	// Electronic Circuit item, currently not meta sensitive
+	  advancedCircuit; 	// Advanced Circuit item, currently not meta sensitive
+
+	  advancedAlloy; 		// Advanced Alloy item, currently not meta sensitive
+
+	  carbonFiber; 		// Raw Carbon Fiber item, currently not meta sensitive
+	  carbonMesh; 		// Raw Carbon Mesh item, currently not meta sensitive
+	  carbonPlate; 		// Carbon Plate item, currently not meta sensitive
+
+	  matter; 			// UUA item, currently not meta sensitive
+	  iridiumOre; 		// Iridium Ore item, currently not meta sensitive
+	  iridiumPlate; 		// Iridium Plate item, currently not meta sensitive
+
+
+	// Metal Plates
+
+	  platecopper;               // Metal plate item, meta sensitive
+	  platetin;                  // Metal plate item, meta sensitive
+	  platebronze;               // Metal plate item, meta sensitive
+	  plategold;                 // Metal plate item, meta sensitive
+	  plateiron;                 // Metal plate item, meta sensitive
+	  platelead;                  // Metal plate item, meta sensitive
+	  platelapi;                  // Metal plate item, meta sensitive
+	  plateobsidian;              // Metal plate item, meta sensitive
+	  plateadviron;              // Metal plate item, meta sensitive
+
+	// Metal Dense Plates
+	  denseplatecopper;               // Metal dense plate item, meta sensitive
+	  denseplatetin;                  // Metal dense plate item, meta sensitive
+	  denseplatebronze;               // Metal dense  plate item, meta sensitive
+	  denseplategold;                 // Metal dense plate item, meta sensitive
+	  denseplateiron;                 // Metal dense plate item, meta sensitive
+	@Deprecated
+	  denseplateadviron;              // Metal dense plate item, meta sensitive
+	  denseplatelead;                  // Metal dense plate item, meta sensitive
+	  denseplatelapi;                  // Metal dense plate item, meta sensitive
+	  denseplateobsidian;              // Metal dense plate item, meta sensitive
+
+
+	// upgrade modules
+	  overclockerUpgrade;		// overclocker upgrade item, meta sensitive
+	  transformerUpgrade;		// transformer upgrade item, meta sensitive
+	  energyStorageUpgrade;	// energy storage upgrade item, meta sensitive
+	  ejectorUpgrade;			// ejector upgrade item, meta sensitive
+
+	// misc
+	  coin; 					// Coin item, currently not meta sensitive
+	  reinforcedDoor; 		// Reinforced Door item, currently not meta sensitive
+	  constructionFoamPowder; // Construction Foam Powder item, currently not meta sensitive
+	  grinPowder;				// Poisonous ingrident, currently not meta sensitive
+	  debug;					// Debug item, currently not meta sensitive
+	  boatCarbon;				// Carbon Fiber Canoe item, meta sensitive
+	  boatRubber;				// Rubber Dinghy item, meta sensitive
+	  boatRubberBroken;		// Damaged Rubber Dinghy item, meta sensitive
+	  boatElectric;			// Electric Boat item, meta sensitive
+
+	//Agriculture
+	  cropSeed; 				// Crop seeds, stuff stored in NBT, don't use for crafting recipes!
+	  cropnalyzer;			// Cropnalyzer handheld device
+	  fertilizer;				// Basic IC2Item, used to provide nutrients toCropBlocks
+	  hydratingCell;			// Cell used to hydrate Crops, meta = Content, 0= Full, 9999 = Near empty
+	  electricHoe;			// Electric Hoe, Metadata indicates charge level
+	  terraWart;				// Mystic opposite of NEtherWart, cures StatusEffects, simply consumeable
+	  weedEx;					// Spraying can of WEED-EX, meta indicates usages left
+
+	//Boozeception
+	  mugEmpty;				// Simple stone mug
+	  coffeeBeans;			// Harvested CoffeeBeans
+	  coffeePowder; 			// Processed Coffee Beans, used to craft drinkable Coffee
+	  mugCoffee;				// Mug of Coffee, Meta indicates status 0 = cold, 1 = Normal, 2 = Sugar'd
+	  hops;					// Hops, harvested freshly from crop
+	  barrel; 				// Carried Barrel, metadata encrypts the information about the liquid inside
+	  blockBarrel;			// Unobtainable "placed barrel", TileEntity controlling the Fermentation process
+	  mugBooze; 				// Mug filled with booze, metadata encrypts the information about the liquid inside
+
+	 */
+
+	/**
+	 * Get the base IC2 package name, used internally.
+	 * 
+	 * @return IC2 package name, if unable to be determined defaults to ic2
+	 */
+	private static String getPackage() {
+		Package pkg = IC2Items.class.getPackage();
+
+		if (pkg != null) {
+			String packageName = pkg.getName();
+
+			return packageName.substring(0, packageName.length() - ".api.item".length());
+		}
+
+		return "ic2";
+	}
+
+	private static Class<?> Ic2Items;
+}
+

src/api/java/ic2/api/item/ICustomDamageItem.java

@@ -0,0 +1,56 @@
+package ic2.api.item;
+
+import net.minecraft.entity.EntityLivingBase;
+import net.minecraft.item.ItemStack;
+
+/**
+ * ICustomDamageItem allows items to have custom damage handling without the massive overhead of
+ * Item.getDamage() / Item.setDamage(), which turn ItemStack.getItemDamage into virtual calls.
+ *
+ * The custom damage value is typically stored in the item stacks nbt data.
+ *
+ * If an Item implements ICusomDamageItem, the normal ItemStack damage won't be changed by IC2.
+ * It's up to the implementer to potentially manipulate it for suitable visual effect on the
+ * rendered damage bar or to provide a suitable item renderer.
+ *
+ * Item.isDamageable() still applies.
+ *
+ * @author Player
+ */
+public interface ICustomDamageItem {
+	/**
+	 * Retrieve the custom damage value for the supplied item stack.
+	 *
+	 * @param stack ItemStack to be queried.
+	 * @return Custom damage value.
+	 */
+	int getCustomDamage(ItemStack stack);
+
+	/**
+	 * Retrieve the maximum custom damage value for the supplied item stack.
+	 * @param stack ItemStack to be queried.
+	 * @return Custom damage value limit.
+	 */
+	int getMaxCustomDamage(ItemStack stack);
+
+	/**
+	 * Set the custom damage value for the supplied item stack.
+	 *
+	 * @param stack ItemStack to be manipulated.
+	 * @param damage New damage value.
+	 */
+	void setCustomDamage(ItemStack stack, int damage);
+
+	/**
+	 * Increase the custom damage value for the supplied item stack.
+	 *
+	 * It's up to the implementation to not apply any damage, e.g. based on some randomness or
+	 * properties of src.
+	 *
+	 * @param stack ItemStack to be manipulated.
+	 * @param damage Extra damage to be applied.
+	 * @param src Entity damaging the item, may be null.
+	 * @return true if damage was applied.
+	 */
+	boolean applyCustomDamage(ItemStack stack, int damage, EntityLivingBase src);
+}

src/api/java/ic2/api/item/IDebuggable.java

@@ -0,0 +1,22 @@
+package ic2.api.item;
+
+
+/**
+ * Allows a tile entity to output a debug message when the debugItem is used on it.
+ * Suggestions by Myrathi
+ */
+public abstract interface IDebuggable {
+    /**
+     * Checks if the tile entity is in a state that can be debugged.
+     *
+     * @return True if the tile entity can be debugged
+     */
+    public abstract boolean isDebuggable();
+
+    /**
+     * Gets the debug text for the tile entity.
+     *
+     * @return The text that the debugItem should show
+     */
+    public abstract String getDebugText();
+}

src/api/java/ic2/api/item/IElectricItem.java

@@ -0,0 +1,55 @@
+package ic2.api.item;
+
+import net.minecraft.item.Item;
+import net.minecraft.item.ItemStack;
+
+/**
+ * Provides the ability to store energy on the implementing item.
+ *
+ * The item should have a maximum damage of 13.
+ */
+public interface IElectricItem {
+	/**
+	 * Determine if the item can be used in a machine or as an armor part to supply energy.
+	 *
+	 * @return Whether the item can supply energy
+	 */
+	boolean canProvideEnergy(ItemStack itemStack);
+
+	/**
+	 * Get the item ID to use for a charge energy greater than 0.
+	 *
+	 * @return Item ID to use
+	 */
+	Item getChargedItem(ItemStack itemStack);
+
+	/**
+	 * Get the item ID to use for a charge energy of 0.
+	 *
+	 * @return Item ID to use
+	 */
+	Item getEmptyItem(ItemStack itemStack);
+
+	/**
+	 * Get the item's maximum charge energy in EU.
+	 *
+	 * @return Maximum charge energy
+	 */
+	double getMaxCharge(ItemStack itemStack);
+
+	/**
+	 * Get the item's tier, lower tiers can't send energy to higher ones.
+	 * Batteries are Tier 1, Energy Crystals are Tier 2, Lapotron Crystals are Tier 3.
+	 *
+	 * @return Item's tier
+	 */
+	int getTier(ItemStack itemStack);
+
+	/**
+	 * Get the item's transfer limit in EU per transfer operation.
+	 *
+	 * @return Transfer limit
+	 */
+	double getTransferLimit(ItemStack itemStack);
+}
+

src/api/java/ic2/api/item/IElectricItemManager.java

@@ -0,0 +1,95 @@
+package ic2.api.item;
+
+import net.minecraft.entity.EntityLivingBase;
+import net.minecraft.item.ItemStack;
+
+/**
+ * This interface specifies a manager to handle the various tasks for electric items.
+ *
+ * The default implementation does the following:
+ * - store and retrieve the charge
+ * - handle charging, taking amount, tier, transfer limit, canProvideEnergy and simulate into account
+ * - replace item IDs if appropriate (getChargedItemId() and getEmptyItemId())
+ * - update and manage the damage value for the visual charge indicator
+ * 
+ * @note If you're implementing your own variant (ISpecialElectricItem), you can delegate to the
+ * default implementations through ElectricItem.rawManager. The default implementation is designed
+ * to minimize its dependency on its own constraints/structure and delegates most work back to the
+ * more atomic features in the gateway manager.
+ */
+public interface IElectricItemManager {
+	/**
+	 * Charge an item with a specified amount of energy.
+	 *
+	 * @param itemStack electric item's stack
+	 * @param amount amount of energy to charge in EU
+	 * @param tier tier of the charging device, has to be at least as high as the item to charge
+	 * @param ignoreTransferLimit ignore the transfer limit specified by getTransferLimit()
+	 * @param simulate don't actually change the item, just determine the return value
+	 * @return Energy transferred into the electric item
+	 */
+	double charge(ItemStack stack, double amount, int tier, boolean ignoreTransferLimit, boolean simulate);
+
+	/**
+	 * Discharge an item by a specified amount of energy
+	 *
+	 * @param itemStack electric item's stack
+	 * @param amount amount of energy to discharge in EU
+	 * @param tier tier of the discharging device, has to be at least as high as the item to discharge
+	 * @param ignoreTransferLimit ignore the transfer limit specified by getTransferLimit()
+	 * @param externally use the supplied item externally, i.e. to power something else as if it was a battery
+	 * @param simulate don't actually discharge the item, just determine the return value
+	 * @return Energy retrieved from the electric item
+	 */
+	double discharge(ItemStack stack, double amount, int tier, boolean ignoreTransferLimit, boolean externally, boolean simulate);
+
+	/**
+	 * Determine the charge level for the specified item.
+	 * 
+	 * @param itemStack ItemStack containing the electric item
+	 * @return charge level in EU
+	 */
+	double getCharge(ItemStack stack);
+
+	/**
+	 * Determine if the specified electric item has at least a specific amount of EU.
+	 * This is supposed to be used in the item code during operation, for example if you want to implement your own electric item.
+	 * BatPacks are not taken into account.
+	 *
+	 * @param itemStack electric item's stack
+	 * @param amount minimum amount of energy required
+	 * @return true if there's enough energy
+	 */
+	boolean canUse(ItemStack stack, double amount);
+
+	/**
+	 * Try to retrieve a specific amount of energy from an Item, and if applicable, a BatPack.
+	 * This is supposed to be used in the item code during operation, for example if you want to implement your own electric item.
+	 *
+	 * @param itemStack electric item's stack
+	 * @param amount amount of energy to discharge in EU
+	 * @param entity entity holding the item
+	 * @return true if the operation succeeded
+	 */
+	boolean use(ItemStack stack, double amount, EntityLivingBase entity);
+
+	/**
+	 * Charge an item from the BatPack a player is wearing.
+	 * This is supposed to be used in the item code during operation, for example if you want to implement your own electric item.
+	 * use() already contains this functionality.
+	 *
+	 * @param itemStack electric item's stack
+	 * @param entity entity holding the item
+	 */
+	void chargeFromArmor(ItemStack stack, EntityLivingBase entity);
+
+	/**
+	 * Get the tool tip to display for electric items.
+	 * 
+	 * @param itemStack ItemStack to determine the tooltip for
+	 * @return tool tip string or null for none
+	 */
+	String getToolTip(ItemStack stack);
+
+	// TODO: add tier getter
+}