[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.
In reply to DutchJellyDev:
Thank you, I forgot spigot enchantment names required all caps.
In reply to yvaltas_kitty:
No problem. But to be clear: spigot only requires those enum enchantment names in caps in versions below 1.13.
but why when i place the blocks, and when i watch it, it's bugged, the positions are not my.
update to 1.14.1 every plugins
Hey there Mr. Developer!
I absolutely love this plugin, and while I am coming to you for assistance, I feel it is necessary to let you know how awesome your work is and I appreciate you very much. This has made the Roleplay elements of our server stand out more, and it's all thanks to this plugin.
The trouble I am having is related to the permissions, and the lack of direction available on your page. I'm hoping you can shed some light on it for me as I'd love to continue using your plugin. To give you the lowdown, it's about crafting. When a player on my server (non-opped) tries to craft something, it doesn't show up for them. Example: An anvil over a dark oak plank to make a Smithing Table, or a few precious items with a regular book to make a specific written book with important Lore details for quests.
The only information I found so far in the comments is "ceh.defaultperm", which allows player with that permission to craft that item. I got it to work once and I am not sure how.
The permissions plugin I am using is LuckPerms, and it doesn't recognize ceh or CraftEnhance any time I type it in (i.e, it doesn't auto-fill the permission node). I will however get the confirmation that the permission has been added but nothing changes. There was one time it did show up, and at that point I had already added the above permission to all the ranks (and individual players of testing). It said I had already added it but the players were able to craft custom items.
The next day, the player had logged on to try and do some custom crafting and they couldn't again. It acts as if the permission isn't there.
Is there something I'm missing? My server log doesn't show anything wrong, so I can't tell if there's an error with the latest version of the plugin or what not.
I'd love to keep using this plugin, but can't seem to get it to work right. If you can provide any assistance, please let me know! I know you're working hard on your studies and I hope that's going well, so please get to me when you can!
Thanks you!
EDIT: For anyone having the issue, I realized my mistake was I created the recipe without ceh.defaultperm at the end. You seem to HAVE to make the recipe with that part of the command included. So like, yea... That was a bunch of trial and error now. We good.
In reply to MJRookieForge:
Thanks for your feedback and showing some confusing aspects of the plugin. I'll try to make the permissions easier to work with when I have spare time to work on the plugin.
In reply to DutchJellyDev:
Well Uni is important! So keep to your studies. You'll find time when you find time. :) Thank you for making one of my favorite plugins!
How do I remove/edit a recipe?
In reply to Forge_User_08628250:
Middle mouseclick on a recipe in the recipes viewer to open te editor.
Hey, any news on an update to fix those game-breakers any time soon? Our server’s having a meltdown after a massive dupe glitch with an emerald sword recipe essentially crashed the entire economy.
In reply to goldrat143264:
I'm sorry about the duping glitch that isn't fixed yet. However I have to study alot in the opcoming month. Therefor I'd suggest to have your developers look into the sourcecode to fix the issue, if you have any.
So to clarify: developing the plugin costs alot of time that I don't have at the moment. I apologize for that.
I'm not sure if something like this has already been mentioned before but is it possible to create a recipe which uses any type of wood? E.g. crafting 4 chests using 8 logs of any type.
In reply to Forge_User_38600534:
Yes that's possible with this plugin.
In reply to gamergamer1000:
Could you explain how I would go about doing this, please?
In reply to Forge_User_38600534:
A Gui should pop up where you can add your logs however you want and set the result to be the 4 chests. You'll have to do this with all wood types. If that doesn't work, please let me know so I can fix it in the next patch.
Oh cool, ANOTHER MASSIVE ISSUE HAHA
Wheat is flat out just not recognised properly as an item. You can put it into recipes, but if all the other items of the recipe are there except the wheat, you can still craft the item. I tried making a 'bread' recipe by putting three wheat in diagonally, and i made the recipe, and could craft it, but if i put anything into the crafting table and took it out so it was empty, i could craft bread.
PLEASE FIX THIS IS BAD BUGS AHHHHHH
In reply to goldrat143264:
That bug has to do with spigot api compatibility I think. Alot of item types have changed in the 1.13 api, which messes up serialisation to the .yml files sometimes. Thanks for pointing out all the bugs in the plugin! I'll look into this one too.
Hello author, after I installed CEH, any other plugin that has a display GUI will have problems:
Although some items in the GUI as decorations for the menu, but we can take them out from the GUI and put in backpack.(especially the skull-related plugin)
At the same time, ceh will generate an error, but I don't know the trigger mechanism.
Forgive my English :B
In reply to auromanx:
I'm aware of this issue. It should be fixed in the next version. However, if you're into programming, it's already fixed in the github repository. I just need to find time to actually update the plugin and fix the other major bug that currently exists in the plugin.
Thanks for pointing out this bug! I really appreciate you taking your time to make me aware of this issue.
In reply to gamergamer1000:
Hello author,
When will you update craftenhance? I look at your posts several times a day, but I can't wait for updates... QWQ