Source-checkedAdmin & protection

CustomRecipeAPI [1.13+]

by DarkMonolith · for Minecraft

Create custom recipes easily! - Uses custom crafting table

18KDownloads
5 yr agoLast updated
Spigot · PaperLoaders
1.17Latest game version

About CustomRecipeAPI [1.13+]

From SpigotMC

Create 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

  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

<button type="button" class="button bbCodeSpoilerButton ToggleTrigger Tooltip JsOnly" title="Click to reveal or hide spoiler" data-target="> .SpoilerTarget">Spoiler: config.yml</button>
Code (Text):
workbenchtitle: "&amp;e&amp;lSpecial Crafting"
recipebook: "&amp;e&amp;lRecipe Book"
nextpage: "&amp;e&amp;lNext Page"
currentpage: "Current page"
previouspage: "&amp;e&amp;lPrevious Page"
customrecipeview: "&amp;e&amp;lCustom Recipe View"
customrecipecreator: "&amp;e&amp;lCustom Recipe Creator"
fullinv: "&amp;cInventory is full. Cannot craft item."
invalidrecipe: "&amp;cInvalid Recipe"
createrecipe: "&amp;aCreate Custom Recipe"
toggleshapeless: "&amp;9Toggle Shapeless Recipe"
shaped: "Shaped"
leftclicktoview: "&amp;7Left click to view recipe."
rightclicktogive: "&amp;7Right click to give yourself this item."
permission: "Permission"
backtomenu: "&amp;cBack to Menu"
deleterecipe: "&amp;cDelete Recipe"
cannotbeundone: "&amp;7cannot be undone"
recipeview: "&amp;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);

Read the full description on SpigotMC →

Highlights

From source data

Game 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

LoaderGame versionsNewest
Paper1.13 to 1.17 (5 versions)1.17
Spigot1.13 to 1.17 (5 versions)1.17

From 10 recorded builds of CustomRecipeAPI [1.13+].

Recent builds

BuildReleasedGame versionsLoaders
1.6.02021-11-251.13 to 1.17 (5 versions)Spigot, Paper
1.5.22021-11-04n/aSpigot, Paper
1.5.12020-12-13n/aSpigot, Paper
1.5.02020-10-13n/aSpigot, Paper
1.4.52020-10-08n/aSpigot, Paper
1.4.42020-10-02n/aSpigot, 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 catalog
Listed on SpigotMC as “Admin”

Admin & protection

Permissions, moderation, anti-cheat and land protection for the people running the server.

Runs on your server

From source side support

SpigotMC 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.

NxLabs

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.