Skip to main content

Custom Items

// Listen to item registry event
onEvent('item.registry', event => {
  // The texture for this item has to be placed in kubejs/assets/kubejs/textures/item/test_item.png
  // If you want a custom item model, you can create one in Blockbench and put it in kubejs/assets/kubejs/models/item/test_item.json
  event.create('test_item').displayName('Test Item')
})

Other methods item builder supports: [you can chain these methods after displayName()]

  • type('itemType')
tier('itemTier') maxStackSize(size) unstackable() maxDamage(damage) burnTime(ticks) containerItem(item_id) tool(type, level) miningSpeed(speed) attackDamage(damage) attackSpeed(speed) rarity(rarity) glow(true/false) tooltip(text...) group(group_id) color(index, colorHex) texture(customTexturePath) parentModel(customParentModel) food(foodBuilder => ...)

Valid item types:

    basic (default) sword pickaxe axe shovel hoe helmet chestplate leggings boots

    Valid item tiers:

      Swords + Tools:
        wood stone iron gold diamond netherite Armor
          leather chainmail iron gold diamond turtle netherite

          Valid group/creative tab IDs:

            search buildingBlocks decorations redstone transportation misc food tools combat brewing