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 Redmag3 Redmag3 Oct 17, 2016 at 20:16 UTC - 0 likes

    @haveric: Go

    a server I play on uses and developed this

    it has a module in it that replaces anvil repairs, its open-source so wondering if that helps?

  • Avatar of haveric haveric Oct 14, 2016 at 18:46 UTC - 0 likes

    @Redmag3: Go

    Not at this time. Perhaps in the future if better support is added in the API.

  • Avatar of Redmag3 Redmag3 Oct 13, 2016 at 19:31 UTC - 0 likes

    Is there any way to replace anvil and enchanting table crafting? I'd like to replace their outputs.

  • Avatar of haveric haveric Oct 10, 2016 at 20:53 UTC - 0 likes

    @slimpyman: Go

    Multiple results for smelting doesn't currently work. You can still do some things based on name and lore, but due to restrictions of furnace recipes, it doesn't handle them the best. I have some ideas that I'll probably be testing soon with both furnace recipes and brewing, but I'm going to wait for 2.8 to release (it's in the queue) and make sure it is stable enough before doing any other major changes.

  • Avatar of slimpyman slimpyman Oct 08, 2016 at 02:26 UTC - 0 likes

    @haveric: Go

    haha i asked a bunch of questions... so with response of you saying it isnt supported, are you speaking of having multiple results of smelting the same item, based on what the name or lore of it is?

  • Avatar of iluis iluis Oct 05, 2016 at 16:53 UTC - 0 likes

    @haveric: Go

    Sigh Thanks, kinda sucks how it ain't in the API but it's all good.

  • Avatar of haveric haveric Oct 05, 2016 at 15:17 UTC - 0 likes

    @iluis: Go

    Unfortunately the unbreakable tag has yet to be added to the api as much as I want it to be added. (The hide attribute was though, don't ask me how that makes sense). The best way right now to do this is to use the @command flag in combination with @noresult (Alternatively, you can let the main result be a useless/cheap item and they'd get both). You can then use @displayresult to show whatever you want in the result slot so it makes a little more sense to the crafter.

  • Avatar of iluis iluis Oct 05, 2016 at 15:03 UTC - 0 likes

    @haveric: Go

    I'm trying to make a recipe for Jungle Stick and since I use custom textures on different damage values on a wooden sword the result has to be wood_sword:4 and has to have an unbreakable tag and the hide attributes flag.

  • Avatar of haveric haveric Oct 04, 2016 at 16:44 UTC - 0 likes

    @slimpyman: Go

    This isn't currently supported, but I hope to improve this in the future.

    @iluis: Go

    I can only use what has been added to the API. I'd love for everything to be supported there as well, but that's not the way it works. If you have anything specific you are trying to do, perhaps it can already be done in a different way than you are trying. If you could provide some more specifics to what you are trying to accomplish, I might be able to help out more.

  • Avatar of iluis iluis Oct 04, 2016 at 16:24 UTC - 0 likes

    It'd be nice if NBT tags and flags could be used in the results.


Date created
Oct 11, 2011
Last update
Oct 10, 2016
Development stage
  • enUS
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
Recent files
  • R: v2.8 for 1.10 Oct 10, 2016
  • 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



Optional dependency