Ultimate Mob Heads Fork Forked

MobHeads
Custom mob head drops for every mob in the game — updated for Paper 26.3

A Paper plugin that adds custom player-skull drops for nearly every mob in the game, including variant-aware drops for wolves, frogs, pandas, copper golems, and more. Heads are fully configurable with custom textures, drop chances, looting bonuses, broadcast messages, and advancement support.

──────────────────────────────────────────────

Features

• 200+ unique mob heads — per-variant drops for wolves, frogs, sheep, horses, villagers, axolotls, pandas, cats, and more
• Variant-aware drops — a weathered copper golem drops a different head than an unaffected one; a screaming goat drops a different head than a regular one
• Fully configurable — set drop chance, looting bonus, display name, texture, broadcast message, and advancement triggers per mob
• Advancement integration — grant players in-game advancements when they collect specific heads
• Charged creeper support — guaranteed drops when a mob is killed by a charged creeper (configurable per mob)
• Fish heads — obtainable while fishing with Luck of the Sea bonus support
• Vanilla skull support — creeper, zombie, skeleton, wither skeleton, and ender dragon heads drop as vanilla skulls usable in crafting
• WorldGuard support — respects region flags
• Collection book — /mobheads collection shows which heads you've collected and which are missing
• Head lore — heads show "Beheaded by <player>" (or "Caught by" for fishing) and the date; players can turn it off with /mobheads headlore
  
• Heads stack — identical heads of the same mob stack in your inventory
  
• Self-updating — your config and the advancements data pack update automatically when you install a new version

──────────────────────────────────────────────

Requirements

• Server: Paper 26.3
• Java: 25+

This plugin targets Paper specifically and may not work correctly on vanilla Spigot.

──────────────────────────────────────────────

Installation

1. Click the Download button at the top of this page.
2. Drop it into your server's plugins/ folder
3. Restart the server — a default config.yml will be generated
4. Adjust drop chances, textures, and other settings to your liking
5. Use /mobheads reload to apply config changes without restarting

Upgrading? Just replace the jar. Your config.yml is updated automatically (your own settings are kept, and a backup of the old file is saved), and the advancements data pack is installed and updated for you.

──────────────────────────────────────────────

Commands & Permissions

Commands

• /mobheads reload — Reloads the configuration file
• /mobheads give <player> <headname> — Gives a player a specific head by mob name (e.g. Red_Parrot) or player name
• /mobheads probability <headname> — Displays the drop probability for a mob's head
• /mobheads collection — Opens a book showing which mob heads you've collected
• /mobheads collection <player> — Shows another online player's collection
• /mobheads headlore [on|off] — Turns the "Beheaded by" lore on your heads on or off
• /mobheads initachievements — Reinstalls the advancements data pack

Permissions

• com.cyber.mobheads.behead.mobs — Required for mob head drops to trigger
• com.cyber.mobheads.behead.players — Required for player head drops to trigger
• com.cyber.mobheads.behead.fish — Required for fish head drops to trigger
• com.cyber.mobheads.reload — Access to /mobheads reload
• com.cyber.mobheads.give — Access to /mobheads give
• com.cyber.mobheads.probability — Access to /mobheads probability
• com.cyber.mobheads.initachievements — Access to advancement initialisation
• com.cyber.mobheads.collection — Access to /mobheads collection (everyone by default)
• com.cyber.mobheads.collection.others — View other players' collections (op by default)
• com.cyber.mobheads.headlore — Access to /mobheads headlore (everyone by default)

The behead permissions must be granted to your players, otherwise heads will never drop.

──────────────────────────────────────────────

Configuration

Each mob entry in config.yml supports the following fields:

Set dropChance: NONE to disable a specific head without removing its entry. Use [vanilla] for random_uuid and textureCode to drop the vanilla skull instead of a custom one (supported for Zombie, Skeleton, Wither Skeleton, Creeper, and Ender Dragon). See the head_lore section of config.yml to change or turn off the head lore text.

──────────────────────────────────────────────

Custom Advancements

The plugin ships with a set of custom advancements that unlock when players collect specific heads. The advancements data pack is installed into your main world automatically on startup and kept up to date with each plugin version — no manual download needed. Set auto_update_achievements: false in config.yml if you'd rather manage it yourself.

Each mob in config.yml has an advancements list — when that head drops, the listed criteria are automatically awarded to the player.

──────────────────────────────────────────────

Credits

• @CyberDrain — original plugin
• @zombie_striker — intermediate fork
• @Almighty_Broku — help populating the bulk of the advancements
• Lord-Lofi — this fork (Paper 26.3 support, new mobs, advancement system, variant-aware drops, collection book, head lore)

If you have suggestions or questions, feel free to send me a PM.

— Lord Lofi