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 Wormkid109 Wormkid109 Sep 01, 2014 at 04:58 UTC - 0 likes

    Can't add Enchants to basic recipes

    // test recipe
    craft test
    388 + 388 + 388
    air + stick
    air + stick
    = diamond_pickaxe ; name &aPick ; enchant dig_speed 5

    Outcome has no enchants.

  • Avatar of haveric haveric Aug 31, 2014 at 06:14 UTC - 0 likes

    @Superboop: Go

    It looks like the error you're getting is from the changed getOnlinePlayers method. I can't find the specific build that this was changed in, so for now, I'd suggest using the latest 1.7.10 build. (1.7.9 was the latest I could pick when uploading the file)

    Can you provide some examples of recipes where the flags don't work?

    I'm not sure what's going on with the .yml files claiming to be outdated. I probably changed some logic that I shouldn't have.

    Please note: I am still new to this codebase and I am attempting to refactor code where I can to allow for better maintainability of the project. Things will likely break. I didn't personally use this plugin beforehand, so I am learning everything about it as I go. The more community feedback I get, whether it be bug reports, feature requests, or anything else, the better I can provide back to the community and support this plugin.

    Also note that v2.1 was released within 2-3 days of me taking over the project, sat in the approval queue for a week (while I was working on refactoring code), got denied for not conforming to the new updater api, and then I rebuilt it with all the changes I had done (with less testing than I would have liked) and it sat in the approval queue for another week before finally being released. My goal was simply to get an updated (official) working build out as quick as possible so that more people were up to date. Now that it is released, I can focus on fixing any bugs that pop up or any flags that don't work like they should.

  • Avatar of Superboop Superboop Aug 31, 2014 at 04:19 UTC - 0 likes

    For some reason, the new update (v2.1) broke a lot of things, which forced me to revert back to the old version (v2.0).

    v2.1 did not work at all for CB 1.7.9-02 (Beta build), where it threw this error, and using CB 1.7.10-01 (Dev build) did not throw any immediate errors but did not accept any flags whatsoever in recipes as well.

    It also stated "item aliases.yml" and "enchant aliases.yml" are outdated everytime I load the server, which persists even if I delete those files and let the plugin generate the files again.

    Last edited Aug 31, 2014 by Superboop
  • Avatar of haveric haveric Aug 28, 2014 at 22:57 UTC - 0 likes

    @rediem: Go

    Are you getting any errors in the console or the log?

  • Avatar of rediem rediem Aug 28, 2014 at 19:06 UTC - 0 likes

    not working with 1.7.10 cauldron, just initializes forever and makes no folder.

  • Avatar of Ponygobyebye Ponygobyebye Aug 25, 2014 at 21:16 UTC - 0 likes

    Awesome plugin! Keep up the good work :)

  • Avatar of z65703071 z65703071 Aug 24, 2014 at 10:45 UTC - 0 likes

    I reported a bug for 1.7.2 to a new ticket.

  • Avatar of haveric haveric Aug 19, 2014 at 02:41 UTC - 0 likes

    @Zloi_Kloun: Go

    It is sitting in the approval queue... again. I have no control over how long it takes to be approved, unfortunately. If you'd like to help test it early, please send me a PM.

  • Avatar of Zloi_Kloun Zloi_Kloun Aug 19, 2014 at 00:16 UTC - 0 likes

    @haveric: Go

    but last is 2.0/ where can i get 2.1? thx

  • Avatar of haveric haveric Aug 17, 2014 at 20:50 UTC - 0 likes

    Because of a delay in file approval, I'm looking to get a couple people to help test the new version. If anybody is interested, please PM me for details.

    Some people who might be interested: @CommodoreAlpha @NoxCode

    I'm also looking for any plugins that currently use RecipeManager's API so that I can properly test that everything is still working. If you own a plugin or know of one that uses this API, please PM me.

    Sorry for the delay, I'm hoping it doesn't take another week to get approved, but I am at their mercy.


Date created
Oct 11, 2011
Last update
Aug 17, 2014
Development stage
  • enUS
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
Recent files
  • 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
  • R: v1.26b for 1.3.2 Sep 01, 2012



Optional dependency