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

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

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