[1.9-1.16] Custom Recipes and Crafting (CraftEnhance)
There's also a discord now! https://discord.gg/8xYEbft
More detailed info is written in the github wiki, so make sure to check that out too.
And also, Donations are really appreciated! I've put alot of my spare time into developing this opensource plugin. So maybe consider buying me a nice cup of coffee! :)
CraftEnhance is the first plugin that allows crafting with all custom items. It's very unique. Try and see how awesome it is! It's compatible with basically every bukkit or spigot version.
Create recipes with all custom items
This means you can add recipes with enchantments, custom names, a durability, potions or anything you can think of that exists in the game.
Full GUI support.
Editing recipes, creating recipes, viewing recipes and ordering the recipes in the viewer GUI are all possible through inventory GUIs.
Middle click to edit.
Opening the editor for a recipe is not done through a command, but done through a simple middlemouseclick on a recipe in the recipe viewer. This does require a permission.
Set permissions for a recipe.
In order to completely let server owners be owners of their server, permissions for the custom recipes exist. People that don't have the permission for a custom recipe, can't craft or see it. The 'seeing' part can be configured.
Edit items in-game.
To make cool recipes an item editor is needed. This item editor allows users to set colored lore, set colored names, set the durability, add enchantments, add itemflags or even set the localizedname of items. And for the record: itemflags are the things that allow you to hide enchantments or attributes on items!
Full tab completion support!
I personally think this is an obligated feature to have in the 1.13 update of Minecraft. No more remembering all commands, just the first few letters of a few basic ones.
Creating recipes is easy and done through GUI's. Here's a quick video where everything is explained.
Making the custom items for your precious recipes is also really easy to do as explained in this video.
SoulStriker has also kindly made a showcase for this plugin:
These are all the command you need when using this plugin. If something is between [these brackets], it means it's an optional part of the command. If something is between (these backets) it's not optional.
/ceh
Just use autocompletion on this command! Oh and by the way, it's short for CraftEnHance.
/recipes
View the available custom recipes in a GUI. You can also use the /ceh viewer command if you're really feeling like typing this longer command.
/ceh createrecipe [key perms]
Create a new custom recipe with a generated key by default. This will open a recipe editor GUI. You can leave the perms empty, but if you wanna set a permission, you also gotta set a key!
/ceh reload
Reload everything!
/ceh specs (key)
Shows the specifications of the recipe with the specified key. You can find the key of a recipe by middle clicking it in the recipe viewer to open the editor for it where the key is displayed.
/ceh setpermission (key) (permission)
Set the permission of the recipe with the specified key to the specified permission. Again, you can find the key of a recipe in the editor.
/ceh changekey (oldkey) (newkey)
Simply changes the key of a recipe to "newkey"!
/ceh cleanitemfile
Cleans the items.yml file meaning that it'll remove all saved unused items from the file. I wouldn't recommend to use this because it doesn't affect performance of your server much or at all.
/edititem
This is the basic command for editing items. Please use tab completion on this.
/edititem name [name]
Edit the name of the item in your main hand. Make sure that you use all the colors you want!
/edititem durability [1-100]
Set the durability of the item in your main hand to [1-100]% of it's max durability.
/edititem enchant [enchant] [lvl] [enchant] [lvl][..]
Set your specified enchantments to your held item. It removes all enchants and then adds the specified ones.
/edititem itemflag [itemflag] [itemflag] [..]
Toggle the specified itemflags on your held item. This are the available itemflags:
HIDE_ATTRIBUTES |
Setting to show/hide Attributes like Damage
|
---|---|
HIDE_DESTROYS |
Setting to show/hide what the ItemStack can break/destroy
|
HIDE_ENCHANTS |
Setting to show/hide enchants
|
HIDE_PLACED_ON |
Setting to show/hide where this ItemStack can be build/placed on
|
HIDE_POTION_EFFECTS |
Setting to show/hide potion effects on this ItemStack
|
HIDE_UNBREAKABLE |
Setting to show/hide the unbreakable State
|
/edititem lore [line_number] [lore]
Set the specified line of the lore of your held item to be the specified tekst. The tekst section can be left empty if an empty line needs to be added.
The permissions are configurable!
However, these are the default permissions. You can also look these up in the config.yml file.
craftenhance.edit
/ceh createrecipe, /ceh cleanitemfile, /ceh orderrecipes, /ceh setpermission, /ceh specs, /ceh changekey. This is also the permission required to middleclick recipes to open the editor.
craftenhance.view
/ceh viewer, /recipes.
craftenhance.edititems
All commands that start with /edititem.
Alongside the config.yml, 3 other files will be created: guitemplates.yml, recipes.yml and items.yml.
guitemplates.yml
You can fully customize all the gui's that you see using this file. I think they're faily self-explanatory given the preset files, so I'll only go over the basics. "fill-space" is a range of slot indexes where items can get filled, like the recipes in the recipes viewer. "template" specifies the items that are put into the inventory. Make sure that those don't overlap with fill-space. In template the buttons are also made.
"buttons" specifies where the buttons are located, where the value is the type of the button. Please refer to the preset file to see your options.
recipes.yml
You can manually make or edit all your recipes in here. The recipes use item keys of items in the items.yml file. However, because all recipes can be created through gui's, I'll not go over this more in-depth.
items.yml
Items are stored here with a unique key. This is also managed by the plugin, so there's no real need to touch this.
config.yml
Some of the messages and permissions are stored in here. One of the important settings is whether you want people to see a recipe that they don't have permissions to.
I'm getting a bug with this
For context, I'm trying to use a renamed book in my recipe and the output is a CrackShot gun item, and it seems like the plugin lets anyone use ANY book instead of the specific one.
Why is this?
I've used this plugin for a while and only had issues since I updated the server and the plugin to 1.16.1. When I try to do the main command (/ceh) it gives me the message "[CraftEnhance] Could not execute the command." Followed by "An internal error occurred while attempting to perform this command"
when I use /pl to see the plugin list it shows its disabled.
Here's what the log says: https://pastebin.com/chZNxQcF
any idea on how to fix this?
Not sure im just stupid but non of my friends can use any of the recipes but when oped they can.
Could you help me with this?
In reply to lyanide:
I'm guessing you accidentally set permissions for the recipes. You can unset them with the setpermission command.
Do you think about making compatibility with the slime fun plugin?
In reply to rrreapthus:
You can already add recipes that use the slimefun items, did you mean that with 'slimefun compatibility'?
Im trying to create recipes but when my non-op friends join the cant do /recipes
How do I fix this?
In reply to xuzumaki_:
You need to give your players a permission "craftenhance.view", which you can do by editing your permissions.yml file. Paste this in your permissions.yml file and your players should have permissions to view recipes by default:
In reply to dutchjellyd:
where do you find the permission.yml file
Is there a way to create custom enchant books? Say changing the properties of a normal book?
In reply to pdiids:
I don't think that's possible through the item editor of this plugin. However, you can probably still get the books you want with the minecraft give command or some other item edit plugin.
I'm having a similar issue to wallygms, same error in the Aternos logs. I would like to point out that some custom recipes still work while others don't, and the commands used to open any of the guis don't work and cause the error that wallygms showed if typed. Basically it feels like 1.16 broke the plugin partially. Is there any way I can fix the recipes that broke or bring the GUIs back in the 2.3.4 version of the addon?
In reply to drofindorb:
This is all fixed in 2.4.0!
the pluging just get disable 2 days ago and i dont know why, i didnt add new pluginsbefore that.
In reply to wallygms:
Probably because of the 1.16 update
In reply to wallygms:
That exception shows that an error occurs when you try to perform a command of the disabled plugin, but when and why did it get disabled? Im assuming some config error? And also, I'd appreciate it if you could use pastebins to post stacktraces, or report them on the github issues page.
I hope I could help with finding the cause of the issue with this pointing in the right direction.
In reply to DutchJellydev:
that´ is the error with my server to, how can you correct it?
My friends and I want to spice up our soon-to-be 1.16 server with a custom TNT recipe. Is there any way to increase the explosion radius on it? / Is there a TNT Modifier for this plugin?
In reply to beastisaurusrex:
Radiuses of TNT explosions are not part of this plugin, sorry. However, you could find another plugin that adds special TNT types, and simply create a recipe for it using this plugin.
Hey today the Plugin stopped working on my server, after i added a few recipes. I think the error is in the files items.yml or recipes.yml could you have a look?
Link to recipes.yml:https://pastebin.com/kLMFezVc