[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.
This is an outstanding plugin but the fact that you can't add multiple items is not good. So you can't add 2 of the same item in one slot. Other than that this is a good plugin.
Hey man, I love the plugin, but I've created a custom permission, how do I give someone said permission. I'm using mine hut and can't set anything in files very easily.
Does it allow stacked ingredients?
In reply to jdefgh:
No that's not supported. However, I don't think that this should be a problem because you can just create intermediate items that represent a stack of 9.
The plugin is very good, but i have a problem. In 1.14.4 it works perfectly, but in 1.16.4, i can craft a diamond sword with diamons and sticks with customs IDs. I made a diamond sword with tags, that could be crafted with an enchanted diamond with tags, but when i use that diamond or any item with tags, it crafts normal Minecraft items, and i can craft that diamond sword i told, with normal Minecraft items. Any solution?
In reply to Lean511:
The plugin currently won't work with model data properly, which is what you mean with custom IDs right?
An easy solution would be to add some other item meta to your items like a custom name, lore, enchantment or item flag.
how do you set it so everyone can see your custom recipes
Hello, how to replace a recipe for a thing created by minecraft?
In reply to hack550:
Disable the recipe with /ceh disabler, and then just make a new one that replaces it.
Registration of recipes works perfectly but is not produced according to registered recipes. How can I solve it? We proceeded null because we wanted to allow you to create all of them without specifying permissions. I am a cat server of 1.12.2 version.
In reply to 슈온:
So if I understand you correctly, the recipes are showing up in /recipes, but you are not able to craft them?
In reply to dutchjellyd:
Yes. You can register the recipe, but you can't make it.
In reply to dutchjellyd:
I don't know why, but suddenly things registered in the recipe began to work. Thank you for the good plug-in.
I've got an Issue, my server is running on 1.16.1 paperspigot and I made a custom recipe for a saddle. everybody who is op can see and craft it, but for some reason players that aren't op can't craft it. I'm not sure what permission I should grant the group of players to be able to see and craft the recipe, can you help me with that? It's not really clear after reading the whole article above. Thanks a lot!
In reply to Forge_User_48846181:
alright for some reason the recipe still shows up with the command /ceh viewer but nobody but the ops were able to craft it. I fixed it by recreating the same recipe again but I'm not sure if it will still work once I restart the server or something else happens. Can you tell me what to do to make my recipes 'stable' in a way
thanks again
In reply to Forge_User_48846181:
If you create a recipe you can set a permission for that recipe. This is optional. What that does is that it prevents players that don't have that permission from crafting that recipe.
You can see what permission your recipe has by hovering over one of the buttons in the recipe editor (right click a recipe in /recipes). In addition to this, you can also set the permission to something else there.
ok so this plugin is good, and I mean REALLY good, but there is a huge bug that has been plaguing my server for a while.
EVERY SINGLE TIME I restart the server I lose all the recipes and have to uninstall and reinstall the plugin to even make it work again. I don't know the source of this it just kinda started happening and never stopped.
In reply to MR_BreadBoy:
Uninstalling and reinstalling is not needed; another reload will get the job done (from what I've been told). I'm currently not sure what's causing the issue, but I am trying to fix it. In the latest update (2.4.2) I tried something that might work. I'll have to see if people are still having the issue.
Thanks for the nice feedback tho. Comments like these really motivate me to keep working on this plugin.
Players on the server cant do /recipes or /ceh viewer
I am using a minehut server and everything else about the plugin works great, and they are able to craft the recipes just not use the commands
please explain how to fix this, I tried a solution you replied to another comment about this but it didnt work for me, as you said paste:
defaultGroup:
description: Default group
default: true
children:
craftenhance.view: true
into the permissions file but thats not a file that i see... please help thanks
In reply to seasandyy:
The permissions.yml file is at the root of your server folder, I don't know if you're able to access that on minehut. It's in the same directory as your server.properties file. Do you have sftp or ssh access?
Another solution is to use some permissions plugin. You can probably find millions of tutorials for them on youtube.