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 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 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:

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 haveric haveric Mar 27, 2015 at 21:22 UTC - 0 likes

    @ReeferX7: Go

    Can you provide a snippet of your log with the full error in it? Are you getting this only after people are logging in or with any specific action (smelting, crafting, etc.)? What version of Bukkit/Spigot are you using? What's your onlinemode set to?

  • Avatar of ReeferX7 ReeferX7 Mar 27, 2015 at 20:18 UTC - 0 likes

    Hellow @haveric how can i disable this:

    WARN Plugin attempted to establish connection in main server thread

    Spam my console!


  • Avatar of haveric haveric Mar 25, 2015 at 14:35 UTC - 0 likes

    @Camaroz1: Go

    There is no wait time on crafting recipes and that's not something that can be easily added.

    You could craft something that requires smelting and then set a long time on the smelting of that item though.

  • Avatar of Camaroz1 Camaroz1 Mar 25, 2015 at 13:28 UTC - 0 likes

    Add Feature: Need x time for craft is done (im going to do a blueprint with this plugin)

    And a admin cmd to finish it immediately

    Last edited Mar 25, 2015 by Camaroz1

    Indie Game VN:

  • Avatar of xH3LLRAIZ3Rx xH3LLRAIZ3Rx Mar 24, 2015 at 02:13 UTC - 0 likes

    @haveric: Go

    ok, ran out of other idea's, will comment if I figure out some more

  • Avatar of haveric haveric Mar 23, 2015 at 22:49 UTC - 0 likes

    @xH3LLRAIZ3Rx: Go

    There is no attribute that does that without writing custom code to handle it, which means it would be better suited as another plugin extending RecipeManager.

  • Avatar of xH3LLRAIZ3Rx xH3LLRAIZ3Rx Mar 21, 2015 at 04:27 UTC - 0 likes

    you should add a flag to results to were they are not placeable, like if the result is a block, when someone tries to place it, it goes back to their inventory

  • Avatar of pilvimaa pilvimaa Mar 20, 2015 at 22:23 UTC - 0 likes

    @haveric: Go

    Brewing support is very interesting news. It should open up some new possibilities.

  • Avatar of jhs232 jhs232 Mar 20, 2015 at 07:54 UTC - 0 likes

    @haveric: Go

    Thanks for the incredibly quick response. And yes, I just wanted to remove individual recipes (I guess I should check the documentation first, next time). Thanks!

  • Avatar of haveric haveric Mar 19, 2015 at 14:35 UTC - 0 likes

    @jhs232: Go

    If you want to remove all vanilla recipes, there is a setting called "clear-recipes" that will remove everything if set to true.

    If you want to remove individual recipes, you can create a file with @remove on top (or before each recipe) and then add the recipes you want removed. To help with this, you can use /rmextract to get a file of all recipes. I believe you need to remove the "= result" part of the recipes or you will get errors in the console.

    For example:

    = blaze_powder:0:2 // Probably need to remove this line

    Let me know if you have any questions or run into any issues.


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