About CustomRecipeAPI [1.13+]
From SpigotMCCreate custom recipes easily! - Uses custom crafting table
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
- 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
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:
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);
Next up, you'll want to get started on some recipes. Here's an example of what I did.
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);
Highlights
From source dataGame versions
Supports 5 Minecraft versions, the newest being 1.17.
Loaders
Runs on Spigot and Paper.
Footprint
Rated a light load on a server.
CustomRecipeAPI [1.13+] on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers, for Paper servers. We download it from SpigotMC, place it, and restart the server.
- Server side
- Required on the server
- Server type needed
- Spigot, Paper
- Server load
- light
- Smallest plan we suggest
- Minecraft — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 1.6.0, released 2021-11-25
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Paper | 1.13 to 1.17 (5 versions) | 1.17 |
| Spigot | 1.13 to 1.17 (5 versions) | 1.17 |
From 10 recorded builds of CustomRecipeAPI [1.13+].
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 1.6.0 | 2021-11-25 | 1.13 to 1.17 (5 versions) | Spigot, Paper |
| 1.5.2 | 2021-11-04 | n/a | Spigot, Paper |
| 1.5.1 | 2020-12-13 | n/a | Spigot, Paper |
| 1.5.0 | 2020-10-13 | n/a | Spigot, Paper |
| 1.4.5 | 2020-10-08 | n/a | Spigot, Paper |
| 1.4.4 | 2020-10-02 | n/a | Spigot, Paper |
Run CustomRecipeAPI [1.13+] on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogAdmin & protection
Permissions, moderation, anti-cheat and land protection for the people running the server.
Runs on your server
From source side supportSpigotMC lists CustomRecipeAPI [1.13+] as required on the server. Check its SpigotMC page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- SpigotPaper
- Runs on
- Serverrequired on the server
- Game versions
- 1.17 and 4 earlier
- Requires
- One-click install needs a Paper server.
Verified at the source
- ✓SpigotMCOfficial listing, checked 2026-10-02Open ↗
- ✓AuthorDarkMonolith, as published on SpigotMC
- ✓LicenseNot published by the sourceFree
CustomRecipeAPI [1.13+], answered
Generated from the mod’s own source data.
Do my players need to install CustomRecipeAPI [1.13+]?
SpigotMC lists CustomRecipeAPI [1.13+] as required on the server. Check its SpigotMC page to see whether players need it too.
Which loaders does it support?
Spigot and Paper.
Is it free?
Yes. CustomRecipeAPI [1.13+] is free to download from SpigotMC.
How do I add it to my Nxeon server?
Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

Run CustomRecipeAPI [1.13+] on a Minecraft server.
Deploy in about a minute from $4.99 a month, then add CustomRecipeAPI [1.13+] in one click.









