Mob Metadata

The entity-metadata section allows you to customize mob appearance with armor, equipment, and entity-specific variants.

Optional Section

Entity metadata is entirely optional. If you don't include it, the mob will have its default Minecraft appearance.

---

Basic Structure

Entity metadata configuration

entity-metadata:
  # Baby/age state
  baby: false
  
  # Equipment (armor and held items)
  equipment:
    helmet: DIAMOND_HELMET
    chestplate: DIAMOND_CHESTPLATE
    leggings: DIAMOND_LEGGINGS
    boots: DIAMOND_BOOTS
    main-hand: DIAMOND_SWORD
    off-hand: SHIELD
  
  # Entity-specific variants
  variants:
    # Generic variant (entity-specific)
    type: desert
    
    # Specific variant types (see below)
    sheep-color: WHITE
    cat-variant: TABBY
    frog-variant: TEMPERATE

---

Equipment

Add armor and held items to compatible mobs.

Supported Mobs

Equipment Type	Supported Entities
Full Armor	ZOMBIE, SKELETON, WITHER_SKELETON, STRAY, HUSK, DROWNED, ZOMBIFIED_PIGLIN, PIGLIN, PIGLIN_BRUTE, ARMOR_STAND, GIANT
Held Items	Above + VINDICATOR, PILLAGER, EVOKER, VEX, WITCH, ALLAY, FOX, DOLPHIN

Equipment Slots

Armor

equipment:
  helmet: DIAMOND_HELMET
  chestplate: IRON_CHESTPLATE
  leggings: LEATHER_LEGGINGS
  boots: CHAINMAIL_BOOTS

Weapons

Tools

Custom Items

Any Minecraft material can be used.

---

Baby/Age State

Make mobs appear as babies.

# Adult mob (default)
entity-metadata:
  baby: false

# Baby mob
entity-metadata:
  baby: true

---

Entity-Specific Variants

Sheep

Customize sheep color and shearing state.

Colors

entity-metadata:
  sheep-color: WHITE
  sheep-sheared: false

Available Colors: WHITE, ORANGE, MAGENTA, LIGHT_BLUE, YELLOW, LIME, PINK, GRAY, LIGHT_GRAY, CYAN, PURPLE, BLUE, BROWN, GREEN, RED, BLACK

Sheared

---

Cat

Set cat breed variant.

entity-metadata:
  cat-variant: TABBY

Available Variants: TABBY, BLACK, RED, SIAMESE, BRITISH_SHORTHAIR, CALICO, PERSIAN, RAGDOLL, WHITE, JELLIE, ALL_BLACK

---

Frog (1.19+)

Set frog biome variant.

entity-metadata:
  frog-variant: TEMPERATE

Available Variants:

• TEMPERATE - Orange frog

• WARM - White frog

• COLD - Green frog

---

Axolotl

Set axolotl color variant.

entity-metadata:
  axolotl-variant: LUCY

Available Variants:

• LUCY - Pink

• WILD - Brown

• GOLD - Yellow/gold

• CYAN - Cyan/blue

• BLUE - Blue (rare)

---

Horse

Customize horse color and markings.

Color

entity-metadata:
  horse-color: BLACK

Available Colors: WHITE, CREAMY, CHESTNUT, BROWN, BLACK, GRAY, DARK_BROWN

Style/Markings

Combined

---

Villager

Customize villager type and profession.

Type (Biome)

entity-metadata:
  villager-type: DESERT

Available Types: DESERT, JUNGLE, PLAINS, SAVANNA, SNOW, SWAMP, TAIGA

Profession

Level

---

Other Variants

Fox

entity-metadata:
  fox-variant: SNOW  # RED or SNOW

Parrot

Rabbit

Llama

Mooshroom

---

Special Mob States

Creeper

entity-metadata:
  creeper-powered: true  # Charged creeper (lightning effect)

Slime & Magma Cube

entity-metadata:
  slime-size: 4  # Size (1-127, default is 1)

Size Reference:

• 1 - Small

• 2 - Medium (default in vanilla)

• 4 - Large

• 8+ - Giant

Phantom

entity-metadata:
  phantom-size: 10  # Size (0-64, default is 0)

Note: Larger phantoms are more dangerous and have bigger hitboxes.

Pufferfish

entity-metadata:
  pufferfish-state: 2  # Puff state (0=normal, 1=mid-puff, 2=fully puffed)

Pig

entity-metadata:
  pig-saddled: true  # Pig with saddle

Strider

entity-metadata:
  strider-cold: true  # Cold/shivering strider (purple color)

Goat

entity-metadata:
  goat-screaming: true  # Screaming goat variant

Bee

entity-metadata:
  bee-angry: true        # Angry bee (red eyes)
  bee-has-nectar: true   # Bee carrying pollen
  bee-has-stung: true    # Bee that has stung (loses stinger)

Tamed Mobs (Wolf, Cat, Parrot)

entity-metadata:
  tamed: true     # Tamed state
  sitting: true   # Sitting position

---

Complete Examples

Armored Skeleton

skeleton-knight.yml

entity:
  mob-type: SKELETON
  display-name: '&7Skeleton Knight'
  health: 200
  auto-hit:
    enabled: true
    interval: 15

entity-metadata:
  equipment:
    helmet: IRON_HELMET
    chestplate: IRON_CHESTPLATE
    leggings: IRON_LEGGINGS
    boots: IRON_BOOTS
    main-hand: IRON_SWORD
    off-hand: SHIELD

Boss Zombie

zombie-boss.yml

entity:
  mob-type: ZOMBIE
  display-name: '&4&l[BOSS] Zombie King'
  health: 1000
  auto-hit:
    enabled: true
    interval: 5

entity-metadata:
  equipment:
    helmet: NETHERITE_HELMET
    chestplate: NETHERITE_CHESTPLATE
    leggings: NETHERITE_LEGGINGS
    boots: NETHERITE_BOOTS
    main-hand: NETHERITE_AXE
    off-hand: TOTEM_OF_UNDYING

Baby Zombie

baby-zombie.yml

entity:
  mob-type: ZOMBIE
  display-name: '&aBaby Zombie'
  health: 50
  auto-hit:
    enabled: true
    interval: 10

entity-metadata:
  baby: true
  equipment:
    main-hand: WOODEN_SWORD

Rainbow Sheep

rainbow-sheep.yml

entity:
  mob-type: SHEEP
  display-name: '&d&lRainbow Sheep'
  health: 30
  auto-hit:
    enabled: false

entity-metadata:
  sheep-color: PINK
  sheep-sheared: false

Giant Slime

giant-slime.yml

entity:
  mob-type: SLIME
  display-name: '&a&lGiant Slime'
  health: 500
  auto-hit:
    enabled: true
    interval: 30

entity-metadata:
  slime-size: 8  # Very large slime

---