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 speciifed 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 alot 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 midlander23 midlander23 Sep 22, 2014 at 13:47 UTC - 0 likes

    @haveric: Go

    sure, I want a recipe to craft coloured leather armour. E.g: setting this recipe: wood+stone+wood to make green leather helmet craftable.

    Last edited Sep 23, 2014 by midlander23
  • Avatar of haveric haveric Sep 22, 2014 at 03:51 UTC - 0 likes

    @midlander23: Go

    Can you be more specific as to what you want the recipe to do?

  • Avatar of midlander23 midlander23 Sep 19, 2014 at 18:54 UTC - 0 likes

    Hi, I'm wondering if I could set a recipe for coloured leather armour, hope you can help me and tell me how. PD: great work with this plugin, I really like it :D

  • Avatar of haveric haveric Sep 10, 2014 at 17:32 UTC - 0 likes

    @Superboop: Go

    Some of the issues you had, such as /rmreload not working correctly are fixed in v2.1.1 (which is in the approval queue and on github under downloads).

    I'll have to look into the other two issues, can you create tickets for them?

  • Avatar of Superboop Superboop Sep 10, 2014 at 17:20 UTC - 0 likes

    Hi, many of the issues seem to be resolved for me. Currently there are 3 problems that I am encountering (CB1.7.9-02, RM v2.1):

    - /rmreload causes some recipes to break (e.g. the override recipes). It seems that you are aware of this already.

    - Placing items on the crafting table often creates the "anvil repair" sound (3 metal clinks). The sounds occur when an item is displayed on the crafting output (regardless of if the output is taken out of the output slot or not). So if I place a row of three iron bars on the crafting table, the metal repair sound pops up the moment I place the 3rd iron bar.

    - When you have more than the necessary amount of items on the crafting bench, the output disappears, although you can still click on it and get the output. (i.e. graphical glitch). For example, if I have a recipe where a 2x2 of iron bar creates an output, having 2 slots with 2 iron bars and 2 slots with 1 iron bar will have the output display nothing; when you click on the output slot, however, you get the output.

  • Avatar of LGCMcLovin LGCMcLovin Sep 09, 2014 at 10:32 UTC - 0 likes

    Also, suggestion i saw in another plugin related to this, plugin allowed for recipe creation on command, by placing crafting materials in the 9 slots on left side of main inventory space, and the item to be crafted in the top right corner of the main inventory area. it didnt matter what else you had in your inventory, as long as the materials, and finished product were in the proper place. you would then run a command to add the recipe, for instance /recipe add shaped, would create a shape specific recipe for that item. was very convenient, although the way the plugin was written would cause people to lag out of the server due to a refresh of every single recipe (including the vanilla recipes it had created and overwritten) when you created a new recipe

    it also affected other recipes as well, players couldnt craft any items created by mods, that hadnt been coded into the plugins recipes. just an idea, for a simple ingame way to add recipes, for ease of access of the administrators using this, either way, still an amazing piece of coding!


  • Avatar of LGCMcLovin LGCMcLovin Sep 09, 2014 at 10:26 UTC - 0 likes

    by far the most amazing recipe plugin ever, i am using this plugin on a Pixelmon server running the latest pixelmon build on 1.7.10 minecraft. I ran into an issue with another plugin fastcraft, which automatically detects bukkit recipes and adds them to its database automatically for simple click crafting of items. but this does not detect recipes added by mods. within seconds of installing this plugin (i use plugman to load new plugins while servers still running) i had added permissions, and extracted the recipes from the pixelmon mod into this plugins files with 1 simple command. which automatically added the pixelmon mod items to the fastcraft crafting database. giving my players the ability to craft their pokeballs with just a click of the mouse, no more putting items in a crafting table!!! Amazing work, to say the least. and if youre interested in working with growing server group with some pretty epic plans in the works, would love to have a chat with you. teamspeak IP is just ask for the owner. im on quite often. hope to hear from you, again amazing work, and good day


  • Avatar of h0us3cat h0us3cat Sep 06, 2014 at 15:15 UTC - 0 likes

    @haveric: Go

    Well i dont want to use a uuid build :)


  • Avatar of haveric haveric Sep 06, 2014 at 05:33 UTC - 0 likes

    @h0us3cat: Go

    Just a quick update on your issue:

    • I tested it on a 1.7.2 CB that I still have sitting around and did not get the error you are.
    • 1.7.2 is before the UUID change and will spew errors when used with RecipeManager.
    • I am adding backwards support for the getOnlinePlayers() change which will allow some older builds of CraftBukkit to work (I believe 1.7.5 and up will be supported)

    If you are able to replicate this on a newer CraftBukkit build (assuming you can even get one due to the current DMCA situation), please let me know.

  • Avatar of haveric haveric Sep 05, 2014 at 15:16 UTC - 0 likes

    @h0us3cat: Go


    I'll have a chance to test this tonight. Can you create a ticket so that I can keep you updated without filling up the comments?


Date created
Oct 11, 2011
Last update
Sep 05, 2014
Development stage
  • enUS
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
Recent files
  • R: v2.1.1 for CB 1.7.9-R0.2 Sep 05, 2014
  • R: v2.1 for CB 1.7.9-R0.2 Aug 17, 2014
  • R: v2.0 for 1.5.2 May 30, 2013
  • B: v2.0beta for 1.5.2 May 24, 2013
  • A: v2.0alpha3 for 1.5.2 May 09, 2013



Optional dependency