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

Option	Type	Description
Material	string	Base item type
Display	string	Custom display name
Lore	list	Item description lines
Enchantments	map	Enchantment: Level pairs
Amount	number	Stack size
Unbreakable	boolean	Prevent durability loss
Model	string	(New 1.21.4+) Namespaced model (e.g., namespace:model_id)
CustomModelData	number/string	Legacy 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