PlayerHeadDrops

<div align="center"> !(https://cdn.modrinth.com/data/cached_images/29ede4f851c97778af1524d460126b9b83a40852.png) !(https://img.shields.io/badge/version-2.0.0-1E90FF?style=for-the-badge) !(https://img.shields.io/badge/Minecraft-1.13+-4C9A2A?style=for-the-badge) !(https://img.shields.io/badge/Platform-Paper%20%7C%20Purpur-FF6B35?style=for-the-badge) !(https://img.shields.io/badge/Java-8+-ED8B00?style=for-the-badge&logo=openjdk&logoColor=white) (https://img.shields.io/modrinth/dt/playerheaddrops?style=for-the-badge&logo=modrinth&logoColor=white&color=00AF5C&label=downloads)](https://modrinth.com/plugin/playerheaddrops) !(https://img.shields.io/badge/side-server-9B4DCA?style=for-the-badge) (https://img.shields.io/badge/Telegram-channel-26A5E4?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/prostoimpery) </div> > **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. --- ## Demo <div align="center"> <iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/lbpigmOl6Kk" title="PlayerHeadDrops" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> </div> --- ## Configuration <details> <summary><b>config.yml</b></summary> ```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: - "<gray>Killed by: <white>%killer%</white></gray>" - "<gray>World: <white>%world%</white></gray>" - "<dark_gray>%date% %time%</dark_gray>" 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: "<yellow>☠ %player%'s head has dropped!</yellow>" radius: -1 economy: enabled: false reward: 0.0 effects: sound: enabled: false name: entity.player.levelup particles: enabled: false name: SOUL ``` </details> --- ## 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 <details> <summary><b>Do heads survive server restarts?</b></summary> Yes — the plugin uses embedded texture data, so skins are preserved forever. </details> <details> <summary><b>Does it work with keepInventory?</b></summary> Yes — the drop logic is independent of vanilla gamerules. </details> <details> <summary><b>Can I change the head name and lore?</b></summary> Yes — fully customizable in config.yml: format, color, italic, lore with MiniMessage support. </details> <details> <summary><b>Does