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 jeffro1001 jeffro1001 Apr 15, 2015 at 14:34 UTC - 0 likes

    you are so awesome

    Thank you so much for this. I have been looking for something like this forever!!!

    edit just wanted to add that I really appreciate you including the html pages too. saved me a bunch of time.

    Stop by in play anytime.

    Last edited Apr 16, 2015 by jeffro1001
  • Avatar of jeffro1001 jeffro1001 Apr 15, 2015 at 14:23 UTC - 0 likes

    Ill give it a shot and let you know


  • Avatar of haveric haveric Apr 15, 2015 at 12:29 UTC - 0 likes

    @jeffro1001: Go

    Something like this should work:

    glowstone_dust + glowstone_dust
    glowstone_dust + air
    stick + air
    = wood_hoe
    @name §aStaff of healing
    @ingredientcondition glowstone_dust | name §aHealing Dust

    Let me know if that doesn't work or you have any other issues/questions.

  • Avatar of jeffro1001 jeffro1001 Apr 15, 2015 at 12:15 UTC - 0 likes

    This looks like a great plugin.

    I've been playing around with it today, but I cannot figure out how to accomplish what I need to do with it.

    I'll explain my situation so you can better understand what I'm trying to do.

    I use the EpicBoss plugin to create custom boss mobs.

    This addon has the ability to configure custom drops that you can name whatever you want, with the display name being whatever color you want.

    One of my bosses drops glowstone dust with the custom name §aHealing Dust. Giving the display name of the drop a green color.

    I know that players have the ability to rename items, but they dont have the ability to give the renamed items a color ( which is why I color the boss drops )

    I want to be able to use this custom drop in a recipe, but I want to make sure that the player has to use the custom named dust and not just pain glowstone dust.

    It looks like this addon has the ability to configure the output of the recipe with different color names and lores, but I cannot figure out how to set up the recipe where the ingredients require special colored display names.

    Is this even possible?

    If so could you give me an example of a recipe that would use 3 §aHealing Dust and 1 stick to have an output of a wood hoe with a custom name §aStaff of healing ?

  • Avatar of SirSchinken SirSchinken Apr 02, 2015 at 14:34 UTC - 0 likes

    Im using this Recipe:

    = sugar:0:1 ; name <aqua>Test ; lore <aqua>Test
      @ingredientcondition stick | name Crafted Stick | nolore | noenchant

    but i can still smelt every stick, without an custom name, how can i fix that?

    Last edited Apr 02, 2015 by SirSchinken
  • Avatar of XInstinctX XInstinctX Apr 01, 2015 at 20:25 UTC - 0 likes

    @haveric: Go

    I believe you can, although i am no java programmer myself, i've seen it though.

  • Avatar of haveric haveric Apr 01, 2015 at 14:46 UTC - 0 likes

    @SirSchinken: Go

    Add multiple lines of lore flags such as:

    @lore This sword is very powerful
    @lore But can only be wielded by a dwarf

    @XInstinctX: Go

    Not that I can think of. Let me do some research and see if this is even possible and I'll get back to you when I know more.

  • Avatar of XInstinctX XInstinctX Apr 01, 2015 at 14:38 UTC - 0 likes

    @haveric: Go

    Alright last thing, any flags to change the damage?

    Like i want to make a Stone Hoe that does +3 Damage and then I want to also make a Hardy Stone Hoe that does +4 Damage.

    Is there anyway other than whacking a set enchantment on it?

  • Avatar of SirSchinken SirSchinken Apr 01, 2015 at 07:40 UTC - 0 likes

    is there a way to add multiple lore lines to an result/crafting item?

    Edit: Does furnance support @ingredientcondition & custom result items? cause i cant get it to work

    Last edited Apr 01, 2015 by SirSchinken
  • Avatar of haveric haveric Apr 01, 2015 at 03:25 UTC - 0 likes

    @XInstinctX: Go

    I just did some testing and when I try to smelt one of these recipes in an already placed furnace, it smelts normally. If I place a new furnace and add fuel to it (as a user without the permission), it correctly blocks the recipe. This is due to how furnaces currently handle custom recipes by checking the last person who fueled a furnace. There seems to be a bug related to not remembering the fueler between server restarts which I will be looking into.

    There will still be ways to get around the permission though for furnaces with the current implementation as someone else who has the permission can just add all of the fuel. There is certainly room for improvement here, but it is more difficult due to furnaces being shared inventories.


Date created
Oct 11, 2011
Last update
Feb 18, 2015
Development stage
  • enUS
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
Recent files
  • 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
  • R: v2.3 for 1.8.1 Dec 23, 2014



Optional dependency