SilentHead

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8

平台： paper

标签： equipment game-mechanics

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.