Skip to main content

​
Items Overview

Define custom items that can be used for mob equipment or drops.

​
Configuration

Item files are located in plugins/btcMobs/Items/.

​
Basic Structure

MyCustomSword:
  Material: DIAMOND_SWORD
  Display: "&6Legendary Blade"
  Lore:
    - "&7A powerful weapon"
    - "&7forged in ancient fires"
  Enchantments:
    SHARPNESS: 5
    FIRE_ASPECT: 2
  Amount: 1

​
Options

OptionTypeDescription
MaterialstringBase item type
DisplaystringCustom display name
LorelistItem description lines
EnchantmentsmapEnchantment: Level pairs
AmountnumberStack size
UnbreakablebooleanPrevent durability loss
Modelstring(New 1.21.4+) Namespaced model (e.g., namespace:model_id)
CustomModelDatanumber/stringLegacy custom model ID (integer) or Model String
[!NOTE] Starting with Minecraft 1.21.4, it is highly recommended to use the Model option which supports namespaced strings. CustomModelData is still supported for backwards compatibility and will automatically handle both integer IDs and namespaced keys.

​
Advanced Options

CustomArmor:
  Material: LEATHER_CHESTPLATE
  Display: "&bIce Armor"
  Color: "#00FFFF"    # RGB color for leather
  Enchantments:
    PROTECTION: 4
    FROST_WALKER: 2
  Attributes:
    GENERIC_ARMOR: 10
    GENERIC_ARMOR_TOUGHNESS: 5
  Flags:
    - HIDE_ENCHANTS
    - HIDE_ATTRIBUTES

​
Using in Mobs

Reference items in mob equipment: 
ArmoredGuard:
  Type: ZOMBIE
  Equipment:
    Helmet: MyCustomHelmet
    Chest: CustomArmor
    MainHand: MyCustomSword

​
Using in Drops

Reference items in drop tables: 
BossDrops:
  Drops:
    - MyCustomSword 1 0.1
    - CustomArmor 1 0.05