General properties

model_id
indicates the file name of model and texture for this item in the resourcepack.
1
assets\minecraft\models\new_<type>\<model_id>.json
Copied!
vanilla_type
indicates the original Minecraft item material we want our item to be based off. In this example I want this sword to be like a diamond sword, since it's an emerald sword and I want it to have an high durability like diamond swords have.
As you can see I'll have to create the model and texture files in there paths:
1
assets\minecraft\models\new_diamond_sword\6.json
2
assets\minecraft\textures\new_diamond_sword\6.png
Copied!
1
emerald_sword:
2
  enabled: true
3
  permission: emeraldsword
4
  model_id: 6
5
  vanilla_type: DIAMOND_SWORD
6
  name: '&fEmerald sword'
Copied!
Important
Not every custom item can have vanilla_type changed:
blocks.yml
bows.yml
drinks.yml
eatables.yml
armors.yml
fishing_rods.yml
furnitures.yml
hats.yml
items.yml
minerals.yml
seeds.yml
shields.yml
totems_of_undying.yml
vegetables_and_fruits.yml
Only in these configs you can specify the vanilla_type:
swords.yml (must be swords or tools)
tools.yml (must be tools or swords)
guns.yml (must be swords or tools)
enabled
Specify if the item is enabled or not
1
enabled: true
Copied!
permission
Specify which permission a user needs to have in order to craft the current item, example:
1
permission: mysword
Copied!
User must have this permission ia.craft.mysword to craft the item
name
1
name: '&fMy awesome custom sword'
Copied!
lore
1
    lore:
2
      - '&fWow this is my first'
3
      - '&fcustom sword!'
Copied!
enchants
You can set a default enchant for the item so when players craft this item it'll have the specified enchants. You can add more than one enchant (like lore lines).
1
enchants:
2
  - FIRE_ASPECT:1 #<enchant name>:<level>
Copied!
You can get enchant names here​
events
Events
specific_properties
Each .yml file which contains a particular item type has its own special_properties structure.
To see the available properties take a look at the various pages under "specific items" and search for "specific_properties".
One specific_properties attribute is available to all .yml files, it's the luck attribute.
Luck attribute is used to specify luck amount.
1
luck_offhand: <number>
2
luck_mainhand: <number>
3
luck_head : <number>
4
luck_chest: <number>
5
luck_legs: <number>
6
luck_feet: <number>
Copied!
​
craft_recipe
Recipe to craft the current custom item
Craft recipe
result_recipe
Recipe to craft any item with any ingredient, it's useful if you want to add multiple crafting recipes for the current custom item
Result recipe