HeadDisguisePlugin

A comprehensive Minecraft plugin for PaperMC 1.21.6 that creates an immersive player head and disguise system.

Features

🎭 Core Functionality
Player Head Drops: Custom player heads drop on death, preserving the player's skin and name
Dual Equipping System: Equip heads via inventory slot or right-click anywhere
Automatic Disguises: Integration with LibsDisguises for seamless skin/name changes
Custom Death Messages: Death messages show disguised names instead of real ones
Self-Pickup Prevention: Players cannot pick up their own dropped heads
🛠️ Technical Features
Built for PaperMC 1.21.6 with Java 21
Robust event handling and error management
NBT data preservation for head metadata
Permission-based access control
Clean, modular architecture
Installation
Prerequisites:

PaperMC 1.21.6 server

Usage
For Players
Equipping Heads:
Drag a player head to your helmet slot in inventory
OR right-click with the head in hand for instant equipping
Disguising: Automatically applied when head is equipped
Combat: Use heads mid-fight for tactical disguises
For Admins
/headdisguise reload - Reload plugin and remove all disguises
/headdisguise remove [player] - Remove disguise from specified player
/headdisguise info - Display plugin information
Permissions
headdisguise.use - Allow using head disguises (default: true)
headdisguise.admin - Access to admin commands (default: op)
headdisguise.bypass.selfpickup - Can pick up own dropped heads (default: op)
Configuration
The plugin includes a config.yml for customizing behavior:

Toggle PvP-only head drops
Control pickup restrictions
Customize disguise behavior
Enable debug logging
How It Works
Death Event: When a player dies, a custom head with their profile is dropped
Head Creation: Heads store original owner UUID and name in NBT data
Equipping: Players can equip heads via inventory or right-click
Disguise Application: LibsDisguises API applies skin and name changes
Message Handling: Death messages reflect disguised identities
Development
Built with Maven and modern Java practices:

Clean separation of concerns
Event-driven architecture
Comprehensive error handling
Extensive logging for debugging

License

This plugin is provided as-is for educational and development purposes.