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
    • @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)

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 CommodoreAlpha CommodoreAlpha Nov 24, 2015 at 05:38 UTC - 0 likes

    This is probably related to an earlier crash report I sent you, but I got this server crash.

    It appears I'm noticing a general trend of mods fighting with RecipeManager concerning how Furnace recipes are handled. In this case, it was quite unexpected - there is a "gas block" from the Engineer's Toolbox mod which, judging from how it caused a server crash, also messes around with furnace recipes.

    Other causes of crashing which I've found (all related to furnaces) is using the Forge from Metallurgy 4 (runs on lava directly) and smelting different types of ores which are distinguished only by their damage value.

    Server Information: ""

    Antarctic Special Operations, home of the buggiest (modded) server ever! With the most incompetent admin (me) also! Currently unplayable on survival due to construction accidents involving but not limited to a rebar in the face. I'll consider opening for Beta testing as soon as I overcome my incompetence. <3

  • Avatar of haveric haveric Nov 22, 2015 at 06:28 UTC - 0 likes

    @CommodoreAlpha: Go

    I don't know enough about mods to answer this. Perhaps you could ask the mod author?

  • Avatar of CommodoreAlpha CommodoreAlpha Nov 21, 2015 at 20:26 UTC - 0 likes

    Not the most relevant comment to this plugin, but I was wondering what you could make of this.

    As you can see, the mob ID is a negative number, something I didn't know was possible. As such, it doesn't show up in the names index html file.

  • Avatar of YukioJon YukioJon Nov 16, 2015 at 18:25 UTC - 0 likes

    @haveric: Go

    Alright, thank you for the information. I wish you good luck if you ever decide to make the extension and add the food/saturation options! :)

  • Avatar of haveric haveric Nov 16, 2015 at 18:13 UTC - 1 like

    @YukioJon: Go

    While it is possible to do, it requires Listeners on the consume events which makes this not a direct attachment to the item except through an internal plugin storage or a lore attribute. Because of that, it probably won't be included in RecipeManager, but it is a good candidate for an extension of RecipeManager, which I've been considering making for a while.

  • Avatar of YukioJon YukioJon Nov 16, 2015 at 17:52 UTC - 0 likes

    @haveric: Go

    I don't know any possible way to do that in Vanilla Minecraft. However, there is this plugin which seems to be able to do it. I don't have much knowledge on actually making plugins, so this might not be useful at all to you. This is the plugin I'm talking about; Also, I can edit the link away, or delete this whole post if you don't wish for other plugins to be linked here! Just give me the word and I'll do it! :)

    I'd love to see the ability to change food/saturation of food-items because I'd be a great combo together with all the other possibilities of your plugin! :)

  • Avatar of haveric haveric Nov 16, 2015 at 17:43 UTC - 1 like

    @YukioJon: Go

    That is odd, the order shouldn't really matter. I'll have to look into that.

    I don't believe there is a way to configure food/saturation using the Bukkit API. Do you know if this is possible using the /give command with vanilla minecraft?

  • Avatar of YukioJon YukioJon Nov 16, 2015 at 17:27 UTC - 0 likes

    @haveric: Go

    It's already fixed. Apparently moving the @ingredientcondition tag to the bottom of the list fixed the problem.

    Here's what I had first;

    COMBINE enchant iron_sword
    267 + 339
    = 267
    @ingredientcondition PAPER | enchant PROTECTION_FIRE 1
    @cloneingredient allmeta
    @enchantitem PROTECTION_FIRE

    And this is the working one I have right now;

    COMBINE enchant iron_sword
    267 + 339
    = 267
    @cloneingredient allmeta
    @enchantitem PROTECTION_FIRE
    @ingredientcondition PAPER | enchant PROTECTION_FIRE 1

    Thank you anyways! :) Also; Small question: Do you think you'll ever add a way to configure the food-fill and saturation of food-type items?

    Last edited Nov 16, 2015 by YukioJon
  • Avatar of haveric haveric Nov 16, 2015 at 16:51 UTC - 1 like

    @YukioJon: Go

    Can you provide all of your recipes so that I can test against them to see if there is something misconfigured or conflicting? I should have a chance tonight to actually test this to see what might be going wrong.

  • Avatar of Jikoo_K Jikoo_K Nov 13, 2015 at 05:05 UTC - 0 likes

    @haveric: Go

    Ah, thanks very much, I didn't realize you could define different results based on ingredient conditions for the same shape, I thought it was percents only.

    EnchantedFurnace: Because pickaxes can only do so much.


Date created
Oct 11, 2011
Last update
Nov 04, 2015
Development stage
  • enUS
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
Recent files
  • R: v2.6.4 for 1.8.1 Nov 04, 2015
  • R: v2.6.3 for 1.8.1 Nov 03, 2015
  • R: v2.6.2 for 1.8.1 Oct 30, 2015
  • R: v2.6.1 for 1.8.1 Oct 25, 2015
  • R: v2.6 for 1.8.1 Oct 23, 2015



Optional dependency