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 speciifed 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 alot 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 alot 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-arange 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 alot 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:

Known issues

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 inside the jar file as always, feel free to look at it, improve on it and feed back. Also on GitHub: 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 xXBadeye xXBadeye Apr 11, 2014 at 18:14 UTC - 0 likes

    I need to know how to remove the fire preview in the crefating menu, when it sais "10 more items needed". I'd also like to have the chat message removed.

    Last edited Apr 12, 2014 by xXBadeye


  • Avatar of Tealk123 Tealk123 Apr 09, 2014 at 15:54 UTC - 0 likes

    is there a way to create a recipe premission for dying leatherarmor without having to write an extra recipe vor every armor piece in combination with everey dye?
    My Projekts:
    Minecraft Server Startscript Linux BFAK:Tealk,428,21e1efb53ce1cbb613ccc7973ac3b9811ec711cdb8a0235d21e97ff9d3cc8ef1

  • Avatar of ReeferX7 ReeferX7 Apr 09, 2014 at 10:11 UTC - 1 like

    This is the best plugin Ever!!!

  • Avatar of reploidxzero reploidxzero Apr 03, 2014 at 23:25 UTC - 0 likes

    @haveric: Go

    Works like a dream. Thank you so much

  • Avatar of haveric haveric Apr 03, 2014 at 00:31 UTC - 0 likes

    @frol1: Go

    I don't feel that I could contribute enough to handle future development by myself. I can help maintain it is all for now. If there are other interested developers, I would be more interested in taking it over fully as a team.

    @Tealk123: Go @reploidxzero: Go

    You can get my unofficial build from Github

  • Avatar of reploidxzero reploidxzero Apr 01, 2014 at 22:01 UTC - 0 likes

    @haveric: Go

    Do you have a pre-compiled download of it anywhere?

  • Avatar of Tealk123 Tealk123 Mar 23, 2014 at 12:12 UTC - 0 likes

    I get this error can you please help me?

    [13:10:09] [Server thread/INFO]: [RecipeManager] Generated 'recipe flags.html' file.
    [13:10:09] [Server thread/INFO]: [RecipeManager] Generated 'commands & permissions.html' file.
    [13:10:09] [Server thread/WARN]: [RecipeManager] Task #18 for RecipeManager v2.0 generated an exception
    	at ro.thehunters.digi.recipeManager.Files.createNameIndex( ~[?:?]
    	at ro.thehunters.digi.recipeManager.Files.<init>( ~[?:?]
    	at ro.thehunters.digi.recipeManager.Files.reload( ~[?:?]
    	at ro.thehunters.digi.recipeManager.RecipeManager.reload( ~[?:?]
    	at ro.thehunters.digi.recipeManager.RecipeManager.onEnablePost( ~[?:?]
    	at ro.thehunters.digi.recipeManager.RecipeManager.access$0( ~[?:?]
    	at ro.thehunters.digi.recipeManager.RecipeManager$ ~[?:?]
    	at ~[spigot.jar:git-Spigot-1337]
    	at org.bukkit.craftbukkit.v1_7_R1.scheduler.CraftScheduler.mainThreadHeartbeat( [spigot.jar:git-Spigot-1337]
    	at net.minecraft.server.v1_7_R1.MinecraftServer.u( [spigot.jar:git-Spigot-1337]
    	at net.minecraft.server.v1_7_R1.DedicatedServer.u( [spigot.jar:git-Spigot-1337]
    	at net.minecraft.server.v1_7_R1.MinecraftServer.t( [spigot.jar:git-Spigot-1337]
    	at [spigot.jar:git-Spigot-1337]
    	at [spigot.jar:git-Spigot-1337]
  • Avatar of frol1 frol1 Mar 03, 2014 at 04:59 UTC - 1 like

    @haveric: Go

    Hey man, couldn't you submit this to Bukkit and just explain that THDigi hasnt been on in a year and that you would like to 'maintain' the plugin? Also how do we download your updated version? I have no idea how Github works :P

    Last edited Mar 03, 2014 by frol1
  • Avatar of frol1 frol1 Mar 03, 2014 at 04:35 UTC - 0 likes

    Hmm only 'Commands and Permissions' and 'Recipe Flags' appeared once the server was restarted.

  • Avatar of CommodoreAlpha CommodoreAlpha Feb 20, 2014 at 23:54 UTC - 0 likes

    @ReeferX7: Go

    I would imagine smelting would be difficult to check permissions for, because you don't know who put the item in the furnace. The plugin can mainly see only an item cooking in the furnace, and no other data attached to it. Sure, it can log every time a player puts an item in the furnace, but that oversimplifies the problem and can impose a heavy burden on the server. For instance, if an item gets put in the furnace by player A, and then player B adds more items, who is responsible for the stack?

    In a nutshell, I doubt it's as you said, a "little fix". On the contrary, I would think it'd be rather complex to solve. But not impossible. Maybe. Just because a problem seems "small" and easy to fix, doesn't mean it is; there are always deep implications even for what may seem like the simplest effect.

    Sure, I'd love to include my server IP here. But it's under construction, and I wouldn't want to get sued for players wandering inside and getting hit by a random beam of steel floating about. And no, I doubt plugins would make very good lawyers either. I've never seen a plugin that forced you to sign a contract do so well.


Date created
Oct 11, 2011
Last update
May 30, 2013
Development stage
  • enUS
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
Recent files
  • R: v2.0 for 1.5.2 May 30, 2013
  • B: v2.0beta for 1.5.2 May 24, 2013
  • A: v2.0alpha3 for 1.5.2 May 09, 2013
  • R: v1.26b for 1.3.2 Sep 01, 2012
  • R: v1.26 for CB 1.3.1-R1.0 Aug 07, 2012



Optional dependency