RyanDo at 09:43, 12 October 2025

2025-10-12T09:43:13Z

← Older revision		Revision as of 09:43, 12 October 2025
Line 1:		Line 1:
	~~[[BKCommonLib\|« Go back]]~~

	==Introduction==		==Introduction==
	[https://github.com/bergerkiller/BKCommonLib/blob/master/src/main/java/com/bergerkiller/bukkit/common/utils/RecipeUtil.java RecipeUtil] provides various utility methods to work with item crafting and furnace recipes. It allows you to obtain the information required to do various recipe-related operations.		[https://github.com/bergerkiller/BKCommonLib/blob/master/src/main/java/com/bergerkiller/bukkit/common/utils/RecipeUtil.java RecipeUtil] provides various utility methods to work with item crafting and furnace recipes. It allows you to obtain the information required to do various recipe-related operations.

RyanDo: Created page with "« Go back ==Introduction== [https://github.com/bergerkiller/BKCommonLib/blob/master/src/main/java/com/bergerkiller/bukkit/common/utils/RecipeUtil.java Recipe..."

2021-06-09T19:14:20Z

Created page with "« Go back ==Introduction== [https://github.com/bergerkiller/BKCommonLib/blob/master/src/main/java/com/bergerkiller/bukkit/common/utils/RecipeUtil.java Recipe..."

New page

[[BKCommonLib|« Go back]]

==Introduction==
[https://github.com/bergerkiller/BKCommonLib/blob/master/src/main/java/com/bergerkiller/bukkit/common/utils/RecipeUtil.java RecipeUtil] provides various utility methods to work with item crafting and furnace recipes. It allows you to obtain the information required to do various recipe-related operations.

==Craft Recipes==
To perform crafting operations, BKCommonLib has it's own implementation, or wrapper class, to store and use a crafting (table) recipe: [https://github.com/bergerkiller/BKCommonLib/blob/master/src/main/java/com/bergerkiller/bukkit/common/inventory/CraftRecipe.java CraftRecipe]. In this class, all required input items and resulting output item(s) are stored. You can then, by calling just one method, perform the crafting in an inventory, with an optional maximum amount of times.

==Obtaining a Craft Recipe==
There are methods in [https://github.com/bergerkiller/BKCommonLib/blob/master/src/main/java/com/bergerkiller/bukkit/common/utils/RecipeUtil.java RecipeUtil] to obtain the Craft Recipes that are able to produce a given item, this method is called '''getCraftingRequirements'''. As a plugin, you can then go through all recipes and try to craft something, or design your own filter to get the desired results.

==Example of Craft Recipes being used==
The following example will try to craft 64 wood 'pieces' (one item with amount 64) using the items from a player inventory. Note that '''craft''' does not take in account how many items you get per crafting operation, therefore '''craftItems''' was added that takes care of that. It only uses the first recipe that can be found in this example, so other ways to craft wood are ignored.

<pre>Inventory inventory = player.getInventory();
CraftRecipe[] recipes = RecipeUtil.getCraftingRequirements(Material.WOOD, null);
if (recipes.length > 0) {
recipes[0].craftItems(inventory, 64);
}</pre>
If you want to be certain that crafting is possible, make a copy of the inventory (e.g. InventoryBaseImpl) and pass that into the crafting method first.

==Furnace 'recipes'==
The furnace does not really maintain a list of recipes, instead it more or less assigns a property to certain items that make them 'furnace craftable'. For that reason, and because the output amount is always 1, no special FurnaceCraftRecipe is added. Instead, you can obtain the furnace results, check the fuel time of items, check whether an item is fuel and whether an item can be heated, and so on. All of these methods can be found in [https://github.com/bergerkiller/BKCommonLib/blob/master/src/main/java/com/bergerkiller/bukkit/common/utils/RecipeUtil.java RecipeUtil].

BKCommonLib/Recipes - Revision history

RyanDo at 09:43, 12 October 2025

RyanDo: Created page with "« Go back ==Introduction== [https://github.com/bergerkiller/BKCommonLib/blob/master/src/main/java/com/bergerkiller/bukkit/common/utils/RecipeUtil.java Recipe..."