Skip to main content

Drops Overview

Configure what items drop when your custom mobs die.

Drop Table Configuration

Drop tables are defined in plugins/btcMobs/DropTables/ directory.

Basic Structure

MyDropTable:
  Drops:
    - <item> <amount> <chance>

Example

ZombieLoot:
  Drops:
    - ROTTEN_FLESH 1-3 1.0
    - IRON_INGOT 1 0.1
    - DIAMOND 1 0.01
    
RareBossLoot:
  Drops:
    - DIAMOND 2-5 0.5
    - NETHERITE_INGOT 1 0.1
  Commands:
    - "eco give <player> 100"
  Experience: 50-100

Drop Syntax

<material> <amount> <chance>
ComponentDescription
materialItem type (DIAMOND, IRON_SWORD, etc.)
amountSingle number or range (e.g., 1-3)
chance0.0 to 1.0 (0.5 = 50% chance)

Special Drop Types

Commands

Execute commands on drop:
Commands:
  - "tell <player> You killed a boss!"
  - "eco give <player> 500"

Experience

Drop experience points:
Experience: 50
# or
Experience: 25-75

Equipment Drops

Mobs can drop their equipped items:
EquipmentDropChance:
  Helmet: 0.5
  Chest: 0.5
  Legs: 0.5
  Boots: 0.5
  MainHand: 1.0
  OffHand: 0.1

Linking to Mobs

Reference drop tables in mob configuration:
MyBoss:
  Type: ZOMBIE
  Health: 200
  Drops:
    - ZombieLoot
    - RareBossLoot

Conditions

Control when drops activate:
ConditionalLoot:
  Drops:
    - DIAMOND 1 1.0
  Conditions:
    - weather{weather=clear}
    - biome{biome=plains}