Skip to main content
Version: GeckoLib5

The Item JSON Files

All items in Minecraft require associated asset JSON files, and GeckoLib items require them too.
GeckoLib's items require some specific contents, however.

The Item JSON​

The first of the two JSON files your item will need is the "Item JSON".
This file goes in your assets/<modid>/items/ folder, and must be named the same as the registered id of your item.

Item JSON File

The contents of this JSON file should be as below, with the <modid> and <item_id> replaced with your mod's id and item's id respectively:

{
  "model": {
    "type": "minecraft:special",
    "base": "<modid>:item/<item_id>",
    "model": {
      "type": "geckolib:geckolib"
    }
  }
}
danger

Don't forget to change the <modid> and <item_id> values to match your mod and item!

The Item Display JSON​

The second JSON file your item will need is the "Item Display JSON".
This file goes in your assets/<modid>/models/item/ folder, and must be named the same as the registered id of your item.

Item Display JSON File

The contents of this JSON file should be as below, with the <modid> and <item_id> replaced with your mod's id and item's id respectively:

{
  "parent": "builtin/entity",
  "textures": {
    "particle": "<modid>:item/<item_id>"
  }
}
danger

Don't forget to change the <modid> and <item_id> values to match your mod and item!