CustomRecipes
by mehboss
CustomRecipes is a Java Agent plugin for Paper, Spigot, Bukkit, Purpur and BungeeCord servers that lets server owners define custom crafting, smelting and stonecutting recipes.
What it does
Server owners write their own recipes in the plugin configuration, covering crafting grids, furnaces and stonecutters. Recipe results can carry custom names, lore and item attributes, and a recipe can be blacklisted or fully overridden so that a vanilla recipe no longer works as before. Recipes can also be removed by key when a server wants to change how a vanilla item is crafted.
The plugin supports a set of data options that go beyond plain items: spawners, colored leather armor, potions, stored enchantments and NBT data can all be used as recipe results. Placeholders from PlaceholderAPI are available in messages, and the plugin's own placeholders can be used in response messages shown to players who craft an item. PlaceholderAPI must be installed on the server for these to work.
The plugin is for server owners on the listed server platforms, and players join without installing anything. Files cover game versions 1.8.8 – 1.21.11 with 62 release versions, and the latest Java Agent file is 2.0.6.0 for 1.21.11. The plugin is open source under the Mozilla Public License 2.0, and public links to its source code, issue tracker and wiki are available.
Key features
Custom crafting recipes
Players can craft items from recipes the server owner defines, including recipes for furnaces and stonecutters.
Recipe overrides and blacklists
A recipe can be blacklisted, or a vanilla recipe can be removed by its key so the server can change how it is crafted.
Custom model data
Items can be given a specific custom model data value, which lets them use texture pack models for vanilla items on versions 1.14 and later.
Item attributes
Attributes such as attack damage and knockback can be changed on specific items, and effects such as poison can be applied to weapons.
Gallery
Compatibility
Latest build for each game version and loader.
1.21.x12 of 12 versions with builds
1.20.x7 of 7 versions with builds
1.19.x5 of 5 versions with builds
1.18.x3 of 3 versions with builds
1.17.x2 of 2 versions with builds
1.16.x6 of 6 versions with builds
1.15.x3 of 3 versions with builds
1.14.x5 of 5 versions with builds
1.13.x3 of 3 versions with builds
1.12.x2 of 2 versions with builds
Only full game releases are shown. This mod publishes no snapshot builds.
14 older game versions (1.8.8 – 1.12) not shown. All files on Modrinth
Use cases
Who it’s for: Server owners on Paper, Spigot, Bukkit, Purpur or BungeeCord who want to define their own recipes, item attributes or custom model data. The plugin is not a client mod, so players join without installing anything.
Questions
Does CustomRecipes require PlaceholderAPI?
Which server platforms does CustomRecipes run on?
Can CustomRecipes change vanilla recipes?
What the author says
Create any recipe to make any item you desire. Anything found in-game can be done using CR! Use your imagination to make hundreds of custom items and recipes! Blacklisting a recipe listens for the result while crafting, triggering any response or messages to the player, while overriding a recipe completely removes…
Official listing
- Modrinth page
- modrinth.com/mod/customrecipes
- Owner
- mehboss
- Published
- 2025-05-04
- Updated on Modrinth
- 2026-01-29
- Facts verified
- 2026-10-15