RecipeManager

Workbench

RecipeManager 2

Complex recipes made easy !


Features

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: http://mcstats.org/plugin/RecipeManager


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.


Changelog

In the jar file, auto-extracted when first ran to plugins/RecipeManager/changelog.txt and on GitHub: https://github.com/haveric/RecipeManager2/blob/master/src/changelog.txt


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: https://github.com/haveric/RecipeManager2 If you need, you can use code from my project but please give credits.


Support project

If you feel I deserve:

https://www.paypalobjects.com/en_US/i/btn/btn_donate_SM.gif

Thanks for your support !

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Nuinethir Nuinethir Feb 28, 2012 at 02:15 UTC - 0 likes

    With R5, will it be possible to remove the necessity for Spout? As it stands, this is the only plugin I run that uses Spout, simply to remove/deny recipes (like editing the recipe for TNT to use 4 sand, 4 sulphur, and 1 blaze powder) and I would rather remove Spout entirely.

    BFAK:24679,2c50a3ae095effee4839b7c4e01ce1fa7e496c566e519a03047becf037f6f31f

  • Avatar of THDigi THDigi Feb 26, 2012 at 14:50 UTC - 0 likes

    <<reply 551448>>

    That would allow me to replace restricting with removing/editing of the default recipes... however, it won't allow most of the suggested stuff because the recipes are still processed by bukkit and I can't add permissions and stuff.

    Well, anyway, when that code is in a recommended build I will look into it further and maybe make this version a better one until I get to the new one.

    Last edited Feb 26, 2012 by THDigi
  • Avatar of Rofii Rofii Feb 22, 2012 at 02:10 UTC - 0 likes

    Is it possible to have this work with Buildcraft's automatic crafting tables?

  • Avatar of jayD101 jayD101 Feb 21, 2012 at 12:35 UTC - 0 likes

    THDigi;

    You should look aound this change on bukkit API : https://github.com/Bukkit/Bukkit/commit/3604da1f55d241d6649ef2844b0fdfbd1a980a95

    I guess it could be a major improvment for your plugin.

  • Avatar of Adkos Adkos Feb 18, 2012 at 14:27 UTC - 0 likes

    I have a problem with your plugin... :/

    I try to create recipes using custom materials from some spout plugin, the values are something like 318:1027

    I've created a recipe with this data value, no console error, everything loads fine.

    In game, I type "/recipes workbench", and tadaaaa ! I've got a "FLINT:2 + FLINT:3 + FLINT:4 = FLINT:5" message... Where's my 1027 ? Of course, recipe don't work, as there's no item with 318:5 ID (all custom IDs are over 1024).

    Before ask me why I try to use your plugin as MoreMaterials orother Spout plugins do it well, it's why I have to created custom weapon parts (barrel, stock, magazine etc...) with MoreMaterials, then craft them together to have complete weapons from GunPack plugin.

    Please help :)

  • Avatar of THDigi THDigi Feb 13, 2012 at 18:46 UTC - 0 likes

    <<reply 537055>>

    The problem is I can't seem to replicate that duping thing... and I can't see that video because it's removed.
    Have you tried it yourself ? Can you at least post the recipe ? :P

    Also, my plugin doesn't handle crafting, bukkit does... but I want to see for myself about that duping thing maybe I can fix it or report it to bukkit.

  • Avatar of LordKainzo LordKainzo Feb 11, 2012 at 23:07 UTC - 0 likes

    @THDigi: Go

    I love the setup of this, the biggest concern was the dupes. Good job on the project, we'll re-enable once dupes are gone :D

  • Avatar of THDigi THDigi Feb 09, 2012 at 17:24 UTC - 0 likes

    <<reply 532719>>

    Hmm, whops, I posted a link to the jar with the source, I dunno if I modified it since then tough...

    <<reply 532084>>
    Well, if cookbook does what you want, switch, I will update when I have the time to test out the errors which I can't seem to get.

    Last edited Feb 09, 2012 by THDigi
  • Avatar of armed_troop armed_troop Feb 09, 2012 at 00:50 UTC - 0 likes

    @THDigi:

    Can you post the source code somewhere? The latest jars don't include it.

    Or I guess I could decompile it. The LGPL allows that...

  • Avatar of Folas1337 Folas1337 Feb 08, 2012 at 14:55 UTC - 0 likes

    I would also like an update or we'll have to move to Cookbook somewhen...

Facts

Date created
Oct 11, 2011
Categories
Last update
Sep 05, 2014
Development stage
Release
Language
  • enUS
License
GNU Lesser General Public License version 3 (LGPLv3)
Curse link
RecipeManager
Downloads
38,014
Recent files
  • R: v2.1.1 for CB 1.7.9-R0.2 Sep 05, 2014
  • R: v2.1 for CB 1.7.9-R0.2 Aug 17, 2014
  • 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

Authors

Relationships

Optional dependency
Vault