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 load 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 @override to remove/restrict/override 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
    • @[email protected] 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)

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 already been 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 an older version, update and test again.

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 provide credits to haveric and THDigi.

Support project

If you find RecipeManager useful and want to help support future development and faster updates, please donate:

Thanks for your support!

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

  • Avatar of EvHub EvHub Mar 28, 2012 at 17:43 UTC - 0 likes

    @THDigi: Go

    Any chance for making recipes that leave a certain item behind in the crafting grid? For example, crafting a lava bucket with something else and the empty bucket stays behind? I would really appreciate this feature, thanks!

  • Avatar of lizardbones lizardbones Mar 28, 2012 at 03:10 UTC - 0 likes

    Running CB 1.2.3 R0.2 b2122 with RecipeManager loaded doesn't seem to cause this glitch. I've also got Nethrar setup though so we're not using the vanilla portals.

    In any event, excellent plugin, does what I want it to. :-)

  • Avatar of THDigi THDigi Mar 27, 2012 at 16:38 UTC - 0 likes

    @LordKainzo: Go

    Well, the issue is not with my plugin alone... look here, what simple plugin you can make to replicate the glitch: (the #6 post)

    It only occurs when you teleport to nether, if you reconnect in nether it won't glitch anymore, but if you exit nether and teleport again it will glitch again... so I dunno, you decide what you restrict... either you restrict block placing in nether, restrict nether all together or just kick player to reconnect when he enters nether... I will try to find a fix for this meanwhile.

    EDIT: I've submitted a bug report for bukkit, maybe they can figure it out: (yeah I know wrong category, I dunno how that happened)

    Last edited Mar 27, 2012 by THDigi
  • Avatar of LordKainzo LordKainzo Mar 26, 2012 at 16:25 UTC - 0 likes

    @THDigi: Go

    Ouch, do you suggest we keep this disabled until that infinite block glitch is fixed?

  • Avatar of boblefisk boblefisk Mar 25, 2012 at 13:01 UTC - 0 likes

    hehe. im sorry i cant help you, im terrible at programming java, had a course at my school, got a D!

    System.out.println("Hello, world!\n");


  • Avatar of THDigi THDigi Mar 23, 2012 at 01:11 UTC - 0 likes

    @boblefisk: Go

    Pffffffffffffffffffffffffffffffffffffffffffffffffff X( I just tested this out, it's true... but the worst part is that it's the fault of the same code that gives out random errors in some tickets that I can't figure out. I really have to find a alternative to that code because it's EVIL !

    And it also seems if I replace it with somethimg similar it still does that dupe glitch, If I comment that code out, it doesn't... WTF ? :| There's seriously something wrong with chunks in bukkit...

    Last edited Mar 23, 2012 by THDigi
  • Avatar of boblefisk boblefisk Mar 22, 2012 at 22:16 UTC - 0 likes

    when you enter the nether, you dont lose blocks when you place them. infinite blocks in nether.

    just try to enter nether and place a block.

    im sure its this addon, because i tried it with this addon only.

  • Avatar of THDigi THDigi Mar 22, 2012 at 21:44 UTC - 0 likes

    @lizardbones: Go

    I already made enchanted results in the next version, I need to finish working on the rest of it to release it. Still, I can only make enchanted recipe results, I can't use enchanted items as materials for recipes.

    @boblefisk: Go

    What ?

  • Avatar of boblefisk boblefisk Mar 22, 2012 at 18:27 UTC - 0 likes

    your latest build R: v1.1g for CB 1.1-R7 Mar 03, 2012

    is having a infinite block bug in nether. you dont lose blocks once entering nether, if you restart server while down there, its temp. fixed, but as soon as you reenter nether, the same problem occur.

  • Avatar of lizardbones lizardbones Mar 21, 2012 at 19:26 UTC - 0 likes

    For having enchanted items as a result, couldn't you do something like this? -> Make an item stack of something (boots); Enchant the item stack of something; Create a new recipe with that enchanted item as the result; Add the recipe to the server;

    Here's some copied code with one added line: ItemStack resultmoss = new ItemStack(Material.MOSSY_COBBLESTONE,1); resultmoss.addEnchantment(ENCH, ?); << this line is suspect, but something like this ShapedRecipe mossrecipe = new ShapedRecipe(resultmoss);

    There's more there, like actual code, but is there something in the getServer.addRecipe() or the new ShapedRecipe()/new unshapedRecipe() routines or the addEnchantment routine that prevents enchanted items from being the result of a recipe?

    This is an "I'm curious" post, not a "Do this" post.


Date created
Oct 11, 2011
Last update
Mar 16, 2016
Development stage
  • enUS
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
Recent files
  • R: v2.7.3 for 1.9 Mar 16, 2016
  • R: v2.7.2 for 1.8.1 Mar 01, 2016
  • R: v2.7.1 for 1.8.1 Mar 01, 2016
  • R: v2.7 for 1.8.1 Feb 27, 2016
  • R: v2.6.4 for 1.8.1 Nov 04, 2015



Optional dependency