Transform into any monster by wearing their head! MobHeadDisguise is a lightweight, performance-optimized plugin that adds an immersive stealth mechanic to your server. When players wear monster heads, they become invisible to those specific mob types - until they break their cover!

Features
Core Mechanics

• Monster Disguise System - Wear a mob head to become undetectable by that mob type
• Attack Cooldown - Breaking disguise by attacking triggers a 30-second vulnerability period
• Golem Interactions - Iron Golems and Snow Golems become hostile to disguised players
• Smart AI Manipulation - Seamlessly integrates with vanilla mob AI without performance impact
• Creative Mode Bypass - System automatically disabled in creative mode

Supported Heads & Protected Mobs

• Zombie Head → Protects from: Zombies, Drowned, Husks, Zombie Villagers
• Skeleton Skull → Protects from: Skeletons, Strays
• ⚫ Wither Skeleton Skull → Protects from: Wither Skeletons
• Creeper Head → Protects from: Creepers (Iron Golems won't attack!)
• Piglin Head → Protects from: Piglins, Piglin Brutes, Zombified Piglins
• Dragon Head → Protects from: Ender Dragon

How It Works
Basic Usage

1. Obtain a mob head through vanilla gameplay (mob drops, creative, etc.)
2. Equip the head in your helmet slot
3. Enjoy immunity from that mob type - they won't target you!
4. Avoid attacking - Hit a disguised mob and lose protection for 30 seconds

Special Mechanics

• Golem Behavior: Iron and Snow Golems see through your disguise and attack!
• Creeper Exception: Iron Golems ignore players in Creeper heads (they don't attack Creepers)
• Group Protection: One head protects from all related mob variants
• Restore Notification: Get notified when your disguise cooldown expires

⚙️ Configuration

Spoiler: config.yml

# MobHeadDisguise Configuration
# Created by YourName

# Attack cooldown duration in seconds
# How long a player loses disguise after attacking a monster
attack-cooldown: 30

# Golem behavior settings
golem-behavior:
# Should Iron Golems attack players wearing monster heads?
iron-golem-attacks: true
# Should Snow Golems attack players wearing monster heads?
snow-golem-attacks: true
# Range in blocks for golems to detect disguised players
detection-range: 16

# All messages are customizable
# Use & for color codes
messages:
prefix: "&6[MobHeadDisguise] &r"

# When player equips a monster head
disguise-equipped: "&aYou equipped {head}. {mobs} will not attack you!"

# When player attacks a monster and loses disguise
disguise-lost: "&cYou attacked {mob}! Disguise lost for {time} seconds."

# When disguise is restored after cooldown
disguise-restored: "&aYour {head} disguise is active again!"

# Command messages
command-header: "&6=== MobHeadDisguise v{version} ==="
command-description: "&eThis plugin allows you to disguise as monsters!"
command-available-heads: "&eAvailable heads:"
command-warning: "&cWarning: Attacking a monster removes disguise for {time} seconds!"

# Head descriptions for command
heads:
zombie: "&7- Zombie Head: Protection from Zombies, Drowned, Husks, Zombie Villagers"
skeleton: "&7- Skeleton Skull: Protection from Skeletons and Strays"
wither-skeleton: "&7- Wither Skeleton Skull: Protection from Wither Skeletons"
creeper: "&7- Creeper Head: Protection from Creepers"
piglin: "&7- Piglin Head: Protection from Piglins, Piglin Brutes and Zombified Piglins"
dragon: "&7- Dragon Head: Protection from Ender Dragon"

# Monster names (used in messages)
mobs:
zombie: "Zombie"
skeleton: "Skeleton"
creeper: "Creeper"
wither_skeleton: "Wither Skeleton"
piglin: "Piglin"
ender_dragon: "Ender Dragon"
drowned: "Drowned"
husk: "Husk"
stray: "Stray"
piglin_brute: "Piglin Brute"
zombified_piglin: "Zombified Piglin"
zombie_villager: "Zombie Villager"

# Head item names (used in messages)
head-names:
zombie_head: "Zombie Head"
skeleton_skull: "Skeleton Skull"
wither_skeleton_skull: "Wither Skeleton Skull"
creeper_head: "Creeper Head"
piglin_head: "Piglin Head"
dragon_head: "Dragon Head"

Message Placeholders

• {head} - The head item name
• {mob} - The attacked mob name
• {mobs} - List of protected mobs
• {time} - Cooldown duration
• {version} - Plugin version

Commands & Permissions
Commands

• /mobheaddisguise (Aliases: /mhd, /mobdisguise) - Display plugin information and available heads

Permissions

• mobheaddisguise.use - Allow using mob head disguises (Default: true)
• mobheaddisguise.info - Allow viewing plugin information (Default: true)
• mobheaddisguise.reload - Allow reloading configuration (Default: op)

Technical Information
Requirements

• Server Version: Spigot/Paper/Purpur 1.21.5+
• Java Version: 17 or higher
• Dependencies: None! Completely standalone

Performance

• Zero TPS impact - Uses efficient event handling
• Minimal memory footprint
• No constant checks or loops for basic functionality
• Optimized entity detection algorithms