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 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 xH3LLRAIZ3Rx xH3LLRAIZ3Rx Oct 05, 2015 at 03:31 UTC - 0 likes

    can you make it where if you do @command *command it would run as OP? because that seems to be a problem for me, where I need people to run the command but they dont have perms, so for example:

    @command *createdisc 10 1000

  • Avatar of haveric haveric Oct 02, 2015 at 20:01 UTC - 0 likes

    @DoloStar: Go

    Copied from the documentation: "Commands are executed server-side, if you add / prefix it will execute the command on the crafter."

    My guess is that you are using the / prefix and the user doesn't have the permission you want. Try changing the command to a server variant if possible.

    If that doesn't work, pastebin your recipes and I can try to help more.

    @TheMercury199: Go

    Sorry for the late reply, if you're still having issues here, can you provide a pastebin of your recipes and I'll take another look at this.

    @Tai1er: Go

    The current code wasn't built to handle this case apparently. I'm going to have to look into how feasible it would be to make this work or provide an alternative way to achieve what you're doing here.

  • Avatar of DoloStar DoloStar Sep 28, 2015 at 14:56 UTC - 0 likes

    Hi,anyone know how to ignore permissions when use @command?

  • Avatar of Tai1er Tai1er Sep 13, 2015 at 12:51 UTC - 0 likes


    I want to create a purse system but I don't know how to add a minimal amount of ingredient

    The problem is when there is 3 emeralds the condtion with 2 emeralds is still possible.

    Someone has a solution? :C

    Last edited Sep 13, 2015 by Tai1er
  • Avatar of TheMercury199 TheMercury199 Sep 10, 2015 at 16:26 UTC - 0 likes

    So it seems that while I was able to get my ore smelting to stack in the groups of two. The time it takes to smelt is the same as default iron, and several other recipes I have disabled with the @restrict flag, in the extracted recipes file no longer are restricted. Specifically these are all hoes, and axes, and carrot on a stick. The message that accompanies the @restrict flag is displayed however, the recipe is still usable.

    Additionally the iron ore stacking will break sometimes after a restart or after I reload the recipe manager files.

  • Avatar of TheMercury199 TheMercury199 Sep 09, 2015 at 19:27 UTC - 0 likes

    @haveric: Go

    Thank you for your help, I really appreciate you taking the time to help me figure this out. I modified the recipe as you directed, and left the default recipe not disabled. If there is nothing written after the override flag smelting behaves as default minecraft, producing one ingot and stacking them. If there is a false after the flag 2 ingots are produced and one iron ore is removed. The smelting process begins again and when it ends no iron is added as a result but no iron ore is removed. The fuel is however consumed. When true is put after the override flag, an error is thrown for the recipe. I will try placing the @override flag within the default recipe and see where I can get with that later. Thank you once again.

    So I managed to fix the issue, you were very helpful. I have included these recipes.

    SMELT ironOreBuff
    iron_ore % 17.5-22.5
    = iron_ingot:0:2


    = iron_ingot:0:1

    Thank you once again for you help. I really appreciate it.

    Last edited Sep 09, 2015 by TheMercury199
  • Avatar of haveric haveric Sep 09, 2015 at 19:05 UTC - 0 likes

    @TheMercury199: Go

    I'm not at a dev machine to test this, but try adding the @override flag:

    iron_ore:* % 17.5-22.5
    = iron_ingot:0:2

    Let me know if that doesn't work and I can take a look when

  • Avatar of TheMercury199 TheMercury199 Sep 09, 2015 at 18:44 UTC - 0 likes

    @xH3LLRAIZ3Rx: Go

    I tried what you suggested using the following code.

    SMELT ironOreBuff
    = iron_ingot

    I am going to try disabling the default recipe later in the day as well, and respond with additional information.


    I tried disabling the iron ore recipe and was met with the error that the recipe was already created by the plugin not allowing me to disable the default one. I attempted to override just the default recipe, and got an error such that the ironOreBuff recipe was not added. Any recommendations?

    Last edited Sep 09, 2015 by TheMercury199
  • Avatar of xH3LLRAIZ3Rx xH3LLRAIZ3Rx Sep 08, 2015 at 07:08 UTC - 0 likes

    @TheMercury199: Go

    try removing the 0:2 at the end of iron_ingot to see if it will stack to 64

    Last edited Sep 08, 2015 by xH3LLRAIZ3Rx
  • Avatar of TheMercury199 TheMercury199 Sep 08, 2015 at 00:17 UTC - 0 likes

    I am configuring this plugin with a 1.7.10 server and I have added the following recipe.

    SMELT ironOreBuff
    iron_ore % 17.5-22.5
    = iron_ingot:0:2

    The recipe functions correctly, except that it will only give 2 ingots if the result area for the furnace is empty. I want it to just stack on the result side until it no-longer can. Any recommendations?

    Last edited Sep 08, 2015 by TheMercury199


Date created
Oct 11, 2011
Last update
Aug 02, 2015
Development stage
  • enUS
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
Recent files
  • R: v2.5.1 for 1.8.1 Aug 02, 2015
  • R: v2.5 for 1.8.1 Jul 03, 2015
  • R: v2.4 for 1.8.1 May 18, 2015
  • R: v2.3.4 for 1.8.1 Feb 18, 2015
  • R: v2.3.3 for 1.8.1 Feb 08, 2015



Optional dependency