![PlayerHeadDrops Banner](https://cdn.modrinth.com/data/cached_images/29ede4f851c97778af1524d460126b9b83a40852.png) ![Version](https://img.shields.io/badge/version-2.0.0-1E90FF?style=for-the-badge) ![Minecraft](https://img.shields.io/badge/Minecraft-1.13+-4C9A2A?style=for-the-badge) ![Platform](https://img.shields.io/badge/Platform-Paper%20%7C%20Purpur-FF6B35?style=for-the-badge) ![Java](https://img.shields.io/badge/Java-8+-ED8B00?style=for-the-badge&logo=openjdk&logoColor=white) [![Modrinth](https://img.shields.io/modrinth/dt/playerheaddrops?style=for-the-badge&logo=modrinth&logoColor=white&color=00AF5C&label=downloads)](https://modrinth.com/plugin/playerheaddrops) ![Side](https://img.shields.io/badge/side-server-9B4DCA?style=for-the-badge) [![Telegram](https://img.shields.io/badge/Telegram-channel-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/prostoimpery)

> **When a player dies, their head drops — complete with their skin.** > Everything else is configurable down to the smallest detail. --- ## Features - **Skin preservation** — textures are embedded into the item, so skins survive server restarts. - **Drop chance** — from 0% to 100%, plus Looting and permission bonuses. - **One-time drop mode** — each player's head can drop only once. Data persists across restarts. - **Cooldown** — a specific player's head won't drop again until the configured time passes. - **PvP-only mode** — heads drop only when killed by another player. Mobs, suicide, and /kill don't count. - **Drop to inventory** — send the head directly to the killer's inventory instead of the ground. - **Anti-farm** — ignore suicide, void deaths, and self-kills. - **World control** — blacklist or whitelist worlds. - **Custom name and lore** — format, color, italic, lore with MiniMessage and placeholders support (%player%, %killer%, %world%, %date%, %time%). - **Mob heads** — vanilla mob heads (ZOMBIE, SKELETON, CREEPER, WITHER_SKELETON, PIGLIN, ENDER_DRAGON) with separate chances. - **Looting bonus** — each level of Looting on the killer's weapon adds to the drop chance. - **Permission bonus** — chance multiplier for players with playerheaddrops.boost permission. - **Announcements** — customizable chat message when a head drops, global or radius-based. - **Economy (Vault)** — reward the killer for each head drop. - **Sounds and particles** — accompany head drops with sound effects and particles. --- ## Configuration

config.yml

```yaml # ───────────────────────────────────────── # PlayerHeadDrops v2.0.0 | Author: Kasperoid # ───────────────────────────────────────── config-version: 2 drop-chance: 1.0 one-time-drop: false cooldown-seconds: 0 only-pvp: false drop-to-inventory: false anti-farm: ignore-suicide: true ignore-void: false ignore-self-kill: true worlds: mode: blacklist list: - world_the_lobby - creative_world head: name-format: "%player%'s Head" name-color: yellow name-italic: false lore: - "Killed by: %killer%" - "World: %world%" - "%date% %time%" mob-heads: enabled: false default-chance: 0.05 only-player-kill: true name-format: "" chances: ZOMBIE: 0.05 SKELETON: 0.05 CREEPER: 0.05 WITHER_SKELETON: 0.10 PIGLIN: 0.05 ENDER_DRAGON: 1.0 looting-boost: enabled: false per-level: 0.1 permission-boost: enabled: false multiplier: 2.0 announce: enabled: false message: "☠ %player%'s head has dropped!" radius: -1 economy: enabled: false reward: 0.0 effects: sound: enabled: false name: entity.player.levelup particles: enabled: false name: SOUL ```

--- ## Compatibility | | | |:---:|:---:| | **Server** | Paper / Purpur / Bukkit / Spigot | | **Minecraft** | 1.13+ | | **Java** | 8+ | --- ## Installation 1. Download the latest `.jar` from the files tab. 2. Place it in your server's `plugins/` folder. 3. Restart the server. 4. Edit `config.yml` to your liking. 5. Restart again to apply changes. --- ## FAQ

Do heads survive server restarts?

Yes — the plugin uses embedded texture data, so skins are preserved forever.

Does it work with keepInventory?

Yes — the drop logic is independent of vanilla gamerules.

Can I change the head name and lore?

Yes — fully customizable in config.yml: format, color, italic, lore with MiniMessage support.

Does it support PlaceholderAPI?

Yes — in announcement messages and head lore.

How do I disable drops in certain worlds?

Use the blacklist mode in the worlds section and list the worlds.

--- ## Links

[![Modrinth](https://img.shields.io/badge/Modrinth-Download-00AF5C?style=for-the-badge&logo=modrinth&logoColor=white)](https://modrinth.com/plugin/playerheaddrops) [![Telegram](https://img.shields.io/badge/Telegram-channel-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/prostoimpery) [![GitHub](https://img.shields.io/badge/GitHub-kasperoid31-181717?style=for-the-badge&logo=github&logoColor=white)](https://github.com/kasperoid31) [![CurseForge](https://img.shields.io/badge/CurseForge-PlayerHeadDrops-F16436?style=for-the-badge&logo=curseforge&logoColor=white)](https://www.curseforge.com/minecraft/bukkit-plugins/playerheaddrops) [![Hangar](https://img.shields.io/badge/Hangar-PlayerHeadDrops-00b4d8?style=for-the-badge&logo=papermc&logoColor=white)](https://hangar.papermc.io/kasperoid/PlayerHeadDrops)

PlayerHeadDrops

2.0.0-1.18-1.21

2.0.0-1.13-1.21

2.0.0