<center> <h1>Head Drop</h1> </center> <center> <a href="https://modrinth.com/plugin/head-drop" target="_blank"> <img alt="modrinth" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/available/modrinth_vector.svg"> </a> <a href="https://www.curseforge.com/minecraft/bukkit-plugins/players-head-drop" target="_blank"> <img alt="curseforge" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/available/curseforge_vector.svg"> </a> <a href="https://discord.gg/zcFRqtynu2" target="_blank"> <img alt="discord-plural" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/social/discord-plural_vector.svg"> </a> <a href="https://ko-fi.com/gab" target="_blank"> <img alt="kofi-singular" height="56" src="https://cdn.jsdelivr.net/npm/@intergrav/devins-badges@3/assets/cozy/donate/kofi-singular_vector.svg"> </a> </center> </br> ## 🤝 Our Partner <center> <a href="https://voltra.gg/r/gab" target="_blank"> <img alt="Voltra" src="https://cdn.modrinth.com/data/cached_images/67644375e7d252e9db0c485ad69af7e3c5509b24.png"> </a> </center> Need a game server ? We're partnered with <strong><a href="https://voltra.gg/r/gab" target="_blank">Voltra</a></strong>, one plan, every game, from $1.99/mo, with a 2 day free trial and no card charged today. Use code <strong>GAB10</strong> at checkout, or just click the banner above, either way you get 10% off. Clicking the banner above supports the development of this plugin at no extra cost to you ♥️ ## 📌 About This Minecraft plugin makes players drop their head upon death. Configure head drops, glowing effects, particles, broadcast messages, per-player statistics, and much more, all from a single `config.yml` Runs natively on **Spigot, Paper, Purpur and Folia**, with no extra dependencies <center> <img alt="Head Drop" src="https://cdn.modrinth.com/data/cached_images/d1e1df98fc28f5fc5078dc27ae9d631a3548605c.gif"> </center> ## 💡 Features - **PvP / PvE / All Drop Modes** Choose when heads drop : on any death, only player kills (`pvp`), or only environmental deaths (`pve`) - **Custom Drop Chance** Configure the exact probability of a head dropping (0% → 100%) - **Per-Player Drop Limit** Optionally cap how many heads a single player can ever drop (great for farm prevention). Reset any player with a command - **World Blacklist** Disable head drops entirely in specific worlds - **Invisibility Protection** Optionally prevent head drops when the dying player is invisible - **Drop as Item or Place on the Ground** Choose whether heads drop as a normal item, or are placed directly on the ground as a head block, facing the direction the player was looking. When placing on the ground, HeadDrop searches nearby for a free, supported spot (with a configurable fallback to a normal drop if none is found) - **Custom Head Item** - Editable display name - Single-line or multi-line lore - 10 placeholders (player, killer, weapon, world, coordinates, XP, death cause, date & time…) - Configurable date format **and timezone** - Optional despawn timer - Option to block renaming in anvils (only for plugin heads) - Optional name & lore **persistence** : heads keep their identity even after being placed, mined, or blown up (TNT, creepers, end crystals…) - **Hex & Legacy Colors** Every text option (head name, lore, broadcast message) supports both legacy color codes (`&a`) and hex colors (`&#FF00AA`), so you're no longer limited to the 16 vanilla colors - **Broadcast Messages** Toggle a global chat message whenever a head drops, with full placeholder and color-code support - **Optional Effects** - Visual lightning bolt (no damage) - Custom sound on drop - Particles with **7 shapes** (upward, circle, burst, cycle, pulse, wave, spiral) and a configurable duration (or infinite) - Colored glowing outline (**16 colors**, hex accepted and matched to the closest one, timed or infinite) - **Statistics System** An in-game GUI (`/head stats`) showing every player's head-drop count and last drop time, with : - Global server stats (total heads, unique players, most recent & oldest drop) - Sorting by count, last drop, or name (ascending / descending) - Single-player view and live player skins - Persistent storage that survives restarts - **Give Command** Hand out any player's head by username with `/head give`, styled with the exact same name and lore as a dropped head - **Automatic Config Migration** Updating the plugin never breaks your config : on startup, an outdated `config.yml` is automatically backed up and upgraded to the new version, keeping every setting you've already configured - **Built-in Update Checker** Get notified in the console when a new version is released on Modrinth All these features can be fully configured in the `config.yml` > **Default behav

Head Drop

## 🤝 Our Partner

Need a game server ? We're partnered with Voltra, one plan, every game, from $1. 99/mo, with a 2 day free trial and no card charged today.

Use code GAB10 at checkout, or just click the banner above, either way you get 10% off.

Clicking the banner above supports the development of this plugin at no extra cost to you ♥️

## 📌 About This Minecraft plugin makes players drop their head upon death. Configure head drops, glowing effects, particles, broadcast messages, per-player statistics, and much more, all from a single `config.yml`

Runs natively on Spigot, Paper, Purpur and Folia, with no extra dependencies

## 💡 Features

• PvP / PvE / All Drop Modes
• Choose when heads drop : on any death, only player kills (`pvp`), or only environmental deaths (`pve`)

• Custom Drop Chance
• Configure the exact probability of a head dropping (0% → 100%)

• Per-Player Drop Limit
• Optionally cap how many heads a single player can ever drop (great for farm prevention). Reset any player with a command

• World Blacklist
• Disable head drops entirely in specific worlds

• Invisibility Protection
• Optionally prevent head drops when the dying player is invisible

• Drop as Item or Place on the Ground
• Choose whether heads drop as a normal item, or are placed directly on the ground as a head block, facing the direction the player was looking. When placing on the ground, HeadDrop searches nearby for a free, supported spot (with a configurable fallback to a normal drop if none is found)

• Custom Head Item
• - Editable display name
• - Single-line or multi-line lore
• - 10 placeholders (player, killer, weapon, world, coordinates, XP, death cause, date & time…)
• - Configurable date format and timezone
• - Optional despawn timer
• - Option to block renaming in anvils (only for plugin heads)
• - Optional name & lore persistence : heads keep their identity even after being placed, mined, or blown up (TNT, creepers, end crystals…)

• Hex & Legacy Colors
• Every text option (head name, lore, broadcast message) supports both legacy color codes (`&a`) and hex colors (`&#FF00AA`), so you're no longer limited to the 16 vanilla colors

• Broadcast Messages
• Toggle a global chat message whenever a head drops, with full placeholder and color-code support

• Optional Effects
• - Visual lightning bolt (no damage)
• - Custom sound on drop
• - Particles with 7 shapes (upward, circle, burst, cycle, pulse, wave, spiral) and a configurable duration (or infinite)
• - Colored glowing outline (16 colors, hex accepted and matched to the closest one, timed or infinite)

• Statistics System
• An in-game GUI (`/head stats`) showing every player's head-drop count and last drop time, with :
• - Global server stats (total heads, unique players, most recent & oldest drop)
• - Sorting by count, last drop, or name (ascending / descending)
• - Single-player view and live player skins
• - Persistent storage that survives restarts

• Give Command
• Hand out any player's head by username with `/head give`, styled with the exact same name and lore as a dropped head

• Automatic Config Migration
• Updating the plugin never breaks your config : on startup, an outdated `config.yml` is automatically backed up and upgraded to the new version, keeping every setting you've already configured

• Built-in Update Checker
• Get notified in the console when a new version is released on Modrinth

All these features can be fully configured in the `config.yml`

> **Default behav