CustomMobHeads

CustomMobHeads is a lightweight, highly configurable Paper plugin that lets mobs drop custom textured player heads when killed. Whether you're building a trophy room or just want cool mob-themed decor, this plugin adds satisfying and personalized rewards for slaying mobs.

🎯 Features

• 📊 Per-mob drop chances
  Define unique drop rates for each mob and variant in simple YAML config files.

• 🧬 Variant-aware head drops
  Supports detailed variants for mobs like:

  • Temperate / Warm / Cold Cows, Pigs, and Chickens (1.21.5+)
  • Angry / Pollinated / Angry + Pollinated Bees
  • Charged / Normal Creepers
  • Villager Biomes + Professions
  • Tropical Fish with 22 named special variants (others drop a generic head)
  • Easter eggs like Toast Rabbits, jeb_ Sheep, and The Killer Bunny

  • 🎨 Custom textures
    Assign base64 head textures in a dedicated textures.yml file for easy management.

  • ⚙️ Simple, flexible configuration

    • chance_config.yml: Drop rates per mob or variant
    • textures.yml: Texture base64 values
    • translations.yml: Display names for heads
    • config.yml: Global behavior (lore, default chance, force drop, etc.)

⚙️ config.yml overview

# If true, all mobs will always drop their head (for testing purposes)
force-drop-all: false

# If true, dropped heads will have lore with the killer's name
add-killer-lore: true

# The fallback drop chance (percent) if a mob type is missing in chance_config.yml
default-drop-chance: 50.0

⚠️ Note: This plugin only supports vanilla mobs by default. Modded mobs will not drop heads unless manually configured — and may show as missing texture if no base64 is provided. This has not been tested, so here be dragons!