PlayerHeadDrops

Nothing says victory in Minecraft quite like collecting the head of your fallen foe. The PlayerHeadDrops add-on brings that thrill to your server by making a player's head drop on death, complete with their unique skin texture. Lightweight, highly configurable, and built for modern Paper servers, this plugin turns every skirmish into a trophy hunt.

Key Features

PlayerHeadDrops is designed to be simple yet flexible, giving server owners full control over how heads behave. Here is what you can expect:

• Skin-accurate heads – Each head stores embedded texture data, so the skin remains intact even after server restarts or when the original player is offline.
• Configurable drop chance – Set the probability anywhere from 0% (never drop) to 100% (always drop), or any decimal in between.
• One-time drop mode – A player's head can drop only once, ever. The data persists across restarts, preventing duplicate trophies from the same player.
• PvP-only mode – Restrict head drops to kills made by another player, ignoring environmental deaths or mob kills.
• Drop to inventory – Instead of falling to the ground, the head can be placed directly into the killer's inventory for instant bragging rights.
• Server-wide announcements – Broadcast a customizable message when a head drops, with full color code support.
• Fully customizable head name – Change the item's display name format, color, and italic style to match your server's theme.

How to Install PlayerHeadDrops

Getting PlayerHeadDrops up and running on your server takes just a few minutes. Follow these steps to download PlayerHeadDrops and set it up correctly:

1. Download the latest .jar file from the official source (check the files tab on the project page).
2. Place the .jar into your server's plugins/ folder.
3. Restart the server to generate the default configuration files.
4. Open plugins/PlayerHeadDrops/config.yml and adjust the settings to your liking.
5. Restart the server once more to apply your changes.

If you manage your server through the foxygame.net launcher, adding PlayerHeadDrops is even simpler. The launcher's built-in add-on catalog lets you install PlayerHeadDrops with a single click, and it automatically keeps the plugin updated to the latest compatible version for your server setup. That means no manual file downloads or worrying about version mismatches.

Configuration Options

Once installed, you will find a well-organized config.yml file inside the plugins/PlayerHeadDrops/ folder. Here are the main settings you can tweak:

• drop-chance – A decimal value between 0.0 and 1.0. For example, 0.5 means a 50% chance.
• one-time-drop – Set to true to ensure each player's head drops only once across all server sessions.
• only-pvp – When true, heads drop exclusively from player-versus-player kills.
• drop-to-inventory – If true, the head goes directly into the killer's inventory instead of spawning on the ground.
• announce-drop – Enable or disable a server-wide message when a head drops.
• announce-message – Customize the broadcast text. Use %player% as a placeholder for the victim's name and standard Minecraft color codes (like &e for yellow).
• head name-format – Define the item name, e.g., %player%'s Head.
• head name-color – Choose a color for the head's display name (yellow, red, aqua, etc.).
• head name-italic – Set to true to make the name italic.

All changes take effect after a server restart. The plugin also creates a data/dropped_heads.yml file to track which players have already had their head drop when the one-time-drop feature is enabled.

Compatibility and Requirements

PlayerHeadDrops is built for modern Minecraft server environments. It requires:

• Server software – Paper 1.21 or newer (and derivatives like Purpur). It does not work on vanilla Minecraft servers or older Bukkit/Spigot versions without Paper's API features.
• Minecraft version – 1.21 and above. The plugin leverages modern item components to store skin data reliably.
• Java – Java 21 or higher is needed to run the server and the plugin.

Because PlayerHeadDrops uses Paper's native methods for head textures, the heads remain intact even if the original player changes their skin later. This makes it a robust choice for long-running survival or PvP worlds.

Why Choose PlayerHeadDrops for Your Server

There are many head-drop plugins out there, but PlayerHeadDrops stands out for its simplicity and reliability. It does not bloat your server with unnecessary features or performance-heavy processes. The configuration is straightforward, and the generated files are minimal. Whether you run a small community server or a large PvP network, this add-on scales without issues.

The ability to limit drops to PvP kills only is especially useful for competitive servers, where you want to reward player skill without cluttering the world with heads from accidental deaths. Meanwhile, the one-time-drop mode adds a collectible aspect, encouraging players to seek out rare trophies from every unique opponent.

For server administrators who use the foxygame.net launcher, PlayerHeadDrops integrates seamlessly into the one-click install ecosystem, so you can add it to your server without touching any configuration files manually. The launcher also handles version compatibility checks, ensuring you always run a build that matches your server's Paper release.

With clear documentation, active maintenance, and a focus on doing one thing well, PlayerHeadDrops is a must-have for any Minecraft server that wants to add a tangible reward to player combat. Download PlayerHeadDrops today and let the head-hunting begin.