document IDebuggable API, make chutes cheaper to make them comparable to hoppers more

api/buildcraft/api/tiles/IDebuggable.java

@@ -5,6 +5,21 @@ import net.minecraft.entity.player.EntityPlayer;
 import net.minecraft.item.ItemStack;
 import net.minecraftforge.common.util.ForgeDirection;
 
+/**
+ * I would like to ask that this interface is not called by any
+ * non-Creative Mode-only item, and especially not computer mods.
+ * This is because often, the debug information can and will let you
+ * "cheat", similar to how F3 gives you debug information about
+ * Minecraft's inner engine workings.
+ */
 public interface IDebuggable {
+	/**
+	 * Get the debug information from a tile entity as a list of strings,
+	 * usable with the BuildCraft Debugger.
+	 * @param info The List debug strings should be output to.
+	 * @param side The side of the tile.
+	 * @param debugger The debugger ItemStack used.
+	 * @param player The player querying the debug information.
+	 */
 	void getDebugInfo(List<String> info, ForgeDirection side, ItemStack debugger, EntityPlayer player);
 }

api/buildcraft/api/tiles/package-info.java

@@ -6,7 +6,7 @@
  * Please check the contents of the license, which should be located
  * as "LICENSE.API" in the BuildCraft source code distribution.
  */
-@API(apiVersion = "1.1", owner = "BuildCraftAPI|core", provides = "BuildCraftAPI|tiles")
+@API(apiVersion = "1.2", owner = "BuildCraftAPI|core", provides = "BuildCraftAPI|tiles")
 package buildcraft.api.tiles;
 import cpw.mods.fml.common.API;
 

common/buildcraft/BuildCraftFactory.java

@@ -323,8 +323,7 @@ public class BuildCraftFactory extends BuildCraftMod {
 		if (hopperBlock != null) {
 			CoreProxy.proxy.addCraftingRecipe(new ItemStack(hopperBlock),
 					"ICI",
-					"IGI",
-					" I ",
+					" G ",
 					'I', "ingotIron",
 					'C', Blocks.chest,
 					'G', "gearStone");