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