package codechicken.nei.recipe; import java.util.List; import net.minecraft.client.gui.inventory.GuiContainer; import net.minecraft.inventory.Container; import net.minecraft.item.ItemStack; import org.lwjgl.input.Keyboard; import codechicken.nei.PositionedStack; import codechicken.nei.api.IOverlayHandler; import codechicken.nei.api.IRecipeOverlayRenderer; /** * Do not implement this. Implement one of it's subinterfaces, either {@link ICraftingHandler} or {@link IUsageHandler} */ public interface IRecipeHandler { /** * For legacy compatibility reasons, this method's default implementation returns the class name. * * @return A unique identifier for this handler, used for finding duplicate handlers as well as GUI tab * {@link HandlerInfo}. */ default String getHandlerId() { return getClass().getName(); } /** * * @return The name of this inventory. To be displayed at the top of the viewing container. */ String getRecipeName(); /** * For legacy compatibility reasons, this method's default implementation returns the recipe name. This is also the * expected behavior * * @return The name of this inventory. To be displayed in the tooltip in the tab at the top of the viewing * container. */ default String getRecipeTabName() { return getRecipeName(); } /** * * @return The number of recipes that this handler contains. */ int numRecipes(); /** * Draw the background of this recipe handler (basically the slot layout image). * * @param recipe The recipe index to draw at this position. */ void drawBackground(int recipe); /** * Draw the foreground of this recipe handler (for things like progress bars). * * @param recipe The recipe index to draw at this position. */ void drawForeground(int recipe); /** * * @param recipe The recipe index to get items for. * @return A list of the ingredient {@link PositionedStack}s in this recipe relative to the top left corner of your * recipe drawing space. */ List getIngredientStacks(int recipe); /** * * @param recipe The recipe index to get items for. * @return A list of the other {@link PositionedStack}s in this recipe relative to the top left corner of your * recipe drawing space. For example fuel in furnaces. */ List getOtherStacks(int recipe); /** * * @param recipe The recipe index to get the result for. * @return The recipe result {@link PositionedStack} relative to the top left corner of your recipe drawing space. */ PositionedStack getResultStack(int recipe); /** * A tick function called for updating progress bars and cycling damage items. */ void onUpdate(); /** * * @param recipe The recipe index to check for. * @param gui The GUI to overlay. * @param container The container of the GUI. * @return true if this recipe can render an overlay for the specified type of inventory GUI. */ boolean hasOverlay(GuiContainer gui, Container container, int recipe); /** * * @param recipe The recipe index to get the overlay renderer for. * @return An instance of {@link IRecipeOverlayRenderer} to be used for rendering the overlay of this specific * recipe. */ IRecipeOverlayRenderer getOverlayRenderer(GuiContainer gui, int recipe); /** * * @param recipe The recipe index to get the overlay renderer for. * @return An instance of {@link IOverlayHandler} to be used for rendering the overlay of this specific recipe. */ IOverlayHandler getOverlayHandler(GuiContainer gui, int recipe); /** * Simply works with the {@link codechicken.nei.api.DefaultOverlayRenderer} If the current container has been * registered with this identifier, the question mark appears and an overlay guide can be drawn. * * @return The overlay identifier of this recipe type. */ default String getOverlayIdentifier() { return null; } /** * * @return The number of recipes that can fit on a page in the viewer (1 or 2) */ int recipiesPerPage(); /** * * @param gui An instance of the currentscreen * @param currenttip The current tooltip, will contain item name and info * @param recipe The recipe index being handled * @return The modified tooltip. DO NOT return null */ List handleTooltip(GuiRecipe gui, List currenttip, int recipe); /** * * @param gui An instance of the currentscreen * @param stack The itemstack currently under the mouse * @param currenttip The current tooltip, will contain item name and info * @param recipe The recipe index being handled * @return The modified tooltip. DO NOT return null */ List handleItemTooltip(GuiRecipe gui, ItemStack stack, List currenttip, int recipe); /** * * @param gui An instance of the currentscreen * @param keyChar The character representing the keyPress * @param keyCode The KeyCode as defined in {@link Keyboard} * @return true to terminate further processing of this event. */ boolean keyTyped(GuiRecipe gui, char keyChar, int keyCode, int recipe); /** * * @param gui An instance of the currentscreen * @param button The button index being pressed, {0 = Left Click, 1 = Right Click, 2 = Middle Click} * @return true to terminate further processing of this event. */ boolean mouseClicked(GuiRecipe gui, int button, int recipe); /** * For legacy compatibility reasons, this method has a do-nothing default implementation. * * @param gui An instance of the currentscreen * @param scroll The scroll direction, {> 0 = Up, < 0 = Down} * @return true to terminate further processing of this event. */ default boolean mouseScrolled(GuiRecipe gui, int scroll, int recipe) { return false; } }