Skip to content

CustomItems

WolfyScript edited this page May 16, 2021 · 5 revisions

CustomItems in CustomCrafting make it a lot easier to manage your recipes and are more flexible than just using items with NBT.

These items are saved to a config file and contain an id, so they can be identified by the plugin.

Benefits

  • They perform (way) better in recipes because it only has to check for one NBT Tag.
  • Players can rename or enchant the item and then still use it inside recipes.
  • You can change the item later on and it'll be updated in all the recipes it's used in.
  • They have extra settings like custom durability and more.

Usage

Make sure to only use the items you got via /cc give <player> <namespaced_key> [<amount>] to create the recipe.
(The GUI will look for the id and save it accordingly).
Then when crafting the recipe you also need to use the item that contains the id and it should all work fine.

Configure

CustomItems can be created and saved via the Item Creator (MainMenu bottom left).

1. Open ItemCreator

ItemCreator

2. Place your item into the top middle empty slot.

ItemCreator

3. Configure the Item

There are many options you can choose on top of the Item Creator.
See Features below (More info coming soon)

4. Save your item by clicking on the Save Item button on top and type in the namespaced key:

/wui <namespace> <key>

Features

Custom Durability

Choose the Custom Durability & Damage option in the ItemCreator.
There you have the option to set the Durability, Tag, and Damage.

It will not change the vanilla durability! that's not possible!.
If you set the custom durability the vanilla damage of the item will be changed according to the percentage of the custom damage and durability.
To view the custom durability you need to set a tag like &r&fDurability: %dur%/%max_dur%. There are two placeholders you can use:
%dur% - The current durability with the damage included.
%max_dur% - The maximum durability.