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 slimpyman slimpyman Sep 25, 2016 at 01:59 UTC - 0 likes

    im trying to find refernece in the help files, but to no avail.... id like to make a recipe, lets say sword. since i disabled renaming using colors, items with colors can only be crafted or bought.

    So im trying to say, make a sword. im trying to figure out how to use an iron_ingot renamed steel in the recipe. i just cannot find out how to make this plugin differentiate between iron ingot and the "steel" ingot.

  • Avatar of bscal123 bscal123 Aug 06, 2016 at 02:14 UTC - 0 likes

    @haveric: Go


  • Avatar of haveric haveric Aug 06, 2016 at 02:11 UTC - 0 likes

    @bscal123: Go

    Can you zip up your plugins/RecipeManager folder and pm it to me?

  • Avatar of bscal123 bscal123 Aug 06, 2016 at 02:03 UTC - 0 likes

    @haveric: Go

    Yes that is the entire recipe file. Lines 2 - 9 get that error of Warning: Unexpected directive.

    Last edited Aug 06, 2016 by bscal123
  • Avatar of haveric haveric Aug 06, 2016 at 01:47 UTC - 0 likes

    @bscal123: Go

    Is that your entire recipe file? If not, can you pastebin the entire thing or pm it to me?

  • Avatar of bscal123 bscal123 Aug 06, 2016 at 01:20 UTC - 0 likes

    Everytime I make a shaped recipe I receive and error:
     Warning: Unexpected directive

    This would be one of my recipes:
    iron_ingot + stone + iron_ingot
    iron_ingot + stone + iron_ingot
    iron_ingot + stone + iron_ingot
    = iron_ingot
    @name §bSteel
    @lore §7Steel is stronger than iron.
    @lore §7Used to craft medium level guns.

    Shapeless work fine

  • Avatar of haveric haveric Jul 19, 2016 at 16:15 UTC - 0 likes

    @ketchupcoke: Go

    I'm not sure if it can hide lore, but you can try using the @hide flag. Take a look at the generated "recipe flags.html" in your RecipeManager folder for flag options.

  • Avatar of ketchupcoke ketchupcoke Jul 19, 2016 at 15:57 UTC - 0 likes

    Hi, I was just wondering if it would be possible to add an option for crafted items to have the flag which removes the new 1.9 meta added to items. Something like: itemMeta.addItemFlag(ItemFlag.HIDE_ATTRIBUTES); Since some RPG servers like mine use custom lore to modify stats and they aren't really necessary

    Last edited Jul 19, 2016 by ketchupcoke
  • Avatar of TheClubMC TheClubMC Jul 13, 2016 at 17:46 UTC - 0 likes

    @haveric: Go

    Sorry for late reply and thanks for your reply.

    It would be great. Yes, please add ability to hide those message such as custom message for @needlevel, @modlevel and something like these flags.


  • Avatar of tman7206 tman7206 Jul 13, 2016 at 09:27 UTC - 0 likes

    Failmsg was a good option. I couldn't get rid of that fire though; however, I am satisfied with this.

    -------- Is there some reason you are sticking with such an old version of the game?

    This has something to deal with Korean culture ( not a good word choice I say )
    You know " force updated " does not work higher than version 1.5.2 right?
    ==> Those who use crack version of Minecraft no longer were be able to enjoy higher version of Minecraft; therefore entire Minecraft society stopped at 1.5.2 in Korea. Now 1.5.2 servers are the most played in here. Ridiculous, right?

    + Don't worry, I bought the game.


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