Custom Recipe API (CRAPI)
Custom Recipe API (CRAPI) is an API that makes creating custom recipes super easy. This API does require some programming knowledge, but you can start creating custom recipes within 5 minutes of downloading if you know what you're doing.

WORKS GREAT WITH: ItemCreatorPlus

How to get started
1. Download CRAPI
2. Add it as a dependency to your plugin. / As a library
3. Start making custom recipes!

NOTE: Custom Recipes can now be made in-game with the command /crapi new, in a super easy-to-use GUI

Permissions:
crapi.command:
description: Allows the use of CRAPI commands
default: op
crapi.book:
description: Allows the use of the CRAPI recipe book
default: op
crapi.giveitem:
description: Allows the use of the CRAPI recipe book to give items
default: op
crapi.new:
description: Lets the user create new recipes in-game
default: op
crapi.setworkbench:
description: Allows the user to update the workbench recipe
default: op
crapi.viewworkbench:
description: Allows the user to view the workbench recipe
default: op
crapi.craft:
description: Allows the user to craft custom recipes
default: true
crapi.craft.item_permission:
description: per-item permission. To view an item's permission name, have the crapi.op permission and view the /crapi book
crapi.craftall:
description: Allows the user to craft every custom recipe
default: op
crapi.give:
description: Allows the user to use the /crapi give and /crapi items commands
default: op
crapi.op:
description: Allows the user to view the permission name of each recipe
default: op

Commands:
/crapi book
opens the recipe book
/crapi new
opens the recipe creator screen
/crapi setworkbench
edit workbench recipe
/crapi workbench
view workbench recipe
/crapi give <player> <item> <amount>
give a player a custom item
/crapi items
view all available items to give

Spoiler: config.yml

Code (Text):

workbenchtitle: "&e&lSpecial Crafting"
recipebook: "&e&lRecipe Book"
nextpage: "&e&lNext Page"
currentpage: "Current page"
previouspage: "&e&lPrevious Page"
customrecipeview: "&e&lCustom Recipe View"
customrecipecreator: "&e&lCustom Recipe Creator"
fullinv: "&cInventory is full. Cannot craft item."
invalidrecipe: "&cInvalid Recipe"
createrecipe: "&aCreate Custom Recipe"
toggleshapeless: "&9Toggle Shapeless Recipe"
shaped: "Shaped"
leftclicktoview: "&7Left click to view recipe."
rightclicktogive: "&7Right click to give yourself this item."
permission: "Permission"
backtomenu: "&cBack to Menu"
deleterecipe: "&cDelete Recipe"
cannotbeundone: "&7cannot be undone"
recipeview: "&7Recipe View"

What you need to know to create recipes in your plugin
First you need to initialize the craft bench. You NEED to choose a Dispenser for the crafting bench, but the recipe is up to you.
Here's an example of what I did for one of my other plugins:

Code (Text):

ItemStack workbenchItem = new ItemStack(Material.DISPENSER);
ItemMeta meta = workbenchItem.getItemMeta();
meta.setDisplayName(ChatColor.YELLOW.toString() + ChatColor.BOLD.toString() + "Special Crafting");
workbenchItem.setItemMeta(meta);
ShapedRecipe workbenchRecipe = new ShapedRecipe(new NamespacedKey(main, "Workbench"), workbenchItem);
workbenchRecipe.shape("IGI", "GDG", "IGI");
workbenchRecipe.setIngredient('I', Material.IRON_BLOCK);
workbenchRecipe.setIngredient('G', Material.GLASS);
workbenchRecipe.setIngredient('D', Material.DIAMOND_BLOCK);
Bukkit.getServer().addRecipe(workbenchRecipe);

main.crapimanager.setWorkBench(workbenchRecipe);

You can make a custom itemstack for the Dispenser and a custom recipe using regular materials (since this has to be crafted in the crafting table).

Next up, you'll want to get started on some recipes. Here's an example of what I did.

Code (Text):

ItemStack redstone = new ItemStack(Material.REDSTONE);
ItemStack quartz = new ItemStack(Material.QUARTZ);
ItemStack gold = new ItemStack(Material.GOLD_INGOT);

ItemStack storageCell = new ItemStack(Material.STONE_AXE);

CustomRecipeAPI.createRecipe(storageCell, redstone, quartz, redstone, quartz, gold, quartz, redstone, quartz, redstone);

The order of the items goes like this:
[1, 2, 3
4, 5, 6 -> 0
7, 8, 9]

You can either put air, or nothing (nothing only works when there are no more items after it) to leave the slots empty.



For the JavaDocs here's a download link: https://tinyurl.com/yeo6wo63

For any help, feel free to contact me on my discord.
https://discord.gg/AET9mWj