GT wrench capabilities for AE2 blocks and others (#2395)

* GT wrench capabilities for ae blocks

* Fix grid array out of bounds

* Fix shift right ae block disappear for an instant

1 files changed, 4 insertions, 3 deletions

diff --git a/src/main/java/gregtech/api/interfaces/IToolStats.java b/src/main/java/gregtech/api/interfaces/IToolStats.java
index c92a0ef05c..9d8da63b6c 100644
--- a/src/main/java/gregtech/api/interfaces/IToolStats.java
+++ b/src/main/java/gregtech/api/interfaces/IToolStats.java
@@ -36,7 +36,8 @@ public interface IToolStats {
     void onStatsAddedToTool(GT_MetaGenerated_Tool aItem, int aID);
 
     /**
-     *
+     * @implNote if you are only modifying drops, override
+     *           {@link #convertBlockDrops(List, ItemStack, EntityPlayer, Block, int, int, int, byte, int, boolean, BlockEvent.HarvestDropsEvent)}
      * @param player   The player
      * @param x        Block pos
      * @param y        Block pos
@@ -156,7 +157,7 @@ public interface IToolStats {
     boolean isMiningTool();
 
     /**
-     * aBlock.getHarvestTool(aMetaData) can return the following Values for example. "axe", "pickaxe", "sword",
+     * {@link Block#getHarvestTool(int)} can return the following Values for example. "axe", "pickaxe", "sword",
      * "shovel", "hoe", "grafter", "saw", "wrench", "crowbar", "file", "hammer", "plow", "plunger", "scoop",
      * "screwdriver", "sense", "scythe", "softhammer", "cutter", "plasmatorch"
      *
@@ -168,7 +169,7 @@ public interface IToolStats {
     /**
      * This lets you modify the Drop List, when this type of Tool has been used.
      *
-     * @return the Amount of modified Items.
+     * @return the Amount of modified Items, used to determine the extra durability cost
      */
     int convertBlockDrops(List<ItemStack> aDrops, ItemStack aStack, EntityPlayer aPlayer, Block aBlock, int aX, int aY,
         int aZ, byte aMetaData, int aFortune, boolean aSilkTouch, BlockEvent.HarvestDropsEvent aEvent);