Head Drop

Drop the player’s head on death. Fully customizable

43,41k

Head Drop

<center> <h1>Head Drop</h1> </center>

<center> <a href="https://ko-fi.com/gab476" 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> <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> </center> </br>

📌 About

This Minecraft plugin makes players drop their head upon death. Configure head drops, glowing effects, messages, and more via `config.yml`

<center> <img alt="Head Drop" src="https://cdn.modrinth.com/data/cached_images/d1e1df98fc28f5fc5078dc27ae9d631a3548605c.gif"> </center>

💡 Features

- PvP / PvE Head Drops Enable or disable head drops separately for PvP and PvE

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

- Custom Head Item - Editable display name - Single-line or multi-line lore - Optional despawn timer - Option to block renaming in anvils

- Broadcast Messages Toggle global messages when a head is dropped, with full placeholder support

- Optional Effects Add lightning , particles, sounds, or a glowing outline with customizable duration and styles

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

> Default behavior : > If you don’t modify the config, head drops function just like vanilla : no effects, no broadcasts, no special visuals

📝 Full Config

Spoiler

```yml

Check for plugin updates on server startup

check_for_updates: true

DROP SETTINGS

drop:

Drop mode: "pvp" (player kills only), "pve" (environment deaths only), "all" (both)

mode: "all"

Chance for a head to drop (0.0 = 0%, 1.0 = 100%)

chance: 1.0

Prevent head drop when player has invisibility effect

prevent_when_invisible: false

HEAD ITEM SETTINGS

head:

Custom name for the dropped head item

name: "%head_player%'s Head"

Custom lore for the dropped head item

Leave as empty string "" for no lore, or use a list for multiple lines

lore: ""

Uncomment this for detailed lore (remove 'lore: ""' above first!)

lore:

- "&8&l&m━━━━━━━━━━━━ &r&6&lInfo &8&l&m━━━━━━━━━━━━"

- "&6• &eVictim : &f%head_player%"

- "&6• &cKiller : &f%head_killer%"

- "&6• &aWorld : &7%head_world%"

- "&6• &bLocation : &f%head_coordinates%"

- "&6• &7Dropped : &8%head_datetime%"

- "&8&l&m━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

Time in seconds for player heads to despawn (max 300 seconds = 5 minutes)

despawn_time: 300

Prevents renaming of plugin heads via an anvil

disable_rename_in_anvil: false

BROADCAST SETTINGS

broadcast:

Enable or disable broadcasting a message when a player's head is dropped

enabled: false

Message to broadcast (supports placeholders)

message: "§c%head_player%'s§r§6 head has been dropped !§r"

EFFECTS SETTINGS

effects:

Lightning effect (visual only, no damage)

lightning: enabled: false

Sound effect

sound: enabled: false

Check the list: https://www.digminecraft.com/lists/sound_list_pc.php

type: "entity.player.levelup"

Particle effects

particles: enabled: false

Duration in seconds (use "infinite" for no limit)

duration: 10

Particle type: flame, heart, smoke...

Check: https://minecraft.wiki/w/Particles_(Java_Edition)

type: "smoke"

Shape: upward, circle, cycle, pulse, wave, spiral, burst

shape: "upward"

Glowing effect

glowing: enabled: false

Duration in seconds (use "infinite" for no limit)

duration: 10

Color: https://htmlcolorcodes.com/minecraft-color-codes/

color: "red" ```

🛠️ Setup

1. Download the version of the plugin that matches your Minecraft server 2. Place the `.jar` file in your `plugins` folder 3. Restart your server to activate the plugin

Most settings can be customized in the `config.yml` file, make sure to review it for full configuration options

⚙️ Config

After modifying your `config.yml`, use the command `/head reload` to apply your changes without restarting the server This command is only available if you are %%MD0%% or in %%MD0%%

🤝 Community & Support

Need help, found a bug, or just want to chat ? Join our Discord community, we’re always happy to hear your feedback and suggestions !

This plugin is completely free If you’d like to support its development and help it grow :

- 🧡 Support on Ko-Fi

*Your support helps the project stay alive and brings new updates*

❓ FAQ

Q: Where can I find the `config.yml` file ? A: After the first launch, the file appears at : `/plugins/HeadDrop/config.yml`

Q: How do I update the plugin to a newer version ? A: Download the latest release, replace the old `.jar` file in your `plugins` folder, then restart your server

Q: How do I report bugs ? A: Join the Q: How do I report bugs ? and post the issue in the bug-reporting channel

Q: What happens if I delete the `config.yml` file ? A: The plugin automatically regenerates a fresh default configuration file the next time the server starts

📊 Metrics

This plugin uses bStats, an open-source statistics service for Minecraft, to collect anonymous usage data. If you prefer to disable it, open the `config` file inside the `bStats` folder and set metrics to `false`

<a href="https://bstats.org/plugin/bukkit/PlayerHeadDrop/24050" target="_blank"> <img src="https://bstats.org/signatures/bukkit/PlayerHeadDrop.svg" alt="bStats"> </a>

ADS