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.
