RecipeManager 2

Complex recipes made easy !


NOTE: I will refer to some .html files in here, those files can be found in your /plugins/RecipeManager/ folder after you loaded the plugin the first time. The html files will also be updated automatically on new versions.

  • Add new recipes:
    • Shaped or shapeless recipes with optionally multiple results;
    • Furnace recipes with optional custom cook time and optional special fuel;
    • Fuel recipes with custom burning time or even random time from specified range.
    • See 'basic recipes.html' for more info.
  • Making recipes more special with flags, featured flags:
    • @permission to limit a recipe (or result) to specific permission node(s);
    • @remove, @restrict and @overwrite to remove/restrict/overwrite existing recipes, including Minecraft recipes.
    • @ingredientcondition to make extra requirements from ingredients like enchantments, ranged data values, stack amounts, etc;
    • @keepitem to keep an ingredient from using up and optionally damaging it in the process;
    • @modmoney/@reqmoney and their experience and level counterparts to require/give/take money/exp/level from crafter;
    • @cooldown to limit the usage of the recipe;
    • And a lot more, see 'recipe flags.html' for all of them including documentation.
  • Flags can also be added to results to make them more special, some featured result flags:
    • @cloneingredient to clone an ingredient's features over to the result, like data value, amount, enchantments, etc;
    • @itemname and @itemlore to edit a result's display name and description with colors;
    • @potionitem and @fireworkitem to design your custom potions and fireworks;
    • @getrecipebook to get a RecipeBook as result, ones generated by this plugin with recipes in them;
    • And a lot more, see 'recipe flags.html' for all of them including documentation.
  • Flexible recipe files to add your recipes in:
    • You can use any kind of spacing and letter casing you want in recipe files, also supports comments;
    • Design your file names and folder structure as you want in the 'recipes' folder;
  • Auto-generated recipe books with high customization:
    • Pick which recipes to be added and to what volume;
    • Re-arrange them as you like;
    • Books that players have are automatically updated when edited by admin and reloaded;
    • For more information see 'recipe books.yml' file.
  • Other features:
    • Local documentation files for ease, the .html files that will be generated the first time you run the plugin;
    • Customizable settings, messages and item/data/enchant aliases in their respective YML files;
    • Supports Vault for economy and permission groups;
    • API for plugin developers, custom events and utility methods for most features;
    • MCStats / Metrics:

Installing or updating

  1. Download the latest version of the plugin
  2. Place the RecipeManager.jar file in the plugins folder and start/restart the server
  3. Now the plugins/RecipeManager/ folder is created which contains configuration files (.yml) and documentation files (.html)

NOTE If you're upgrading from 1.x versions of RecipeManager, please first delete all files and folders except recipes folder from your RecipeManager folder before installing version 2, this will keep your folder clean because a lot of files have been renamed and this way will be less confusing.

Also some recipes or flags might not work like in 1.x versions, please re-test your recipes.

Using the plugin

  • Run the plugin at least once to allow the .html files to be generated then start with 'basic recipes.html'.
  • Plugin settings can be configured in "plugins/RecipeManager/config.yml"
  • When you're done editing, type rmreload in server console to reload everything without a server restart.
  • Commands and permissions can be found in 'commands & permissions.html' file.

Tutorials, example recipes, tips and tricks

User-contributed resources in the Resources forum section.


In the jar file, auto-extracted when first ran to plugins/RecipeManager/changelog.txt and on GitHub:

Having problems, found bugs ?

If you have any issues or found some bugs, please create a ticket. But first you should check other tickets if the issue has been already reported. Also check the latest file's known caveats (under changelog) before posting a ticket.

Note: I don't support any previous versions other than the absolute latest, so if you used a older version, update and test again :P

Source code

Source code is on github, feel free to look at it, improve on it and provide feedback: If you need, you can use code from my project but please give credits.

Support project

If you feel I deserve:

Thanks for your support !

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of xH3LLRAIZ3Rx xH3LLRAIZ3Rx May 23, 2015 at 05:27 UTC - 0 likes

    why when making this item does it show a chest with a 0?

    heres my item

    CRAFT Hardened Metal Blocks
    iron_ingot:0 + iron_ingot:0 + iron_ingot:0
    iron_ingot:0 + iron_ingot:0 + iron_ingot:0
    iron_ingot:0 + iron_ingot:0 + iron_ingot:0
    = iron_block
    @ingredientcondition iron_ingot | nometa | failmsg false
    = iron_block
    @name &b&lHardened Block
    @ingredientcondition iron_ingot | name &b&lHardened Metal | failmsg false
  • Avatar of KrohitsuBitte KrohitsuBitte May 22, 2015 at 08:10 UTC - 0 likes

    Hello! I don't know if this is a bug or not, but it seems worth reporting.

    Whenever I smelt an item and try to give it a custom name and lore, they do not appear, It works just fine on crafted items as well. Any help?


    Update: It worked for a few minutes, then suddenly stopped again. What's going on?!

    Last edited May 22, 2015 by KrohitsuBitte: Strange happening
  • Avatar of haveric haveric May 21, 2015 at 19:12 UTC - 0 likes

    @Sean_Amor: Go

    What items are you using for the scripts and how are they being created?

  • Avatar of Sean_Amor Sean_Amor May 21, 2015 at 18:48 UTC - 0 likes

    I have a plan for a quest script like the following: An npc requests a set number of one item, for a prize.

    Will this plugin help me prevent players from cheating by crafting the item. I want to be able to hide the requested items through out the game so they will have to find them vs. crafting them.

  • Avatar of haveric haveric May 21, 2015 at 17:58 UTC - 0 likes

    @Paul3820999: Go

    I'm not sure that I can, but I will look into this some more and let you know if there's anything I find. If you know of any other plugins that do this, that would probably help speed up the process.

  • Avatar of Paul3820999 Paul3820999 May 21, 2015 at 12:51 UTC - 0 likes

    Hi Author, can you add item hide ench? (NBT)

    Last edited May 21, 2015 by Paul3820999

    I am Hong Kong people! 我是香港人!

  • Avatar of haveric haveric May 19, 2015 at 14:47 UTC - 0 likes

    @icewing2012: Go

    Take a look at the rmextractrecipe command. It exports the item in hand in a format that shows how it would be used as an ingredient and as a result. Being able to create a full recipe though would be interesting. I might play around with that to see how well it works.

  • Avatar of icewing2012 icewing2012 May 19, 2015 at 14:38 UTC - 0 likes

    would it be possible to add a command that would look at your hand and generate a recipe file, then you could add the ingrediants by placing them in a certain part of your inventory. just an idea which would help people like me who use other plugins to make custom items and have items made already.

  • Avatar of haveric haveric May 19, 2015 at 06:49 UTC - 0 likes

    @jalu14: Go

    Just tested it in the latest spigot and it still works. What's probably happening is that you are using a furnace that already has fuel in it. Try placing a new furnace or replacing the fuel to fix the permissions.

    Furnace recipes are hard to deal with as they are shared crafting and the api support is limited. They will probably have quirks like this for quite a while, but I am always trying to improve them were I can.

  • Avatar of haveric haveric May 18, 2015 at 22:54 UTC - 0 likes

    @jalu14: Go

    I'll have to re-test it for the latest spigot. What kind of data do you want to add to items? You can already do quite a lot with the current flags.


Date created
Oct 11, 2011
Last update
May 18, 2015
Development stage
  • enUS
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
Recent files
  • R: v2.4 for 1.8.1 May 18, 2015
  • R: v2.3.4 for 1.8.1 Feb 18, 2015
  • R: v2.3.3 for 1.8.1 Feb 08, 2015
  • R: v2.3.2 for 1.8.1 Jan 26, 2015
  • R: v2.3.1 for 1.8.1 Jan 11, 2015



Optional dependency