# HeadDisguisePlugin
\nA comprehensive Minecraft plugin for PaperMC 1.21.6 that creates an immersive player head and disguise system.<\/p>\n
# Features
\n\ud83c\udfad Core Functionality
\nPlayer Head Drops: Custom player heads drop on death, preserving the player’s skin and name
\nDual Equipping System: Equip heads via inventory slot or right-click anywhere
\nAutomatic Disguises: Integration with LibsDisguises for seamless skin\/name changes
\nCustom Death Messages: Death messages show disguised names instead of real ones
\nSelf-Pickup Prevention: Players cannot pick up their own dropped heads
\n\ud83d\udee0\ufe0f Technical Features
\nBuilt for PaperMC 1.21.6 with Java 21
\nRobust event handling and error management
\nNBT data preservation for head metadata
\nPermission-based access control
\nClean, modular architecture
\nInstallation
\nPrerequisites:<\/p>\n
PaperMC 1.21.6 server<\/p>\n
Usage
\nFor Players
\nEquipping Heads:
\nDrag a player head to your helmet slot in inventory
\nOR right-click with the head in hand for instant equipping
\nDisguising: Automatically applied when head is equipped
\nCombat: Use heads mid-fight for tactical disguises
\nFor Admins
\n\/headdisguise reload – Reload plugin and remove all disguises
\n\/headdisguise remove [player] – Remove disguise from specified player
\n\/headdisguise info – Display plugin information
\nPermissions
\nheaddisguise.use – Allow using head disguises (default: true)
\nheaddisguise.admin – Access to admin commands (default: op)
\nheaddisguise.bypass.selfpickup – Can pick up own dropped heads (default: op)
\nConfiguration
\nThe plugin includes a config.yml for customizing behavior:<\/p>\n
Toggle PvP-only head drops
\nControl pickup restrictions
\nCustomize disguise behavior
\nEnable debug logging
\nHow It Works
\nDeath Event: When a player dies, a custom head with their profile is dropped
\nHead Creation: Heads store original owner UUID and name in NBT data
\nEquipping: Players can equip heads via inventory or right-click
\nDisguise Application: LibsDisguises API applies skin and name changes
\nMessage Handling: Death messages reflect disguised identities
\nDevelopment
\nBuilt with Maven and modern Java practices:<\/p>\n
Clean separation of concerns
\nEvent-driven architecture
\nComprehensive error handling
\nExtensive logging for debugging
\n# License
\nThis plugin is provided as-is for educational and development purposes.<\/p>\n","protected":false},"excerpt":{"rendered":"
An Drop Head FOR the SILENT SMP<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"silenthead","_minecraft_project_id":"FRgZUF1x","_minecraft_author":"MaxouIX","_minecraft_license":"MIT","_minecraft_downloads":44,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"silenthead.zip","_minecraft_size_bytes":8082,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T21:25:38.199583Z","_minecraft_date_created":"2025-08-27T21:55:33.118278Z","_minecraft_date_modified":"2025-08-29T06:49:14.025557Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/silenthead","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-08T06:27:43+00:00","_minecraft_import_hash":"c40803644adac228fa5230af41ca1d92","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[88,89,127],"mod_loader":[132],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-139495","mod","type-mod","status-publish","hentry","mod_category-equipment","mod_category-game-mechanics","mod_category-paper","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n